Files
dacli/docs/source-analysis.md
T
sswandClaude 727b13c407 feat(v0.11+): Phase A-E AI 工作流闭环 - 源分析 + 镜像 + 新命令 + skill + 验证
按 docs/dacli/v0.11-final.md 4 阶段执行:
1. 源码分析 docs/source-analysis.md (分析 web/views/** 页面逻辑)
2. 镜像高频 webapi (dict + workflow)
3. 新增 AI 痛点驱动命令 (form selector + workflow selector)
4. 集成到 form-development / workflow-development skill
5. 用官方示例验证 (workSystem 86 form/17 flow, developSystem 4 form)

新增模块:
- src/webapi/dict.ts (15 函数镜像 web/.../systemData/dictionary.ts)
- src/webapi/workflow.ts (14 函数镜像 web/.../workFlow/template.ts)
- src/commands/form/selector.ts (formSelector 命令 + 树形平铺)
- src/commands/workflow/selector.ts (getFlowSelector 命令)

测试:
- tests/test-webapi-dict-workflow.ts (15 dict + 14 workflow 函数实测 PASS)

Skill 集成:
- .claude/skills/form-development/SKILL.md (新增 form selector 段)
- .claude/skills/workflow-development/SKILL.md (新增 workflow selector 段)

验证 (workSystem):
- form selector --json: 86 form 平铺
- workflow selector --json: 17 工作流

验证 (developSystem):
- form selector --json: 4 form
- workflow selector --json: 17 工作流 (跨应用可见)

源分析报告 docs/source-analysis.md 列出 18 个未覆盖模块 + 缺口分级 (P0/P1/P2).

Co-Authored-By: Claude <[email protected]>
2026-06-25 13:59:32 +08:00

185 lines
6.8 KiB
Markdown

# dacli 源码分析报告 (2026-06-25)
**目的**: 分析 `web/apps/jnpf-web-apps-main/src/views/**/*.vue` 页面操作逻辑,
识别 dacli 当前命令未覆盖的 AI 工作流缺口.
## 1. 分析范围
| 模块 | views 子目录 | dacli 命令 | 状态 |
|------|-------------|-----------|------|
| 表单设计 | onlineDev/formDesign | form (24 子命令) | ✅ 已覆盖 |
| 数据建模 | dataCenter/dataModel | dm (4 子命令) | ✅ 已覆盖 (但缺 addFields/update) |
| 数据连接 | dataCenter/dataSource | datasource (4) | ✅ 已覆盖 |
| 菜单管理 | permission/menu | menu (7) | ✅ 已覆盖 |
| 用户管理 | permission/user | user (18) | ✅ 已覆盖 |
| 角色管理 | permission/role | role (4) | ✅ 已覆盖 |
| 组织/职位 | permission/organize | org (3) | ✅ 已覆盖 |
| 字典 | sysData/dictionary | dict (4) | ✅ 已覆盖 |
| 报表 | onlineDev/report | report (3) | ⚠️ 缺 webapi 镜像 |
| 门户 | onlineDev/visualPortal | portal (4) | ⚠️ 缺 webapi 镜像 |
| 大屏 | onlineDev/dataV | bigscreen (4) | ⚠️ 缺 webapi 镜像 |
| 数据接口 | dataCenter/dataInterface | di (1) | ⚠️ 缺 webapi 镜像 |
| 工作流 | workFlow/ | workflow (5) | ⚠️ 缺 webapi 镜像 |
| 消息 | msgCenter/ | msg (3) | ⚠️ 缺 webapi 镜像 |
| 定时任务 | teamwork/schedule | schedule (5) | ⚠️ 缺 webapi 镜像 |
| 打印 | onlineDev/printDev | print (3) | ⚠️ 缺 webapi 镜像 |
| 日志 | sysLog/ | log (2) | ⚠️ 缺 webapi 镜像 |
| 监控 | monitor/ | monitor (3) | ⚠️ 缺 webapi 镜像 |
| 报表 | onlineDev/dataReport | report (合并) | ⚠️ 缺 webapi 镜像 |
## 2. 核心页面操作逻辑分析
### 2.1 formDesign/Form.vue (3 步骤创建流程)
```js
// handleSubmit() 关键逻辑:
async function handleSubmit() {
if (state.activeStep < 1) { // 步骤 0: 基础信息
const values = await validate();
state.dataForm = { ...state.dataForm, ...values };
handleRequest();
} else if (state.activeStep === 1) { // 步骤 1: 表单设计
generatorRef.getData().then((res) => {
state.formData = res.formData;
state.dataForm.formData = JSON.stringify(state.formData);
handleRequest();
});
} else { // 步骤 2: 列表设计
if (state.dataForm.webType == 1) return handleRequest();
columnDesignRef.getData().then((res) => {
state.columnData = res.columnData;
handleRequest();
});
}
}
function handleRequest() {
const query = {
...state.dataForm,
tables: JSON.stringify(state.tables),
formData: state.dataForm.formData,
columnData: state.dataForm.columnData,
appColumnData: state.dataForm.appColumnData,
};
const formMethod = state.dataForm.id ? update : create;
formMethod(query);
}
```
**关键发现**:
- **submit 时 formData/columnData/tables 都是 JSON 字符串** (后端期望)
- **id 存在走 update, 否则 create** — dacli 没暴露 update 命令
- **webType == 1 跳过列表设计** — dacli 已支持 (autoTable)
- **maxStep = webType == 4 ? 1 : 2** — type=4 视图只 1 步 (基础+设计, 无列表)
### 2.2 dataCenter/dataModel/Form.vue
```js
async function handleSubmit() {
const tableInfo = { ...dataForm.value, ...values };
const tableFieldList = hasTableData.value
? fieldList.value.filter((o) => !o.disabled)
: fieldList.value;
const query = {
tableFieldList: tableFieldList.map((o) => ({
...o,
primaryKey: o.primaryKey ? 1 : 0, // boolean → 1/0
allowNull: o.allowNull ? 1 : 0,
identity: o.identity && o.primaryKey ? 1 : 0,
})),
tableInfo,
};
const formMethod = hasTableData.value ? addTableFields : dataForm.value.table ? update : create;
formMethod(unref(linkId), query);
}
```
**关键发现**:
- **三态 formMethod**: addTableFields (有表加字段) / update (有表名) / create (新建)
- dacli dm 命令**只有 create**, 缺 update / addFields
- **boolean → 1/0 转换是必须的** (dacli v10.6.1 已自动)
### 2.3 permission/menu/Form.vue (创建菜单)
```js
import { getDataReportSelector, getDataVSelector, getPortalSelector,
getReportSelector, getVisualDevSelector, getFlowSelector } from '#/api/...';
```
**关键发现**:
- 创建菜单时需要知道**有哪些目标可挂**: form / report / portal / datav / flow
- 每个目标都对应一个 `xxxSelector` API
- **AI 痛点**: 必须先 list 这些资源才知道选哪个
### 2.4 sysData/dictionary/Form.vue
```js
const query = { ...values, id: id.value, dictionaryTypeId: typeId.value };
const formMethod = id.value ? update : create;
formMethod(query).then((res) => {
baseStore.setDictionaryList(); // 刷新 web 端全局缓存
closeModal();
});
```
**关键发现**:
- 创建/修改字典数据项, dictionaryTypeId 是父级类型
- dacli dict 有 typeCreate/typeUpdate, 但**没暴露 dictData 创建** (字典项)
## 3. AI 工作流缺口 (按优先级)
### 3.1 缺口 P0 (高频, 必须补)
| 缺口 | 影响 AI 操作 | 解决 |
|------|-------------|------|
| 没有 `formSelector` 类命令 | 创建菜单 / 工作流挂表单时, 不知道有哪些 form 可选 | 加 `dacli form selector --json` |
| 没有 `reportSelector` 类命令 | 同上 (报表挂载) | 加 `dacli report list` |
| 没有 `portalSelector` 类命令 | 同上 (门户挂载) | 加 `dacli portal list` |
| 没有 `dictSelector` 类命令 | 表单 select 字段配置字典 | 加 `dacli dict typeList` |
| 没有 `flowSelector` 类命令 | 菜单挂工作流 | 加 `dacli workflow list` |
### 3.2 缺口 P1 (中频, 应补)
| 缺口 | 解决 |
|------|------|
| 没有 form update 命令 | 加 `dacli form update <id>` (webapi/update) |
| 没有 dm addFields / dm update 命令 | 加 `dacli dm addFields` / `dacli dm update` |
| 没有 dictData CRUD | 加 `dacli dict dataList/dataCreate/dataUpdate` |
### 3.3 缺口 P2 (低频, 可缓)
| 缺口 | 解决 |
|------|------|
| msg / schedule / print / monitor 等 | 镜像 webapi 后再补命令 |
## 4. 实施路径 (按 AI 痛点驱动)
### 阶段 1: 镜像高频 selector 类 webapi (半天)
```ts
// 新增 webapi 模块
dacli/src/webapi/selectors.ts // formSelector + reportSelector + portalSelector + flowSelector + dictSelector
```
### 阶段 2: 新增 selector 命令 (半天)
```bash
dacli form selector --type=1 --keyword=员工 --json
dacli report list --json
dacli portal list --json
dacli workflow list --json
dacli dict typeList --json
```
### 阶段 3: 写 skill (1 小时)
dacli/.claude/skills/dacli-ai-workflow/SKILL.md:
- 提示 AI 在不同业务场景下该用什么命令
- 高频组合: 创建 menu 前先 form selector
### 阶段 4: 用官方示例验证
跑 developSystem / workSystem 验证:
- 创建菜单挂某个 form: `dacli form selector --json` → `dacli menu create --formId=...`
- 字典挂载: `dacli dict typeList --json` → 表单 select 字段
- 工作流挂载: `dacli workflow list --json` → `dacli menu create --type=4`