Commit Graph
385 Commits
Author SHA1 Message Date
ssw f115fe1e26 feat(dacli): CI 关卡 G 加故意 FAIL 白名单 (修 hook 误报)
按 cmd-review/regression-2026-06-29 §4.4 修复 hook 误报问题.

**问题**:
- di/_validate.ts web 端明确无 formValidate 正则 (架构差异, 不是漏校验)
- 之前 hook 把 di 当作真实 FAIL 阻塞 commit, 需要 DACLI_SKIP_GATE=1 才能提交
- 浪费 CI 体验, 掩盖真正应该阻塞的问题

**修复**: 加 KNOWN_FALSE_POSITIVES 白名单机制

**新增**:
- const KNOWN_FALSE_POSITIVES: Record<cmd, reason>
  - di: web 端 di/Form.vue:172-178 明确无 formValidate 正则
- getKnownReason(cmd): 查表获取原因
- checkCommandDir/checkValidate: 白名单命中 → FAIL 转 WARN + 填充 knownReason
- 汇总新增 knownFalsePositives / realFailures 字段
- 退出码: realFailures > 0 才 FAIL, 否则根据 WARN 决定
- 输出新增 '白名单详情' 段, 标注每条已知故意 FAIL 的原因

**CI 关卡 G 输出增强**:
- status 列加 '(已知)' 标签 (白名单命中)
- 汇总新增 2 行: 白名单命中 / 真实 FAIL
- 总体: WARN (有白名单) 但不阻塞 commit
- 改进建议新增 '已知故意 FAIL (白名单)' 类别, 明确指引

**实测验证**:
- 之前: di FAIL → 退出码 1 (阻塞 commit, 需 DACLI_SKIP_GATE=1)
- 现在: di 转 WARN → 退出码 2 (不阻塞 commit, 自动通过 hook)

**扩展指南**: 添加新白名单需明确 web 端架构差异, 避免掩盖真实问题
格式: KNOWN_FALSE_POSITIVES[cmd] = 'web 端 xxx/Form.vue:XX 明确...'

测试: TS 编译干净 + 真实 FAIL=0 + exit code 2 (WARN, 不阻塞)
2026-06-29 18:31:05 +08:00
ssw 3eb31b02c2 feat(dacli): 扩大 4 个弱镜像 _validate.ts (bigscreen/datasource/msg/schedule)
CI 关卡 G 镜像统计前后:
- bigscreen: 3 → 4
- datasource: 1 → 36
- msg: 1 → 17
- schedule: 1 → 26

每个字段错误信息加 '镜像 web Form.vue:XX-L' 引用, 整体镜像水平 ~14/文件.
2026-06-29 18:27:53 +08:00
ssw cf5847d09c feat(dacli): 扩大 _validate.ts web 镜像 (4 文件, CI 关卡 G 89%→94%)
按 cmd-review/regression-2026-06-29 §4.4 扩大 web 镜像, 4 个 _validate.ts 升级.

重写 user/_validate.ts (133 行 → 231 行, 修复最严重盲点):
- 之前: mirror_comments=3 / line_ref=no / ENCODE_REGEXP=no (3 NO)
- 现在: mirror_comments=17 / line_ref=yes / ENCODE_REGEXP=yes (全 YES)
- 镜像 web permission/user/Form.vue:22-160 schemas 完整 (8 字段 + 2 条件)
- enabledMark 修复 {0=禁用 1=启用 2=锁定} (web L62-72, 修复 v0.11e+ 漏 2)
- 加 FULLNAME_REGEXP (镜像 web formValidate.ts:33-36)

加精确行号引用 (3 文件):
- datasource/_validate.ts: web dataCenter/dataSource/Form.vue:36-90
- msg/_validate.ts: web msgCenter/{notice/msgTemplate/sendConfig}/Form.vue
- schedule/_validate.ts: web teamwork/schedule/Form.vue:63-150

CI 关卡 G: 17/18 _validate.ts PASS = 94% (仅 di 故意不改)
2026-06-29 18:19:41 +08:00
ssw d5e82ceb9c auto(284e8d004cbb): session end @ 2026-06-29T18:09:29 (+3f) 2026-06-29 18:09:30 +08:00
test 63a30c6800 test hook skip 2026-06-29 18:08:45 +08:00
ssw baf90faaad refactor(dacli): 移除 init --restart 虚假 flag (v3.0+)
用户反馈: --restart 历史目的是 JVM 进程级重启, 但 90% 场景根本不需要重启 JVM.

**移除**:
- .option('--restart', ...) flag
- InitAppOpts.restart 字段
- if (opts.restart) dry-run 逻辑
- installAiHelpHook --restart 引用 + example
- healthCheck 不通时的 --restart 推荐指引 (改为手动 nohup)

**保留**:
- --auto-recover (真工作, v0.11e+ B-2 fix, 检测 system 缺失时自动重建)
- 健康检查 (baseUrl + form list)
- system 缺失检测

**未来扩展** (v0.12+ 可能加, 不在本 turn 范围):
- --reload-config 调 POST /actuator/refresh (Spring Cloud RefreshScope, 替代 dry-run)
- --reload-ds 重新连接数据源
- --reload-menu 重建菜单/权限缓存

**用户决策 (2026-06-29)**: 删 --restart, 有需要场景再加. 务实.

测试: TS 编译干净 + init --help 不显示 --restart + init 实测仍工作 (健康检查 + system 完整)
2026-06-29 18:05:01 +08:00
ssw 0a0c690c16 feat(dacli): 新增 dacli app use <code> 一体化命令 (v3.0+ P1)
cmd-review/app.md P1 建议: AI 工作流痛点是切换 appCode 需要 2 步:
  1. dacli app switch --appCode=X (重新登录)
  2. dacli app context --json (拿环境快照)

v3.0+ 一体化命令: 一步完成 switch + context + CurrentUser 验证.

**新增 src/commands/app/use.ts** (181 行):
- 3 步流程:
  1. switch — 复用 JnpfClient.login 重新登录新 appCode
  2. context — lazy import loadAppContext, 拿 dbLinkId/enCode/表单/菜单/警告
  3. CurrentUser — 走 webapi/user.getUserInfoApi 服务器端确认 (token+appCode+用户身份)
- 容错: switch 失败 exit 1; context/CurrentUser 失败仅 warning 不阻断
- 输出: --json 输出完整 AppContext + currentUser, 供 AI 一站式使用
- 选项 --no-current-user: 跳过 CurrentUser 验证 (快但弱验证)
- 选项 --account / --password: 自定义凭据

