From 3257ce35b6b1afbeccd79d313d2995f240fa88c8 Mon Sep 17 00:00:00 2001 From: ssw Date: Wed, 1 Jul 2026 11:43:19 +0800 Subject: [PATCH] auto(284e8d004cbb): session end @ 2026-07-01T11:43:19 (+1f) --- src/commands/workflow/create.ts | 414 +++++++++++++++----------------- 1 file changed, 192 insertions(+), 222 deletions(-) diff --git a/src/commands/workflow/create.ts b/src/commands/workflow/create.ts index 99b1c8c..c09179a 100644 --- a/src/commands/workflow/create.ts +++ b/src/commands/workflow/create.ts @@ -1,18 +1,34 @@ /** - * commands/workflow/create.ts — 新建流程模板 + * commands/workflow/create.ts — 新建流程模板 (v0.12+ BS-新27 6 步 webapi 路径) * - * API: POST /api/workflow/template body=TemplateNodeCrFrom - * - {fullName, enCode, category, type, flowXml, flowNodes, flowConfig, ...} - * - v0.11: 与后端 TemplateCrForm.java 字段名 1:1 对齐 (type/iconBackground/showType) + * 修复 Bug 3 (流程编辑页无节点 + 提交报"系统异常") * - * AI 集成 (白皮书 5.10.3): --ai "<描述>" 调用 POST /api/workflow/ai, - * LLM 返回 flowXml, 自动塞进 body。 + * 6 步 webapi 路径 (镜像 web 浏览器 AiCreateModal.vue 完整流程, 端到端可用): + * 1. loadWorkflow.getAiInfo(keyword) → 走 web 端, prompt/parse/format 跟 web 一致 + * 2. loadWorkflow.create(template) → 创建空模板 (走 /api/workflow/template) + * 3. getVersionList(templateId) → 拿 versionId (走 /api/workflow/template/Version/{id}) + * 4. buildFlowNodes(flowXml, formId) → 构造完整 flowNodes (含 global + 解析节点) + * 5. loadWorkflow.save({type:1, ...}) → 真正发布 + 部署 (走 /api/workflow/template/Save) + * 6. (caller 后续) /workflow/task 发起 + * + * 镜像原型: + * - web/.../onlineDev/flowEngine/components/AiCreateModal.vue (AI 弹窗 + form 配置 + create) + * - web/.../onlineDev/flowEngine/DesignForm.vue:130-150 (handleRequest + saveFlow) + * - web/.../api/workFlow/template.ts: getAiInfo + create + saveFlow + * - web/.../FlowProcess/src/helper/config.ts:13-58 (defaultGlobalForm 模板) + * - jnpf/.../flowable/util/FlowUtil.java:2134 (后端 launch 必查 global.getTitleType) + * + * v0.12+ 简化 (BS-新27 jxcj 2026-07-01): + * - 移除老路径 (--no-ai-path / --auto-enable / 单独 PUT enabledMark) - 都是没用的中间步骤 + * - --ai 默认走 6 步 webapi, --flowXml 用户直传也走 webapi 路径 + * - 必填: --fullName + --category, --enCode 可选 (缺时从 fullName 自动生成 snake_case) */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' import { installAiHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' -import { callAiWorkflow, extractFlowNodesFromBpmn } from '../form/_ai.ts' +import { callAiWorkflow } from '../form/_ai.ts' +import { buildFlowNodes } from './_webapi_helpers.ts' import { validateWorkflowCreate } from './_validate.ts' import { enhanceFromBackend, formatErrorLine } from '../_error_codes.ts' @@ -20,263 +36,235 @@ interface CreateOpts { fullName?: string enCode?: string category?: string - /** v0.11 修复: 后端字段名是 `type` (TemplateCrForm.java:19), dacli 旧称 flowType 错配 */ + /** 流程类型 (0=标准 1=简流, 默认 0) */ type?: string - /** v0.11e+ Phase B2: auto-authorize */ - autoAuthorize?: boolean - /** BS-新6 (jxcj 2026-06-30): create 后自动调 workflow update --enabledMark=1, 生成 flowId. - * 默认 ON (镜像 web Actions/Module 流程版本), --no-auto-enable 关闭 */ - autoEnable?: boolean - /** BS-新6 (jxcj 2026-06-30): 绑定的 formId (同时绑 form + start node formId, 一次完成 5 命令等价) */ + /** start node 绑定的 formId (镜像 web 选表单步骤) */ startFormId?: string + /** 用户直传 BPMN XML (跳过 AI, 也走 6 步路径) */ flowXml?: string - flowNodes?: string flowConfig?: string - /** v0.11 修复: 后端字段名是 `iconBackground` (TemplateCrForm.java:28) */ iconBackground?: string - /** v0.11 修复: 后端字段名是 `showType` (TemplateCrForm.java:42), visibleType 是别名 */ showType?: string - /** v0.11d+ 镜像 web flowEngine/Form.vue:70-75 icon 必填 */ icon?: string json?: boolean - /** 5.10.3 AI 创建流程 — 自然语言描述, 平台 LLM 生成 flowXml */ + /** 5.10.3 AI 创建流程 (--ai "<描述>") - 调 web 端 getAiInfo 拿 flowXml */ ai?: string + /** 自动授权给当前角色 (镜像 web 流创建后行为) */ + autoAuthorize?: boolean +} + +/** 从 fullName 生成 enCode (snake_case) - 镜像 web form validate: 字母数字小数点, 不能放首尾 */ +function autoEnCode(fullName: string): string { + // 只保留 ASCII 字母数字和小数点; 其余 (中文/标点/下划线) 全删 (因为正则不允许 _) + const cleaned = fullName.replace(/[^a-zA-Z0-9.]/g, '').toLowerCase() + if (!cleaned) return 'workflow' // 中文开头, fallback + // 首字符不能是数字或 . (enCode 正则要求首字母是字母) + if (/^[0-9.]/.test(cleaned)) return `wf${cleaned}` + return cleaned } export function buildWorkflowCreateCommand(): Command { const cmd = new Command('create') - .description('新建流程模板 (--ai "<描述>" 走平台 LLM 自动生成 BPMN xml)') - .option('--fullName ', '中文名 (--ai 自动填, 否则必填)') - .option('--enCode ', '英文编码 (--ai 自动填, 否则必填)') - .option('--category ', '分类 id (workflow list 看真实值)') - // v0.11 修复: 与后端 TemplateCrForm.java:type 对齐 (0=标准 1=简流) - .option('--type ', '流程类型 (0=标准 1=简流, 默认 0=标准)', '0') - .option('--flowXml ', 'BPMN xml (--ai 自动填, 否则必填)') - .option('--flowNodes ', 'flowNodes JSON 字符串 (节点结构, --ai 自动填)') + .description('新建流程模板 (6 步 webapi 路径: AI → create → version → buildFlowNodes(含global) → save(type=1 部署))') + .option('--fullName ', '中文名 (必填)') + .option('--enCode ', '英文编码 (必填或 auto: 从 fullName 生成 snake_case)') + .option('--category ', '分类 id (必填, 跑 `dacli workflow selector` 看真实值, 或直接传中文 "项目管理")') + .option('--type ', '流程类型 (0=标准 1=简流, 默认 0)', '0') + .option('--flowXml ', 'BPMN xml (--ai 自动填; 用户直传跳过 AI)') .option('--flowConfig ', 'flowConfig JSON 字符串') .option('--iconBackground ', '图标背景色 (默认 #108ee9)', '#108ee9') - // v0.11d+ 镜像 web flowEngine/Form.vue:70-75 icon 必填 .option('--icon ', '流程图标 (默认 icon-ym icon-ym-flow)', 'icon-ym icon-ym-flow') - // v0.11 修复: 后端 showType (TemplateCrForm.java:42) .option('--showType ', '显示位置 (0=全局 1=流程 2=菜单, 默认 0)', '0') - .option('--ai ', '白皮书 5.10.3 AI 创建流程 — 自然语言描述, 平台 LLM 生成 flowXml') - // v0.11e+ Phase B2: auto-authorize (镜像 web 流创建后自动授权给当前角色) - .option('--auto-authorize', 'v0.11e+ Phase B2: 创建后自动给当前角色授权 (镜像 web Actions/Module 流程版本)', false) - // BS-新6 (jxcj 2026-06-30): create 后自动调 update --enabledMark=1, 生成 flowId - .option('--auto-enable', 'BS-新6: 创建后自动 enabledMark=1 (生成 flowId, 默认 ON)', true) - .option('--no-auto-enable', 'BS-新6: 关闭自动 enable') - .option('--startFormId ', 'BS-新6: 绑定的 formId (同时给 start node formId, 默认从 menu/url 推)') + .option('--startFormId ', '绑定的 formId (绑到 start 节点 formId, 镜像 web 选表单步骤)') + .option('--ai ', 'AI 创建流程 — 自然语言描述, 走 web 端 getAiInfo 拿 flowXml') + .option('--auto-authorize', '创建后自动给当前角色授权', false) .option('--json', '原始 JSON 输出', false) .action(async (opts: CreateOpts) => { - // 5.10.3 AI 创建流程 - if (opts.ai) { - log.info(`--ai "${opts.ai}" — 调用平台 AI 生成流程 (白皮书 5.10.3)`) + const c = await JnpfClient.fromToken() + + // ========== 1. 解析 flowXml 来源 (AI 或 直传) ========== + let flowXml: string | undefined = opts.flowXml + if (!flowXml && opts.ai) { + log.info(`[step 1/6] --ai "${opts.ai.slice(0, 50)}${opts.ai.length > 50 ? '...' : ''}" — 调 web 端 getAiInfo`) const data = await callAiWorkflow(opts.ai) if (!data.flowXml) { log.error('AI 响应缺 flowXml, 无法自动建流程') if (opts.json) printJson(data) process.exit(2) } - opts.flowXml = opts.flowXml || data.flowXml - if (data.flowNodes) opts.flowNodes = opts.flowNodes || JSON.stringify(data.flowNodes) - log.info(`AI 生成 flowXml 长度 ${data.flowXml.length} 字符`) + flowXml = data.flowXml + log.info(` ↳ AI 返回 flowXml 长度 ${flowXml.length} 字符`) + } + if (!flowXml) { + log.error('必须传 --flowXml 或 --ai "<描述>" 之一') + process.exit(2) } - // v0.11d+ 移除前置 fail-fast, 改由 step machine 聚合校验 (镜像 web flowEngine/Form.vue:125-150 validate) - const c = await JnpfClient.fromToken() - // D-8 (BS-45 防御): flowNodes 必 Map 格式, Array 会报 "Cannot deserialize value of type Map from Array value" - let flowNodes: unknown = {} - if (opts.flowNodes) { - let parsed: unknown - try { parsed = JSON.parse(opts.flowNodes) } - catch (e) { - // v0.11d+: 让 step machine 统一报 JSON 解析错误, 不在这里 fail-fast - log.warn(`flowNodes JSON 解析警告: ${(e as Error).message}, step machine 会再次校验`) - parsed = opts.flowNodes - } - if (Array.isArray(parsed)) { - // D-8: BS-45 防御, 但改成 WARN 提示, 不阻断 (step machine 会拦) - log.warn('D-8: --flowNodes 必传 Map 格式 (key=nodeCode, value=nodeInfo), Array 会被 step machine 拦截') - } - flowNodes = parsed - } - // v0.11g+ (2026-06-28): 用户没传 --flowNodes 时, 自动从 BPMN XML 解析生成 flowNodes - // 修复 Bug 2: 上架后 launch 报 "Node does not exist" 因为 flowNodes=0 - // 镜像 web packages/jnpf/plugins/jnpf-bpmn 流程设计器保存时自动生成 flowNodes 的行为 - // 注意: 必须在 step machine 之前跑, 否则 step 1 节点完整性校验会失败 - if ((!flowNodes || (typeof flowNodes === 'object' && Object.keys(flowNodes as object).length === 0)) && opts.flowXml) { - const extracted = extractFlowNodesFromBpmn(opts.flowXml) - const cnt = Object.keys(extracted).length - if (cnt > 0) { - flowNodes = extracted - opts.flowNodes = JSON.stringify(extracted) - log.info(`自动从 BPMN 解析生成 flowNodes (${cnt} 个节点): ${Object.keys(extracted).join(', ')}`) - } else { - log.warn(`未从 BPMN 解析出 flowNodes (XML 无 startEvent/userTask/endEvent 节点)`) - } - } - // v0.11d+ step machine 校验 (镜像 web flowEngine/Form.vue + AiCreateModal.vue + 后端 TemplateController.java:268-276) - // 在发 API 前暴露问题, 聚合错误一次报 + // enCode 兜底: 缺时从 fullName 生成 + const enCode = opts.enCode || (opts.fullName ? autoEnCode(opts.fullName) : 'workflow') + + // ========== 2. step machine 校验 (聚合错误一次报) ========== await runWorkflowStepMachine(c, { fullName: opts.fullName, - enCode: opts.enCode, + enCode, category: opts.category, icon: opts.icon, showType: opts.showType, - flowXml: opts.flowXml, - flowNodes: opts.flowNodes, + flowXml, }) - const body: Record = { + + // ========== 3. create template (空 flowNodes, 跟 web 一致) ========== + log.info(`[step 2/6] POST /workflow/template (空 flowNodes, 跟 web AiCreateModal 一致)`) + const createBody: Record = { fullName: opts.fullName, - enCode: opts.enCode, + enCode, category: opts.category || null, - // v0.11 修复: 与后端 TemplateCrForm.java:type 对齐 (旧称 flowType) type: Number(opts.type ?? '0'), - flowXml: opts.flowXml, - flowNodes, + flowXml, + flowNodes: {}, flowConfig: opts.flowConfig || '{}', sortCode: 0, - // v0.11 修复: 与后端 TemplateCrForm.java:showType 对齐 (旧称 visibleType, 是别名) showType: Number(opts.showType ?? '0'), - // v0.11 修复: 与后端 TemplateCrForm.java:iconBackground 对齐 (旧称 color) iconBackground: opts.iconBackground ?? '#108ee9', - // v0.11d+ 镜像 web flowEngine/Form.vue:70-75 (用户传或默认) icon: opts.icon ?? 'icon-ym icon-ym-flow', } - log.info(`POST /workflow/template ${opts.enCode} type=${body.type} showType=${body.showType}`) - const r = await c.postJson('/workflow/template', body) - if (r.code !== 200) { - log.error(`创建流程失败 (code=${r.code}): ${r.msg}`) - // v0.11e+ Phase A1: 后端错误增强 — 自动从 msg 提取 ErrorCode - const enhanced = enhanceFromBackend(r.msg || '', 'workflow', { entity: 'workflow' }) - log.error(` ${formatErrorLine(enhanced, { step: 2, stepName: '后端API' })}`) - if (opts.json) printJson(r) + const createResp = await c.postJson('/workflow/template', createBody) + if (createResp.code !== 200) { + log.error(`创建失败 (code=${createResp.code}): ${createResp.msg}`) + const enhanced = enhanceFromBackend(createResp.msg || '', 'workflow', { entity: 'workflow' }) + log.error(` ${formatErrorLine(enhanced, { step: 2, stepName: 'create template' })}`) process.exit(1) } - // v0.12+ 修复 Bug 1.2: 后端 create 返回 `data: ` 字符串, 不是 `{id}` 对象. - // 兼容 2 种结构 (旧代码假设 data.id, 新版用 data 本身或 data.id) - let newId = '(unknown)' - if (typeof r.data === 'string') { - newId = r.data - } else if (r.data && typeof r.data === 'object') { - newId = (r.data as { id?: string }).id || '(unknown)' - } - // 兜底: 如果后端用 r.data 整个对象, 拉 list 查 enCode 拿到 id (最后一次兜底) - // 修复 (2026-06-29 jxcj P1-4): 拉 list 同时校验用户传的 enCode 是否真生效, JNPF 经常自动改 enCode (如 LC 流水号) - let actualEnCode = opts.enCode - if (newId !== '(unknown)' || opts.enCode) { - try { - const lr = await c.get<{ list?: Array<{ id: string; enCode: string }> }>('/workflow/template', { - currentPage: 1, - pageSize: 10, - }) - // 优先按 id 匹配, 兜底按 enCode 匹配 - const matchById = lr.list?.find((t) => t.id === newId) - const matchByEnCode = lr.list?.find((t) => t.enCode === opts.enCode) - const match = matchById || matchByEnCode - if (match?.id) { - if (newId === '(unknown)') newId = match.id - actualEnCode = match.enCode - } - if (actualEnCode !== opts.enCode) { - log.warn(`⚠️ JNPF 后端未采用用户传的 enCode, 实际 = ${actualEnCode} (用户传 = ${opts.enCode})`) - log.warn(` 这是 JNPF 流水号机制, 使用实际 enCode "${actualEnCode}" 后续操作 (bindFlow/launch/...)`) - } - } catch { - // 兜底失败忽略 - } - } - log.ok(`创建成功: id=${newId} enCode=${actualEnCode}`) + const templateId = (typeof createResp.data === 'string' ? createResp.data : (createResp.data as { id?: string })?.id) || '' + log.ok(` ↳ templateId = ${templateId}`) - // v0.11e+ Phase B2: auto-authorize (镜像 web 流程创建后自动授权给当前角色) + // ========== 4. getVersionList 拿 versionId ========== + log.info(`[step 3/6] GET /workflow/template/Version/${templateId}`) + const verResp = await c.get>(`/workflow/template/Version/${templateId}`) + const versions = (verResp.data as unknown) as Array<{ id: string; state?: number }> || [] + if (versions.length === 0) { + log.error(`创建后没有 version 记录, templateId=${templateId}, 数据异常`) + process.exit(1) + } + const versionId = versions[0].id + log.ok(` ↳ versionId (flowId) = ${versionId}`) + + // ========== 5. 构造完整 flowNodes (含 global 节点) ========== + log.info(`[step 4/6] buildFlowNodes — 镜像 web FlowProcess.getData() 注入 defaultGlobalForm`) + const flowNodes = buildFlowNodes(flowXml, { formId: opts.startFormId, category: opts.category }) + const nodeCount = Object.keys(flowNodes).length + const hasGlobal = 'global' in flowNodes + log.ok(` ↳ ${nodeCount} 个节点 (含 global=${hasGlobal}, start.formId=${opts.startFormId || '(none)'})`) + + // ========== 6. save(type=1) 真正发布 + 部署 ========== + log.info(`[step 5/6] POST /workflow/template/Save type=1 (关键: 真正发布+部署)`) + const saveBody = { + id: templateId, + flowId: versionId, + flowXml, + flowConfig: opts.flowConfig || '{"visibleType":1}', + type: 1, + flowNodes, + isAddVersion: false, + } + const saveResp = await c.postJson('/workflow/template/Save', saveBody) + if (saveResp.code !== 200) { + log.error(`Save 失败 (code=${saveResp.code}): ${saveResp.msg}`) + const enhanced = enhanceFromBackend(saveResp.msg || '', 'workflow', { entity: 'workflow' }) + log.error(` ${formatErrorLine(enhanced, { step: 5, stepName: 'save type=1' })}`) + process.exit(1) + } + log.ok(` ↳ Save 成功 (workflow 已部署到 Flowable)`) + + // ========== 7. 验证发布状态 ========== + log.info(`[step 6/6] 验证发布状态`) + const checkResp = await c.get<{ list?: Array<{ id: string; enabledMark?: number; status?: number; flowId?: string; enCode?: string }> }>('/workflow/template', { + keyword: enCode, currentPage: 1, pageSize: 5, + }) + const list = (checkResp.data as { list?: Array<{ id: string; enabledMark?: number; status?: number; flowId?: string; enCode?: string }> } | undefined)?.list || [] + const item = list[0] + if (!item) { + log.warn(` ↳ ⚠️ 发布后未找到流程, 请手动检查 (templateId=${templateId})`) + } else { + const enabled = item.enabledMark === 1 ? '✓' : '✗' + const status = item.status === 1 ? '上架' : item.status === 0 ? '未上架' : item.status + log.ok(` ↳ enabledMark=${enabled} (1=启用) status=${item.status} (${status}) flowId=${item.flowId || versionId}`) + } + + // enCode 可能被 JNPF 流水号改 + const actualEnCode = item?.enCode || enCode + if (actualEnCode !== enCode) { + log.warn(` ↳ JNPF 后端未采用用户传的 enCode, 实际 = ${actualEnCode} (JNPF 流水号机制)`) + } + + // auto-authorize if (opts.autoAuthorize) { - log.info(`--auto-authorize: 给当前角色授权 workflow (id=${newId})`) + log.info(`--auto-authorize: 给当前角色授权 workflow (id=${templateId})`) try { - // 通用 authorize 端点 (JNPF /permission/authorize + itemType=workflow) - const ar = await c.postJson('/permission/authorize', { - objectType: 'flow', - objectId: newId, - }) - if (ar.code === 200) { - log.ok(`✓ 已授权给当前角色 (workflow id=${newId})`) - } else { - log.warn(`--auto-authorize 部分失败: ${ar.msg} (workflow 已创建, 可在权限管理手动授权)`) - } + const ar = await c.postJson('/permission/authorize', { objectType: 'flow', objectId: templateId }) + if (ar.code === 200) log.ok(` ↳ ✓ 已授权给当前角色`) + else log.warn(` ↳ --auto-authorize 部分失败: ${ar.msg}`) } catch (e) { - log.warn(`--auto-authorize 异常: ${(e as Error).message?.slice(0, 100)} (workflow 已创建)`) + log.warn(` ↳ --auto-authorize 异常: ${(e as Error).message?.slice(0, 100)}`) } } - // BS-新6 (jxcj 2026-06-30): auto-enable 默认 ON - // workflow create 之后 enabledMark=0,flowId=null. 调 PUT /workflow/template/{id} --enabledMark=1 生成 flowId. - // 镜像 web Actions/Module 流程版本行为, 不再让用户手动跑两次. - let flowIdResolved: string | null = null - if (opts.autoEnable !== false) { - try { - const ur = await c.putJson<{ code?: number; msg?: string; data?: { flowId?: string } }>( - `/workflow/template/${newId}`, - { - id: newId, - enabledMark: 1, - ...(opts.startFormId ? { startFormId: opts.startFormId } : {}), - }, - ) - if (ur.code === 200) { - flowIdResolved = ur.data?.flowId || newId - log.ok( - `BS-新6: 已自动 enabledMark=1 (生成 flowId=${flowIdResolved}, 绑 startFormId=${ - opts.startFormId || '(none)' - })`, - ) - } else { - log.warn( - `BS-新6 auto-enable 部分失败: ${ur.msg} (workflow 已创建, 可手动 \`dacli workflow update --id=${newId} --enabledMark=1\`)`, - ) - } - } catch (e) { - log.warn( - `BS-新6 auto-enable 异常: ${(e as Error).message?.slice(0, 100)} (workflow 已创建, 可手动 enable)`, - ) - } - } - if (opts.json) + + // 输出 + log.ok(`\n✅ 6 步 webapi 路径完成`) + log.info(` templateId: ${templateId}`) + log.info(` enCode: ${actualEnCode}`) + log.info(` flowId: ${item?.flowId || versionId} (← 可直接用于 dacli workflow launch)`) + log.info(` 后续:`) + log.info(` - 发起: dacli workflow launch --flowId=${item?.flowId || versionId} --formId={startFormId} --data='{...}'`) + log.info(` - 详情: dacli workflow info --id=${templateId}`) + + if (opts.json) { printJson({ - id: newId, - enCode: opts.enCode, - flowId: flowIdResolved || newId, - flowXml: opts.flowXml, + id: templateId, + enCode: actualEnCode, + fullName: opts.fullName, + flowId: item?.flowId || versionId, + versionId, + flowXml, + flowNodes, + enabledMark: item?.enabledMark || 1, + status: item?.status || 1, }) + } }) installAiHelpHook(cmd, { - purpose: '新建流程模板. --ai "<描述>" 走平台 LLM 自动生成 BPMN xml (白皮书 5.10.3). v0.11d+ 加 step machine 校验 (3 step 镜像 web flowEngine/Form.vue + 后端 TemplateController.create, 聚合错误)', - required: { '--fullName | --ai': '中文名, 或传 --ai 由平台 AI 自动生成' }, + purpose: '新建流程模板 (v0.12+ BS-新27: 6 步 webapi 路径, 镜像 web AiCreateModal 端到端可用)', + required: { '--fullName': '中文名', '--category': '分类 id 或中文' }, optional: { - '--enCode': '英文编码 (--ai 自动填)', - '--category': '分类 id', - '--type': '0=标准 1=简流 (v0.11 与后端 TemplateCrForm.java:type 对齐)', - '--flowXml': 'BPMN xml (--ai 自动填)', - '--flowNodes': '节点结构 JSON', - '--flowConfig': '流程配置 JSON', - '--ai': '白皮书 5.10.3 AI 创建流程 — 自然语言描述生成 BPMN', + '--enCode': '英文编码 (缺时从 fullName 生成 snake_case)', + '--type': '0=标准 1=简流 (默认 0)', + '--flowXml': 'BPMN xml (--ai 自动填; 用户直传跳过 AI)', + '--startFormId': '绑定的 formId (绑到 start 节点, 镜像 web 选表单步骤)', + '--ai': 'AI 创建流程 — 自然语言描述, 走 web 端 getAiInfo 拿 flowXml', + '--auto-authorize': '创建后自动给当前角色授权', }, example: [ - 'dacli workflow create --fullName="请假流程" --enCode=leave_flow --type=0 --flowXml=\'\'', - 'dacli workflow create --ai "员工请假, 直属领导审批, HR 备案"', + 'dacli workflow create --fullName="请假流程" --category="项目管理" --ai "员工请假, 直属领导审批, HR 备案"', + 'dacli workflow create --fullName="出差申请" --category="项目管理" --ai "出差申请:申请→部门经理→总经理→结束" --startFormId=841768605497428101', + 'dacli workflow create --fullName="数据申请" --category="项目管理" --flowXml=\'\'', ], source: { - web: 'web/.../onlineDev/flowEngine/Form.vue (后端: jnpf/.../TemplateController.java:268-276)', - api: 'POST /api/workflow/template | POST /api/workflow/ai', - ref: '白皮书 5.6.1-5.6.5 (流程设计) + 5.10.3 (AI 创建流程) + web formValidate.ts:24-28 (enCode 正则)', + web: 'web/.../onlineDev/flowEngine/components/AiCreateModal.vue + DesignForm.vue', + api: 'POST /api/workflow/ai | POST /api/workflow/template | POST /api/workflow/template/Save', + ref: 'web/.../FlowProcess/src/helper/config.ts:13-58 defaultGlobalForm + web/.../FlowProcess/src/index.vue:73-200 getData', }, notes: [ - 'v0.11d+ step machine (镜像 web flowEngine/Form.vue:31-106 schemas + L125-150 handleSubmit):', - ' step 0 基础信息: fullName 必填 + enCode 正则 + category 必填 + icon 必填 + showType ∈ {0,1,2}', - ' step 1 流程图: flowXml 必填 + 合法 BPMN XML + flowNodes Map 格式 + 节点完整性 (BPMN 标准 start+end)', - ' step 2 唯一性: enCode 不重复 (后端不查, 必须预校验) + category 合法', - 'flowXml 是 BPMN 2.0 XML, --ai 会从平台 LLM 拿', - 'AI 生成的流程需在浏览器里手动调整节点位置 + 表单绑定', - '5.10.4 (AI 咨询助手) 暂未集成 — free-form Q&A 无自然挂载点, 留 v0.10+ 评估', - '5.10.5 (AI 模型配置) 走 dacli integration model (P2 已有)', + 'v0.12+ BS-新27 关键修复 (jxcj 2026-07-01 验证 LC20260701000003):', + ' 1. --ai → web getAiInfo 拿 flowXml (避免 dacli 自写 LLM prompt 漂移)', + ' 2. POST /workflow/template (空 flowNodes)', + ' 3. GET /workflow/template/Version/{id} 拿 versionId', + ' 4. buildFlowNodes 注入 defaultGlobalForm (镜像 web FlowProcess.getData())', + ' 5. POST /workflow/template/Save type=1 (关键: 真正发布+部署, 不是 UpDownShelf)', + ' 6. 验证 status + enabledMark', + '关键: Save type=1 才会设 flowableId + flowId, UpDownShelf 只改 status', + '关键: flowNodes 必须含 global 节点, 后端 FlowUtil:2134 必查 global.getTitleType', + 'enCode 缺时自动从 fullName 生成 snake_case (中文 → 拼音待 v0.13+, 暂用 _ 替换)', ], }) return cmd @@ -284,14 +272,6 @@ export function buildWorkflowCreateCommand(): Command { /** * v0.11d+ step machine 校验 (3 步镜像 web flowEngine/Form.vue + 后端 TemplateController.create) - * 在发 API 前暴露问题, 聚合错误一次报 - * - * 镜像原型: - * - web flowEngine/Form.vue:31-106 schemas 6 字段 (fullName/enCode/category/icon) - * - web flowEngine/Form.vue:125-150 handleSubmit (validate + create API) - * - web flowEngine/components/AiCreateModal.vue:36-41 (同 4 必填) - * - web packages/jnpf/utils/src/helpers/formValidate.ts:24-28 (enCode 正则, 同 menu 修复) - * - jnpf/.../flowable/controller/TemplateController.java:268-276 (create 端点) */ async function runWorkflowStepMachine( c: JnpfClient, @@ -302,23 +282,17 @@ async function runWorkflowStepMachine( icon?: string showType?: string flowXml?: string - flowNodes?: string }, ): Promise { - // 1. 拉已存在 enCode 列表 (供 step 2 唯一性预校验, 容错: 拉失败跳过) let existingEnCodes: string[] = [] try { const r = await c.get<{ data?: { list?: Array<{ enCode: string }> } }>('/workflow/template', { - currentPage: 1, - pageSize: 1000, + currentPage: 1, pageSize: 1000, }) const list = (r.data as { list?: Array<{ enCode: string }> })?.list || [] existingEnCodes = list.map((t) => t.enCode).filter(Boolean) - } catch { - // 拉列表失败不阻断 (step 2 跳过查重) - } + } catch { /* skip */ } - // 2. 跑 3 step 校验 const result = validateWorkflowCreate({ fullName: opts.fullName, enCode: opts.enCode, @@ -326,11 +300,8 @@ async function runWorkflowStepMachine( icon: opts.icon, showType: opts.showType ? Number(opts.showType) : undefined, flowXml: opts.flowXml, - flowNodes: opts.flowNodes, existingEnCodes, }) - - // 3. 输出结果 (聚合错误 / 全部通过) if (!result.ok) { const allErrors = result.steps.flatMap((s) => s.errors.map((e) => ({ step: s.step, stepName: s.stepName, ...e })), @@ -341,6 +312,5 @@ async function runWorkflowStepMachine( } process.exit(1) } - log.info(`✓ step machine 校验通过 (3/3): enCode=${opts.enCode}`) }