Files
dacli/docs/web-patches
ssw 720c99d062 fix(BS-New-1, BS-New-3): 字典 enCode 自动 skip-duplicate + datetime 自动转 Long
BS-New-1: dict dataCreate 新增 --skip-duplicate (默认 ON)
  - 预拉已有 items 检测 enCode/fullName 冲突
  - 命中冲突的项自动跳过 (避免后端 EXIST001/EXIST002)
  - --no-skip-duplicate 保留旧行为 (强制失败)

BS-New-3: test run POST create 前自动转 ISO8601 → Long
  - 根因: 后端 VisualdevModelDataServiceImpl.swapDatetime 强制
    Long.parseLong(value), ISO8601 字符串抛 NumberFormatException
  - 镜像 web datePicker 默认 Date.now()
  - 检测 datePicker/timePicker 字段, 字符串值自动 new Date().getTime()

测试场 (testspace) 验证:
- BS-New-1: 单条/批量 重复 enCode 自动 skip ✓
- BS-New-3: 用户传 ISO8601 → Long → 数据库正确落地 ✓

jxcj 2026-06-30 实战教训
2026-06-30 18:53:38 +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 前 + 后必跑 CI 关卡 G (§二十 v3 主规范):
    npx tsx src/commands/_gate_webapi.ts
    
    • FAIL (exit 1, 真实违规) → 阻塞, 必须修
    • WARN (exit 2, 白名单命中) → 提示但通过
    • PASS (exit 0) → 可继续
  3. 改 web 后完善该文档, 含:
    • 实际 diff (改前 vs 改后)
    • 改动原因 (为什么 dacli 需要这个改动)
    • 验收方法 (怎么验证 patch 还在)
    • CI 关卡 G 跑通截图 (paste 真实 FAIL=0 那一段输出)
  4. web 升级后 重新读本目录所有 patch, 逐个对照, 缺失的重新应用
    • 升级后必跑 CI 关卡 G, 确认 patch 没有破坏架构

不写文档 = 改动 100% 会被升级覆盖丢失. 不跑 CI 关卡 G = 改动可能引入镜像架构回归 (新 web 端依赖未镜像).

当前 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 镜像
_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"

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. 必跑 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