**改 src/commands/app/index.ts**:
- 注册 buildAppUseCommand (放 context 之后, 让 --help 优先显示)
- 父命令 description 加 v3.0+ 一体化 use 标记

**实测验证** (jxcj 切换):
- [1/3] 切换成功 (admin @ jxcj, dbLinkId=2071492464356302848)
- [2/3] context 加载 (1 enCode, 1 表, 0 workflow, 1 警告)
- [3/3] CurrentUser 验证 (admin 管理员)
- 总耗时: **517ms** (一次调用拿全)

**附带修复**: report/list.ts 加 initReportWebapi import (CI 关卡 G 标 FAIL 时还原的改动)

测试: TS 编译干净 + 3 步流程 PASS + CurrentUser 集成正确

详见 docs/cmd-review/regression-2026-06-29.md §4.2
2026-06-29 17:58:02 +08:00
sswandClaude f32faa69e5 fix(dacli/webapi): 报表 API 镜像路径从 jnpf-web-datareport 改为主 webapp
jnpf-web-datareport 是 jQuery 老项目, 没有 src/api/ 目录 (只有 src/index.js)
原路径 /jnpf/前端/jnpf-web-datareport/src/api/index.js 永远 ENOENT, 任何
dacli report 命令触发 initWebapi 都炸

新路径 /web/apps/jnpf-web-apps-main/src/api/onlineDev/report.ts 是 Vue 3 主
webapp 的报表 API 客户端, 导出 getReportList/getReportInfo/delReport/copy/
getData/saveVersion 等 6 个函数, 走 /api/Report 端点 (被 nginx 代理到报表服务 32000)

验证: loadWebModule 成功, 6 个函数都拿到, dacli report list --json 不再 ENOENT

Co-Authored-By: Claude <[email protected]>
2026-06-29 17:48:53 +08:00
ssw c70ffb7844 auto(284e8d004cbb): session end @ 2026-06-29T17:47:59 (+1f) 2026-06-29 17:47:59 +08:00
ssw a0a51afc78 feat(dacli): 新增 dacli user info 子命令 (v3.0+ 双入口)
用户反馈: dacli app context --json 把 CurrentUser 集成进去后, 大 JSON (含 menuList/permissionList) 不方便调试.
用户决定: 做双入口, dacli user info 单独入口 (聚焦, 小 JSON).

**新增 src/commands/user/info.ts**:
- 无 id → CurrentUser (走 webapi/user.getUserInfoApi, 镜像 web/api/core/user.ts:10-15)
- 有 id → 特定用户详情 (走 webapi/user.loadUser.getUserInfo, 镜像 web/api/permission/user.ts)
- 选项 --backend <0|1>: CurrentUser 用, 默认 1 (与 web 端后台管理端一致)
- 选项 --json: 原始 JSON 输出 (含 menuList/permissionList)
- 默认输出聚焦字段: userId/userAccount/userName/isAdmin/systemCode/systemId/hasBackend

**改 src/commands/user/index.ts**:
- 注册 buildUserInfoCommand (放最前, --help 优先显示)
- 父命令 description 加 v3.0+ 双入口标记
- 现有 19 个子命令 (list/create/update/...) 完全保留

**双入口设计 (v3.0+)**:
- dacli user info — 聚焦, 小 JSON, 调试 / 单命令调用
- dacli app context --json — 含 currentUser, 一站式 AI 工作流
- AI 可按场景选择入口

**应用隔离 (v3 §4)**:
- systemId 从 token.json 自动读 (HTTP App-Code 头)
- 不需要手动传 --appCode
- 与 web 端 user.ts 语义对齐

**实测**:
- dacli user info → userId=349057407209541, userAccount=admin, systemCode=jxcj ✓
- dacli user info --json → 完整响应 (menuList 12 个菜单 + permissionList) ✓
- dacli app context --json → currentUser 字段仍正常 ✓

测试: TS 编译干净 + 19 子命令 --help 正常 + user info 实测通过

详见 docs/cmd-review/regression-2026-06-29.md §4.2 CurrentUser 集成
2026-06-29 17:47:36 +08:00
ssw 2350da48f9 feat(dacli): webapi/user.ts + app context 集成 CurrentUser API (v3.0+ P0)
用户反馈: 浏览器登录监测到 /api/oauth/CurrentUser?systemCode=X&isBackend=Y 是关键请求,
服务器端同时验证 token + appCode + 用户身份. dacli app context 应走 webapi 镜像 (不直接 curl).

**新增 webapi/user.ts 扩展** (CurrentUser 相关, v3.0+):
- getUserInfoApi(c, params) — 镜像 web/api/core/user.ts:10-15, GET /api/oauth/CurrentUser?systemCode=&isBackend=&_t=
- getConfig / getLoginConfig / unlockApi — 其他 web 端 core/user.ts 函数
- 与现有 loadUser Proxy 不同: CurrentUser 不走 _loader.ts dynamic import
  (web 端依赖 window.location.pathname, dacli 没 window)
  直接用 JnpfClient + defHttp shim 模式, 接受 appCode 参数从 token.json 拿

**改 app/context.ts 集成 CurrentUser**:
- 新增 tryFetchCurrentUser(c, appCode) — 调用 webapi/user.getUserInfoApi
- 失败容错: 不抛错, 写入 warnings, currentUser = undefined
- 新增 currentUser 字段到 AppContext 输出 (含 userInfo/menuList/permissionList/sysConfigInfo 等)

**改 src/core/types.ts**:
- AppContext 新增 currentUser?: { id/account/realName/roleId/roleName/organizeId/isBackend/systemCode ... }

**实测验证**:
- dacli app context --json 返回完整 CurrentUser 响应 (systemCode=jxcj 回显 ✓)
- 包含 userInfo (userAccount=admin, userName=管理员, isAdministrator=true)
- 包含 menuList (12 个菜单树) + permissionList (权限) + sysConfigInfo (sysVersion V6.2.0)
- AI 现在可以从 context 拿到 server 确认的 user info + menu 权限 (比读本地 token 更可靠)

测试: TS 编译干净 + 实际跑通 (jxcj token, server 返完整 user/menu/permission)

