auto(284e8d004cbb): session end @ 2026-07-01T11:43:19 (+1f)
This commit is contained in:
1 parent
12f4f7eedc
commit
3257ce35b6
1 file changed
+192
-222
+192
-222
@@ -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}`)
|
||||
}
|
||||
Reference in new issue
Block a user