auto(284e8d004cbb): session end @ 2026-07-01T11:43:19 (+1f)

This commit is contained in:
ssw committed 2026-07-01 11:43:19 +08:00
1 parent 12f4f7eedc
commit 3257ce35b6
1 file changed
+192 -222
+192 -222
View File
@@ -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 <n>', '中文名 (--ai 自动填, 否则必填)')
.option('--enCode <e>', '英文编码 (--ai 自动填, 否则必填)')
.option('--category <c>', '分类 id (workflow list 看真实值)')
// v0.11 修复: 与后端 TemplateCrForm.java:type 对齐 (0=标准 1=简流)
.option('--type <t>', '流程类型 (0=标准 1=简流, 默认 0=标准)', '0')
.option('--flowXml <xml>', 'BPMN xml (--ai 自动填, 否则必填)')
.option('--flowNodes <json>', 'flowNodes JSON 字符串 (节点结构, --ai 自动填)')
.description('新建流程模板 (6 步 webapi 路径: AI → create → version → buildFlowNodes(含global) → save(type=1 部署))')
.option('--fullName <n>', '中文名 (必填)')
.option('--enCode <e>', '英文编码 (必填或 auto: 从 fullName 生成 snake_case)')
.option('--category <c>', '分类 id (必填, 跑 `dacli workflow selector` 看真实值, 或直接传中文 "项目管理")')
.option('--type <t>', '流程类型 (0=标准 1=简流, 默认 0)', '0')
.option('--flowXml <xml>', 'BPMN xml (--ai 自动填; 用户直传跳过 AI)')
.option('--flowConfig <json>', 'flowConfig JSON 字符串')
.option('--iconBackground <color>', '图标背景色 (默认 #108ee9)', '#108ee9')
// v0.11d+ 镜像 web flowEngine/Form.vue:70-75 icon 必填
.option('--icon <i>', '流程图标 (默认 icon-ym icon-ym-flow)', 'icon-ym icon-ym-flow')
// v0.11 修复: 后端 showType (TemplateCrForm.java:42)
.option('--showType <n>', '显示位置 (0=全局 1=流程 2=菜单, 默认 0)', '0')
.option('--ai <desc>', '白皮书 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 <id>', 'BS-新6: 绑定的 formId (同时给 start node formId, 默认从 menu/url 推)')
.option('--startFormId <id>', '绑定的 formId (绑到 start 节点 formId, 镜像 web 选表单步骤)')
.option('--ai <desc>', '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<string, unknown> = {
// ========== 3. create template (空 flowNodes, 跟 web 一致) ==========
log.info(`[step 2/6] POST /workflow/template (空 flowNodes, 跟 web AiCreateModal 一致)`)
const createBody: Record<string, unknown> = {
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<unknown>('/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<unknown>('/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>` 字符串, 不是 `{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<Array<{ id: string; state?: number }>>(`/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<unknown>('/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=\'<?xml...>\'',
'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=\'<?xml...>\'',
],
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<void> {
// 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}`)
}