Files
dacli/docs/cmd-review/datasource.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.6 KiB
Raw Blame History

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

1. 命令清单

子命令 格式 用途
dacli datasource list [--keyword] [--json] 列出所有数据源(按名称/enCode 过滤)
dacli datasource create --fullName --enCode --dbType --connectionString --username --password [--json] 创建数据源
dacli datasource test --dbType --connectionString --username --password [--json] 测试连接(不创建)
dacli datasource delete <id> [--json] 删除数据源

2. web 端对应

  • 数据源页:web/.../views/system/dataSource/Index.vue
  • 数据源 API:web/.../api/system/dataSource.ts
  • webapi/dataSource.ts 已存在 (v0.11 Phase 1 已镜像, 11 函数)

3. 改/删/留 建议

[KEEP] 保留

  • list — AI 找数据源入口
  • create — 创数据源
  • test — 测连接
  • delete — 删数据源

[REFACTOR-WEBAPI] P0 重点

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

  • 当前 100% 绕过 v0.11+ webapi 镜像,全部用 c.postJson/c.get/c.del 手写
  • webapi/dataSource.ts 已镜像 11 个函数(包含 testDbConnection、getDataSourceInfo 等),使用率为 0%
  • 消除 ~150 行手写 API 代码,同步 web 端加密/字段逻辑

[DEPRECATE] 无

[NEW-CMD] P1

  • dacli datasource info <id> — 查单个数据源详情(webapi 已有 getDataSourceInfo)
  • dacli datasource selector — 选择器(按 dbType 过滤 + 简单格式输出),AI 验证/选择数据源必需
  • dacli datasource update <id> — 改连接串/密码(高频运维场景)

4. AI 痛点评估

dbLinkId 流程

理想 AI 流程:

dacli app context --json         # 拿 appCode/dbLinkId
dacli datasource list --json     # 看已有数据源
dacli datasource test --dbType=mysql --connectionString=...  # 测连接
dacli form create --dbLinkId=<enCode> ...  # 建表单

当前痛点:

  • ❌ test 命令测试后不会回填到数据源,AI 经常需要重复填
  • ❌ create 后没有 selector 帮助 AI 找到新数据源 enCode
  • ❌ update 命令缺失,AI 创建后无法修改

核心结论:dacli datasource 4 个子命令结构合理,但 100% 绕过 v0.11+ webapi 镜像。webapi/dataSource.ts 镜像已存在但使用率为 0%,导致 API 不一致风险和 ~150 行重复代码。

3 个最关键建议:

  1. P0 [REFACTOR-WEBAPI]: 4 个子命令全部切到 loadDataSource.* 调用
  2. P1 [NEW-CMD]: 新增 datasource info <id> 和 datasource selector
  3. P1 [NEW-CMD]: 新增 datasource update <id> 改连接串/密码