按 feedback-web-patch-docs.md 规则, 建立 dacli/docs/web-patches/ 目录:
- README.md: 文档化规则 + 当前 patches 状态 + Phase 3 候选 (说明)
- _visualDev-api-shim.md: Phase 1 webapi/visualDev patch (commit d4506fe)
- _buildformdata-formUtils.md: Task 4-10 _buildformdata.ts patch (commit bb3ebaf~fd8ef3b)
Phase 3 候选改造 (formDesign/Form.vue / CreateMenuModal.vue / sysForm/Form.vue)
通过 Phase 1 webapi 间接覆盖 (web 端组件仍调原端点, dacli 用 webapi 调同样端点),
直接抽纯函数价值有限, 暂不执行. 如果未来 BS-48/49/50 反复修, 再启动真正 Phase 3.
升级 web 后, AI 读本目录所有 patch 文档逐个对照, 缺失的重新应用.
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 后完善该文档, 含:
- 实际 diff (改前 vs 改后)
- 改动原因 (为什么 dacli 需要这个改动)
- 验收方法 (怎么验证 patch 还在)
- web 升级后 重新读本目录所有 patch, 逐个对照, 缺失的重新应用
不写文档 = 改动 100% 会被升级覆盖丢失.
当前 Patches 状态
| Patch 文件 | 对应 web 端文件 | 状态 | 备注 |
|---|---|---|---|
_buildformdata-formUtils.md |
web/.../helper/formUtils.ts |
✅ 已应用 (v0.11+ Task 4-10) | 已是纯函数, 无需 patch |
_ai_prompts-GEN_MODEL_QUESTION.md |
web/.../views/onlineDev/.../AiCreateModal.vue |
✅ 已应用 (v0.11+ Task 7-10) | prompt 抽到 _ai_prompts.ts |
_visualDev-api-shim.md |
web/.../api/onlineDev/visualDev.ts |
✅ 已应用 (v0.11+ Phase 1) | 通过 webapi/visualDev.ts 镜像 |
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. 跑 baseline 验证
SKIP_PLAYWRIGHT=1 bash /home/ubuntu/ccWorkDir/dacli/.claude/skills/dacli-ts/examples/baseline/all.sh
不在本目录的事
- 删 web 端文件: 大概率不行 (其他模块依赖), 不在 patch 范围
- 改 web 端 bug: 不属于 dacli 范围, 应报给 JNPF 平台组
- dacli 自有模块改动: 走 git log, 不在本目录