docs(dacli/v3+webpatches): 加 webpatches 排除规则 (web/**/ssw 不触发)

用户反馈 (2026-06-29): 不是所有 web/** 路径都触发 webpatches CI 机制.
最关键: web/**/ssw/** 实际指后端 Java 业务包 (boot/ssw-{app}-biz/...),
不是 web 端源码, 不应触发 webpatches + CI 关卡 G.

**改 docs/web-patches/README.md** (新增 '排除规则' 章节):
- 路径模式表: 8 类路径分类 (前端源码✅ / 静态产物❌ / 后端 ssw❌ 等)
- 特别注意 web/**/ssw/ 模式 (实际指后端 Java)
- 判断原则: 触发 vs 不触发
- 未来自动化检查建议 (伪代码)

**v3 主规范 §22 +§22.8 排除规则** (43 行):
- 路径模式表 (8 类, 与 README 同步)
- 特别说明 web/**/ssw/ 模式 (用户反馈)
- 引用用户原话: '不是所有路径都触发 webpatches CI'
- 判断原则
- 未来自动化检查建议 (git diff + grep)

**关键排除路径**:
- boot/**/ssw*/**/*.java (后端 Java 业务包, 走 backend-dev 流程 §六.2)
- web/apps/.../public/ssw/** (dacli 生成的静态扩展, §4.4, 走 git log)
- web/apps/.../dist/ssw/** (构建产物, 部署生成)
- uniapp/pages/ssw/** (移动端 ssw 页面, 走 uniapp 流程)

**webpatches 适用路径** (✅ 触发):
- web/.../src/**/*.vue (前端 Vue 组件)
- web/.../src/**/*.ts (前端 TS 模块)
- web/packages/jnpf/utils/src/**/*.ts (dacli 复用的前端工具)

权威源: docs/web-patches/README.md + dacli docs 尚数网基本开发规范v3.0.md §22.8
This commit is contained in:
ssw committed 2026-06-29 18:40:03 +08:00
1 parent 1e2ead67b6
commit 86d7d8e690
2 files changed
+70 -1

No files matched your search

+27 -1
View File
@@ -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 前自动跑)
权威源: `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
```
+43
View File
@@ -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