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

2.9 KiB

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

1. 命令清单 (7 个子命令)

# 命令 用途
1 dacli storage list [--profile] [--yml] [--json] 列出 application-{profile}.yml 中 file-storage 配置的所有后端
2 dacli storage info <platform> [--profile] [--yml] [--json] 显示某 platform 的详细配置 (敏感字段脱敏)
3 dacli storage test [platform] [--profile] [--yml] [--type] 测试存储后端连通性 (走 /api/file/Uploader/{type})
4 dacli storage use <platform> [--profile] [--yml] [--no-backup] 切换 default-platform (备份 + 写 yml + 提示重启)
5 dacli storage backup [--profile] [--yml] 显式备份 application-{profile}.yml
6 dacli storage diff [--profile] [--yml] 跟 git HEAD 对比 yml 变化
7 dacli storage _helpers 内部辅助 (yml 解析等)

2. web 端对应

  • JNPF 后端: /api/extend/Storage (POST/GET/PUT/DELETE) + /api/extend/Storage/{id}/Actions/Upload|Download
  • dacli 状态: 无 webapi 镜像 — storage 未在 v0.11+ webapi/ 模块列表
  • Web UI: jnpf 6.x 不开放存储配置 UI (走 yml)
  • 文件操作层: web/.../api/core/common.ts 已实现 /api/file/Uploader/{type} (upload/preview/download/merge/packDownload)

3. 改/删/留 建议

[KEEP] 保留 (6 个全部)

  • list, info, use, backup, diff — AI 调试核心
  • test — 连通性验证必需

[REFACTOR-WEBAPI] P1 必做

新增 src/webapi/storage.ts, 镜像 web 端 /api/extend/Storage CRUD (优先级 P1)

  • 当前走纯 yml 方案, AI 调试需了解 spring yml 结构

[NEW-CMD] P0 严重缺失 (5 个命令)

  1. storage create/update/delete (P0 严重) — 当前 AI 无法添加/修改/删除 platform, 必须手动改 yml
  2. storage upload/download/ls (P0 严重) — 文件上传/下载无 CLI 入口, 阻塞附件调试和迁移场景
  3. storage types (P2) — 列出所有 backend-type (7+ 种), 当前需看源码才能知道支持哪些后端

[DEPRECATE] 无

4. AI 痛点评估

痛点 1 (最严重): 创建新 platform 完全缺失

  • AI 初始化新存储后端场景被阻塞, 无法独立完成

痛点 2 (严重): 文件上传/下载无 CLI 入口

  • 附件调试场景完全阻塞

痛点 3 (中等): 7 子命令完整度 50%

  • CRUD 0/4 + 文件操作 0/3
  • 对比 menu/user 缺乏完整性

webapi 镜像缺失影响

  • AI 调试需深入 spring yml, 启动 JNPF 才能验证
  • 不如其他 webapi 镜像命令即时

核心结论: storage 命令族当前可用率 50%, 缺 CRUD 和文件操作; AI 在初始化新存储和文件调试场景完全阻塞.

3 个最关键建议:

  1. P0 必做 (5-6 天): storage create/update/delete + storage upload/download/ls
  2. P1 推荐 (1-2 天): 新增 webapi/storage.ts 镜像
  3. P2 可选: storage types + list/info 默认 JSON 输出