详见 docs/cmd-review/regression-2026-06-29.md §4.2
2026-06-29 17:39:15 +08:00
ssw 72ced8a42e feat(dacli): webapi 镜像 org 命令 (CI 关卡 G 总体 FAIL=0) 2026-06-29 17:31:43 +08:00
ssw 6b2becd458 feat(dacli): webapi 镜像 print/portal/report (CI 关卡 G 从 3 FAIL 到 0) 2026-06-29 17:29:43 +08:00
ssw 2663b8c487 auto(284e8d004cbb): session end @ 2026-06-29T17:17:50 (+4f) 2026-06-29 17:17:51 +08:00
ssw 8c10df63b3 feat(dacli): CI 关卡 G 自动检查 webapi 镜像架构 (regression audit §4.4 落地)
v3.0+ regression audit §4.4 建议的防御机制, 现已实现:

**新增 src/commands/_gate_webapi.ts** (310 行):
- 自动检查 3 大维度:
  1. 命令 webapi 引用率 (app/dict/menu/form 应有, apis/doc 元工具 0 正确)
  2. _validate.ts 镜像精度 ("镜像 web" 注释数 + 精确行号 + ENCODE_REGEXP 复用)
  3. 回归盲点扫描 (找无 webapi 引用的命令 + 缺镜像注释的 _validate + BS-56 硬编码正则)
- 退出码: 0=PASS / 1=FAIL(阻塞) / 2=WARN(提示)
- 用法: `npx tsx src/commands/_gate_webapi.ts` (CI 集成入口)

**初始扫描结果** (基线):
- 命令: PASS 18 / WARN 2 / FAIL 4 / 总 24
- _validate.ts: 总 18, 镜像注释率 18/18 (100%), ENCODE_REGEXP 复用率 8/18 (44%)
- 总体: FAIL

**当前违规清单** (后续 turn 修复):
- P0 缺 webapi: org / portal / print / report
- BS-56 缺 ENCODE_REGEXP: datasource / di / dict / form / menu / msg / role / schedule
- (这些是历史 _validate.ts 升级遗漏, 不是本次 turn 引入)

**防御价值**:
- 未来所有新代码改动自动检查, 防止重蹈"经验复刻"覆辙
- 新增 _validate.ts 不带"镜像 web" 注释会被 WARN
- 处理 enCode 但硬编码正则会被 FAIL (BS-56 防御)
- 无 webapi 引用的新命令会被 FAIL (P0 防御)

测试: TS 编译干净 + 实际跑通 (输出 24 命令 + 18 _validate 检查)

详见 docs/cmd-review/regression-2026-06-29.md §4.4
2026-06-29 17:12:43 +08:00
ssw 676fce5778 feat(dacli): _loader.ts 加 @vben/request shim (让 web logoutApi 真正工作)
task 26 发现新缺口: web 端 auth.ts:1 import { ContentTypeEnum } from '@vben/request',
@vben/request 是 Vben 业务包, 依赖 axios + Vue + Vite, Node 直接 import 会失败.
本 turn 修复闭环: web logoutApi 现在真正能调通 (之前虽然命令可用, 但远程会失败).

**新增**:
- src/webapi/_vben_request_shim.ts (41 行)
  - 镜像 web/packages/effects/request/src/request-client/enum.ts:1-31
  - 导出: ResultEnum (FORBIDDEN/SUCCESS/TOKEN_ERROR/TOKEN_LOGGED/TOKEN_TIMEOUT)
  - 导出: RequestEnum (DELETE/GET/POST/PUT)
  - 导出: ContentTypeEnum (FORM_DATA/FORM_URLENCODED/JSON/OCTET_STREAM)

**改 src/webapi/_loader.ts**:
- 加规则 5: from '@vben/request' → from '<vben request shim path>'
- 加 LoadOptions.vbenRequestShimPath 配置项 (默认 _vben_request_shim.ts)
- 加 SHIM_DIR + VBEN_REQUEST_SHIM_PATH 常量

**v3.0+ 价值兑现**:
- 之前 webapi/auth.logoutApi 只是声明, web logoutApi 实际失败
- 现在 app/logout.ts 端到端跑通: web logoutApi 调用成功 + 清本地 token
- 解锁未来更多 @vben/request 依赖的 web 模块镜像 (如字典/工作流可能用到)

测试: TS 编译干净 + 端到端 PASS
- web logoutApi 调用成功 ✓
- 本地 token 清成功 ✓
- JSON 输出结构化 ✓

详见 docs/cmd-review/regression-2026-06-29.md §4.2
2026-06-29 17:04:41 +08:00
ssw 4c97a04332 auto(284e8d004cbb): session end @ 2026-06-29T17:03:58 (+1f) 2026-06-29 17:03:58 +08:00
ssw ed70bc041f feat(dacli): v3.0+ 新增 dacli app logout 子命令 (regression audit P2)
cmd-review/app.md 已识别缺口: web 端有 logoutApi, dacli 无 logout 命令.
v3.0+ 新增, 走 webapi/auth.logoutApi (web 端 POST /api/oauth/Logout 镜像).

**新增**:
- src/commands/app/logout.ts (138 行)
  - 流程 3 步: web logoutApi + 清本地 token + 提示重新登录
  - 选项 --no-remote-logout: 跳过 web logoutApi, 仅清本地 (断网场景)
  - 选项 --json: 输出结构化结果
- src/commands/app/index.ts: 注册 buildAppLogoutCommand()

**webapi 价值兑现**:
- webapi/auth.logoutApi 之前只是声明 (cmd-review 已识别)
- 现在被 app/logout.ts 实际调用, 形成完整链路
- 复用 web 端 logoutApi (POST /api/oauth/Logout + withCredentials)

**容错**:
- web logoutApi 失败非致命, 仍清本地 token (避免用户卡死循环)
- 已验证: 远程 500/网络断 都能清本地成功

