- 移除 stale 引用 _ai_prompts-GEN_MODEL_QUESTION.md (文件已不存在) - 更新表格备注: 前 2 项 patch (formUtils / visualDev) 为 'web 端零改动镜像契约文档', 解释其作为 v0.11+ 镜像架构合法使用场景 - 新增 '清理日志 (2026-07-02)' 段: 删除 jxcj-dashboard-portal-report.md / jxcj-official-site.md (跟踪目标 web/public/ssw/ 违反 README §排除规则 + CLAUDE.md §代码修改权限 + memory feedback-web-patch-docs) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <[email protected]>
web-patches — dacli 对 web 端的改造记录
目的
dacli v0.11+ 镜像架构阶段, 当 dacli 需要复用 web 端 Vue 组件 setup() 中的业务逻辑, 我们会修改 web/ 端源码. 但 web/ 端是平台源码 (JNPF 升级时会覆盖), 所以 每个 web 端改动必须在这里单独存档一份 patch, 升级后能 re-apply.
规则
- 改 web 前先在本目录写
<component>.md(含"待改动清单") - 改 web 前 + 后必跑 CI 关卡 G (§二十 v3 主规范):
npx tsx src/commands/_gate_webapi.ts- FAIL (exit 1, 真实违规) → 阻塞, 必须修
- WARN (exit 2, 白名单命中) → 提示但通过
- PASS (exit 0) → 可继续
- 改 web 后完善该文档, 含:
- 实际 diff (改前 vs 改后)
- 改动原因 (为什么 dacli 需要这个改动)
- 验收方法 (怎么验证 patch 还在)
- CI 关卡 G 跑通截图 (paste 真实 FAIL=0 那一段输出)
- web 升级后 重新读本目录所有 patch, 逐个对照, 缺失的重新应用
- 升级后必跑 CI 关卡 G, 确认 patch 没有破坏架构
不写文档 = 改动 100% 会被升级覆盖丢失. 不跑 CI 关卡 G = 改动可能引入镜像架构回归 (新 web 端依赖未镜像).
当前 Patches 状态
| Patch 文件 | 对应文件 | 状态 | 备注 |
|---|---|---|---|
_buildformdata-formUtils.md |
web/.../helper/formUtils.ts |
✅ 已应用 (v0.11+ Task 4-10) | web 端零改动, dacli 用 _loader.ts 动态 import 镜像 |
_visualDev-api-shim.md |
web/.../api/onlineDev/visualDev.ts |
✅ 已应用 (v0.11+ Phase 1) | web 端零改动, dacli 用 webapi/visualDev.ts 镜像 |
_codegen-ServiceImpMarco-virtual-field.md |
boot/resources/.../ServiceImpMarco.vm |
✅ 已应用 (2026-06-23) | ⚠ 特例: 后端 vm 模板, 非 web 前端源码; 虚拟字段 null 守卫 |
_jnpf-admin-scanBasePackages-ssw.md |
boot/jnpf-admin/.../JnpfAdminApplication.java |
✅ 已应用 (2026-04-07) | ⚠ 特例: 主入口对 JNPF 基线定制; scanBasePackages 加 "ssw" |
零改动镜像 patch 的合法性: 上面前 2 项 patch 文档记录 "web 端保持原样, dacli 通过 dynamic import 镜像"。 这是 v0.11+ 镜像架构的合法使用场景 — patch 文档的"价值"在于记录 dacli 镜像哪些 web 端函数、 镜像机制 (import 替换规则) + 验收方法, 让 web 升级后能验证镜像链路仍然成立。 它不违反"web 端零改动则无需 patch"的直觉 — 它是镜像架构的契约文档, 不是 diff 记录。
清理日志
- 2026-07-02 删除 2 个误归类 patch:
jxcj-dashboard-portal-report.md— 跟踪目标web/.../public/ssw/jxcj/{dashboard,portal,report}/, 命中"排除规则"第 102 行❌ 否(静态扩展产物, 走 git log)jxcj-official-site.md— 跟踪目标web/.../public/ssw/jxcj/{index,directions,awards}.html + api.js, 同上
- 2026-07-02 移除 README 表格中 stale 引用
_ai_prompts-GEN_MODEL_QUESTION.md(文件不存在, 早已删除未同步 README) - 触发原因: 用户审查 web-patches 目录与 CLAUDE.md §代码修改权限 / memory
feedback-web-patch-docs规则的对齐情况
Phase 3 候选 (未来可做)
按 docs/dacli/v0.11-mirror-refactor.md §3 Phase 3, 候选改造:
web/.../views/onlineDev/formDesign/Form.vue抽buildFormSubmitPayload(state)web/.../views/onlineDev/formDesign/components/CreateMenuModal.vue抽buildMenuMountPayload(formId, type)web/.../views/onlineDev/sysForm/Form.vue系统表单 submit 逻辑
当前状态 (2026-06-25): 这 3 个候选都通过 Phase 1 webapi 间接覆盖 (web 端组件
仍调原端点 /visualdev/Base/{id}/Actions/Module 等, dacli 用 webapi/visualDev 调用
同样的端点). 直接抽纯函数的额外价值有限, 暂不执行.
如果未来 BS-48/49/50 等盲点反复修, 再考虑 Phase 3 真正执行.
验收 / 升级流程
每次 web 升级 (JNPF 平台 release) 后:
# 1. 看 patch 清单
ls dacli/docs/web-patches/*.md
# 2. 对每个 patch:
# - 读 patch 文档的"实际 diff"
# - 对照当前 web/ 端文件: 改动还在吗?
# - 不在 → 重新应用, 跑 baseline 验证
# - 在 → 文档标 ✅
# 3. 必跑 CI 关卡 G (v3.0+ 新增, 防止 patch 引入镜像架构回归)
npx tsx src/commands/_gate_webapi.ts
# 期望: 真实 FAIL = 0, 总体 PASS 或仅 WARN (白名单命中)
# 4. 跑 baseline 验证
SKIP_PLAYWRIGHT=1 bash /home/ubuntu/ccWorkDir/.claude/skills/dacli-ts/examples/baseline/all.sh
不在本目录的事
- 删 web 端文件: 大概率不行 (其他模块依赖), 不在 patch 范围
- 改 web 端 bug: 不属于 dacli 范围, 应报给 JNPF 平台组
- dacli 自有模块改动: 走 git log, 不在本目录
CI 关卡 G 集成背景 (v3.0+, 2026-06-29)
按 v3 主规范 §二十 CI 关卡 G + §二十二 webpatches 强制流程:
- 改 web 前: 跑
_gate_webapi.ts确认当前基线 (真实 FAIL = 0) - 改 web 后: 再跑一次确认改动没有引入新镜像问题
- 不通过: 暂停, 检查改动是否引入了新的镜像失败模式
- 白名单 (KNOWN_FALSE_POSITIVES): 仅限 web 端架构差异 (如 di 无正则), 不能为图方便加白名单
权威源: 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/(移动端)
自动化建议 (未来):
# 检查本次改动是否触发 webpatches (伪代码)
git diff --name-only HEAD~1 | grep -E '^web/.*\.(vue|ts)$' | grep -v '/public/ssw/' | grep -v '/dist/ssw/'
# 空输出 = 不触发, 有输出 = 触发 webpatches + 跑 CI 关卡 G