Files
dacli/docs/cmd-review/_summary.md
T

6.2 KiB
Raw Blame History

Phase 1 总结报告: 23 个 dacli 父命令审计 (2026-06-25)

背景: 用户在 v0.11+ plan 中要求"逐个过 23 个 dacli 父命令", 看 web 端页面逻辑, 决定命令改/删/留. 方法: 5 批 × 5/批 派 Explore 子代理并行审计, 主代理汇总. 产出: dacli/docs/cmd-review/ 23 个 markdown 报告 + 本总结.

1. 审计覆盖 (23/23 完成)

批次 命令 web 路径修正
A apis, app, bigscreen, datasource, di bigscreen → jnpf/前端/jnpf-web-datascreen-vue3
B dict, dm, doc, form, integration —
C log, menu, monitor, msg, org —
D portal, print, report, role, schedule report → web/apps/jnpf-web-apps-main/src/api/onlineDev/report.ts (主 webapp)
E storage, user, workflow —

用户关键修正 (2026-06-25):

  1. bigscreen web 在独立子项目 jnpf-web-datascreen-vue3, 不是主 webapp
  2. report (v3 修正 2026-06-29): webapi 镜像源在 主 webapp web/apps/jnpf-web-apps-main/src/api/onlineDev/report.ts (Vue 3)
    • jnpf/前端/jnpf-web-datareport 是 jQuery 老设计器, 无 src/api/ 目录, 不可镜像
    • web/packages/jnpf/plugins/jnpf-univer 是 Vue 3 组件包, 无 api/ 目录, 也不可镜像
  3. 这两类命令审计 v2 已重新执行

2. 总体数据

维度 数据
总子命令数 116 (24 父命令)
webapi 镜像模块 6 (dataModel/dataSource/dict/menu/visualDev/workflow)
webapi 镜像函数 95
webapi 实际使用率 < 30% (大量 c.postJson/c.get 仍手写)
缺 [REFACTOR-WEBAPI] 的命令 12+ 父命令
缺 [NEW-CMD] P0 必补 30+ 个新命令
端点错误 (P0 假 PASS) 3 处 (integration emailTest/smsTest, msg templateCreate)

3. P0 优先级 Top 10 (按执行价值)

  1. dacli form update (高需求, 增量改 schema) — 改 schema 需 export → 改 → import, 无原子性
  2. dacli log exception (P0 必补) — AI 排查后端异常的唯一杀手锏, 当前完全缺失
  3. dacli di info/test/create/update/delete (5 个) — 当前 1 个 list, AI 完全无法闭环
  4. dacli role update/info/selector/authorize (4 个) — 权限管理闭环断裂
  5. dacli org update/delete/info + org position (5 子) + org selector — 闭环 + 岗位空白
  6. dacli msg noticeUpdate/Delete + templateUpdate/Delete (4 个) + 修端点错误
  7. dacli storage create/update/delete + upload/download/ls (6 个) — 阻塞附件调试
  8. dacli apis search --field= (P0) — 解决 AI 字段盲猜
  9. dacli bigscreen update/delete/category (3+ 个) — 补全 CRUD 闭环
  10. dacli report create/update/delete + preview + category (5+ 个) — 报表管理 3/8 = 12.5% 覆盖率

4. P0 [REFACTOR-WEBAPI] Top 5 (架构对齐)

  1. datasource 4 子命令 (100% 绕 webapi) — webapi/dataSource.ts 已镜像 11 函数, 使用率 0%
  2. dict 4 子命令 (100% 绕 webapi) — webapi/dict.ts 已镜像 15 函数, 使用率 0%
  3. menu 6/8 子命令 (1/15 = 6.7% 使用率) — 消除 ~120 行硬编码
  4. form import.ts (8 调用) + codegen.ts (4) + create.ts (4) + fixcolumndata.ts (3) — 22 调用待切
  5. dm create + drop — 切到 webapi/dataModel.ts

5. 端点错误 (P0 假 PASS, 立即修)

命令 当前错误端点 正确端点 影响
integration emailTest /message/SendMessageConfig/testSendConfig /message/AccountConfig/testSendMail 假 PASS
integration smsTest /system/SmsTemplate/testSent /message/AccountConfig/testSendSms 假 PASS
msg templateCreate /api/system/MessageTemplate /api/message/MessageTemplateConfig 调用失败

6. AI 痛点 Top 5 跨命令

  1. webapi 一致性差 — 12+ 父命令 100% 绕 webapi, 大量 c.postJson/c.get 手写
  2. CRUD 闭环断裂 — 大量命令缺 update/info/delete, 改名/修改/清理需 delete+create
  3. selector 缺失 — 多个命令缺选择器 (role/org/dict type/storage/menu), AI 引用 ID 需 list 拉全表
  4. P0 端点错误 (假 PASS) — 3 处端点错, AI 调用成功但实际不生效
  5. 子项目 web 路径未知 — bigscreen/report 是独立子项目, 需特殊处理

7. Phase 2 执行建议

立即执行 (P0 端点错误)

  • 修 integration emailTest/smsTest 端点
  • 修 msg templateCreate 端点
  • 加 @deprecated 标记
  • 执行时间: 半天

短期 (P0 必补 [NEW-CMD])

  • form update (2 周)
  • log exception (1 周)
  • di info/test/create/update/delete (1 周)
  • role update/info/selector/authorize (1 周)
  • org position + selector (1 周)
  • msg noticeUpdate/Delete + templateUpdate/Delete (3 天)
  • 总时间: ~6 周

短期 (P0 必补 [REFACTOR-WEBAPI])

  • datasource 4 子命令 (2 天)
  • dict 4 子命令 (2 天)
  • menu 6 子命令 (3 天)
  • form import/codegen/create/fixcolumndata (1 周)
  • 总时间: ~2 周

中期 (P1 增强)

  • apis search (3 天)
  • storage CRUD (1 周)
  • bigscreen update/delete/category (1 周)
  • report CRUD (2 周)

8. 不建议做的事 (基于审计)

  1. ❌ 不建议补 schedule pause/resume/start/stop — JNPF 无对应 API, 用 update --enabledMark 替代
  2. ❌ 不建议把 schedule log 移到 monitor — 数据源不同
  3. ❌ 不建议命令化 bigscreen/report 设计器 drag-drop — UI 复杂操作, 命令化收益低
  4. ❌ 不建议补 app init --restart 实际功能 — 现有 dry-run 已说明, 改用 app use <code> 替代
  5. ❌ 不建议 dict dataList 改名 — 现有 4 子命令命名清晰

9. 下一步

Phase 2 开始: 按 P0 优先级执行

  1. Day 1-2: 修 3 处端点错误 + 加 @deprecated
  2. Week 1: form update + log exception
  3. Week 2-3: di/role/org/msg P0 必补
  4. Week 4-5: webapi 镜像化 (datasource/dict/menu/form)
  5. Week 6+: P1 增强 (apis search / storage / bigscreen / report)

作者: 2026-06-25 派 25 个 Explore 子代理审计 (5 批 × 5) 审计者: 23 个 dacli 父命令 (apis/app/bigscreen/datasource/di/dict/dm/doc/form/integration/log/menu/monitor/msg/org/portal/print/report/role/schedule/storage/user/workflow) 关键修正: bigscreen/report 是独立子项目, web 路径已修正 下一步: Phase 2 按 P0 优先级执行