按 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]>
6.8 KiB
6.8 KiB
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 步骤创建流程)
// 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
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 (创建菜单)
import { getDataReportSelector, getDataVSelector, getPortalSelector,
getReportSelector, getVisualDevSelector, getFlowSelector } from '#/api/...';
关键发现:
- 创建菜单时需要知道有哪些目标可挂: form / report / portal / datav / flow
- 每个目标都对应一个
xxxSelectorAPI - AI 痛点: 必须先 list 这些资源才知道选哪个
2.4 sysData/dictionary/Form.vue
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 (半天)
// 新增 webapi 模块
dacli/src/webapi/selectors.ts // formSelector + reportSelector + portalSelector + flowSelector + dictSelector
阶段 2: 新增 selector 命令 (半天)
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