**已知问题 (polish doc)**:
- web 端 auth.ts: import { ContentTypeEnum } from '@vben/request'
- _loader.ts 当前未处理 @vben/* Vben alias (只处理了 #/ lodash-es jnpf/utils)
- 导致 web logoutApi 当前会失败 (但 dacli 容错正确, 清本地成功)
- v0.12+ 路线: _loader.ts 加 @vben/request shim

测试: TS 编译干净 + 3 项验证 PASS
- dacli app --help 显示 logout 命令 ✓
- dacli app logout --no-remote-logout 端到端流程正常 ✓
- 远程失败时本地仍清成功 ✓

详见 docs/cmd-review/regression-2026-06-29.md §4.2 问题 2
2026-06-29 17:01:00 +08:00
ssw a4d258147e feat(dacli): v3.0+ 镜像 web Form.vue 完整 schema (regression audit P1)
升级 3 个 _validate.ts, 镜像 web 端 Form.vue schemas + 加精确行号引用:

**report/_validate.ts** (镜像 web onlineDev/report/Form.vue:26-58):
- 旧版只有 2 字段 (fullName/enCode), 漏 3 字段 (category/sortCode/description)
- maxlength 错误: 旧版 50 → web report 是 100
- enCode 正则硬编码 → 统一 ENCODE_REGEXP (BS-56, 与 dict/menu/print 一致)
- 加精确行号引用 (L26-58)

**org/_validate.ts** (镜像 web permission/organize/OrganizeForm.vue:31-72):
- 旧版只有 4 字段 (fullName/enCode/parentId/category), 漏 2 字段 (sortCode/description)
- enCode 正则硬编码 → 统一 ENCODE_REGEXP (BS-56)
- category 扩展: web 端也支持 'group'/'company'/'department' 字符串值
- 加精确行号引用 (L31-72)

**storage/_validate.ts** (web 端无 Form.vue, 标注镜像源):
- 关键发现: web/apps/jnpf-web-apps-main/src 搜 storage/*Form.vue 无结果
- 这是真正的经验复刻源点 (web 无对应页面, 只能镜像后端 StorageController + ssw-common Java)
- 之前只有基础字段校验, 漏 sortCode/description/enabledMark + BS-56 enCode 正则
- 加精确镜像源注释, 警告 web 端无 Form.vue
- 加 ENCODE_REGEXP (BS-56) + sortCode 0-999999 + description ≤ 200 + enabledMark ∈ {0,1}

**v3.0+ 价值**:
- BS-56 防御强化: 所有 _validate.ts 共享 ENCODE_REGEXP 常量
- web 镜像精度提升: 9/12 _validate.ts 有精确行号引用 (从 4/12 起步)
- 镜像源透明化: storage 标注 web 无 Form.vue, 不让 AI 误以为有 web 镜像

测试: TS 编译干净 + 3 命令族 --help 正常

回归审计报告: docs/cmd-review/regression-2026-06-29.md (381 行)
2026-06-29 16:55:56 +08:00
ssw 7b95ae6d10 feat(dacli): v3.0+ webapi 镜像化 (app 命令族, regression audit P0)
新增 webapi 镜像模块 + app 命令 webapi 化 (详见 docs/cmd-review/regression-2026-06-29.md):

**新增 webapi 模块** (2 文件):
- src/webapi/auth.ts: 镜像 web/api/core/auth.ts (loginApi + logoutApi + saasLoginApi + getTenantMobileCode + applySaasApi)
  - 6 个便捷包装函数 + AuthApi namespace 类型 + loadWebModule 真 import
- src/webapi/system.ts: 镜像 web/api/system/system.ts (15 函数)
  - getSystemList / getAuthSystemList / create / update / getInfo / delSystem
  - copySystem / exportSystem / getAppAuth / saveAppAuth / changeAppAuth / getDevUser
  - getSystemSelector / getSystemlist / setPin

**重构 app 命令** (3 文件):
- app/list.ts: webapi/system.getSystemList (替代直接 c.get)
- app/info.ts: webapi/system.getInfo (替代直接 c.get)
- app/create.ts: webapi/system.getSystemList + create + saveAppAuth (step 1 + 4)
  - step 2/3 保留 c.postJson (ssw-common 特有, web 无等价)
  - step 5 保留 JnpfClient.login (有 encryptPassword 加密逻辑)
- 修复历史 TS 错误: installAiHelpHook.source 无 webapi 字段, 用 web 字段
- 修复历史 TS 错误: ClientOptions 无 checkSystem 字段, 用 any cast 透传

**应用隔离价值**:
- 之前缺失能力恢复: copySystem / exportSystem / saveAppAuth / changeAppAuth / setPin
- 与 web 端 schema 漂移风险消除 (复用 web 端类型 + query 参数处理 + 错误响应)

测试: TS 编译干净 + 3 项验证 PASS
- dacli app list 走 webapi 返回 11 个应用 ✓
- dacli app info 走 webapi 返回完整字段 ✓
- dacli apis list --tag=system 走 OR 匹配返回 364 API ✓

留给下个 turn: storage/org/report _validate.ts 补 formValidate + 校验项 (task 25)
2026-06-29 16:50:37 +08:00
ssw fddf8b5c03 feat(dacli): v3.0+ regression audit fixes (P0 紧急)
回归审计报告 + 修复 (详见 docs/cmd-review/regression-2026-06-29.md):

**新增**:
- docs/cmd-review/regression-2026-06-29.md (381 行, 3 批 25 文件审计)
- docs/archive/README.md + 3 个归档子目录 (v0.11-history, skill-audit, deprecated-v0.6-v0.8)
- src/commands/integration/_validate.ts (镜像 web sendConfig/Form.vue:42-50, 7 字段 + BS-56)
- src/commands/print/_validate.ts (独立 _validate, 8 字段 + 条件校验 commonUse=1→icon, category=2→formId)

**v3.0+ 关键改进**:
- print 从借用 report 改为独立 _validate (避免字段覆盖不全)
- integration 从无校验改为完整 step machine (BS-56 + messageSource + messageType)
- 归档顶层 7 个 v0.11 历史 plan + skill-audit 26 文件 + deprecated 23 文件
  (避免 AI 误读历史为待执行任务)

v3 §四 应用隔离方案 + §16.6 文档审查 + §17.4 历史归档 同步更新

测试: 6 项验证 PASS (TS 编译干净 / 命令加载 / 新选项 / 条件校验 / BS-56 / tag OR 匹配)
2026-06-29 16:41:22 +08:00
ssw bb2be67bf0 auto(284e8d004cbb): session end @ 2026-06-29T16:39:21 (+2f) 2026-06-29 16:39:21 +08:00
ssw c9285962dd auto(284e8d004cbb): session end @ 2026-06-29T15:59:01 (+24f) 2026-06-29 15:59:01 +08:00
ssw 49893fa873 auto(284e8d004cbb): session end @ 2026-06-29T15:56:29 (+34f) 2026-06-29 15:56:29 +08:00
ssw 0738d60f80 auto(284e8d004cbb): session end @ 2026-06-29T15:33:12 (+1f) 2026-06-29 15:33:13 +08:00
ssw 6819b31f22 auto(284e8d004cbb): session end @ 2026-06-29T15:28:21 (+1f) 2026-06-29 15:28:22 +08:00
ssw 842ecf6c17 docs(v3.0): § 11.3 backend-dev 加 'jxcj 2026-06-29 端到端验证 200'
配套 commit d196426 (.claude 仓库端到端实战教训):
- 4 个 Java 模板更新 (entity extends SuperBaseEntity, controller @DS + 反射设 id, service-impl 实战注释)
- SKILL.md 加 § 端到端实战教训 (6 个关键点 + 7 步端到端跑通流程)
- v3.0 引用实战验证 (jxcj 2026-06-29 /api/ssw/jxcj/team/list 200)
2026-06-29 15:27:30 +08:00
ssw 5cce45183a auto(284e8d004cbb): session end @ 2026-06-29T15:24:30 (+1f) 2026-06-29 15:24:31 +08:00
ssw 294b17a66a docs(v3.0): § 11.1/11.3 同步 ssw-pack-init 合并 (skill 列表 6→5)
按 commit cf535ae (.claude 合并):
- § 11.1 核心开发 6 → 5 个 (删 ssw-pack-init 行)
- § 11.1 标题加 'v0.12+ 合并 ssw-pack-init → backend-dev'
- § 11.3 backend-dev 描述: 'v0.12+ 合并原 ssw-pack-init, 10 个代码模板 + 4 项必备配置'
- § 11.6 决策树: '编译/打包 → backend-dev (v0.12+ 合并)' 替代原 ssw-pack-init
- § 4 必备配置检测脚本路径: ssw-pack-init/scripts/ → backend-dev/scripts/
2026-06-29 14:34:09 +08:00
ssw 68f702d166 docs(v3.0): § 11.3 backend-dev 加 'v0.12+ 不强制先建 form, 模板 10 个'
配套 commit 95f710f (backend-dev 恢复 10 模板 + 改 SKILL.md):
- backend-dev 不再绑死 '先建 form 才能写后端'
- templates/ 成为 no-spa-page / 独立业务包 / POC 统一入口
- 模板带 jnpf codegen 标准模式 (SuperServiceImpl + @DS + DynamicSourceGeneratorInterface)
2026-06-29 14:29:49 +08:00
sswandClaude dfbb81343d fix(dacli): 9 个 jxcj V1.0 发现的问题修复 (v0.12+)
P0:
- P0-1: relationForm auto-injection 增强 (camelCase + 大小写不敏感匹配)
- P0-2: real-data 模式也跑 join (testMarker 永远注入, --no-keep-data 清理)
- P0-3: workflow bindFlow 持久化验证 (GET 验证 onLineformId, 失败明确提示)

P1:
- P1-4: workflow --ai 返回实际 enCode (JNPF 流水号机制, 警告)
- P1-5: 字典冲突加建议 (jxcj{原名} 前缀)
- P1-6: verify 默认 warn (form 已发布不阻断)

P2:
- P2-8: menu list --include-actions 默认 ON (含 form-driven 子菜单)
- P2-9: AiFormModel 扩展 dictionaryType/unique/billRule (web 端消费待 web-patches)
- P2-11: dacli doc Node 兼容 (已修复或原本 OK)

Co-Authored-By: Claude <[email protected]>
2026-06-29 14:24:40 +08:00
ssw 7acdcd6139 auto(284e8d004cbb): session end @ 2026-06-29T14:07:58 (+3f) 2026-06-29 14:07:59 +08:00
ssw 424dbd57d6 docs(v3.0): § 11.3 同步 no-spa-page 二次精简 (13 → 6 模板)
按用户决策 (commit 3860252 配套):
- 删 7 个管理框架模板 (admin-shell + list-page + module + ssw-helpers)
- 保留 6 个基础模板 (page.html / login.html / api.js / auth.js / cipher.js / datetime.js)
- 加 '后端业务包 — 直接三层' 段 (不必须先建 form, 走 backend-dev + ssw-pack-init)
- 加 '数据管理页 — AI 自由发挥' 段 (按 ant design vue 3 规范自己构建, 不套模板)

v3.0 § 11.3 + § 15 同步:
- no-spa-page 行: '5+ 模块管理后台' → '数据管理页', 模板 13 → 6
- § 15.4: 强调 '后端直接走 backend-dev 三层包 (不必须先建 form)' + '数据管理页 AI 自由发挥 (按 ant design vue 3 规范自己写)'
2026-06-29 13:52:25 +08:00
ssw a4aadf5b85 docs(v3.0): § 11.3 同步 no-spa-page 模板精简 (23→13, v0.12+)
no-spa-page SKILL.md 在 .claude 仓库已精简 (commit 3f53aa6):
- 删 10 个后端 Java/pom 模板 (与 backend-dev + dacli form codegen 重复)
- 保留 13 个前端模板 (基础 6 + 管理框架 7)
- 改 '后端代码' 段引用 backend-dev / ssw-pack-init

v3.0 § 11.3 业务开发段同步: no-spa-page 行加 '5+ 模块管理后台' + '模板精简到 13 个前端文件 (后端 Java 走 backend-dev)'
2026-06-29 13:45:19 +08:00
ssw b9b64dea90 feat: 重命名 ssw-h5dev-flow → ssw-loop (跨 2 仓库)
.claude 仓库:
- git mv skills/ssw-h5dev-flow → skills/ssw-loop (保留 history)
- 改 SKILL.md frontmatter (name + description 触发词)
- 改 5 个 references + 3 个子代理 prompt 模板 + learnings.md.tmpl
- 改 templates/html/style.css + script.js 注释
- 改 scripts/scaffold.sh + 4 个 check 脚本路径
- 改其他 skill 引用: dacli-ts/SKILL.md + anti-patterns.md, no-spa-page/SKILL.md, jnpf-browser-automation/SKILL.md
- 改 CLAUDE.md §技能索引 + §开发流程 + §问题处理
- 改 .claude/templates/flow-jxcj-rerun-process.md + .claude/settings.local.json (allow list)

dacli 仓库:
- 改 src/commands/doc/_parser.ts + list.ts 注释 (提及 ssw-loop plan/debug/research 走 MD)
- 改 tests/unit/doc-md-slice.test.ts 注释
- 改 docs/尚数网基本开发规范v3.0.md (7 处引用)
- git mv docs/skill-audit/ssw-h5dev-flow.md → ssw-loop.md (保留 history)
- 改 docs/cmd-review/doc.md

历史保留 (未改, 反映 v0.11 时代状态):
- dacli/docs/v0.11-*.md (4 个 plan 文件)
- docs/dacli/ssw-dacli/ (Java 版归档, 已废弃)
- docs/aibridge/.claude/ (Python 时代)

验证: 14/14 doc-md-slice 测试 PASS
2026-06-29 13:28:52 +08:00
ssw 240ab124a2 docs: v3.0 开发规范 (1029 行, 覆盖 .claude/dacli 全景)
合成来源: 5 个 Agent 并行扫描 + v2.0 框架 + aibridge/CLAUDE.md 补充
- scan-1 .claude 顶层 (CLAUDE.md 14 条铁律 + 13 skill 索引)
- scan-2 skills/ 全景 (11 个 skill 触发词 + 关键约束)
- scan-3 dacli 命令 (25 父命令 / 157 子命令 + BS-XX 盲点)
- scan-4 MEMORY (6 条通用洞察, 2026-06-27 审计 60→6)
- scan-5 jnpf 平台机制 (10 章节 + v0.11+ 闭环)

v3.0 vs v2.0 关键升级:
- 工具栈: Python aibridge → TS dacli (22 父/116 子命令, webapi 镜像)
- 配置: AES 密文 → dacli 自动登录 + token.json
- 入口: Python 脚本 → dacli 命令 + --ai-json --autoRelease
- 技能: 19 个独立 → 13 个核心 (12 收纳到 dacli-ts)
- 文档: HTML only → 3 HTML + 4 MD (6 判据驱动, v0.12+)
- 测试: fixture → 真实业务数据 (dacli test run --real-data)
- 反模式: 文档约定 → CI 关卡强制 (4 关卡)
- AI 协作: 4 步手写 → 4 步前置 (CLAUDE.md/context/SKILL/status)

文档结构 (18 章节):
1. 基本要求 (含 v1.0→v2.0→v3.0 演进)
2. 环境部署 (nginx 5 URL + fallback 端口)
3. 配置管理 (dacli 替代 AES 密文)
4. 数据库规范 (snake_case + f_ + 9 系统列 + ssw-common MapperConfig)
5. 功能开发流程 (7 阶段 + 4 步前置 + 3 层验证 ladder)
6. 编码准则 (dacli step machine + 25+ 错误码 + BS-XX 盲点)
7. dacli 命令速查 (22 父命令索引 + 7 个最常用 + enCode 规则)
8. 菜单配置 (11 种 type + dacli menu 命令)
9. 发布流程 (state 机 + webType 4 种 + 9 系统列 + datePicker NPE 防御)
10. JNPF 平台核心机制 (App-Code + jnpfKey 映射 + BS-14 MapperConfig)
11. skill 索引 (13 个核心 + 决策树 + web patch 管理)
12. 文档格式约定 (3 HTML + 4 MD 6 判据 + 4 关卡 CI)
13. git 提交策略 (一轮一提交 + 2 个独立仓库)
14. 反模式 (A1-C6 + 关卡对应)
15. AI 协作原则 (MEMORY 6 条)
16. 代码审查清单 (表单/工作流/后端/前端/安全/文档/反模式 7 类)
17. 附录: 权威源速查
18. 版本历史 (v1.0/v2.0/v3.0 对比)

权威源: $ccWorkDir/dacli/docs/尚数网基本开发规范v3.0.md
引用: $ccWorkDir/.claude/CLAUDE.md + 13 skill SKILL.md + 9 references
2026-06-29 13:13:32 +08:00
ssw 237e0c8556 feat(doc): v0.12+ 支持 .md section 切片 (按 ## 切, id=标题)
- _parser.ts 加 parseMarkdownSections (按 ^## 切分, H1 作前言附加到首 section)
- cache key 加 stripKey 后缀, 避免 stripMermaid=true/false 串扰
- list.ts 扫 .md/.markdown, 跳 screenshots/test_logs/assets/_assets
- 4 个命令 description 改 HTML/MD

配套: ssw-h5dev-flow v0.12+ plan/debug/research 走 MD, 子代理切片读
token 减半, 不再回退到 Read 整个文件 (踩 R1 反模式)

测试: tests/unit/doc-md-slice.test.ts 14/14 PASS (HTML 回归 9/9 PASS)
2026-06-29 12:23:13 +08:00
ssw 2001110f11 auto(284e8d004cbb): session end @ 2026-06-29T12:19:36 (+6f) 2026-06-29 12:19:37 +08:00
sswandClaude bf51a997da fix(form create): BS-18 --no-relation-form-auto default ON (Commander.js negatable default)
默认 ON 时, --no-relation-form-auto 转 opts.relationFormAuto=false.
不应在 .option() 第 3 参数传 false (那是默认值), 否则默认变 false.
Commander.js 自动 negatable 处理, 不需手填 false.

附: 这次 session 共修 3 个 P0 bug (jxcj1 实战暴露, 2026-06-29 复盘):
  - dacli-2026-06-29-01: 主子表 form create --ai-json 必传 --tables (auto 推空)
  - BS-18: relationForm 启发式误判 enCode 含 code 字段 (去掉 _code 后缀 + --no-relation-form-auto)
  - dacli-2026-06-29-04: TC-A 主子表必传 --real-fields 硬关卡

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>
2026-06-29 10:33:29 +08:00
ssw 8300b84806 auto(d389ca8d6886): session end @ 2026-06-29T10:25:03 (+3f) 2026-06-29 10:25:10 +08:00
ClaudeandClaude 216a02f7f1 fix(dacli): BS-56/BS-42/enableFlow/JNPF 4 步法修复 (v0.11h+, 2026-06-28)
按 CLAUDE.md §2.7.1 4 步法修 4 个 dacli 盲点:

1. BS-56 增强: enCode 禁下划线 — 错误信息明确 + 自动建议别名
   - 新增 src/commands/_encode_validator.ts (统一 ENCODE_REGEXP/FULLNAME_REGEXP + validateEnCode + suggestEnCode)
   - form/dict/menu/role 4 个 _validate.ts 切换到共享 helper
   - 错误从'只能输入英文、数字和小数点且小数点不能放在首尾'升级为
     'BS-56: enCode 只能含英文/数字/小数点, 不能含下划线/连字符/中文. 当前 enCode=X 非法. 建议改成: --enCode=Y (自动去下划线/连字符)'

2. BS-42 升级: dm 系统列冲突清晰提示
   - 加 groupMap 给每个系统列别称 (f_description=描述, f_create_user=创建人 ID 等)
   - 消息包含改名建议 (f_desc/f_remark/f_brief/f_summary) 和 code='BS-42'

3. enableFlow 兜底: BS-EFLOW-NOWF guard
   - 在 _blindspot_guards.ts 加新 guard (WARN 级)
   - enableFlow=1 但 workflow list=0 时给明确警告
   - AppContext 加 workflowList 字段, loadAppContext 调 /workflow/Engine/list 收集
   - types.ts/client.ts/context.ts 全链路补 workflowList

4. JNPF 自检: 新增 core/_health_check.ts
   - app init/status 前置 HEAD baseUrl/ 健康检查 (3s timeout)
   - 不通时给 nohup 重启指引
   - JSON 输出 health: {ok, status, error, durationMs}, 不通时退出码 1

验证 (workSystem/jxcj1 PASS):
- BS-56 form/dict/menu 3 命令输出新格式错误 + 别名建议
- BS-42 dm create f_description 输出 BS-42 清晰信息
- JNPF 自检输出 '✓ JNPF 可达: http://nginx/api/ (status=200, 27ms)'

文件 (16 改 + 2 新增):
- src/commands/_encode_validator.ts (新增)
- src/core/_health_check.ts (新增)
- src/core/types.ts (workflowList)
- src/core/client.ts (resolveDbLinkId 兜底)
- src/commands/_blindspot_guards.ts (BS-EFLOW-NOWF)
- src/commands/app/context.ts (tryFetchWorkflows)
- src/commands/app/init.ts (前置健康检查)
- src/commands/app/status.ts (前置健康检查 + JSON 输出)
- src/commands/form/_validate.ts (共享 ENCODE_REGEXP)
- src/commands/dm/_validate.ts (BS-42 升级)
- src/commands/dict/_validate.ts (共享 + BS-56 增强)
- src/commands/menu/_validate.ts (共享 + BS-56 增强)
- src/commands/role/_validate.ts (共享 + BS-56 增强)
- src/commands/form/codegen.ts (workflowList 兜底)
- tests/unit/{blindspot_guards,bs54_guard,dbLinkId,verify_option}.test.ts (workflowList 兜底)

不违反红线:
- ❌ 不动 web/uniapp/jnpf 源码 (CLAUDE.md §15)
- ❌ 不绕过 dacli
- ✅ 一轮一提交 (CLAUDE.md §14)
- ✅ npx tsc --noEmit 在改动文件无新错

Co-Authored-By: Claude <[email protected]>
2026-06-28 23:50:58 +08:00
ssw 08243cb788 auto(d389ca8d6886): session end @ 2026-06-28T22:37:11 (+3f) 2026-06-28 22:37:17 +08:00
ssw 0c9ac1f461 auto(d389ca8d6886): session end @ 2026-06-28T21:57:06 (+1f) 2026-06-28 21:57:12 +08:00
ssw 19b90ce712 auto(d389ca8d6886): session end @ 2026-06-28T20:06:14 (+4f) 2026-06-28 20:06:15 +08:00
ssw 21fd363285 feat(test run): v0.11+ 真实业务数据 CRUD 模式 (阶段 7.2, 解决 TC-A 形式 PASS 但实际不验业务)
问题:
- 旧 test fixture 模式用 _TEST_<timestamp> 后缀 + 即创即删, 真实数据 0 条
- 16 张含 relationForm 表 POST 失败 'Field cannot be empty' 因 sample 跳过
- 无跨表 join 校验 + 业务规则校验
- 用户原话: 'TC-A 应该直接完成数据层面真实跑通验证, 不要再来 TC-D TC-E 了'

改动:
- 默认 ON: --real-data (字段语义化默认值) + --keep-data (留数据供 TC-B)
- 新增: --real-fields / --relation-form-lookup / --relation-form-sample
- 新增: --join-check / --join-rules (Step 5 跨表 join 校验)
- 新增: --business-rules (Step 6 业务规则校验, 支持 >= <= > < == != 6 种运算符)
- 重写 buildSampleData: 优先级 realFields > realData > fixture
- 新增 lookupRelationFormId: 关联表 List 前 N 条拉真实 ID (非跳过)
- 新增 getFormIdByEnCode + evalBusinessRule helper

验证 (developSystem/jxcj):
- developSystem/cs (797437045977907781) real-data 2/2 PASS, --no-real-data 5/5 PASS (向后兼容)
- jxcj/competition_info real-fields 2/2 PASS
- business-rules FAIL 场景正确报错 5/6 (1 FAIL)
- 暴露 jxcj/code_audit_config BS-49/50 (relationForm modelId 缺失)

文档: SKILL.md (installAiHelpHook) + references/commands.md §8 + anti-patterns.md AP-12 已同步

Refs: /home/ubuntu/ccWorkDir/.claude/templates/flow-jxcj-rerun-process.md v2 (撤回 TC-D/TC-E)
2026-06-28 13:13:37 +08:00
ssw f9edebb3ea feat(test render): v0.11g+ 真实渲染契约升级 (4 类校验, 解决 TC-C 形式 PASS 但 relationForm 弹窗空)
旧 TC-C 只对比 vue 字段 ⊆ API 字段, PASS 但 relationForm 弹窗可能空 → 用户填不完必填外键 → 保存失败.

新增 4 选项 (默认全 ON, 都可 --no-xxx 关):
- --no-required-field-check 关闭必填字段 vmodel 完整性校验
- --no-relation-form-data-check 关闭 relationForm 弹窗数据可达性校验 (默认 WARN)
- --relation-form-data-strict 弹窗数据为空时返回 FAIL 而非 WARN
- --no-column-list-required 关闭 columnList 列配置完整性校验 (webType≠1)

新增 4 校验 (Step A/B/C/D):
- Step A 必填字段 vmodel: formData.fields 中所有 required 字段都有 __vModel__
- Step B relationForm 配置: modelId + propsValue + relationField 三必填
- Step C relationForm 弹窗数据可达: getVisualDevList + getModelList 验证关联表 ≥1 条 (默认 WARN)
- Step D columnList 列配置: webType≠1 时 columnList ≥1 + 字段名匹配 API

镜像 web 端契约:
- web/.../FormGenerator/getData() + form/_validate.ts:validateFormData (Step A)
- web/.../RRelationForm/index.vue + form/_validate.ts:validateRelationForm (Step B)
- web/.../RRelationForm/index.vue 弹窗加载 (Step C)
- web/.../ColumnDesign/getData() line 278-282 (Step D)

验证 (jxcj team form 840790355585531909, 1 个 relationForm → jxcj_competition_info):
旧 TC-C: PASS (无任何提示)
新 TC-C (默认 WARN): PASS + ⚠ relationForm 弹窗数据可达性: WARN (0 可达 / 1 空 / 0 错)
新 TC-C (--strict): FAIL (CI 用)

SKILL.md §test render 详细说明 加 v0.11g+ 章节.

驱动文档: .claude/templates/flow-jxcj-rerun-process.md §二 TC-C 升级方案
MEMORY: dacli-test-render-real-contract-2026-06-28.md
2026-06-28 12:56:46 +08:00
ssw 634ae10288 feat(form): step machine v0.11e+ 严格镜像 web 端校验链 (10 错误一次性暴露)
dacli/src/commands/form/_validate.ts (241 → ~440 行):
- 新增 ENCODE_REGEXP / FULLNAME_REGEXP / FOLDER_REGEXP / STARTNUMBER_REGEXP / NO_VMODEL_LIST 常量
  (镜像 web formValidate.ts:24-28 + FormGenerator/helper/config.ts:4-8)
- 新增 VALID_TYPES = {1,2,3,4} (镜像 Form.vue:107)
- step 0 加: fullName 长度+字符 + enCode 长度+禁下划线 + category 必填 + type 合法性
- step 1 加: billRule + relationForm 三必填 + popupSelect 三必填 + autoComplete 二必填
  + relationQuery + rowFormItem + uploadFile/uploadImg + link/iframe URL
- step 2 加: tree type=2 (treeDictionary/props/relation/sync) + group type=3 + parent type=5
  + card type=6 + uploadTpl + printTpl
- 新增 isUrl() helper
- 新增错误码 (25+): VS-CATEGORY / VS-RELATION-MODEL/PROPS/FIELD / VS-POPUP-IFACE/PROPS/FIELD
  / VS-AUTO-IFACE/FIELD / VS-RELQUERY-MODEL/COLS / VS-BILLRULE-DIGIT/START/START-FORMAT/RULE
  / VS-ROW-CHILDREN / VS-UPLOAD-BTN/PATH/FOLDER/FOLDER-FMT / VS-UPLOAD-TPL / VS-PRINT-TPL
  / VS-LINK-URL / VS-TREE-DICT/PROPS-VALUE/PROPS-LABEL/PROPS-CHILDREN/RELATION/SYNC-IFACE
  / VS-GROUP-FIELD / VS-PARENT-FIELD / VS-CARD-TITLE/DISPLAY / VS-VMODEL/FORMAT
  / VS-TYPE / VS030-FORMAT/LEN / VS032-LEN/FORMAT

dacli/src/commands/form/create.ts:901-909: validateFormCreate 调用透传 category

E2E 验证 (10 错误一次性暴露):
- step0 (4 errs): fullName 字符 + enCode 下划线 + category 空 + type=5 非法
- step1 (4 errs): relationForm 缺 modelId/propsValue/relationField + popupSelect 缺 interfaceId
- step2 (2 errs): tree type=2 缺 dictionary + treeRelation

回归: developSystem 5 form + workSystem 82 form list/info 全部正常

派子代理四步法执行, 详见 .claude/memory/dacli-step-machine-strict-mirror-2026-06-28.md
2026-06-28 12:37:54 +08:00
ssw e131e3398b fix(di): B-17+ di create id lookup 用用户 category 不硬编码
**4 步法**:
- 步骤 1: 看 src/commands/di/create.ts:124 硬编码 '30be5ef4e3074dd89385ad6b4540c63d', 与 opts.category 实际值不同, 查不到新 ID → (unknown)
- 步骤 2: B-17 设计意图: 用户传 category 创建 DI, 列表反查也应用同一 category (后端 mapper eq(category, null) 0 行)
- 步骤 3: 镜像 B-15 dict lookup 修法, 用 opts.category
- 步骤 4: 单行修改, 验证 dacli di create 输出真实 id

**Why**: 硬编码 category 跨 app 不一致, 用户传错 category 时反查失败, 仍是 (unknown).

**How to apply**: 后续 di create 用 opts.category, 跨 app / 跨 dict 都自适应
2026-06-27 22:33:53 +08:00
ssw 85724c0781 feat(menu): B-20 menu update 子命令 (镜像 web Menu/Form.vue handleSubmit, 杀手特性 --formEnCode 一键 BS-49 修复)
**4 步法实施**:
- 步骤 1 读源码: web/.../api/system/menu.ts:24-26 (PUT /api/system/Menu/{id}), web/.../views/permission/menu/Form.vue:230-269 (handleSubmit), :281-294 (onTypeChange), :238-243 (pageAddress 类型映射)
- 步骤 2 理解意图: web 端表单填 → 构造 propertyJson moduleId + pageAddress → PUT. BS-49 form enCode 改名后菜单 urlAddress 不同步
- 步骤 3 镜像设计: 镜像 handleSubmit 完整流程, 加 --formEnCode 杀手特性: 自动查 form id + 拼 pageAddress
- 步骤 4 实现: 新建 menu/update.ts (~210 行) + menu/index.ts (注册新子命令)

**杀手特性**: 'dacli menu update <id> --formEnCode=tds_contract_b4' 一键修复 BS-49 (form 改名后菜单 urlAddress 不同步 → 浏览器 404).

**为什么**: tds 打磨 Batch 4 发现 contract 菜单 urlAddress 不匹配 form enCode. 缺 menu update 命令用户没法改.

**How to apply: 后续 menu 改名 / urlAddress 错 / 7 必填字段缺失 都可用 menu update 修复, 不必删除重建.
2026-06-27 22:26:45 +08:00
ssw eb3cac1dba fix(menu): BS-19 menu create 提取真实 id (B-15 扩展, web Form.vue 创建后刷新列表对齐)
**4 步法实施**:
- 步骤 1 读源码: dacli/src/commands/dict/_lookup.ts:21-40 (B-15 lookupTypeIdByEnCode 模板), dacli/src/commands/dict/datacreate.ts:78-99 (B-15 修后镜像), dacli/src/webapi/menu.ts:8-10 (web getMenuList 镜像)
- 步骤 2 理解意图: JNPF POST /api/system/Menu 返 {code:200, msg, data:null}, 与 dict 同病 (B-15). web 端 handleSubmit 后列表自动刷新拿真实 id
- 步骤 3 镜像设计: 镜像 B-15 修法, 创建 lookupMenuIdByEnCode() 用 getMenuList 按 enCode 反查
- 步骤 4 实现: 新建 menu/_lookup.ts (~50 行) + menu/create.ts (3 处模式 A/B/D-4 都接入 lookup, +12/-3 行)

**为什么**: menu create 输出 id=(unknown) 是 cosmetic 缺陷, 后端成功但不返 id. 镜像 web 端 handleSubmit → 列表刷新拿 id 流程.

**How to apply**: 后续 menu create 后会输出真实 id (类似 dict typeCreate/dataCreate), list/update/delete 可用.
2026-06-27 22:26:19 +08:00