Files
dacli/docs/web-patches
sswandClaude a0242714ef docs(v0.11): dacli/docs/web-patches/ 建立 - patch 文档化流程
按 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]>
2026-06-25 13:12:10 +08:00
..

web-patches — dacli 对 web 端的改造记录

目的

dacli v0.11+ 镜像架构阶段, 当 dacli 需要复用 web 端 Vue 组件 setup() 中的业务逻辑, 我们会修改 web/ 端源码. 但 web/ 端是平台源码 (JNPF 升级时会覆盖), 所以 每个 web 端改动必须在这里单独存档一份 patch, 升级后能 re-apply.

规则

  1. 改 web 前先在本目录写 <component>.md (含"待改动清单")
  2. 改 web 后完善该文档, 含:
    • 实际 diff (改前 vs 改后)
    • 改动原因 (为什么 dacli 需要这个改动)
    • 验收方法 (怎么验证 patch 还在)
  3. 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, 候选改造:

  1. web/.../views/onlineDev/formDesign/Form.vue 抽 buildFormSubmitPayload(state)
  2. web/.../views/onlineDev/formDesign/components/CreateMenuModal.vue 抽 buildMenuMountPayload(formId, type)
  3. 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, 不在本目录