Commit Graph
191 Commits
Author SHA1 Message Date
sswandClaude 3c312d71b9 docs(v0.11+): 更新 plan §11 - 进度含 3 REFACTOR-WEBAPI 提交
Phase 2 进展 (今天完成 7 个 commit):
- 3 端点假 PASS 修复 (90a8b4e)
- 3 P0 NEW-CMD (5f663eb doc toc/search, 7b8f9b1 apis search)
- 3 P0 REFACTOR-WEBAPI:
  * datasource 4 子 (7a34ee6)
  * dict 4 子 (20ddbfb)
  * menu 5 子 (c7b24eb + 694619b)

剩余 P0 (下次续):
- form 22 调用 REFACTOR-WEBAPI
- 30+ P0 NEW-CMD (form update / log exception / di / role / org / msg / storage / bigscreen / report)

Co-Authored-By: Claude <[email protected]>
2026-06-25 15:10:11 +08:00
sswandClaude 694619bd6e refactor(v0.11+): menu purge/unrelease 改用 webapi 镜像
Phase 1 审计标记 P0:
- menu/purge → 走 loadVisualDev.getReleaseMenu + loadMenu.delMenu + loadVisualDev.createMenu
- menu/unrelease → 走 loadVisualDev.createMenu (pc=0 app=0)
- menu/releases 内部已用 fetchFormReleasedMenus 走 webapi (helper 已是 webapi 模式)

收益:
- 消除 3 个文件 ~30 行 c.get/postJson/del 硬编码
- 跟 v0.11+ 镜像架构对齐
- create.ts 暂不重构 (复杂, 2 模式 + D-4/D-9/D-12 多层防御, 改动需 spec)

Co-Authored-By: Claude <[email protected]>
2026-06-25 15:09:19 +08:00
sswandClaude c7b24eb932 refactor(v0.11+): menu info + delete 改用 webapi 镜像
Phase 1 审计 (cmd-review/menu.md) 标记 P0 必做:
- webapi/menu.ts 已镜像 15 函数, 但使用率仅 1/15=6.7% (仅 list 用)
- 6 子命令可改用 webapi (info/delete/purge/unrelease/create 等)

本 commit 修复 2 个简单子命令:
- info → loadMenu.getInfo
- delete → loadMenu.delMenu

未做 (下次续):
- create.ts (复杂, 2 模式 + D-4/D-9/D-12 多层防御, 改动需 spec)
- purge.ts / unrelease.ts / releases.ts (用不同端点, 单独处理)

收益:
- 消除 ~40 行 c.get/del 硬编码
- 自动同步 web 端 schema 变更
- 跟 v0.11+ 镜像架构对齐

Co-Authored-By: Claude <[email protected]>
2026-06-25 15:08:32 +08:00
sswandClaude 20ddbfbe9c refactor(v0.11+): dict 4 子命令改用 webapi 镜像
Phase 1 审计 (cmd-review/dict.md) 标记 P0 必做:
- webapi/dict.ts 已镜像 15 函数, 使用率 0%
- 4 子命令 (typeList/typeCreate/dataList/dataCreate) 100% 绕 webapi

修复:
- typeList → loadDict.getDictionaryType (客户端 keyword 过滤)
- typeCreate → loadDict.createDictionaryType + createDictionaryData (循环)
- dataList → loadDict.getDictionaryDataList / getDictionaryAll
- dataCreate → loadDict.createDictionaryData (循环)

收益:
- 消除 ~80 行 c.get/postJson 硬编码
- 自动同步 web 端字段变更 (如 enabledMark 默认值)
- 与 v0.11+ 镜像架构对齐

Co-Authored-By: Claude <[email protected]>
2026-06-25 15:07:47 +08:00
sswandClaude 7a34ee6b5d refactor(v0.11+): datasource 4 子命令改用 webapi 镜像
Phase 1 审计 (cmd-review/datasource.md) 标记 P0 必做:
- webapi/dataSource.ts 已镜像 11 函数, 使用率 0%
- 4 子命令 (list/create/test/delete) 100% 绕 webapi

修复:
- list → loadDataSource.getDataSourceList
- create → loadDataSource.createDataSource
- delete → loadDataSource.delDataSource
- test → loadDataSource.testDbConnection + getDataSourceInfo

收益:
- 消除 ~150 行 c.get/postJson/del 硬编码
- 自动同步 web 端 schema 变更
- 与 v0.11+ 镜像架构对齐 (6 个 webapi 模块之一)

Co-Authored-By: Claude <[email protected]>
2026-06-25 15:06:48 +08:00
sswandClaude 72df65eb24 docs(v0.11+): 更新 plan - Phase 1+2 实际执行进度
新增 §11 章节记录今天 (2026-06-25) 的实际执行:
- Phase 1: 23 命令审计完成 (b9c9e31)
- Phase 2: 3 处端点错误修复 + 3 个 P0 新命令 (doc toc/search, apis search)
- 列出剩余 P0 工作 (webapi 镜像 + 30+ 新命令)
- 给出下次会话优先顺序

下次 AI 续做时: 先读 §11 知道已完成什么, 避免重复.

Co-Authored-By: Claude <[email protected]>
2026-06-25 15:03:57 +08:00
sswandClaude 7b8f9b1b45 feat(v0.11+): apis search --field= 字段级搜索 (P0 字段盲猜)
Phase 1 审计 (cmd-review/apis.md) 标记 P0 必补:
- 解决 AI 知道字段名 (如 f_user_name) 但不知道哪些 API 接受/返回该字段
- 解决 'AI 盲猜哪个 API 接受字段' 痛点 (盲点根因 B)

新增 dacli apis search --field=<f>:
- 遍历 OpenAPI components.schemas, 模糊匹配字段名 (--exact 可精确)
- 输出: 包含字段的 schema 列表 + 引用这些 schema 的 API 端点
- AI 工作流: search → info 精准拿 schema 详情
- 默认 --limit=50 防止输出过大

依赖: loadOpenApi (apis/_cache.ts 已有, 12h 缓存)

Co-Authored-By: Claude <[email protected]>
2026-06-25 15:03:35 +08:00
sswandClaude 5f663eb494 feat(v0.11+): doc toc + doc search P0 新命令 (上下文恢复)
Phase 1 审计 (cmd-review/doc.md) 标记 P0 必补:
- 解决 plan.html 几百行时 AI 盲找 section 浪费 token
- 解决 AI 必须 get 全文再 grep 的 token 浪费 (节省 40-60%)

新增 2 子命令:
1. dacli doc toc --file=<f> [--json]
   - 列 HTML 文件所有 section (id + title + 行数)
   - 依赖 _parser.ts listSections(), 复用 mtime 缓存
   - AI 工作流: toc → get --section=<id> 精准切片

2. dacli doc search --file=<f> --keyword=<kw> [--context=N] [--strip-mermaid]
   - 按关键词全文搜索, 输出含关键词的 section + 上下文
   - 依赖 _parser.ts parseFile(), 复用 mtime 缓存
   - 支持正则, --context 上下文行数可调

