按 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]>
185 lines
6.8 KiB
Markdown
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` |