diff --git a/docs/web-patches/README.md b/docs/web-patches/README.md index 291ff4a..c960273 100644 --- a/docs/web-patches/README.md +++ b/docs/web-patches/README.md @@ -86,4 +86,30 @@ SKIP_PLAYWRIGHT=1 bash /home/ubuntu/ccWorkDir/.claude/skills/dacli-ts/examples/b - **不通过**: 暂停, 检查改动是否引入了新的镜像失败模式 - **白名单 (KNOWN_FALSE_POSITIVES)**: 仅限 web 端架构差异 (如 di 无正则), 不能为图方便加白名单 -权威源: `dacli/src/commands/_gate_webapi.ts` + `dacli/.git/hooks/pre-commit` (commit 前自动跑) \ No newline at end of file +权威源: `dacli/src/commands/_gate_webapi.ts` + `dacli/.git/hooks/pre-commit` (commit 前自动跑) + +## 排除规则 (v3.0+ 重要: 不是所有 web/** 都触发 webpatches) + +**核心**: webpatches **仅适用** web 端**前端源码**(Vue/TypeScript), 后端 Java 业务包和静态产物**不触发**. + +| 路径模式 | 类别 | 是否触发 webpatches CI | 走什么流程 | +|---------|------|----------------------|----------| +| `web/.../src/**/*.vue` | 前端源码 (Vue 组件) | ✅ **是** | webpatches + CI 关卡 G | +| `web/.../src/**/*.ts` | 前端源码 (TS 模块) | ✅ **是** | webpatches + CI 关卡 G | +| `web/packages/jnpf/utils/src/**/*.ts` | 前端工具 (dacli 复用) | ✅ **是** | webpatches + CI 关卡 G | +| `web/apps/.../public/ssw/**` | **静态扩展产物** (dacli 项目生成) | ❌ **否** | 不写 patch, 走 git log | +| `web/apps/.../dist/ssw/**` | **构建产物** (部署时生成) | ❌ **否** | 不写 patch, 走 git log | +| `web/.../src/.../components/Jnpf/**` | JNPF 平台组件 (不要改) | ⚠️ **不写 patch, 改完会丢** | 改前先评估 | +| `boot/**/ssw*/**/*.java` | **后端 Java 业务包** (不是 web) | ❌ **否** | 走 backend-dev 流程 (§22.8) | +| `uniapp/pages/ssw/**` | **移动端 ssw 页面** | ❌ **否** | 走 uniapp 流程 | + +**判断原则**: +- ✅ 触发: 修改 `web/.../src/**` (前端源码) + dacli webapi 镜像链路中用到的 web 工具 +- ❌ 不触发: 修改 `boot/ssw*/**` (后端) + `web/.../public|dist/ssw/` (产物) + `uniapp/pages/ssw/` (移动端) + +**自动化建议** (未来): +```bash +# 检查本次改动是否触发 webpatches (伪代码) +git diff --name-only HEAD~1 | grep -E '^web/.*\.(vue|ts)$' | grep -v '/public/ssw/' | grep -v '/dist/ssw/' +# 空输出 = 不触发, 有输出 = 触发 webpatches + 跑 CI 关卡 G +``` \ No newline at end of file diff --git a/docs/尚数网基本开发规范v3.0.md b/docs/尚数网基本开发规范v3.0.md index d5e0b7d..64fa717 100644 --- a/docs/尚数网基本开发规范v3.0.md +++ b/docs/尚数网基本开发规范v3.0.md @@ -1444,3 +1444,46 @@ npx tsx src/commands/_gate_webapi.ts - **回归审计发现** web 端架构变化 → webpatches 流程需更新 - **webpatches 流程** 跑了 CI 关卡 G FAIL → 触发回归审计 (找出根因) - **双向闭环**: 回归审计 ↔ webpatches 流程, 共同保证 dacli 与 web 端架构一致 + +### 22.8 排除规则 (v3.0+ 重要: 不是所有 web/** 都触发) + +**核心**: webpatches **仅适用** web 端**前端源码** (Vue/TypeScript). 后端 Java 业务包和静态产物**不触发**. + +| 路径模式 | 类别 | 是否触发 webpatches CI | 走什么流程 | +|---------|------|----------------------|----------| +| `web/.../src/**/*.vue` | 前端源码 (Vue 组件) | ✅ **是** | webpatches + CI 关卡 G | +| `web/.../src/**/*.ts` | 前端源码 (TS 模块) | ✅ **是** | webpatches + CI 关卡 G | +| `web/packages/jnpf/utils/src/**/*.ts` | 前端工具 (dacli 复用) | ✅ **是** | webpatches + CI 关卡 G | +| `web/apps/.../public/ssw/**` | **静态扩展产物** (dacli 项目生成) | ❌ **否** | 不写 patch, 走 git log | +| `web/apps/.../dist/ssw/**` | **构建产物** (部署时生成) | ❌ **否** | 不写 patch, 走 git log | +| `web/.../src/.../components/Jnpf/**` | JNPF 平台组件 (不要改) | ⚠️ **不写 patch, 改完会丢** | 改前先评估 | +| **`web/**/ssw/**` (包括 boot/ssw-*)** | **后端 Java 业务包** (不是 web 源码) | ❌ **否** | 走 **backend-dev** 流程 | +| `uniapp/pages/ssw/**` | **移动端 ssw 页面** | ❌ **否** | 走 uniapp 流程 | + +**特别注意 `web/**/ssw/` 模式**: + +> 用户反馈 (2026-06-29): **不是所有路径都触发 webpatches CI**. `web/**/ssw/` 实际指: +> - `boot/**/ssw*/src/main/java/ssw/` — **后端 Java 业务包** (走 backend-dev, §六.2) +> - `web/apps/.../public/ssw/` — **dacli 生成的静态扩展** (§4.4, 走 git log) +> - `web/apps/.../dist/ssw/` — **构建产物** (部署生成, 不入 git) +> +> 这些都不是 web 端**前端源码**, **不走 webpatches**, **不跑 CI 关卡 G** (那是 webpatches 专属). + +**判断原则** (避免误触发): +- ✅ 触发: 修改 `web/.../src/**` (前端源码) + dacli webapi 镜像链路中用到的 web 工具 +- ❌ 不触发: 修改 `boot/ssw*/**` (后端) + `web/.../public|dist/ssw/` (产物) + `uniapp/pages/ssw/` (移动端) + +**自动化检查建议** (未来集成到 hook): +```bash +# 伪代码: 检查本次 commit 改动的 web 文件是否触发 webpatches +git diff --name-only HEAD~1 | \ + grep -E '^web/.*\.(vue|ts)$' | \ + grep -v '/public/ssw/' | \ + grep -v '/dist/ssw/' +# 空输出 = 不触发 (不跑 CI 关卡 G) +# 有输出 = 触发 webpatches (跑 CI 关卡 G) +``` + +**未来增强** (本节不在本 turn 范围): +- 集成到 git pre-commit hook: 自动检测是否需要跑 webpatches CI +- 加 `dacli webpatch check` 命令: 主动列出本次 commit 触发的 webpatches