Files
dacli/docs/cmd-review/dict.md
T
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

6.0 KiB
Raw Blame History

dacli dict 命令审计报告 (2026-06-25)

1. 命令清单

子命令 格式 用途
dacli dict typeList [--keyword] [--json] 字典类型列表 (按编码/名搜索)
dacli dict typeCreate --enCode --fullName [--items] [--category] [--isTree] [--json] 创建字典类型 (含可选字典项)
dacli dict dataList [--typeId|--all] [--json] 字典数据列表 (按类型或全部)
dacli dict dataCreate --typeId [--enCode|--items] [--fullName] [--json] 往已存在字典类型追加字典项

2. web 端对应

  • 字典类型页: web/apps/jnpf-web-apps-main/src/views/sysData/dictionary/
    • index.vue — 字典类型列表 (树形)
    • Form.vue — 字典类型编辑表单
    • components/Form.vue — 字典项编辑表单
  • 字典 API: web/apps/jnpf-web-apps-main/src/api/systemData/dictionary.ts (15 函数)
    • 字典类型 (6): getDictionaryType/getDictionaryTypeSelector/createDictionaryType/updateDictionaryType/getDictionaryTypeInfo/delDictionaryType
    • 字典数据 (9): getDictionaryDataList/getDictionaryAll/getDictionaryDataTypeSelector/getDictionaryDataSelector/createDictionaryData/updateDictionaryData/getDictionaryDataInfo/delDictionaryData/exportData
  • webapi/dict.ts 已存在 (v0.11 Phase 1 已镜像, 15 函数)
  • BS-47 关键约束: 字典的 enCode 和 fullName 全平台唯一 (跨 app), web 端 POST 重复时返回 "The name cannot be repeated"

3. 改/删/留 建议

[KEEP] 保留

  • typeList — AI 防 BS-47 必需, 枚举已有字典来避免重复
  • typeCreate — 杀手锏, 端到端 1 条命令建类型 + 字典项 (web 需 2 个页面)
  • dataList — 字典项查询基础能力
  • dataCreate — 补充 typeCreate, 追加字典项

[REFACTOR-WEBAPI] P0 重点

4 个子命令全部切到 loadDict.* 调用:

  • typeList: 当前用 c.get('/system/DictionaryType') → 应改 loadDict.getDictionaryType({ keyword })
  • dataList: 当前用 c.get('/system/DictionaryData/{typeId}/Data') → 应改 loadDict.getDictionaryDataList({ typeId }) 或 loadDict.getDictionaryAll()
  • typeCreate: 当前用 c.postJson('/system/DictionaryType', ...) + c.postJson('/system/DictionaryData', ...) → 应改 loadDict.createDictionaryType() + loadDict.createDictionaryData()
  • dataCreate: 当前用 c.postJson('/system/DictionaryData', ...) → 应改 loadDict.createDictionaryData()

理由:

  • v0.11+ 强制 webapi 镜像架构, 避免与 web 端 API 签名不同步
  • webapi/dict.ts 已镜像 15 函数, 使用率为 0%
  • 消除 ~80 行硬编码 API 调用, 同步 web 端字段变更 (如 enabledMark 默认值)

[DEPRECATE] 无

  • 4 个现有命令都是基础 CRUD 子集, 无功能重复或设计错误
  • 唯一改进: 内部实现切到 webapi 镜像, 命令名/参数/输出格式不变

[NEW-CMD] P1 高优先级 — 补全 CRUD 闭环

  • dacli dict typeUpdate <id> — webapi 已有 updateDictionaryType(data), AI 建错字典需修改场景
  • dacli dict dataUpdate <id> — webapi 已有 updateDictionaryData(data), 字典项改名/改排序/禁用
  • dacli dict typeDelete <id> — webapi 已有 delDictionaryType(id), 删类型 + 递归删字典项

[NEW-CMD] P2 中优先级

  • dacli dict dataDelete <id> — webapi 已有 delDictionaryData(id), 与 typeDelete 配对闭环

[NEW-CMD] P3 调试辅助

  • dacli dict typeInfo <id> — webapi 已有 getDictionaryTypeInfo(id), 单条详情 (区别于 list)
  • dacli dict dataInfo <id> — webapi 已有 getDictionaryDataInfo(id), AI 调试 BS-47 时拿冲突字典完整信息

[NEW-CMD] P2 集成命令

  • dacli dict typeSelector — 输出树形选择器格式, 方便 form schema 直接引用 (form select 字段需 dict enCode)

4. AI 痛点评估

BS-47 (dict 全平台唯一) — 防护是否充分?

当前防护 (L2 guard BS-47):

  • ✅ 命令执行前检查 ctx.existingEnCodes.includes(name/enc)
  • ✅ 失败时提示: "dacli dict dataList 看已有字典, 复用或加 <app>_ 前缀"
  • ✅ L1 pre-check 也支持

待优化:

  • ⚠️ 提示用 "dacli dict dataList" 应改为 "dacli dict typeList" (命令名是 typeList, 不是 dataList)
  • ⚠️ "加 <app>_ 前缀" 建议改为 "_" (从 app context 自动取)

结论: 防护已较完善, 提示文字有小 bug, Phase 2 修正

form 字段引字典时的引导 — 缺失

痛点:

  • form create 时 select 字段需要 dict.enCode 作 datasource
  • AI 不知道现在有哪些 dict 可选
  • 需先 dacli dict typeList 查 enCode, 再填到 form schema

建议:

  • 新增 dacli dict typeSelector 输出树形选择器格式
  • 或在 dacli form create --help 中加入"如何找 dict enCode"章节

dict 关联 form select 字段闭环 — 不完整

场景 (BS-54 关联):

  1. AI 想建带 select 字段的 form
  2. 需先建 dict (typeCreate)
  3. 拿到 dictId 或 enCode
  4. 填到 form schema 的 select 字段配置

当前闭环问题:

  • 步骤 1-2: ✅ 有 typeCreate
  • 步骤 3: ⚠️ 只能从 typeList 拿 enCode, 但要带 typeId (select 字段实际引用 typeId)
  • 步骤 4: ✅ form create 支持 select + dict 配置, 但 schema 拼装靠 AI 手工

建议:

  • form create 的 precheck 中加入: "select 字段需 dict enCode, 建议先 dacli dict typeList"
  • 或提供 dacli form create --dictCode=xxx 简写 (自动展开为 select 字段)

核心结论: dacli dict 4 个子命令结构合理, 但 100% 绕过 v0.11+ webapi 镜像。webapi/dict.ts 已镜像 15 函数但使用率为 0%, 导致 API 不一致风险和 ~80 行重复代码。同时缺少 Update/Delete CRUD 闭环。

3 个最关键建议:

  1. P0 [REFACTOR-WEBAPI]: 4 个子命令全部切到 loadDict.* 调用
  2. P1 [NEW-CMD]: 新增 typeUpdate + dataUpdate + typeDelete 补全 CRUD 闭环
  3. P1 [OPTIMIZE]: 修正 L2 guard BS-47 提示文字 (dataList → typeList, <app>_ → <appCode>_)