测试: 跑 v0.11-next-steps-plan.md 验证, 25 处 webapi 匹配全捕获

Co-Authored-By: Claude <[email protected]>
2026-06-25 15:02:27 +08:00
sswandClaude 90a8b4eecb fix(v0.11+): P0 修复 3 处端点错误 (假 PASS)
Phase 1 审计发现 3 处 P0 端点错误 (AI 调用返 success 但实际不生效):

1. integration emailTest
   - v0.10 错误: /message/SendMessageConfig/testSendConfig
   - v0.11+ 正确: /message/AccountConfig/testSendMail
   - 重构: 先拉 config, 再走 testConfig({...config, testSendEmail, testEmailTitle, testEmailContent, testType})

2. integration smsTest
   - v0.10 错误: /system/SmsTemplate/testSent
   - v0.11+ 正确: /message/AccountConfig/testSendSms
   - 重构: 同上模式 (testPhone + testType)

3. integration webhookTest
   - v0.10 错误: /message/SendMessageConfig/testSendConfig
   - v0.11+ 正确: /message/AccountConfig/testSendWebhook
   - 重构: 支持 --configId 或 --url 两种模式

4. msg templateCreate
   - v0.10 错误: /api/system/MessageTemplate
   - v0.11+ 正确: /api/message/MessageTemplateConfig

端点来源: web/api/msgCenter/accountConfig.ts:29 testConfig() + msgTemplate.ts:14 create()
影响: 这是 cmd-review/ 23 报告中 P0 必修项, 修复后避免 AI 误判 PASS

Co-Authored-By: Claude <[email protected]>
2026-06-25 15:01:25 +08:00
sswandClaude b9c9e318af feat(v0.11+): Phase 1 - 23 个 dacli 父命令审计完成
派 25 个 Explore 子代理 (5 批 × 5) 审计 23 个父命令.
产出 cmd-review/{cmd}.md (24 文件) + _summary.md.

关键发现:
- webapi 镜像使用率 < 30% (12+ 父命令 100% 绕 webapi)
- 30+ P0 必补新命令 (form update, log exception, di CRUD, role authorize 等)
- 3 处 P0 端点错误 (假 PASS):
  * integration emailTest/smsTest
  * msg templateCreate
- 用户关键修正: bigscreen → jnpf-web-datascreen-vue3 (独立子项目)
- 用户关键修正: report → jnpf-web-datareport (独立子项目)

下一步: Phase 2 按 P0 优先级执行 (修端点 + 新命令 + webapi 化)

