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

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
  • 每个目标都对应一个 xxxSelector API
  • 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