Files
dacli/docs/cmd-review/print.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

3.0 KiB

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

1. 命令清单 (3 个公开子命令)

# 命令 用途 状态
1 dacli print list [--keyword] 列出打印模板 ✅ KEEP
2 dacli print info --id=<id> 查看打印模板详情 ✅ KEEP
3 dacli print create --fullName --enCode --category [--formId] 新建打印模板 (绑 form 数据) ✅ KEEP

2. web 端对应

  • 打印模板页: web/apps/jnpf-web-apps-main/src/views/onlineDev/printDev/ (Form.vue, index.vue)
  • 打印模板 API: web/apps/jnpf-web-apps-main/src/api/system/printDev.ts (17 函数)

完整 API 列表:

  • 基础 CRUD: getPrintDevList, createPrintDev, updatePrintDev, delPrintDev, getPrintDevInfo
  • 复制: copy
  • 下拉框: getPrintDevSelector, getPrintWorkSelector, getPrintDevByIds
  • 导出: exportData
  • 预览: getPreviewInfo
  • 设计版本: saveVersion, getVersionInfo, getVersionList, delVersion, copyVersion
  • 批量打印: getBatchData

3. 改/删/留 建议

[KEEP] 全部 3 命令保留

列表/详情/创建核心场景全覆盖, 设计合理; 决策 6 正确 (webType=1-2, 绑 form 数据, 无需物理表)

[REFACTOR-WEBAPI] P0 重点 (webapi 完全缺失)

新增 src/webapi/printDev.ts 镜像 web 端 17 个 API 函数:

  • list.ts: c.get('/system/printDev') → loadPrintDev.getPrintDevList(data)
  • info.ts: c.get('/system/printDev/{id}') → loadPrintDev.getPrintDevInfo(id)
  • create.ts: c.postJson('/system/printDev', body) → loadPrintDev.createPrintDev(data)

[NEW-CMD] P1 必补 (webapi 已有, 缺 6 个命令)

  1. dacli print update --id --fullName? --enCode? --category? — 修改模板 (避免 delete+create 浪费)
  2. dacli print delete --id — 删除模板 (CRUD 闭环)
  3. dacli print preview --id [--data <json>] — 生成预览 PDF
  4. dacli print release --id — 发布模板 (当前 state=0 不可用)
  5. dacli print copy --sourceId --newName --newCode — 复制模板
  6. dacli print selector — 下拉框列表 (与 form 集成)

[NEW-CMD] P2 (form 联动增强)

关键痛点 dacli form create --printTemplateId=<id> — 当前 form create 已写死 printIds: [], AI 想绑打印必须 3 步操作 (print create → form update), 体验极差

4. AI 痛点评估

print-form 联动未闭环 ⚠️

  • 现状: form create 后 printIds: [], 必须手工触发 form update
  • 改进: 加 --printTemplateId flag 一次完成

CRUD 不完整 (3/7)

  • 缺 update/delete/preview/release
  • 业务场景中发票/合同/工单 100% 需要

核心结论: print 3 子命令能用但 webapi 镜像缺失 + CRUD 闭环不完整 + form 联动需 3 步走, AI 体验差.

Top 3 关键建议:

  1. [REFACTOR-WEBAPI] P0: 新增 webapi/printDev.ts 镜像 17 个 API, 消除硬编码
  2. [form 联动] P0: dacli form create --printTemplateId=<id> 一步绑定
  3. [CRUD 闭环] P1: 补 print update/delete/release/preview 4 命令