6.2 KiB
6.2 KiB
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):
- bigscreen web 在独立子项目
jnpf-web-datascreen-vue3, 不是主 webapp - 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/ 目录, 也不可镜像
- 这两类命令审计 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 (按执行价值)
dacli form update(高需求, 增量改 schema) — 改 schema 需 export → 改 → import, 无原子性dacli log exception(P0 必补) — AI 排查后端异常的唯一杀手锏, 当前完全缺失dacli di info/test/create/update/delete(5 个) — 当前 1 个 list, AI 完全无法闭环dacli role update/info/selector/authorize(4 个) — 权限管理闭环断裂dacli org update/delete/info + org position (5 子) + org selector— 闭环 + 岗位空白dacli msg noticeUpdate/Delete + templateUpdate/Delete(4 个) + 修端点错误dacli storage create/update/delete + upload/download/ls(6 个) — 阻塞附件调试dacli apis search --field=(P0) — 解决 AI 字段盲猜dacli bigscreen update/delete/category(3+ 个) — 补全 CRUD 闭环dacli report create/update/delete + preview + category(5+ 个) — 报表管理 3/8 = 12.5% 覆盖率
4. P0 [REFACTOR-WEBAPI] Top 5 (架构对齐)
- datasource 4 子命令 (100% 绕 webapi) — webapi/dataSource.ts 已镜像 11 函数, 使用率 0%
- dict 4 子命令 (100% 绕 webapi) — webapi/dict.ts 已镜像 15 函数, 使用率 0%
- menu 6/8 子命令 (1/15 = 6.7% 使用率) — 消除 ~120 行硬编码
- form import.ts (8 调用) + codegen.ts (4) + create.ts (4) + fixcolumndata.ts (3) — 22 调用待切
- 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 跨命令
- webapi 一致性差 — 12+ 父命令 100% 绕 webapi, 大量 c.postJson/c.get 手写
- CRUD 闭环断裂 — 大量命令缺 update/info/delete, 改名/修改/清理需 delete+create
- selector 缺失 — 多个命令缺选择器 (role/org/dict type/storage/menu), AI 引用 ID 需 list 拉全表
- P0 端点错误 (假 PASS) — 3 处端点错, AI 调用成功但实际不生效
- 子项目 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. 不建议做的事 (基于审计)
- ❌ 不建议补
schedule pause/resume/start/stop— JNPF 无对应 API, 用update --enabledMark替代 - ❌ 不建议把
schedule log移到monitor— 数据源不同 - ❌ 不建议命令化 bigscreen/report 设计器 drag-drop — UI 复杂操作, 命令化收益低
- ❌ 不建议补
app init --restart实际功能 — 现有 dry-run 已说明, 改用app use <code>替代 - ❌ 不建议
dict dataList改名 — 现有 4 子命令命名清晰
9. 下一步
Phase 2 开始: 按 P0 优先级执行
- Day 1-2: 修 3 处端点错误 + 加 @deprecated
- Week 1: form update + log exception
- Week 2-3: di/role/org/msg P0 必补
- Week 4-5: webapi 镜像化 (datasource/dict/menu/form)
- 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 优先级执行