派 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]>
63 lines
2.6 KiB
Markdown
63 lines
2.6 KiB
Markdown
# 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>` 改连接串/密码
|