P0:
- P0-1: relationForm auto-injection 增强 (camelCase + 大小写不敏感匹配)
- P0-2: real-data 模式也跑 join (testMarker 永远注入, --no-keep-data 清理)
- P0-3: workflow bindFlow 持久化验证 (GET 验证 onLineformId, 失败明确提示)
P1:
- P1-4: workflow --ai 返回实际 enCode (JNPF 流水号机制, 警告)
- P1-5: 字典冲突加建议 (jxcj{原名} 前缀)
- P1-6: verify 默认 warn (form 已发布不阻断)
P2:
- P2-8: menu list --include-actions 默认 ON (含 form-driven 子菜单)
- P2-9: AiFormModel 扩展 dictionaryType/unique/billRule (web 端消费待 web-patches)
- P2-11: dacli doc Node 兼容 (已修复或原本 OK)
Co-Authored-By: Claude <[email protected]>
300 lines
14 KiB
TypeScript
300 lines
14 KiB
TypeScript
/**
|
|
* commands/workflow/create.ts — 新建流程模板
|
|
*
|
|
* API: POST /api/workflow/template body=TemplateNodeCrFrom
|
|
* - {fullName, enCode, category, type, flowXml, flowNodes, flowConfig, ...}
|
|
* - v0.11: 与后端 TemplateCrForm.java 字段名 1:1 对齐 (type/iconBackground/showType)
|
|
*
|
|
* AI 集成 (白皮书 5.10.3): --ai "<描述>" 调用 POST /api/workflow/ai,
|
|
* LLM 返回 flowXml, 自动塞进 body。
|
|
*/
|
|
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 { validateWorkflowCreate } from './_validate.ts'
|
|
import { enhanceFromBackend, formatErrorLine } from '../_error_codes.ts'
|
|
|
|
interface CreateOpts {
|
|
fullName?: string
|
|
enCode?: string
|
|
category?: string
|
|
/** v0.11 修复: 后端字段名是 `type` (TemplateCrForm.java:19), dacli 旧称 flowType 错配 */
|
|
type?: string
|
|
/** v0.11e+ Phase B2: auto-authorize */
|
|
autoAuthorize?: boolean
|
|
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 */
|
|
ai?: string
|
|
}
|
|
|
|
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 自动填)')
|
|
.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)
|
|
.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 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} 字符`)
|
|
}
|
|
// 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 前暴露问题, 聚合错误一次报
|
|
await runWorkflowStepMachine(c, {
|
|
fullName: opts.fullName,
|
|
enCode: opts.enCode,
|
|
category: opts.category,
|
|
icon: opts.icon,
|
|
showType: opts.showType,
|
|
flowXml: opts.flowXml,
|
|
flowNodes: opts.flowNodes,
|
|
})
|
|
const body: Record<string, unknown> = {
|
|
fullName: opts.fullName,
|
|
enCode: opts.enCode,
|
|
category: opts.category || null,
|
|
// v0.11 修复: 与后端 TemplateCrForm.java:type 对齐 (旧称 flowType)
|
|
type: Number(opts.type ?? '0'),
|
|
flowXml: opts.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)
|
|
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}`)
|
|
|
|
// v0.11e+ Phase B2: auto-authorize (镜像 web 流程创建后自动授权给当前角色)
|
|
if (opts.autoAuthorize) {
|
|
log.info(`--auto-authorize: 给当前角色授权 workflow (id=${newId})`)
|
|
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 已创建, 可在权限管理手动授权)`)
|
|
}
|
|
} catch (e) {
|
|
log.warn(`--auto-authorize 异常: ${(e as Error).message?.slice(0, 100)} (workflow 已创建)`)
|
|
}
|
|
}
|
|
if (opts.json) printJson({ id: newId, enCode: opts.enCode, flowXml: opts.flowXml })
|
|
})
|
|
|
|
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 自动生成' },
|
|
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',
|
|
},
|
|
example: [
|
|
'dacli workflow create --fullName="请假流程" --enCode=leave_flow --type=0 --flowXml=\'<?xml...>\'',
|
|
'dacli workflow create --ai "员工请假, 直属领导审批, HR 备案"',
|
|
],
|
|
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 正则)',
|
|
},
|
|
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 已有)',
|
|
],
|
|
})
|
|
return cmd
|
|
}
|
|
|
|
/**
|
|
* 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,
|
|
opts: {
|
|
fullName?: string
|
|
enCode?: string
|
|
category?: string
|
|
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,
|
|
})
|
|
const list = (r.data as { list?: Array<{ enCode: string }> })?.list || []
|
|
existingEnCodes = list.map((t) => t.enCode).filter(Boolean)
|
|
} catch {
|
|
// 拉列表失败不阻断 (step 2 跳过查重)
|
|
}
|
|
|
|
// 2. 跑 3 step 校验
|
|
const result = validateWorkflowCreate({
|
|
fullName: opts.fullName,
|
|
enCode: opts.enCode,
|
|
category: opts.category,
|
|
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 })),
|
|
)
|
|
log.error(`✗ step machine 校验失败 (${allErrors.length} 个错误):`)
|
|
for (const e of allErrors) {
|
|
log.error(` [step ${e.step} ${e.stepName}] ${e.field || '?'}: ${e.message}`)
|
|
}
|
|
process.exit(1)
|
|
}
|
|
|
|
log.info(`✓ step machine 校验通过 (3/3): enCode=${opts.enCode}`)
|
|
}
|