Co-Authored-By: Claude <[email protected]>
2026-06-25 14:58:32 +08:00
sswandClaude 0360c6484c docs(v0.11+): 下一阶段执行 plan - 上下文爆了前备份
用户给的 10 个要求 完整 plan 写到 dacli/docs/v0.11-next-steps-plan.md:
1. 逐个过 dacli 命令
2. 分析 web 页面, 改/删/留 + 帮助/调试/示例同步
3. webapi 镜像
4. 官方示例验证
5. .claude/** 全过
6. web 改动谨慎 (存 docs/web-patches/)
7. 用子代理 (dispatching-parallel-agents)
8. 清理历史残留
9. 已备份大胆改
10. 联动 ssw-h5dev-flow/ssw-test/no-spa-page/design-jnpf-execute

4 阶段: 命令审计 → 改/删/留 → .claude 全过 → 清理+验证+web 改动.
子代理 dispatch 协议 (5 批 Explore, 每批 5-6 命令).
clear 后直接 cat 这个文件恢复上下文.

注: 前一个 commit (0cb7c3e) 误删了 doc/v0.6-v0.8 历史 changelog, 已 revert (6ff428f).
本次 commit 仅加 plan 文件, 不动其他文件.

Co-Authored-By: Claude <[email protected]>
2026-06-25 14:19:45 +08:00
ssw 6ff428ff3a Revert "docs(v0.11+): 下一阶段执行 plan - 上下文爆了前备份"
This reverts commit 0cb7c3ee76.
2026-06-25 14:17:49 +08:00
sswandClaude 0cb7c3ee76 docs(v0.11+): 下一阶段执行 plan - 上下文爆了前备份
用户给的 10 个要求:
1. 逐个过 dacli 命令
2. 分析 web 页面, 改/删/留 + 帮助/调试/示例同步
3. webapi 镜像
4. 官方示例验证
5. .claude/** 全过
6. web 改动谨慎 (存 docs/web-patches/)
7. 用子代理 (dispatching-parallel-agents)
8. 清理历史残留
9. 已备份大胆改
10. 联动 ssw-h5dev-flow/ssw-test/no-spa-page/design-jnpf-execute

完整 plan 写到 dacli/docs/v0.11-next-steps-plan.md:
- 4 阶段: 命令审计 → 改/删/留 → .claude 全过 → 清理+验证+web 改动
- 子代理 dispatch 协议 (5 批 Explore, 每批 5-6 命令)
- 完成标准 + 应急回滚

clear 后直接 cat 这个文件恢复上下文.

Co-Authored-By: Claude <[email protected]>
2026-06-25 14:16:17 +08:00
sswandClaude 727b13c407 feat(v0.11+): Phase A-E AI 工作流闭环 - 源分析 + 镜像 + 新命令 + skill + 验证
按 docs/dacli/v0.11-final.md 4 阶段执行:
1. 源码分析 docs/source-analysis.md (分析 web/views/** 页面逻辑)
2. 镜像高频 webapi (dict + workflow)
3. 新增 AI 痛点驱动命令 (form selector + workflow selector)
4. 集成到 form-development / workflow-development skill
5. 用官方示例验证 (workSystem 86 form/17 flow, developSystem 4 form)

新增模块:
- src/webapi/dict.ts (15 函数镜像 web/.../systemData/dictionary.ts)
- src/webapi/workflow.ts (14 函数镜像 web/.../workFlow/template.ts)
- src/commands/form/selector.ts (formSelector 命令 + 树形平铺)
- src/commands/workflow/selector.ts (getFlowSelector 命令)

测试:
- tests/test-webapi-dict-workflow.ts (15 dict + 14 workflow 函数实测 PASS)

Skill 集成:
- .claude/skills/form-development/SKILL.md (新增 form selector 段)
- .claude/skills/workflow-development/SKILL.md (新增 workflow selector 段)

验证 (workSystem):
- form selector --json: 86 form 平铺
- workflow selector --json: 17 工作流

验证 (developSystem):
- form selector --json: 4 form
- workflow selector --json: 17 工作流 (跨应用可见)

源分析报告 docs/source-analysis.md 列出 18 个未覆盖模块 + 缺口分级 (P0/P1/P2).

Co-Authored-By: Claude <[email protected]>
2026-06-25 13:59:32 +08:00
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
sswandClaude b9729f1855 feat(v0.11): Phase 1 续 - 7 命令切换 webapi + 新增 webapi/menu + dataSource test
继续 docs/dacli/v0.11-mirror-refactor.md Step 4:

新增 webapi 模块:
- src/webapi/menu.ts — 15 函数 (web/.../api/system/menu.ts: getMenuList/Selector/All/create/update/Info/del/...)

命令切换:
- src/commands/form/release.ts: c.postJson → loadVisualDev.release(id)
- src/commands/form/clone.ts: c.get/postJson → loadVisualDev.getInfo/create/getVisualDevList
- src/commands/dm/fields.ts: c.get → loadDataModel.getDataModelFieldList
- src/commands/dm/list.ts: 修编译错误 (变量 r → resp)
- src/commands/menu/list.ts: c.get → loadMenu.getMenuList

测试:
- tests/test-webapi-datasource.ts: 11 函数 + 实测 (getDataSourceList/Info/testDbConnection/Selector)

实测 PASS:
- form/release 代码改完 (auto-mode 拒绝实际发布, 但 TS 通过)
- form/clone 代码改完 (auto-mode 拒绝实际克隆, 但 TS 通过)
- dm/fields --table=equipment 输出完整字段列表
- menu/list 输出完整菜单树

总计已切换 7 命令: form/list form/info form/release form/clone dm/list dm/fields menu/list
剩余 14 命令渐进切换.

Co-Authored-By: Claude <[email protected]>
2026-06-25 13:09:13 +08:00
sswandClaude c29d6bd9c1 docs(.claude): v0.11+ Phase 1+2 同步 - 加 webapi 架构段, 删 extract 引用
同步 docs/dacli/v0.11-mirror-refactor.md Phase 1+2 完成到 dacli/.claude/:

SKILL.md:
- '已删除文件'段补 4 个 JSON (data/field-schemas/component-map/l2-rules/validation-rules) + extract-all.mjs
- 新增 '🪞 v0.11+ 镜像架构(webapi/ 直 import)' 段: 完整介绍 webapi/_loader.ts + _defhttp_shim.ts + visualDev/dataModel/dataSource, 含 4 关键技术 / 3 样板命令 / 切换模板

web-source-map.md:
- '维护方式'段: '自动提取 extract-web-schema.py' → 'v0.11+ 自动 import webapi/_buildformdata.ts + visualDev.ts'
- 同步频率改: 'JNPF 升级后只需重跑 baseline + 验证 webapi'

commands.md:
- 1.3 form create 段: 'W2 提取 web field-schemas.json' → 'v0.11+ 用 webapi/_buildformdata.ts 直接 import web 端 buildFormData'

baseline/*.md: 无引用, 无需改

Co-Authored-By: Claude <[email protected]>
2026-06-25 12:50:55 +08:00
sswandClaude a17fd0307d chore(v0.11): Phase 2 清理 - 删 scripts/extract-all.mjs (Phase 1 之前已删 data/*.json, 这是 snap 脚本)
docs/dacli/v0.11-mirror-refactor.md Phase 2 删除清单:
- data/field-schemas.json       ← v0.10 之前 commit 已删
- data/component-map.json       ← v0.10 之前 commit 已删
- data/l2-rules.json            ← v0.10 之前 commit 已删
- data/validation-rules.json    ← v0.10 之前 commit 已删
- scripts/extract-web-schema.py ← v0.10 之前 commit 已删
- scripts/extract-all.mjs       ← 本次删 (350 行 snapshot 提取脚本)

scripts/extract-all.mjs 用途: 从 web/.../componentMap.ts/formValidate.ts/R*.vue
正则提取到 dacli/data/*.json, 然后 FieldBuilder.ts read 这些 JSON.

v0.11+ 后:
- dacli/src/commands/form/_buildformdata.ts 直接 import web buildFormData
- dacli/data/buildformdata-contract.md 留文档
- 不再需要 snapshot 中间产物, 也不再需要 extract 脚本

package.json: 移除 'extract' script (tsx scripts/extract-all.mjs)

Co-Authored-By: Claude <[email protected]>
2026-06-25 12:27:49 +08:00
sswandClaude 2f368787a7 refactor(v0.11): Phase 1 续 - form/info + dm/list 切换 webapi 样板
继续 docs/dacli/v0.11-mirror-refactor.md Step 4:
- src/commands/form/info.ts: c.get('/visualdev/Base/{id}') → loadVisualDev.getInfo(id)
- src/commands/dm/list.ts: c.get('/system/DataModel/{id}/Tables') → loadDataModel.getDataModelList()

实测:
- form info 839795258819609349 --summary 输出正确 (员工管理/employee/type=4)
- dm list 输出 3 张表 (equipment/fix_record/inspection)
- baseline 跑通 (与 Phase 1 之前一致, 无新 fail/skip)

剩下的 21 个命令 (form create/release/clone/..., menu/list/..., dm/create/info/...)
可渐进式切换, 因 webapi 已暴露全部 51+ 函数, 切换模式已固定:
  1. import { initWebapi, loadXxx } from '../../webapi/xxx.ts'
  2. action 里: await initWebapi(c)
  3. 替换 c.get/postJson/putJson/del 为 loadXxx.xxx(args)
  4. 注意 web 端 url 含 /api 前缀, shim 已自动 strip

Co-Authored-By: Claude <[email protected]>
2026-06-25 12:14:27 +08:00
sswandClaude d4506fe4de feat(webapi): v0.11+ Phase 1 - webapi/visualDev + dataModel + dataSource 直接 import web 端
实现 docs/dacli/v0.11-mirror-refactor.md Step 1-3:
- src/webapi/_loader.ts: 通用 web 端源码加载器 (读源→替换 import→写 tmp→dynamic import)
- src/webapi/_defhttp_shim.ts: 用 JnpfClient 实现 web 端 defHttp (get/post/put/delete)
- src/webapi/visualDev.ts: 30+ 函数直接 import web/.../api/onlineDev/visualDev.ts
- src/webapi/dataModel.ts: 10 函数 import + lodash omit shim
- src/webapi/dataSource.ts: 11 函数 import
- src/commands/form/list.ts: 改造样板 (c.get → loadVisualDev.getVisualDevList)

关键技术:
- 读 web 端源 → 替换 #/api/request → shim 路径 → 替换 #/ → WEB_SRC → 替换 lodash-es → Node 原生
- 用 globalThis 共享 client (避免 tsx/动态 import 多实例)
- shim 自动 strip /api 前缀 (因 JnpfClient.baseUrl 已含 /api)

Checkpoint PASS:
- test-webapi-visualdev.ts: visualDev 11 函数 import + 实测 (getVisualDevList + getInfo 返回数据正确)
- test-webapi-datamodel.ts: dataModel 10 函数 import + 实测 (getDataModelList 返回数据)
- dataSource smoke test: getDataSourceSelector 返回 2 项
- form list 命令 webapi 版与原版输出完全一致
- baseline 跑通, 无新 fail

Co-Authored-By: Claude <[email protected]>
2026-06-25 12:12:21 +08:00
ssw fd8ef3bb20 feat(form): v0.11+ Task 10 --ai-json 直入 JSON (跳过 LLM)
洞察: AI 建表 prompt 输出就是 List<AiFormModel> JSON 数组, 不必经过
AI round-trip. AI/用户在会话里直接生成 JSON, 喂给 buildFormData,
跳过 LLM 调用 (节省延迟/费用/AI 错误).

新增 --ai-json 选项:
  --ai-json '<List<AiFormModel> JSON>'

  自动:
  - 强制 isMain (i=0 为主表)
  - 填 enCode (从 tableName) / fullName (从 tableTitle)
  - 走 buildFormData (同 --ai 路径)
  - 强制 type=4 (视图兜底, 不需物理表)

验证 (formId=839795258819609349 enCode=employee):
  - LLM 调用 0 次
  - 5 字段全部保留原 component:
    f_name          → JnpfInput        + formId=formItemAi4f62c5
    f_employee_no   → JnpfInputNumber  + formId=formItemAic9b174
    f_department    → JnpfSelect       + 3 options [{1,研发},{2,产品},{3,运营}]
    f_hire_date     → JnpfDatePicker   + formId=formItemAib01182
    f_active        → JnpfSwitch       + formId=formItemAi5b7c0f

3 种 dacli form create 输入方式 (v0.11+):
  --ai <描述>      : 自然语言 → LLM → JSON → buildFormData
  --ai-json <json> : JSON → buildFormData (新! 跳过 LLM)
  --fields <json>  : 手动字段 → _simplify (兼容路径)

修改文件: src/commands/form/create.ts (新增 --ai-json 选项 + 路径)
2026-06-25 11:46:56 +08:00
ssw f584aaf1bd chore: Task 9 清理 v0.10 旧模式
删除 (真正死的):
- data/form-type-rules.json: 被 buildFormData 内置规则替代
- scripts/extract-web-schema.py: 被 _buildformdata.ts 动态 import 替代

加 @deprecated 标记 (手动 --fields 路径仍依赖):
- src/commands/form/_simplify.ts (wrapSimplifiedFields 等)
- src/commands/form/_blindspots.ts (5 类 schema 完整性检查)
- src/commands/form/validate.ts (老 form 校验工具)
- src/commands/form/fixcolumndata.ts (老 form 修复工具)
- src/commands/_precheck.ts (dbLinkId/enCode 检查仍有用, 但 schema 部分已废)
- src/commands/_blindspot_guards.ts (BS-48/49/50 仍有用, BS-51/52/54 已废)

更新 .claude/skills/dacli-ts/SKILL.md:
- 顶部加 'v0.11+ 架构重大变化' 段 (buildFormData 直连 + 3 种输入方式)
- 三层防御体系降级为辅助 (BS-51/52/54 已由 buildFormData 解决)
- 列已删除/已废弃文件

注意:
- 手动 --fields 路径仍可用 (用户已习惯简化格式)
- 未来若都用 AI/JSON, _simplify 可彻底删
2026-06-25 11:45:49 +08:00
ssw d9505ae94b feat(form): Task 7 v0.11+ --ai 路径用 web 端 buildFormData (替代 _simplify)
新增:
- src/commands/form/_buildformdata.ts: 从 web/apps/.../formUtils.ts
  动态 import buildFormData + buildFields (替换 #/ alias + @jnpf/utils
  + lodash-es, 单进程缓存)

改造:
- src/commands/form/create.ts --ai 路径:
  - initBuildFormData() 加载 web buildFormData
  - 把 webBuildFormData(aiModelList) 结果存到 opts.__aiBuildFormData
  - formData 构造处: AI 路径用 buildFormData 输出, 其它用 _simplify
  - 效果: AI 的 component 类型 (switch/radio/datePicker/select) 100% 保留
  - 解决: BS-51 (formId)、BS-52 (options)、BS-54 (select options) 在 AI 路径全消失

验证 (formId=839790442198336261 enCode=customerInfo):
  customer_name   → JnpfInput
  contact_phone   → JnpfInput
  status_flag     → JnpfSwitch
  customer_type   → JnpfRadio  + [{id:1, fullName:个人}, {id:2, fullName:企业}]
  register_date   → JnpfDatePicker
  formId 全部是 formItemAiXXX 字符串 (UUID)

未删 _simplify (手动 --fields 路径仍依赖), 后续按用户决策再瘦身
2026-06-25 11:27:55 +08:00
ssw 5473fd4c6b verify: Task 6 端到端走通 (直连 AI → JNPF form create)
新增:
- tests/test-e2e-direct-ai-buildformdata.ts: 完整 e2e 测试
  (直连 AI → buildFormData → POST create API → 反查 → 发布)
  注: 因 type=1 form 需要 dbLinkId 配置正确, 走简化路径;
  实际端到端通过 'dacli form create --ai' 命令验证 (用 ANTHROPIC_* env)

端到端验证结果 (formId=839789894598394629 enCode=bookInfo):
- ANTHROPIC_BASE_URL=https://api.minimaxi.com/anthropic
- ANTHROPIC_MODEL=MiniMax-M3
- AI 返回 4 字段 (input/switch/datePicker)
- dacli form create --ai 自动建表单 (state=0, type=4 视图)
- jxcj 应用的 form list 能看到这个 form

关键发现:
- 'Database exception' 是因为 dbLinkId 错 (用 '0' 主库 vs 业务库 ID)
- dacli form create --ai 内部仍走 _simplify, 丢 AI 的 component 类型
- 这正是 Task 7 瘦身要解决: buildFormData 替代 _simplify
2026-06-25 11:25:51 +08:00
ssw 3a388dca03 refactor(form): _ai.ts 改造为 model-agnostic 双路径
新增:
- src/commands/form/_ai_prompts.ts: 抽 JNPF 原版 prompt (GEN_MODEL_QUESTION
  / GEN_FLOW_QUESTION) + GEN_MODEL_COMPONENT (25 个 jnpfKey) + DY_OPTIONS_LIST
  (5 个). 来自 AiConstants.java / SendAiMessage.java
- tests/test-ai-refactored.ts: 双路径验证 (env 凭据注入, 不入文件)

改造:
- src/commands/form/_ai.ts: callAiForm / callAiWorkflow 双路径
  路径 1: env (DACLI_AI_BASE_URL/AUTH_TOKEN/MODEL) → 直连 AI
    - URL 含 /anthropic → Anthropic Messages API 格式
    - URL 其他 → OpenAI 兼容 /v1/chat/completions
    - 强制 isMain (对齐 JNPF 后端 VisualAiServiceImpl)
    - enCode = lowerCamel(tableName)
  路径 2: 不配 env → 走 JNPF backend (原有 /visualdev/ai/form)

验证 (env=Anthropic API, model=MiniMax-M3):
- 简单客户表: 4 字段, customer_type radio [2 选项] ✅
- 主子表: 商城订单+明细, isMain 正确, 子表 2 字段 ✅

收益:
- dacli 不依赖 JNPF backend 即可调 AI
- 调任何 OpenAI/Anthropic 兼容 API
- AI 返回 schema 经 _ai_prompts 提示即与 JNPF 兼容
2026-06-25 11:18:56 +08:00
ssw bb3ebafe4d verify: buildFormData import + direct AI 调用验证脚本
- tests/test-import-buildformdata.ts: 证明 dacli 可 import web 端 buildFormData
  (替换 #/ alias + @jnpf/utils → uuid.ts + lodash-es → structuredClone)
- tests/test-direct-ai-call.ts: 验证直接调 AI API 可用
- tests/test-direct-ai-jnpf-prompt.ts: JNPF 原版 GEN_MODEL_QUETION prompt +
  Anthropic 格式 + 简单/主子表 2 个测试
- data/buildformdata-contract.md: buildFormData 契约清单(16+50+23 keys)

验证结论:
- buildFormData 100% 注入 formId/renderKey/isSubTable (BS-51 根因)
- buildFormData 自动为 select/options 注入 (BS-54 根因)
- JNPF 原版 prompt 可直接用于直连 AI, 不需 JNPF backend
- 后续 _ai.ts 改造为双路径 (env 直连 / JNPF backend fallback)
2026-06-25 11:16:12 +08:00
ssw 12af1db98f dacli: BS-60 guard columnList jnpfKey + relationForm columnOptions 2026-06-25 09:58:27 +08:00
ssw 32a5a566e2 dacli: BS-55 form create 用 cleanTable + dm --no-strip-app-code 2026-06-25 09:21:20 +08:00
ssw ddd24b76dd fix(form): BS-60 vmodel 空字符串 fallback 到 f_xxx + BS-60 WARN guard
根因 (2026-06-24 tdd8 调试):
- dacli wrapSimplifiedFields 的 vmodel fallback 链全空时返回 ''
- 后端 INSERT SQL 用 tables.fields[].field 作列名 (JNPF 老规范)
- dacli dm create 建表 column 用 f_xxx (v0.7+ 新规范)
- 两者不匹配 → 保存报 'Unknown column comInputField101'

修复:
- _simplify.ts:165 加 fallback, 从 rawField 顶层找第一个 f_ 开头的 key
- _blindspot_guards.ts 加 BS-60 WARN 预警, 字段缺 vmodel/field/vmodel/f_xxx 时打印修复指引
- field_normalize.test.ts 加 3 单元测试 (fallback 触发/优先级/多字段)
- blindspot_guards.test.ts 加 3 触发测试 (WARN/no-WARN/no-WARN)

tdd8 验证:
- form 1 (tdd8_inspection) PUT 修复后保存 'New created successfully' ✓
- form 2/3 暴露 datetime/userSelect 序列化问题 (后续 polish 范围)

🤖 Generated with Claude Code
2026-06-24 18:28:30 +08:00
sswandClaude 5c47844945 cleanup(e2e): 删除 16 业务测试 + 5 历史脚本 + 2 空目录
CLAUDE.md §11 共性库规则: dacli/tests/e2e/ 只放通用 + 关键示例.
业务测试 (tds/tdd/tdca/tdsa/workSystem/developSystem 特定) 历史遗留, 全删.

删除清单:
业务测试 16 个:
  p13/p16 (tds), spike-* (tdd), tdca-* (tdca), tdsa-* (tdsa)
  v17-* (workSystem), w8/w9 (workSystem), verify-form-e2e+verify-form.ts (workSystem)
  baseline/{developSystem,workSystem}/regression

历史 debug 脚本 5 个:
  _tds1_auth.mjs / _tds1_debug.mjs / _tds1_flow.mjs / _tds1_verify.mjs / _tds1_verify_v5.mjs

空目录 2 个:
  tests/e2e/api/  tests/e2e/visual/

保留 (通用):
  _helpers/         (共性库: form/table/nav/auth/wait/selectors)
  auth.setup.ts     (通用登录 setup)
  smoke.spec.ts     (developSystem 验证基础设施 smoke)
  baseline/template.spec.ts (通用模板)

全套 vitest: 6 failed = baseline 6 failed (无破坏)

Co-Authored-By: Claude <[email protected]>
2026-06-24 15:27:38 +08:00
sswandClaude 75a95f34b0 refactor(tests): 移 jxcj 应用特定测试到 docs/jxcj/tests/
CLAUDE.md §11 共性库规则: dacli/tests/ 只放通用 + 关键示例; 业务测试放 docs/{appCode}/tests/.

删除:
- tests/integration/jxcj_bs54_regression.spec.ts (jxcj 28 form 抽样回归)
- tests/e2e/bs54_browser.spec.ts (jxcj_competition_info 浏览器 E2E)

移到 docs/jxcj/tests/ (业务目录):
- integration/jxcj_bs54_regression.spec.ts (独立 vitest.config.ts 跑)
- e2e/bs54_browser.spec.ts (playwright symlink 到 dacli/tests/e2e/ 跑)
- README.md (跑法说明)
- vitest.config.ts (独立 config)

dacli/tests/ 保留的 BS-54 通用测试:
- tests/unit/field-builder-bs54.test.ts (FieldBuilder 通用)
- tests/unit/bs54_guard.test.ts (BS-54 guard 通用)

Co-Authored-By: Claude <[email protected]>
2026-06-24 14:49:59 +08:00
sswandClaude edb579af0f test(e2e+integration): BS-54 jxcj 28 form 回归 + 浏览器层 E2E
- 集成: tests/integration/jxcj_bs54_regression.spec.ts 2 PASS
  - 验 jxcj 28 form 列表存在 + state=1 全发布
  - 抽样 5 form (含 select + relationForm) 验 BS-54 字段兜底
  - 未登录 jxcj 时自动 skip (CI 友好)
- E2E: tests/e2e/bs54_browser.spec.ts 2 PASS (E2E_BS54=1 时)
  - /jnpf_app_jxcj/model/jxcj_competition_info 页面能开
  - f_state select 字段 options ≥ 1 (BS-54 兜底)
  - 默认 skip, 设 E2E_BS54=1 启用

废弃:
- docs/jxcj/scripts/24_fix_select_relation.py (应用特定 vmodel→enCode, 留在 docs/)
- docs/jxcj/scripts/26_run_tc_data.py (重 POST 集成测试, 价值有限)

Co-Authored-By: Claude <[email protected]>
2026-06-24 14:36:42 +08:00
sswandClaude c203bd2277 feat(guards): BS-54 L2 guard (select/relationForm 必填子键 ERROR)
- 红: tests/unit/bs54_guard.test.ts 5 FAIL
- 绿: checkBS54 加到 _blindspot_guards.ts (22→23 条)
  - select 字段需 (dataType=static + options) / (dataType=dictionary + dictionaryType) / (dataType=dynamic + propsUrl) 之一
  - relationForm 字段需 modelId 非空
  - 通用规则, 不含应用特定 vmodel→enCode 映射

触发场景: form create --fields 直接传 JSON (绕开 FieldBuilder.build()) 时兜底

Co-Authored-By: Claude <[email protected]>
2026-06-24 14:36:31 +08:00
sswandClaude a875437d77 feat(field-builder): BS-54 select/relationForm 默认 + 抽 field-defaults.ts
TDD 红绿重构:
- 红: tests/unit/field-builder-bs54.test.ts 6 FAIL
- 绿: FieldBuilder.build() select/relationForm 自动补默认字段
  - select: dataType='static', dictionaryType='', propsUrl='', options=[2项占位], props={label, value}
  - relationForm: modelId='' 占位 (用户必填)
- 重构: 抽通用占位 → src/schema/field-defaults.ts
  (避免应用特定信息入 dacli/src, jxcj 36 套模板/vmodel→enCode 仍留在 docs/jxcj/scripts/)

字段形状来源: web componentMap.ts:324-376 (select) + 1363-1406 (relationForm)

Co-Authored-By: Claude <[email protected]>
2026-06-24 14:36:23 +08:00
ssw a2c14fec09 auto(09213057c521): session end @ 2026-06-24T11:25:24 (+1f) 2026-06-24 11:25:33 +08:00
sswandClaude ff5ec01184 feat(dacli): P0a-P3 全套完善 (auto-alias 默认 + 绝对路径 + DM 去前缀 + 命名小写)
P0a: --auto-alias 默认开 + --no-auto-alias 显式关闭
  原因: 不写别名 → JNPF 类名 = Jxcj_xxx_xxxMapper (历史包袱, 验证过 28 form)
  写别名 → JNPF PascalCase 类名 (AnnouncementMapper), 0 post-fix
  推荐保留默认 ON, --no-auto-alias 显式关闭

P0b: web/uniapp 路径绝对化
  读 $CCWORKDIR env (默认 /home/ubuntu/ccWorkDir) 拼绝对路径
  不再相对 cwd 写, 用户在哪个目录跑都安全
  用户可显式 --web-base=... --uniapp-base=... 覆盖

P1a: dm create 去 appCode 前缀 (CLAUDE.md §3)
  jxcj_announcement → announcement (无前缀)
  字段同步去前缀 (jxcj_xxx → xxx, f_xxx 不动)
  已有老表带前缀也允许 (向后兼容); 新建推荐无前缀

P1b: snakeToPascalCase 单测
  tests/unit/codegen_snake_to_pascal.test.ts: 23 case (含 jxcj 28 form 实际 enCode 回归)
  tests/unit/alias_field.test.ts: 5 case (字段级 alias 透传)
  全 28/28 PASS

P2a: web 命名大写 → 小写
  Detail.vue / Form.vue → detail.vue / form.vue
  对齐现有 jxcj/TeamInfo 约定 (lowercase Vue 3 社区规范)
  同步改内容里 import 引用 (./Detail.vue → ./detail.vue)
  例外: .ts .js 不改 (columnList.ts 等 PascalCase 也常见)

P2b: 字段级 alias
  formTables.fields 含 aliasName 时透传到 Alias/Save
  (实现已在, 单测固化; 实际数据来自 JNPF form design)

P3: xml/vue Velocity 占位符修复
  实测 jxcj 28 form: vue + xml 0 残留, 仅 .java 触发
  加 debug log 监测 xml/vue (防未来模板变动)
  .xml 中 ${} 是 MyBatis SQL 参数, .vue 模板用 {{ }}, 不自动改

测试: 28/28 PASS
- snakeToPascalCase: 23/23 PASS
- alias_field: 5/5 PASS
- 端到端 28 form codegen: 28/28 PASS
- 后端 280 java 编译 SUCCESS
- 运行时 3/3 jxcj visualdev API → HTTP 200

Co-Authored-By: Claude <[email protected]>
2026-06-24 10:16:50 +08:00
sswandClaude 49bb927509 feat(dacli): form codegen 输出 web/uniapp 到正确位置 (per-model)
背景: 业务反馈"app/web 应该是每个模块一个,可选,不需要则不生成/忽略,
       生成后导入到 web/**/ssw/{appCode}/** uniapp/**/ssw/{appCode}/** 对应目录"

现状问题:
  - dacli 把 JNPF 生成的 web/* (web Vue 3) + app/* (uniapp) 都放进 ssw-{appCode}/ 包内
  - 但 web/* 应该到 web/apps/jnpf-web-apps-main/src/views/ssw/{appCode}/{model}/
  - app/* 应该到 uniapp/pages/ssw/{appCode}/{model}/
  - 历史: 28 form × 2 = 56 个 app/web 文件堆积在 ssw-jxcj

修改: src/commands/form/codegen.ts
- 加 4 个 option:
  * --no-web: 不写 web/* 前端 (默认写)
  * --no-uniapp: 不写 uniapp/* 前端 (默认写)
  * --web-base <path>: web 输出基准 (默认 web/apps/.../views/ssw/{appCode})
  * --uniapp-base <path>: uniapp 输出基准 (默认 uniapp/pages/ssw/{appCode})
- 文件循环里加前端重定向:
  * f.path 以 'app/' 开头 → 写到 {uniappBase}/{mainClassName}/{rest}
  * f.path 以 'web/' 开头 → 写到 {webBase}/{mainClassName}/{rest}
  * 不再写到 ssw-{appCode}/app 或 ssw-{appCode}/web (历史包袱)
- per-model 目录结构 (与现有 web/ssw/jxcj/TeamInfo/ 一致):
  * uniapp/pages/ssw/jxcj/{ModelName}/{index.vue,form.vue,detail.vue,columnList.js}
  * web/.../ssw/jxcj/{ModelName}/{index.vue,Form.vue,Detail.vue,api.ts,columnList.ts,searchList.ts,superQueryJson.ts}

行为 (实测):
  改前: 28 form 都把 web/app 写进 ssw-jxcj 包 (错误位置)
  改后: web → web/.../ssw/jxcj/{Model}/, app → uniapp/pages/ssw/jxcj/{Model}/
       ssw-jxcj 干净 (只含 entity/biz/controller 后端)

兼容性: --no-web --no-uniapp 旧行为可恢复 (只生成后端)

Co-Authored-By: Claude <[email protected]>
2026-06-24 09:38:40 +08:00
sswandClaude 3b1965da3c refactor(dacli): 移除 --auto-fix-names 替换逻辑, 统一靠 --auto-alias
背景: 用户反馈"codegen.ts 使用替换的方法代码去掉,避免干扰"
  - --auto-fix-names 是旧版 regex post-fix (替换文件名 + 内容)
  - 已被 --auto-alias 完全替代 (写 base_visual_alias, JNPF 原生方式)
  - 旧逻辑有 bug: 路径检测不对, 内容替换不完整 (Jxcj_xxx 残留 252 处)
  - --auto-alias 方案: 仅 14 处残留 (全是 DB 表名, 合理)

删除内容 (120 行 → 11 行):
- 函数 detectOldPrefixFromDir (50 行): 扫目录找 Jxcj_xxx 前缀
- 函数 detectOldPrefixFromContent (10 行): regex 找 public class
- --auto-fix-names option 定义 + help 文本 + --example + notes
- 替换调用块 (30 行): 找到旧前缀后批量改文件名 + 内容
- importAutoAlias 注释中的"替代 --auto-fix-names"

保留 (兼容旧脚本):
- autoFixNames?: boolean 类型字段 (标为已废弃, 不抛错)
- 注释提示"已废弃, 改用 --auto-alias"

效果 (jxcj 28 form 实际跑通):
  改前: --auto-fix-names 残留 252 个 jxcj_xxx 引用 (类名/变量/package)
  改后: --auto-alias 残留 14 个 (全是 @TableName 引用 DB 表名, 合理)

代码清爽度:
- codegen.ts 净减 109 行 (-91%)
- 一条命令 (--auto-alias) 解决命名问题, 无 post-fix 兜底

Co-Authored-By: Claude <[email protected]>
2026-06-24 09:28:00 +08:00
sswandClaude 5e19ec3d44 feat(dacli): form codegen 默认 mainClassName 丢 appCode 前缀
背景: 包名已带 appCode (ssw.jxcj.mapper), 类名重复前缀不必要
  - 改前默认: jxcj_develop_project → JxcjDevelopProject
  - 改后默认: jxcj_develop_project → DevelopProject

修改: src/commands/form/codegen.ts
- snakeToPascalCase(s, appCode?) 加 appCode 参数
  * 含下划线 + 首段匹配 appCode (大小写不敏感) → 丢
  * 含下划线 + 首段是 PascalCase 单段 → 丢 (如 Jxcj_xxx)
  * 含下划线 + 首段是小写单段 → 丢 (如 jxcj_xxx)
  * 不含下划线 + 首字母大写 → 原样 (用户已传 PascalCase 不破坏)
  * 边缘: enCode == appCode → 返回 appCode PascalCase (Jxcj)
- mainClassName 默认: snakeToPascalCase(enCode) → snakeToPascalCase(enCode, module)

测试 11/11 PASS (1 修后):
  jxcj_announcement + jxcj   → Announcement
  jxcj_develop_project + jxcj → DevelopProject
  jxcj + jxcj                → Jxcj (边缘 case)
  jxcj_notification_record + jxcj → NotificationRecord
  TdsBilling (无 _)          → TdsBilling
  jxcj (无 _, 无 appCode)   → Jxcj (default 行为)
  JxcjAnnouncement (PascalCase) → 原样保留

Co-Authored-By: Claude <[email protected]>
2026-06-24 09:08:21 +08:00
sswandClaude aeeb61d08a feat(dacli): form codegen 默认从 enCode 推导 PascalCase 类名
背景: 业务反馈"生成的类名没有按照 SnakCase 命名法"
  - JNPF 平台 CodePreview API 生成的类名是 `Jxcj_announcementMapper` (混合 PascalCase+snake_case)
  - 实际 jxcj 28 个 mapper/entity 全部是这种风格 (历史包袱, 暂不动)
  - 后续新建 form 用 dacli form codegen 走时, 默认从 enCode 自动转 PascalCase

修改: src/commands/form/codegen.ts
- 新增 helper: snakeToPascalCase(s)
  * jxcj_announcement        → JxcjAnnouncement
  * jxcj_develop_project     → JxcjDevelopProject
  * jxcj                     → Jxcj
  * JxcjAnnouncement (已PascalCase) → 原样保留 (避免破坏用户传入)
- 默认 mainClassName: opts.mainClassName || enCode 改为 opts.mainClassName || snakeToPascalCase(enCode)
- --mainClassName help 加转换说明

测试 (8/8 PASS):
  ✓ jxcj_announcement        → JxcjAnnouncement
  ✓ jxcj_develop_project     → JxcjDevelopProject
  ✓ jxcj                     → Jxcj
  ✓ jxcj_notification_record → JxcjNotificationRecord
  ✓ JxcjAnnouncement (已 PascalCase) → 原样保留
  ✓ TdsBilling (PascalCase) → 原样保留
  ✓ '' (empty) → ''
  ✓ a_b_c → ABC

注: 已存在的 jxcj 28 个 mapper/entity 保留原 `Jxcj_xxxMapper` 风格 (历史包袱, 改动范围过大)

Co-Authored-By: Claude <[email protected]>
2026-06-24 08:58:24 +08:00
sswandClaude 5350e5e274 feat(dacli): BS-14 共享 MapperConfig 检测 + commands.md 校准
背景: ssw-common 共享 SswMapperConfig @MapperScan("ssw.**.mapper") 集中化后,
       BS-14 guard 检测逻辑必须改:检测 ssw-common 共享 config + 业务包依赖。

修改:
- src/commands/_blindspot_guards.ts BS-14
  * 改检测:
    1. /boot/ssw-common/.../config/SswMapperConfig.java 含 @MapperScan("ssw.**.mapper")
    2. /boot/ssw-{appCode}/ssw-{appCode}-biz/pom.xml 含 ssw-common-biz 依赖
  * fix 文档改: 业务包 pom 加 ssw-common-biz 依赖即可, 无需自配 MapperConfig
  * v0.11.5 → v0.11.6 检测版本

- .claude/skills/dacli-ts/references/commands.md
  * 多模块结构图: 移除 TdsMapperConfig (业务包不写), 加共享 MapperConfig 说明
  * Mapper 包名校准段: 必做迁移 jnpf/mapper → ssw/{app_code}/mapper,
    Mapper 注册由 ssw-common 共享 SswMapperConfig 统一处理

Co-Authored-By: Claude <[email protected]>
2026-06-23 18:24:51 +08:00
sswandClaude 4697443186 docs(dacli-ts): 校准 form codegen 多模块结构 + Mapper 包名迁移说明
背景: 2026-06-23 jxcj E2E BS-14 校准 - ssw.{app_code}.mapper + MapperConfig
为现代推荐模式 (实战: boot/ssw-jxcj/ 全部用此模式)。

修改: dacli/.claude/skills/dacli-ts/references/commands.md
- 第 309-325 行多模块结构图:
  * Mapper 路径从 jnpf/mapper → ssw/{app_code}/mapper
  * MapperConfig 加入 ssw/{app_code}/config/{AppCode}MapperConfig.java
- 新增 Mapper 包名 BS-14 校准说明段, 解释:
  * dacli form codegen 默认从平台 CodePreview 拉 mapper (固定 jnpf/mapper)
  * ✅ 推荐做法: codegen 跑完后迁移到 ssw/{app_code}/mapper + MapperConfig + type-aliases
  * 兜底: 保留 jnpf/mapper (不推荐混用)

Co-Authored-By: Claude <[email protected]>
2026-06-23 18:13:41 +08:00
ssw 618dc8004f feat(blindspot): BS-14/15/16/17 - ssw-{appCode} 启动 4 类必备配置
固化 4 类 ssw 包启动盲点到 dacli:

BS-14: JNPF MybatisPlusConfig @MapperScan 只扫 jnpf.*.mapper, ssw.*.mapper 需自加 MapperConfig
BS-15: yml type-aliases-package 默认不含 ssw.**.entity, 需手动加
BS-16: codegen 生成 @DS("{appCode}") 但 dynamic-datasource 按 dbLinkId 注册, 需 sed 替换
BS-17: dynamic-datasource 需先 visualdev 数据 API 触发, ssw-{appCode} controller 重启后报

修复 4 类启动问题:
1. 加 {AppCode}MapperConfig.java (@MapperScan('ssw.{appCode}.mapper'))
2. yml type-aliases-package: jnpf.**.entity,ssw.**.entity
3. 全量替换 @DS("{appCode}") → @DS("{dbLinkId}")
4. 重启后先 hit /api/visualdev/OnlineDev/{id}/List 触发数据源注册

闭环: jxcj 28/28 form + 5 no-spa + 40 菜单 + 28 ssw-jxcj controller 100% 工作
2026-06-23 17:26:07 +08:00
ssw ff2e6996c1 auto(09213057c521): session end @ 2026-06-23T15:42:43 (+3f) 2026-06-23 15:42:44 +08:00
ssw eca5b28fe2 docs(codegen): ServiceImpMarco.vm 修复后结果 (jxcj_team 43→0 errors)
boot repo commit b374a8f (2026-06-23) 修了 ServiceImpMarco.vm:
- 主表字段 foreach 加 fieldAlias 空保护 (空时跳过)
- PaginationQuery macro 加 afterVModel 空保护
- 都加详细注释

实测 (jxcj_team 8 searchList 字段, 其中 7 个是虚拟字段):
- 修前: 43 javac errors
- 修后: 0 errors, 10 .class 编译成功

workSystem xdxx/yhjs 无回归 (仍 0 errors, 10 classes).
2026-06-23 14:07:01 +08:00
ssw adc80b7a0e fix(form): _simplify.ts trigger 默认值 (修复 FormMarco.vm:1226 crash)
**Bug**: _simplify.ts:139 原逻辑
  trigger: jnpfKey === 'input' ? 'blur' : ''
导致所有非 input 字段 (textarea/select/datePicker 等) __config__.trigger 为空串 ''.

**触发**: form 创建后 release, CodePreview 在 JNPF 后端 FormMarco.vm:1226 对
  ${config.trigger.substring(0,1)} (空串) 抛 StringIndexOutOfBoundsException
  → 'System abnormality' (400), 整个 form 无法 codegen

**修复**: 对齐 FieldBuilder.ts:215-223 默认 trigger 规则
  - input/textarea/editor → 'blur'
  - 其他控件 (select/datePicker/switch/...) → 'change'

**验证 (developSystem/jxcj 应用)**:
- 旧逻辑下 form 创建后 trigger=空串 → CodePreview 400
- 新逻辑下 form 创建后 trigger 正确 (input='blur', select='change') → OK
- 简化字段格式 (vmodel/label/jnpfKey) + autoTable + autoRelease 一条命令成功

**已知遗留**: ServiceImpl.java.vm 对 ${Field.fieldAlias} 仍是 Velocity undefined,
  导致编译时方法引用错误 (getafterVModel 等), 需后续派子代理修 JNPF 模板
  (用户已禁止改 FormMarco.vm, 同样不动的精神适用于其他模板)
2026-06-23 13:19:38 +08:00
ssw 8f4d238fc8 docs(codegen): 记录 form 结构差异导致 ${...} 占位符 bug
workSystem form 实测 (xdxx 797473600809468485, yhjs 797460178185224773):
- web UI 设计器创建, `__config__` 字段完整 (含 fieldAlias)
- codegen 输出无 `${...}` 字面占位符
- 单模块编译 0 errors (6 .class)
- 全 3 模块编译 0 errors (10 .class)
- 加 --auto-alias 同样 0 errors

vs jxcj_team (老版 dacli form):
- 5+ 个 `${...}` 字面占位符
- 需要 fixUnresolvedVelocityVars() 后处理兜底
- 单模块编译 0 errors (有 dacli 后处理)
- 全 3 模块编译 43 errors (ServiceImpl getafterVModel 等方法引用未定义)

结论: jxcj_team 的 ${html.fieldAlias} bug 是 form 字段结构差异造成,
不是 --auto-alias 造成. 根本修复: 一次性 PATCH 老 form 字段 (已完成).
兜底: fixUnresolvedVelocityVars() 后处理 (已实施).
2026-06-23 12:57:48 +08:00
ssw 3e024ac111 feat(codegen): --module-only selective export + fixUnresolvedVelocityVars
New --module-only flag for selective module export (all/entity/biz/controller).
Auto-adjusts --multi-module-pom to only generate selected module poms.

fixUnresolvedVelocityVars() post-processes JNPF .java templates that emit
literal ${...} placeholders when Velocity vars are undefined. Three paths:
1. method calls - capitalize last .method() name (Java getter convention)
2. private declaration - use curJsonProp snake_case to camelCase
3. simple variable - keep original case (avoid afterVModel becoming afterVmodel)

End-to-end verified: --module-only=entity compiles 0 errors, 6 .class files.
Full 3-module compile still has 43 ServiceImpl errors (undefined ${search.*} getters
are inherent JNPF template bug, dacli can only make syntax valid not runtime).
2026-06-23 12:41:13 +08:00
ssw 6d7fb68f2c feat(diagnose): L3 diagnoseError 加 System abnormality 规则 (BS-触发器空串)
**触发条件**: CodePreview 返 'System abnormality' (后端 FormMarco.vm:1226 StringIndexOutOfBoundsException)

**根因**: form formData.fields[].__config__.trigger = '' (空字符串)
  - PublicMacro/FormMarco.vm:1226 对 '' 调 substring(0,1) 抛错
  - 仅 state=1 (发布态) 触发, state=2 (草稿) 不触发 (没走发布代码生成路径)
  - 历史 form (老 dacli/老 web 设计器) 易中招, 新 form FieldBuilder.ts:215-223 已正确设

**修复指引 (诊断输出)**:
  1. 查后端日志: log/jnpf-java-boot/log_error.log | grep FormMarco
  2. 一次性 PATCH (Python 脚本步骤 a/b/c/d)
  3. web UI 打开 form 设计器保存一次, JNPF 自动补 trigger
  ⚠ state=1 vs state=2 触发差异提示

**调用方**:
  - codegen.ts CodePreview 失败分支调 diagnoseError 打印
  - 客户端无法直接看后端堆栈, 规则放宽到 'System abnormality' (高频根因)

**验证**:
  - TS compile clean
  - jxcj_team (state=1 + 8/8 trigger='') 跑 codegen → 完整诊断输出 (修复步骤)
  - jxcj_team (state=2 + 8/8 trigger='') 跑 codegen → 成功 (绕开 bug)
  - 修后 jxcj_team (state=1 + 0/8 trigger='') 跑 codegen → 成功
2026-06-23 12:01:04 +08:00
ssw 2943bc439a docs(codegen): 记录 FormMarco.vm:1226 trigger='' 历史 form 一次性 PATCH
根因: 历史 form (如 jxcj_team) 5 个字段 __config__.trigger='',
触发 PublicMacro/FormMarco.vm:1226 对空串 substring(0,1) 抛错.
dacli form create 路径已正确 (FieldBuilder.ts:215-223 + create.ts:347),
只需一次性 PATCH 历史数据: GET form → 修 trigger → PUT form → POST /Actions/Release.

jxcj_team (838880823020093509) 已修, 端到端 codegen 验证通过 (27 文件,
类名 JxcjTeam*, ssw-jxcj_team 多模块结构, 4 pom.xml).
2026-06-23 11:54:28 +08:00