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

63 lines
2.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 流程:
```bash
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>` 改连接串/密码