chore(dacli): clean comment violations batch 2 (5 files)
Files: form/_validate.ts, di/create.ts, form/_ai.ts, workflow/create.ts, dict/_validate.ts Co-Authored-By: Claude <[email protected]>
This commit is contained in:
1 parent
42e596aecc
commit
cbeb429a6d
5 files changed
+220
-268
No files matched your search
+27
-31
@@ -1,16 +1,14 @@
|
||||
/**
|
||||
* commands/di/create.ts — 新建数据接口
|
||||
*
|
||||
* v0.11d+ Phase di: webapi 化 + step machine 校验
|
||||
* Phase di: webapi 化 + step machine 校验
|
||||
* 镜像 web dataInterface/Form.vue handleSubmit (L271-272) + 后端 DataInterfaceController.create (L246-262)
|
||||
* 复用 _validate.ts 镜像校验 (enCode 无正则, type 1/2/3, 联动 action)
|
||||
*
|
||||
* 关键差异 (vs menu/dict/role):
|
||||
* - web 端 enCode **无 formValidate 正则** (只必填+maxlength 50), 镜像
|
||||
* - type 1=SQL/2=静态/3=API (3 种, 不是 11 种 menu 类型)
|
||||
* - type=1 时 action 必填 (1=增/2=改/3=查/4=删)
|
||||
* - type=2/3 时 hasPage 不合理 (镜像 web ifShow 警告)
|
||||
* - 后端 containsSensitive (type=1+action=3) 暂不镜像, 后端会查
|
||||
* - web 端 enCode **无 formValidate 正则** (只必填+maxlength 50), 镜像
|
||||
* - type 1=SQL/2=静态/3=API (3 种, 不是 11 种 menu 类型)
|
||||
* - type=1 时 action 必填 (1=增/2=改/3=查/4=删)
|
||||
* - type=2/3 时 hasPage 不合理 (镜像 web ifShow 警告)
|
||||
* - 后端 containsSensitive (type=1+action=3) 暂不镜像, 后端会查
|
||||
*/
|
||||
import { Command } from 'commander'
|
||||
import { JnpfClient } from '../../core/client.ts'
|
||||
@@ -33,9 +31,9 @@ interface CreateOpts {
|
||||
hasPage?: string
|
||||
isPostPosition?: string
|
||||
description?: string
|
||||
// v0.15+ (R3.3): --from-json-file 提供完整 schema, 替代空 placeholder
|
||||
// --from-json-file 提供完整 schema, 替代空 placeholder
|
||||
fromJsonFile?: string
|
||||
// v0.15+ Round 10 BS-drift-DI-1/2/3 fix: 单独传 schema JSON 字段, 透传 baseline fieldJson/parameterJson/dataConfigJson
|
||||
// Round 10 单独传 schema JSON 字段, 透传 baseline fieldJson/parameterJson/dataConfigJson
|
||||
fieldJson?: string
|
||||
parameterJson?: string
|
||||
dataConfigJson?: string
|
||||
@@ -55,9 +53,9 @@ export function buildDiCreateCommand(): Command {
|
||||
.option('--hasPage <0|1>', '分页 (默认 0, type=3 常用)')
|
||||
.option('--isPostPosition <0|1>', '鉴权 (默认 0)', '0')
|
||||
.option('--description <d>', '说明')
|
||||
// v0.15+ (R3.3): 用户/web 测试场提供完整 schema, 替代空 placeholder (false success 修复)
|
||||
// 用户/web 测试场提供完整 schema, 替代空 placeholder (false success 修复)
|
||||
.option('--from-json-file <f>', '从 JSON 文件读取完整 body (含 dataConfigJson/fieldJson/parameterJson 等, 替代空 placeholder)')
|
||||
// v0.15+ Round 10 BS-drift-DI-1/2/3 fix: 单独透传 baseline schema (避免 --from-json-file 整包传)
|
||||
// Round 10 单独透传 baseline schema (避免 --from-json-file 整包传)
|
||||
.option('--fieldJson <json>', '字段映射 JSON 数组字符串 (BS-drift-DI-1 修, 透传 baseline fieldJson)')
|
||||
.option('--parameterJson <json>', '参数映射 JSON 数组字符串 (BS-drift-DI-2 修, 透传 baseline parameterJson)')
|
||||
.option('--dataConfigJson <json>', '数据源配置 JSON 字符串 (BS-drift-DI-3 修, 透传 baseline 真实 SQL/API 配置)')
|
||||
@@ -70,24 +68,24 @@ export function buildDiCreateCommand(): Command {
|
||||
const c = await JnpfClient.fromToken()
|
||||
await initWebapi(c)
|
||||
|
||||
// v0.21+ (Round 12 BS-新38): enCode 含 `-`/`_` 自动 strip + WARN (即便 web DI 不强制, 但 cross-mod 一致)
|
||||
// (Round 12 enCode 含 `-`/`_` 自动 strip + WARN (即便 web DI 不强制, 但 cross-mod 一致)
|
||||
const _encStrip = autoStripEnCode(opts.enCode)
|
||||
if (_encStrip.wasStriped) {
|
||||
log.warn(`! autoStrip enCode: ${_encStrip.original} → ${_encStrip.value} (BS-新38, 下次别用 - 或 _)`)
|
||||
opts.enCode = _encStrip.value
|
||||
}
|
||||
|
||||
// v0.21+ (Round 12 BS-新38): fullName 含 `-` 软化 (用 · 替代, 同 dict)
|
||||
// (Round 12 fullName 含 `-` 软化 (用 · 替代, 同 dict)
|
||||
if (opts.fullName && /[-—–_]/.test(opts.fullName)) {
|
||||
const softened = String(opts.fullName).replace(/[-—–_]/g, '·')
|
||||
log.warn(`! fullName 含特殊符号 - 自动 soften: ${opts.fullName} → ${softened} (BS-新38)`)
|
||||
opts.fullName = softened
|
||||
}
|
||||
|
||||
// v0.11d+ Phase di: step machine 校验 (复用 _validate.ts)
|
||||
// Phase di: step machine 校验 (复用 _validate.ts)
|
||||
await runDiStepMachineCreate(c, opts)
|
||||
|
||||
// v0.15+ (R3.3): --from-json-file 优先, 直接读完整 body
|
||||
// --from-json-file 优先, 直接读完整 body
|
||||
if (opts.fromJsonFile) {
|
||||
const { readFileSync, existsSync } = await import('node:fs')
|
||||
if (!existsSync(opts.fromJsonFile)) {
|
||||
@@ -135,7 +133,7 @@ export function buildDiCreateCommand(): Command {
|
||||
sortCode: Number(opts.sortCode || '0'),
|
||||
enabledMark: Number(opts.enabledMark || '1'),
|
||||
isPostPosition: Number(opts.isPostPosition || '0'),
|
||||
// BS-17 fix: web 端 MyBatis-Plus 拦截器用 f_delete_mark 列做 tenant 隔离,
|
||||
// web 端 MyBatis-Plus 拦截器用 f_delete_mark 列做 tenant 隔离,
|
||||
// 默认填 0 (不删除). dacli 必须显式给, 否则 mapper insertOrUpdate 后 list 看不见
|
||||
deleteMark: 0,
|
||||
tenantId: '0',
|
||||
@@ -143,10 +141,10 @@ export function buildDiCreateCommand(): Command {
|
||||
if (opts.action !== undefined) body.action = Number(opts.action)
|
||||
if (opts.hasPage !== undefined) body.hasPage = Number(opts.hasPage)
|
||||
if (opts.description) body.description = opts.description
|
||||
// BS-17 fix (2026-06-27): 镜像 web Form.vue:484-491 handleSubmit 完整 schema
|
||||
// fix : 镜像 web Form.vue:484-491 handleSubmit 完整 schema
|
||||
// 必传 fieldJson/parameterJson/dataCountJson/dataEchoJson/dataJsJson/dataExceptionJson, 否则后端 AD102
|
||||
// dataConfigJson 默认静态数据 (type=2), 后端会按 type 选择处理
|
||||
// v0.15+ Round 10 BS-drift-DI-1/2/3 fix: --fieldJson/--parameterJson/--dataConfigJson 透传 baseline 真实配置
|
||||
// Round 10 --fieldJson/--parameterJson/--dataConfigJson 透传 baseline 真实配置
|
||||
// 完整数据源 (SQL/API) 配置需要更详细的 JSON
|
||||
const defaultApiData = { method: 1, url: '', header: [], query: [], body: '', bodyType: 0 }
|
||||
const defaultSqlData = { dbLinkId: '', sql: '' }
|
||||
@@ -172,7 +170,7 @@ export function buildDiCreateCommand(): Command {
|
||||
}
|
||||
if (r.code !== 200 && r.code !== undefined) {
|
||||
log.error(`di create 失败 (code=${r.code}): ${r.msg}`)
|
||||
// v0.11e+ Phase A1: 后端错误增强 — 自动从 msg 提取 ErrorCode
|
||||
// Phase A1: 后端错误增强 — 自动从 msg 提取 ErrorCode
|
||||
const enhanced = enhanceFromBackend(r.msg || '', 'di', { entity: 'di' })
|
||||
log.error(` ${formatErrorLine(enhanced, { step: 2, stepName: '后端API' })}`)
|
||||
if (opts.json) printJson(r)
|
||||
@@ -180,7 +178,7 @@ export function buildDiCreateCommand(): Command {
|
||||
}
|
||||
let newId = (r.data as { id?: string })?.id
|
||||
if (!newId) {
|
||||
// v0.21+ (Round 12 BS-新43): 用共享 _lookup.ts 替代 inline list fallback
|
||||
// (Round 12 用共享 _lookup.ts 替代 inline list fallback
|
||||
newId = (await lookupDataInterfaceIdByEnCode(opts.enCode)) || undefined
|
||||
}
|
||||
log.ok(`✓ DI 创建成功 id=${newId || '(unknown)'} enCode=${opts.enCode}`)
|
||||
@@ -226,28 +224,26 @@ export function buildDiCreateCommand(): Command {
|
||||
}
|
||||
|
||||
/**
|
||||
* v0.11d+ Phase di: di create step machine 校验 (3 步镜像, 复用 _validate.ts)
|
||||
* Phase di: di create step machine 校验 (3 步镜像, 复用 _validate.ts)
|
||||
* 在发 API 前暴露问题, 聚合错误一次报
|
||||
*/
|
||||
async function runDiStepMachineCreate(
|
||||
c: JnpfClient,
|
||||
opts: CreateOpts,
|
||||
): Promise<void> {
|
||||
// 1. 拉全 DI 列表 (供 step 2 唯一性预校验, BS-47)
|
||||
// v0.15+ (P0-8) 走 webapi/getDataInterfaceList, 替代 c.get
|
||||
// v0.21+ (Round 12 fix BS-新39): **不要** filter `category='30be5ef4...'`
|
||||
// 旧: 硬编码只看一个 category, 跨 category 的 enCode 重复检测不到, 后端返 "name cannot be repeated" (BS-新39)
|
||||
// 新: 不带 category filter, 平台全扫, 跟 dict/menu/role 一致 (BS-47 是全平台唯一, 不是分类内唯一)
|
||||
// 1. 拉全 DI 列表 (供 step 2 唯一性预校验, // (P0-8) 走 webapi/getDataInterfaceList, 替代 c.get
|
||||
// (Round 12 fix **不要** filter `category='30be5ef4...'`
|
||||
// 旧: 硬编码只看一个 category, 跨 category 的 enCode 重复检测不到, 后端返 "name cannot be repeated" ( // 新: 不带 category filter, 平台全扫, 跟 dict/menu/role 一致 (是全平台唯一, 不是分类内唯一)
|
||||
let existingDIs: Array<{ fullName?: string; enCode?: string; id?: string }> = []
|
||||
try {
|
||||
const r = (await getDataInterfaceList({
|
||||
currentPage: 1,
|
||||
pageSize: 1000,
|
||||
// 不带 category — 全平台扫 (Round 12 BS-新39 修复)
|
||||
// 不带 category — 全平台扫 (Round 12 修复)
|
||||
})) as { data?: { list?: Array<any> } } | unknown
|
||||
// v0.21+ R15 fix (BS-新47): getDataInterfaceList webapi 已 unwrap .data, 返 {pagination,list} 直返
|
||||
// 旧: r.data?.list — 全空, BS-47 全平台唯一性预校验失效 (但 BS-新39 + 跨 cat 仍生效, 旧版本 BS-47 hit 0)
|
||||
// 新: r.list — 直接拿 list
|
||||
// fix (getDataInterfaceList webapi 已 unwrap .data, 返 {pagination,list} 直返
|
||||
// 旧: r.data?.list — 全空, 全平台唯一性预校验失效 (但 + 跨 cat 仍生效, 旧版本 hit 0)
|
||||
// 新: r.list — 直接拿 list
|
||||
const list = ((r as { list?: Array<any> })?.list) || []
|
||||
existingDIs = list.map((d: any) => ({
|
||||
fullName: d.fullName,
|
||||
|
||||
@@ -1,35 +1,29 @@
|
||||
/**
|
||||
* commands/dict/_validate.ts — dict typeCreate step machine 校验
|
||||
*
|
||||
* 镜像 web sysData/dictionary/components/Form.vue handleSubmit (L102-124) + 后端 DictionaryTypeController create (L186-204) 的前端校验
|
||||
* 让 dacli dict typeCreate 在发 API 之前暴露问题, AI 不用去浏览器试错
|
||||
*
|
||||
* 设计原则 (2026-06-26 v0.11d+):
|
||||
* - 不是复刻 web UI 行为 (drag/drop/click), 而是 mirror JNPF 业务规则
|
||||
* 设计原则 * - 不是复刻 web UI 行为 (drag/drop/click), 而是 mirror JNPF 业务规则
|
||||
* - 跟 form/menu/dm/workflow _validate.ts 模式一致
|
||||
* - 校验通过 → 1 次 create API call
|
||||
*
|
||||
* step 镜像对应:
|
||||
* step 0: 基础信息 (镜像 web Form.vue:22-67 schemas + L102-124 handleSubmit)
|
||||
* - parentId 必填 (顶级 "0" / "1")
|
||||
* - fullName 必填 + formValidate('fullName') + maxlength 50
|
||||
* - enCode 必填 + formValidate('enCode') + maxlength 50
|
||||
* - isTree ∈ {0,1}
|
||||
* - sortCode 0-999999
|
||||
* step 1: 全平台唯一性 (镜像后端 DictionaryTypeController.java:196-201 BS-47)
|
||||
* - enCode 全平台唯一 → EXIST002 (BS-47 重点)
|
||||
* - fullName 全平台唯一 → EXIST001
|
||||
* step 2: 字典项 items 校验 (镜像后端 DictionaryDataController, BS-41)
|
||||
* - items 数组 (如果传) ≥ 1
|
||||
* - 每个 item enCode/fullName 必填
|
||||
* - item enCode 不重复
|
||||
* step 0: 基础信息 (镜像 web Form.vue:22-67 schemas + L102-124 handleSubmit)
|
||||
* - parentId 必填 (顶级 "0" / "1")
|
||||
* - fullName 必填 + formValidate('fullName') + maxlength 50
|
||||
* - enCode 必填 + formValidate('enCode') + maxlength 50
|
||||
* - isTree ∈ {0,1}
|
||||
* - sortCode 0-999999
|
||||
* step 1: 全平台唯一性 (镜像后端 DictionaryTypeController.java:196-201 * - enCode 全平台唯一 → EXIST002 (重点)
|
||||
* - fullName 全平台唯一 → EXIST001
|
||||
* step 2: 字典项 items 校验 (镜像后端 DictionaryDataController, * - items 数组 (如果传) ≥ 1
|
||||
* - 每个 item enCode/fullName 必填
|
||||
* - item enCode 不重复
|
||||
*/
|
||||
|
||||
export interface ValidationError {
|
||||
field?: string
|
||||
message: string
|
||||
/** v0.11e+: ErrorCode (镜像后端 MsgCode.java, AI 能查表)
|
||||
* 复刻 _error_codes.ts 的 ValidationError 字段, 让 step machine 输出格式统一 */
|
||||
/** ErrorCode (镜像后端 MsgCode.java, AI 能查表)
|
||||
* 复刻 _error_codes.ts 的 ValidationError 字段, 让 step machine 输出格式统一 */
|
||||
code?: string
|
||||
}
|
||||
|
||||
@@ -49,13 +43,12 @@ export interface DictItemLite {
|
||||
}
|
||||
|
||||
/** enCode 正则 — 镜像 web packages/jnpf/utils/src/helpers/formValidate.ts:24-28
|
||||
* v0.11h+ (2026-06-28): 改用共享 _encode_validator.ts (BS-56 增强: 自动建议别名)
|
||||
* 改用共享 _encode_validator.ts (增强: 自动建议别名)
|
||||
*/
|
||||
import { ENCODE_REGEXP, FULLNAME_REGEXP } from '../_encode_validator.ts'
|
||||
|
||||
/**
|
||||
* step 0: 基础信息校验
|
||||
*
|
||||
* 镜像 web sysData/dictionary/components/Form.vue:22-67 schemas
|
||||
*/
|
||||
export function validateBasicInfo(opts: {
|
||||
@@ -91,7 +84,7 @@ export function validateBasicInfo(opts: {
|
||||
} else if (String(opts.enCode).length > 50) {
|
||||
errors.push({ field: 'enCode', message: '字典编码不能超过 50 个字符' })
|
||||
} else if (!ENCODE_REGEXP.test(String(opts.enCode))) {
|
||||
// v0.11h+ (2026-06-28) BS-56 增强: 清晰信息 + 自动建议别名
|
||||
// 增强: 清晰信息 + 自动建议别名
|
||||
const suggested = String(opts.enCode).replace(/[_\-]/g, '')
|
||||
errors.push({
|
||||
field: 'enCode',
|
||||
@@ -126,12 +119,9 @@ export function validateBasicInfo(opts: {
|
||||
|
||||
/**
|
||||
* step 1: 全平台唯一性预校验
|
||||
*
|
||||
* 镜像后端 DictionaryTypeController.java:196-201
|
||||
* - isExistByFullName → EXIST001 (BS-47)
|
||||
* - isExistByEnCode → EXIST002 (BS-47 重点)
|
||||
*
|
||||
* BS-47 关键: 字典 enCode/fullName 全平台唯一, 跨 app
|
||||
* - isExistByFullName → EXIST001 ( * - isExistByEnCode → EXIST002 (重点)
|
||||
* 关键: 字典 enCode/fullName 全平台唯一, 跨 app
|
||||
*/
|
||||
export function validateUniqueness(opts: {
|
||||
fullName?: string
|
||||
@@ -148,19 +138,19 @@ export function validateUniqueness(opts: {
|
||||
if (opts.fullName) {
|
||||
const dup = opts.existingTypes.find((t) => t.fullName === opts.fullName)
|
||||
if (dup) {
|
||||
// 修复 (2026-06-29 jxcj P1-5): 冲突时建议加 appCode 前缀 (如 "jxcj所属行业" 而非 "所属行业")
|
||||
// appCode 启发: enCode 中有 `jxcj.` 前缀 或 fullName 中有 `jxcj` 字样 → 是 jxcj app
|
||||
// 简化: 始终建议 "jxcj{原名}" (因为历史数据通常是平台级, app 用加前缀避免冲突)
|
||||
// 修复 冲突时建议加 appCode 前缀 (如 "jxcj所属行业" 而非 "所属行业")
|
||||
// appCode 启发: enCode 中有 `app.` 前缀 或 fullName 中有 `app` 字样 → 是 app app
|
||||
// 简化: 始终建议 "app{原名}" (因为历史数据通常是平台级, app 用加前缀避免冲突)
|
||||
const suggestedFullName = `jxcj${opts.fullName}`
|
||||
errors.push({ field: 'fullName', message: `字典名称"${opts.fullName}"已存在 (BS-47, 后端 EXIST001). 建议: --fullName="${suggestedFullName}" (加 appCode 前缀)`, code: 'EXIST001' })
|
||||
}
|
||||
}
|
||||
|
||||
// 镜像后端 L199-201 EXIST002 enCode 唯一 (BS-47 重点)
|
||||
// 镜像后端 L199-201 EXIST002 enCode 唯一 (重点)
|
||||
if (opts.enCode) {
|
||||
const dup = opts.existingTypes.find((t) => t.enCode === opts.enCode)
|
||||
if (dup) {
|
||||
// 修复 (2026-06-29 jxcj P1-5): enCode 冲突建议用 dot-separated 形式 (如 jxcj.industry 而非 industry)
|
||||
// 修复 enCode 冲突建议用 dot-separated 形式 (如 app.industry 而非 industry)
|
||||
const suggestedEnCode = `jxcj.${opts.enCode.replace(/^jxcj\./, '')}`
|
||||
errors.push({ field: 'enCode', message: `字典编码"${opts.enCode}"已存在 (BS-47, 后端 EXIST002). 建议: --enCode="${suggestedEnCode}" (加 appCode 前缀)`, code: 'EXIST002' })
|
||||
}
|
||||
@@ -176,11 +166,10 @@ export function validateUniqueness(opts: {
|
||||
|
||||
/**
|
||||
* step 2: 字典项 items 校验
|
||||
*
|
||||
* 镜像后端 DictionaryDataController (BS-41: TS 版 dict 只读, 但 items 必填校验必加)
|
||||
* - items 数组 ≥ 1 (如果传)
|
||||
* - 每个 item enCode/fullName 必填 + 正则
|
||||
* - item enCode 不重复
|
||||
* 镜像后端 DictionaryDataController (TS 版 dict 只读, 但 items 必填校验必加)
|
||||
* - items 数组 ≥ 1 (如果传)
|
||||
* - 每个 item enCode/fullName 必填 + 正则
|
||||
* - item enCode 不重复
|
||||
*/
|
||||
export function validateItems(opts: {
|
||||
items?: DictItemLite[]
|
||||
|
||||
+81
-102
@@ -1,42 +1,36 @@
|
||||
/**
|
||||
* _ai.ts — AI 端点 webapi 透传 (v0.13+ BS-新29)
|
||||
*
|
||||
* 设计 (2026-07-01 重构):
|
||||
* - 删 v0.11+ 的"双路径" (直连 LLM + NCPF backend), 全部走 NCPF backend
|
||||
* - 删 v0.11+ 的"自写 LLM prompt" (GEN_MODEL_QUESTION, GEN_FLOW_QUESTION)
|
||||
* - 删 v0.11+ 的"自写 LLM response 解析" (parseAiFormText, parseAiFlowText)
|
||||
* - 保留: NCPF backend 透传 + 类型定义 + printAiFormResult (--ai-field 用)
|
||||
*
|
||||
* _ai.ts — AI 端点 webapi 透传 ( * 设计 * - 删 的"双路径" (直连 LLM + NCPF backend), 全部走 NCPF backend
|
||||
* - 删 的"自写 LLM prompt" (GEN_MODEL_QUESTION, GEN_FLOW_QUESTION)
|
||||
* - 删 的"自写 LLM response 解析" (parseAiFormText, parseAiFlowText)
|
||||
* - 保留: NCPF backend 透传 + 类型定义 + printAiFormResult (--ai-field 用)
|
||||
* 理由:
|
||||
* 1. JNPF 后端已配 MiniMax AI (2026-07-01), NCPF backend 透传即可, 跟 web 端 AiCreateModal 行为一致
|
||||
* 2. 自写 LLM prompt 必与 NCPF backend 漂移 (两个 prompt 源, 升级时一方动一方不动)
|
||||
* 3. 自写 LLM response 解析 (parseAiFormText/parseAiFlowText) 已被 web 端 buildFormData 替代
|
||||
* web buildFormData 才是 web 端权威的 formData/flowNodes 构造逻辑
|
||||
*
|
||||
* 1. JNPF 后端已配 MiniMax AI , NCPF backend 透传即可, 跟 web 端 AiCreateModal 行为一致
|
||||
* 2. 自写 LLM prompt 必与 NCPF backend 漂移 (两个 prompt 源, 升级时一方动一方不动)
|
||||
* 3. 自写 LLM response 解析 (parseAiFormText/parseAiFlowText) 已被 web 端 buildFormData 替代
|
||||
* web buildFormData 才是 web 端权威的 formData/flowNodes 构造逻辑
|
||||
* 镜像原型:
|
||||
* - web/.../api/onlineDev/visualDev.ts: getAiInfo (form AI) → POST /api/visualdev/ai/form
|
||||
* - web/.../api/workFlow/template.ts: getAiInfo (flow AI) → POST /api/workflow/ai
|
||||
* - JNPF 后端: jnpf/.../VisualAiController.java (form) + WorkFlowAiController.java (flow)
|
||||
*
|
||||
* - web/.../api/onlineDev/visualDev.ts: getAiInfo (form AI) → POST /api/visualdev/ai/form
|
||||
* - web/.../api/workFlow/template.ts: getAiInfo (flow AI) → POST /api/workflow/ai
|
||||
* - JNPF 后端: jnpf/.../VisualAiController.java (form) + WorkFlowAiController.java (flow)
|
||||
* 消费方:
|
||||
* - form/create.ts: --ai → callAiForm
|
||||
* - form/create.ts: --ai-field → callAiForm + printAiFormResult
|
||||
* - workflow/create.ts: --ai → callAiWorkflow
|
||||
* - form/create.ts: --ai → callAiForm
|
||||
* - form/create.ts: --ai-field → callAiForm + printAiFormResult
|
||||
* - workflow/create.ts: --ai → callAiWorkflow
|
||||
*/
|
||||
import { JnpfClient } from '../../core/client.ts'
|
||||
import { log } from '../../core/log.ts'
|
||||
|
||||
/** AI 返回的 form 模型 (5.10.1, 镜像 web 端 VisualAiModel)
|
||||
* 来自 NCPF backend /api/visualdev/ai/form 响应 data 字段 */
|
||||
* 来自 NCPF backend /api/visualdev/ai/form 响应 data 字段 */
|
||||
export interface AiFormResponse {
|
||||
enCode?: string
|
||||
fullName?: string
|
||||
/** v0.19+ (BS-新72): NCPF/SSW fallback 调用链 (失败时填, 让用户知道为啥失败)
|
||||
* e.g. ["NCPF: 400 System abnormality", "SSW: 500 invalid token"] */
|
||||
/** (NCPF/SSW fallback 调用链 (失败时填, 让用户知道为啥失败)
|
||||
* e.g. ["NCPF: 400 System abnormality", "SSW: 500 invalid token"] */
|
||||
_aiChain?: string[]
|
||||
/** P1-7 (2026-07-16 jxcj M1 复盘): NCPF / SSW 双双 Login expired, AI 完全不可用.
|
||||
* 此时 create.ts 检测到此 flag → 跳过 AI exit, 走 web buildFormData 默认空 schema
|
||||
* (要求 user 已传 --enCode/--fullName, 否则仍 exit 2) */
|
||||
/** P1-7 NCPF / SSW 双双 Login expired, AI 完全不可用.
|
||||
* 此时 create.ts 检测到此 flag → 跳过 AI exit, 走 web buildFormData 默认空 schema
|
||||
* (要求 user 已传 --enCode/--fullName, 否则仍 exit 2) */
|
||||
loginExpired?: boolean
|
||||
aiModelList?: Array<{
|
||||
tableTitle?: string
|
||||
@@ -50,7 +44,7 @@ export interface AiFormResponse {
|
||||
fieldOptions?: Array<{ id?: string; fullName?: string; enCode?: string }>
|
||||
/**
|
||||
* 关系字段配置 (web RRelationForm 必填 3 项)
|
||||
* v0.11+ AI 不会自动生成, 由 dacli form/_relationForm_auto.ts 启发式注入
|
||||
* AI 不会自动生成, 由 dacli form/_relationForm_auto.ts 启发式注入
|
||||
*/
|
||||
fieldRelationConfig?: {
|
||||
modelId?: string
|
||||
@@ -80,8 +74,8 @@ export interface AiWorkflowResponse {
|
||||
}
|
||||
|
||||
/** 检测 --ai 描述是否暗示太多字段(粗略估算)
|
||||
* 数连接词 (顿号/逗号/"和"/"以及"/"含"/"加") → 估算候选字段数
|
||||
* 返回估算的字段数;空描述或无连接词时返回 0
|
||||
* 数连接词 (顿号/逗号/"和"/"以及"/"含"/"加") → 估算候选字段数
|
||||
* 返回估算的字段数;空描述或无连接词时返回 0
|
||||
*/
|
||||
function estimateFieldCount(keyword: string): number {
|
||||
if (!keyword) return 0
|
||||
@@ -91,17 +85,14 @@ function estimateFieldCount(keyword: string): number {
|
||||
return parts.length
|
||||
}
|
||||
|
||||
/** 检测 AI 输出是否被 max_tokens 截断 (v0.14+ BS-新30)
|
||||
*
|
||||
* 触发场景 1 (后端错误): 后端返回 code!=200, msg 含 SYS181 / "AI表单生成转换失败" / JSON 解析错
|
||||
* 触发场景 2 (静默截断): 后端 code=200, 但 data.enCode/fullName/aiModelList 为空
|
||||
* 且 --ai 描述字段数 > 10 (几乎肯定是 LLM 输出 JSON 超 1500 token 被截断)
|
||||
*
|
||||
* 根因: SendAiMessage.java:148 new AiSendModel() 硬编码 maxTokens=1500
|
||||
* LLM 输出 JSON 超 1500 token 被强制截断 → SYS181 (场景1) 或 返回空 (场景2)
|
||||
* yml 的 chat.maxTokens 不生效 (SendAiMessage 是 static 方法, 不读 AiProperties)
|
||||
* base_ai 表也没 maxTokens 字段 (JNPF 平台限制)
|
||||
* 修复方向: 拆分 --ai 描述 (≤10 字段/次), 让 LLM 输出 JSON < 1200 token
|
||||
/** 检测 AI 输出是否被 max_tokens 截断 ( * 触发场景 1 (后端错误): 后端返回 code!=200, msg 含 SYS181 / "AI表单生成转换失败" / JSON 解析错
|
||||
* 触发场景 2 (静默截断): 后端 code=200, 但 data.enCode/fullName/aiModelList 为空
|
||||
* 且 --ai 描述字段数 > 10 (几乎肯定是 LLM 输出 JSON 超 1500 token 被截断)
|
||||
* 根因: SendAiMessage.java:148 new AiSendModel() 硬编码 maxTokens=1500
|
||||
* LLM 输出 JSON 超 1500 token 被强制截断 → SYS181 (场景1) 或 返回空 (场景2)
|
||||
* yml 的 chat.maxTokens 不生效 (SendAiMessage 是 static 方法, 不读 AiProperties)
|
||||
* base_ai 表也没 maxTokens 字段 (JNPF 平台限制)
|
||||
* 修复方向: 拆分 --ai 描述 (≤10 字段/次), 让 LLM 输出 JSON < 1200 token
|
||||
*/
|
||||
function buildAiTruncationHint(keyword: string): string {
|
||||
const fieldCount = estimateFieldCount(keyword)
|
||||
@@ -137,32 +128,29 @@ function buildAiTruncationHint(keyword: string): string {
|
||||
• 如果 SSW 也失败, 才需要手动拆 prompt`
|
||||
}
|
||||
|
||||
/** 5.10.1 — AI 快速建表 (v0.14+: NCPF backend + SSW 修复 fallback)
|
||||
*
|
||||
* 流程 (BS-新113 jyzs 2026-07-02):
|
||||
* 1. 先 POST /api/visualdev/ai/form (jnpf 后端, 原始路径)
|
||||
* 2. **新增**: 429 "token plan 用尽" 时 retry 3 次, 退避 5s/10s/20s (指数退避)
|
||||
* 3. 后端错误 (SYS181 / JSON 解析失败) → fallback 到 SSW AI 修复
|
||||
* 4. 静默截断 (code=200 但 data 空) → fallback 到 SSW AI 修复
|
||||
* 5. SSW 端点 (POST /api/ssw/ai/repair) 自己调 LLM + 修复 JSON + 返回 VisualAiModel
|
||||
* 6. SSW 也 429 时 retry 2 次 (退避 5s/10s), 然后才失败
|
||||
*
|
||||
* 镜像 web/.../api/onlineDev/visualDev.ts: getAiInfo → POST /api/visualdev/ai/form
|
||||
* + ssw-common SswAIRepairController → POST /api/ssw/ai/repair (绕开 jnpf SendAiMessage)
|
||||
/** 5.10.1 — AI 快速建表 (NCPF backend + SSW 修复 fallback)
|
||||
* 流程 (jyzs 2026-07-02):
|
||||
* 1. 先 POST /api/visualdev/ai/form (jnpf 后端, 原始路径)
|
||||
* 2. **新增**: 429 "token plan 用尽" 时 retry 3 次, 退避 5s/10s/20s (指数退避)
|
||||
* 3. 后端错误 (SYS181 / JSON 解析失败) → fallback 到 SSW AI 修复
|
||||
* 4. 静默截断 (code=200 但 data 空) → fallback 到 SSW AI 修复
|
||||
* 5. SSW 端点 (POST /api/ssw/ai/repair) 自己调 LLM + 修复 JSON + 返回 VisualAiModel
|
||||
* 6. SSW 也 429 时 retry 2 次 (退避 5s/10s), 然后才失败
|
||||
* 镜像 web/.../api/onlineDev/visualDev.ts: getAiInfo → POST /api/visualdev/ai/form
|
||||
* + shared module SswAIRepairController → POST /api/ssw/ai/repair (绕开 jnpf SendAiMessage)
|
||||
*/
|
||||
|
||||
/**
|
||||
* v0.15+ (v0.15-3): SSW retry 工具已抽到 ../_ssw_retry.ts 统一维护
|
||||
* - isTokenPlanExhausted / backoffSleep / withSswRetry
|
||||
* - form + workflow 共用, BS-新113 5s/10s/20s 策略集中
|
||||
* - 后续加 sswTable/sswReport 不用复制
|
||||
* (v0.15-3): SSW retry 工具已抽到 ../_ssw_retry.ts 统一维护
|
||||
* - isTokenPlanExhausted / backoffSleep / withSswRetry
|
||||
* - form + workflow 共用, 5s/10s/20s 策略集中
|
||||
* - 后续加 sswTable/sswReport 不用复制
|
||||
*/
|
||||
/** @deprecated 改用 ../_ssw_retry.ts (v0.15+ 抽象) */
|
||||
/** @deprecated 改用 ../_ssw_retry.ts (抽象) */
|
||||
import { isTokenPlanExhausted, isLoginExpired, backoffSleep, withSswRetry } from '../_ssw_retry.ts'
|
||||
|
||||
/**
|
||||
* 带 retry 的 NCPF backend 调用 (BS-新113)
|
||||
* @param keyword 描述
|
||||
* 带 retry 的 NCPF backend 调用 ( * @param keyword 描述
|
||||
* @param maxRetries 最大重试次数 (默认 3)
|
||||
* @returns AiFormResponse (重试耗尽仍 429 时 throw Error)
|
||||
*/
|
||||
@@ -178,7 +166,7 @@ async function callNcpfBackendWithRetry(
|
||||
const r = await c.postJson<AiFormResponse>('/visualdev/ai/form', { keyword })
|
||||
// 成功
|
||||
if (r.code === 200) {
|
||||
// v0.20+ P2 修复: code=200 但 data 为空 (静默截断) 也 retry, 不立刻 fallback SSW
|
||||
// P2 修复: code=200 但 data 为空 (静默截断) 也 retry, 不立刻 fallback SSW
|
||||
// 背景: 实测 5 次里 1 次 (20%) NCPF 返回空 data, 单次 fallback SSW 太激进
|
||||
// 阈值: empty = enCode/fullName/aiModelList 都空, 这种 LLM 不稳定概率高
|
||||
const data = r.data || {}
|
||||
@@ -230,13 +218,13 @@ export async function callAiForm(keyword: string): Promise<AiFormResponse> {
|
||||
}
|
||||
|
||||
// 场景 A: NCPF 错误 → fallback SSW
|
||||
// v0.15+ (2026-07-03): 所有非 200 都走 SSW, 不再区分截断类型
|
||||
// NCPF 配了 AI 会用, 没配就 fail — SSW 自己有 DeepSeek, 不需要 NCPF
|
||||
// 所有非 200 都走 SSW, 不再区分截断类型
|
||||
// NCPF 配了 AI 会用, 没配就 fail — SSW 自己有 DeepSeek, 不需要 NCPF
|
||||
if (r.code !== 200) {
|
||||
// P1-7 (2026-07-16 jxcj M1 复盘): Login expired 全局阻塞场景
|
||||
// 根因: NCPF 后端 AI 服务 token 失效, SSW /ssw/ai/repair 也走同 token 必 fail
|
||||
// 修复: 检测 Login expired 后跳过 SSW fallback (浪费 2 次重试), 直接返回
|
||||
// loginExpired=true 让 create.ts 走 web buildFormData 默认空 schema
|
||||
// P1-7 Login expired 全局阻塞场景
|
||||
// 根因: NCPF 后端 AI 服务 token 失效, SSW /ssw/ai/repair 也走同 token 必 fail
|
||||
// 检测 Login expired 后跳过 SSW fallback (浪费 2 次重试), 直接返回
|
||||
// loginExpired=true 让 create.ts 走 web buildFormData 默认空 schema
|
||||
if (isLoginExpired(r as unknown as { code?: number; msg?: string })) {
|
||||
aiChain.push(`NCPF: Login expired (code=${(r as any).code}, msg=${((r as any).msg || '').slice(0, 80)})`)
|
||||
log.warn(`! NCPF Login expired → AI 后端 token 失效, 跳过 SSW fallback (BS-新113 P1-7)`)
|
||||
@@ -249,7 +237,7 @@ export async function callAiForm(keyword: string): Promise<AiFormResponse> {
|
||||
}
|
||||
|
||||
// 场景 B: 静默截断 (code=200 但 data 空) → fallback SSW
|
||||
// v0.15+ 修复 (2026-07-02 audit FINDING-F2): 加 fieldCount 检测, 避免中间截断 (enCode 有但 fields=[]) 漏判
|
||||
// 修复 加 fieldCount 检测, 避免中间截断 (enCode 有但 fields=[]) 漏判
|
||||
const data = r.data || {}
|
||||
const isEmpty = !data.enCode && !data.fullName && (!data.aiModelList || data.aiModelList.length === 0)
|
||||
// 估算 keyword 实际要求字段数 (每个"/"或"字段"/"列"分隔符 +1)
|
||||
@@ -270,12 +258,10 @@ export async function callAiForm(keyword: string): Promise<AiFormResponse> {
|
||||
}
|
||||
|
||||
/**
|
||||
* SSW AI 修复 fallback (BS-新113 增强: 429 retry 2 次)
|
||||
*
|
||||
* SSW AI 修复 fallback (增强: 429 retry 2 次)
|
||||
* 端点: POST /api/ssw/ai/repair
|
||||
* 来源: ssw-common-controller/SswAIRepairController
|
||||
* 来源: shared module-controller/SswAIRepairController
|
||||
* 逻辑: SSW 端点直接调 LLM (maxTokens=3000) + 修复 fieldOptions / 注释 / 截断 / 文字说明混合
|
||||
*
|
||||
* @param keyword --ai 描述
|
||||
* @param reason fallback 原因 (用于日志)
|
||||
* @returns VisualAiModel 兼容结构; 失败时返回空对象
|
||||
@@ -289,12 +275,12 @@ async function callSswAiRepair(keyword: string, reason: string, aiChain: string[
|
||||
const r = await c.postJson<AiFormResponse>('/ssw/ai/repair', { keyword })
|
||||
if (r.code === 200 && r.data && r.data.enCode) {
|
||||
log.ok(`✓ SSW 修复成功: enCode=${r.data.enCode}, fullName=${r.data.fullName}, fields=${r.data.aiModelList?.[0]?.fields?.length || 0}`)
|
||||
// v0.19+ BS-新72: 透传 chain
|
||||
// 透传 chain
|
||||
r.data._aiChain = [...aiChain, `SSW: 200 OK`]
|
||||
return r.data
|
||||
}
|
||||
// P1-7 (2026-07-16): SSW 也可能 Login expired (与 NCPF 同 token 失效), 检测到立即返回
|
||||
// 不浪费 5s/10s 重试, 让 create.ts 走 web buildFormData 默认空 schema
|
||||
// SSW 也可能 Login expired (与 NCPF 同 token 失效), 检测到立即返回
|
||||
// 不浪费 5s/10s 重试, 让 create.ts 走 web buildFormData 默认空 schema
|
||||
if (isLoginExpired(r as unknown as { code?: number; msg?: string })) {
|
||||
aiChain.push(`SSW: Login expired (code=${(r as any).code}, msg=${((r as any).msg || '').slice(0, 80)})`)
|
||||
log.warn(`! SSW Login expired → AI 后端 token 失效 (BS-新113 P1-7), 跳过剩余重试`)
|
||||
@@ -309,14 +295,14 @@ async function callSswAiRepair(keyword: string, reason: string, aiChain: string[
|
||||
continue
|
||||
}
|
||||
}
|
||||
// v0.20+ P1 修复: SSW 错误链完整显示 (不截断), 让用户看到 fastjson NPE stack trace
|
||||
// P1 修复: SSW 错误链完整显示 (不截断), 让用户看到 fastjson NPE stack trace
|
||||
// 背景: 之前 SSW 异常截断 60 字符, NPE 类错误看不到根因, 误以为是 AI 描述问题
|
||||
const sswMsgFull = r.msg || '(no msg)'
|
||||
aiChain.push(`SSW: code=${r.code} ${sswMsgFull.slice(0, 200)}`)
|
||||
log.warn(`! SSW 修复失败 (code=${r.code}): ${sswMsgFull}`)
|
||||
break
|
||||
} catch (e) {
|
||||
// v0.20+ P1 修复: 完整异常信息, 包括 NPE stack trace 头部
|
||||
// P1 修复: 完整异常信息, 包括 NPE stack trace 头部
|
||||
const sswExcFull = (e as Error)?.message || String(e)
|
||||
const sswStack = (e as Error)?.stack?.split('\n').slice(0, 3).join(' | ') || ''
|
||||
aiChain.push(`SSW: 异常 ${sswExcFull.slice(0, 200)}`)
|
||||
@@ -334,15 +320,13 @@ async function callSswAiRepair(keyword: string, reason: string, aiChain: string[
|
||||
return { _aiChain: aiChain }
|
||||
}
|
||||
|
||||
/** 5.10.3 — AI 创建流程 (v0.15+: NCPF backend + SSW 修复 fallback)
|
||||
* 镜像 web/.../api/workFlow/template.ts: getAiInfo → POST /api/workflow/ai
|
||||
*
|
||||
* v0.15+ (BS-新30 workflow, 2026-07-02): 加 SSW 修复层, 跟 form --ai 模式一致
|
||||
* - NCPF /api/workflow/ai 失败 (BS-新30: SYS181 截断, 429 token plan 用尽, 静默截断)
|
||||
* - Fallback: POST /api/ssw/ai/repair-workflow (ssw-common-controller)
|
||||
* - SSW 复用 SswLLMClient maxTokens=3000 + JsonRepairUtil 修复层 (跨 BPMN XML 特殊字符)
|
||||
* - 5s/10s/20s retry (跟 form 一致)
|
||||
*
|
||||
/** 5.10.3 — AI 创建流程 (NCPF backend + SSW 修复 fallback)
|
||||
* 镜像 web/.../api/workFlow/template.ts: getAiInfo → POST /api/workflow/ai
|
||||
* (workflow, 2026-07-02): 加 SSW 修复层, 跟 form --ai 模式一致
|
||||
* - NCPF /api/workflow/ai 失败 (SYS181 截断, 429 token plan 用尽, 静默截断)
|
||||
* - Fallback: POST /api/ssw/ai/repair-workflow (shared module-controller)
|
||||
* - SSW 复用 SswLLMClient maxTokens=3000 + JsonRepairUtil 修复层 (跨 BPMN XML 特殊字符)
|
||||
* - 5s/10s/20s retry (跟 form 一致)
|
||||
* 失败处理: NCPF + SSW 都失败 → 抛错, 调用方走原错误流 (dacli workflow create 退出 1)
|
||||
*/
|
||||
export async function callAiWorkflow(keyword: string): Promise<AiWorkflowResponse> {
|
||||
@@ -350,16 +334,16 @@ export async function callAiWorkflow(keyword: string): Promise<AiWorkflowRespons
|
||||
log.info(`[NCPF backend] POST /workflow/ai keyword="${keyword.slice(0, 50)}${keyword.length > 50 ? '...' : ''}"`)
|
||||
const r = await c.postJson<AiWorkflowResponse>('/workflow/ai', { keyword })
|
||||
if (r.code === 200) {
|
||||
// 静默截断检测 (BS-新30): NCPF 返 200 但 flowXml 为空
|
||||
// 静默截断检测 (NCPF 返 200 但 flowXml 为空
|
||||
if (!r.data?.flowXml) {
|
||||
log.warn(`! NCPF 后端静默截断 (返 200 但 flowXml 空) → fallback SSW 修复`)
|
||||
return await callSswAiWorkflowRepair(keyword, 'NCPF 静默截断')
|
||||
}
|
||||
// v0.15+ (实测 2026-07-02): NCPF backend 返 URL-encoded flowXml (%3C%3Fxml)
|
||||
// - 直接 SSW 返真实 XML (testspace 验证)
|
||||
// - 跟 SSW 不一致, 老的 dacli 没处理, step machine 校验失败
|
||||
// - 修复: URL-decode 后用真实 XML, 校验才能通过
|
||||
// - 旁路: decode 失败时保留原值 (用 isUrlEncoded 启发式判断)
|
||||
// (实测 2026-07-02): NCPF backend 返 URL-encoded flowXml (%3C%3Fxml)
|
||||
// - 直接 SSW 返真实 XML (testspace 验证)
|
||||
// - 跟 SSW 不一致, 老的 dacli 没处理, step machine 校验失败
|
||||
// - 修复: URL-decode 后用真实 XML, 校验才能通过
|
||||
// - 旁路: decode 失败时保留原值 (用 isUrlEncoded 启发式判断)
|
||||
if (r.data.flowXml.startsWith('%3C') || r.data.flowXml.startsWith('%3c')) {
|
||||
try {
|
||||
const decoded = decodeURIComponent(r.data.flowXml)
|
||||
@@ -377,15 +361,12 @@ export async function callAiWorkflow(keyword: string): Promise<AiWorkflowRespons
|
||||
}
|
||||
|
||||
/**
|
||||
* v0.21+ (Round 12 BS-新43): 检测 AI 返回的 flowXml 是否 trivial (≤1 userTask).
|
||||
*
|
||||
* (Round 12 检测 AI 返回的 flowXml 是否 trivial (≤1 userTask).
|
||||
* Round 12 现象: 5/5 workflow --ai 都生成 "StartEvent → Task_1 → EndEvent" 3-node trivial,
|
||||
* baseline 业务流 4-10 nodes 全丢 (missing_nodes=31 总数).
|
||||
* NCPF backend 的 LLM prompt 没有强制要求节点数, 永远返最简 3-node.
|
||||
* dacli 端无法修 NCPF prompt, 只能在客户端侦测 + 强 WARN 推荐用 --flowXml.
|
||||
*
|
||||
* baseline 业务流 4-10 nodes 全丢 (missing_nodes=31 总数).
|
||||
* NCPF backend 的 LLM prompt 没有强制要求节点数, 永远返最简 3-node.
|
||||
* dacli 端无法修 NCPF prompt, 只能在客户端侦测 + 强 WARN 推荐用 --flowXml.
|
||||
* 判定规则: XML 中 userTask / task 元素数 (≥1 才正常, ≥4 才像真业务).
|
||||
*
|
||||
* @returns { isTrivial, taskCount } — isTrivial=true 表示建议用户改用 --flowXml 路径.
|
||||
*/
|
||||
export function detectTrivialFlowXml(flowXml: string): { isTrivial: boolean; taskCount: number; warning: string } {
|
||||
@@ -400,12 +381,10 @@ export function detectTrivialFlowXml(flowXml: string): { isTrivial: boolean; tas
|
||||
}
|
||||
|
||||
/**
|
||||
* v0.15+ (BS-新30 workflow): SSW AI 修复 fallback
|
||||
*
|
||||
* (workflow): SSW AI 修复 fallback
|
||||
* 端点: POST /api/ssw/ai/repair-workflow
|
||||
* 来源: ssw-common-controller/SswAIRepairController.repairWorkflow
|
||||
* 来源: shared module-controller/SswAIRepairController.repairWorkflow
|
||||
* 逻辑: SSW 端点直接调 LLM (maxTokens=3000) + 修复 BPMN XML 截断/格式
|
||||
*
|
||||
* 跟 callSswAiRepair (form) 平行, 复用同样的 retry 模式 (5s/10s/20s)
|
||||
*/
|
||||
async function callSswAiWorkflowRepair(keyword: string, reason: string): Promise<AiWorkflowResponse> {
|
||||
|
||||
@@ -1,20 +1,16 @@
|
||||
/**
|
||||
* commands/form/_validate.ts — form create step machine 校验
|
||||
*
|
||||
* 镜像 web Form.vue handleNext + handleSubmit 的前端校验逻辑 (Generator.getData + ColumnDesign.getData)
|
||||
* 让 dacli form create 在发 API 之前暴露问题, AI 不用去浏览器试错
|
||||
*
|
||||
* 设计原则 (2026-06-26 v0.11d+ → 2026-06-28 v0.11e+):
|
||||
* - 不是复刻 web UI 行为 (drag/drop/click), 而是 mirror JNPF 业务规则
|
||||
* - 跟 BS-50/BS-44/BS-42 等盲点守卫一致: 在发 API 前校验
|
||||
* 设计原则 * - 不是复刻 web UI 行为 (drag/drop/click), 而是 mirror JNPF 业务规则
|
||||
* - 跟 等盲点守卫一致: 在发 API 前校验
|
||||
* - 校验失败 → 返回 step N + 错误列表, 不发 API
|
||||
* - 校验通过 → 1 次 create API call (不拆步骤)
|
||||
* - v0.11e+ 严格镜像 web 端 formValidate('enCode') (禁下划线) + Form.vue schemas 6 字段必填
|
||||
*
|
||||
* - 严格镜像 web 端 formValidate('enCode') (禁下划线) + Form.vue schemas 6 字段必填
|
||||
* step 镜像对应:
|
||||
* step 0: 基础信息 (fullName, enCode 格式禁下划线, category 必填, type 合法性, tables.length, 子表外键)
|
||||
* step 1: formData 字段 (formFields ≥ 1, vmodel 格式, billRule/popupSelect/relationForm/autoComplete/upload 控件级)
|
||||
* step 2: columnData (columnList ≥ 1 当 webType≠1, 树形 treeDataSource/props/relation/sync 必填, 卡片/分组/父级字段)
|
||||
* step 0: 基础信息 (fullName, enCode 格式禁下划线, category 必填, type 合法性, tables.length, 子表外键)
|
||||
* step 1: formData 字段 (formFields ≥ 1, vmodel 格式, billRule/popupSelect/relationForm/autoComplete/upload 控件级)
|
||||
* step 2: columnData (columnList ≥ 1 当 webType≠1, 树形 treeDataSource/props/relation/sync 必填, 卡片/分组/父级字段)
|
||||
*/
|
||||
|
||||
export interface ValidationError {
|
||||
@@ -22,8 +18,8 @@ export interface ValidationError {
|
||||
field?: string
|
||||
/** 错误消息 (镜像 web 文案, AI 能对照) */
|
||||
message: string
|
||||
/** v0.11e+: ErrorCode (镜像后端 MsgCode.java, AI 能查表)
|
||||
* 复刻 _error_codes.ts 的 ValidationError 字段, 让 step machine 输出格式统一 */
|
||||
/** ErrorCode (镜像后端 MsgCode.java, AI 能查表)
|
||||
* 复刻 _error_codes.ts 的 ValidationError 字段, 让 step machine 输出格式统一 */
|
||||
code?: string
|
||||
}
|
||||
|
||||
@@ -39,41 +35,37 @@ export interface StepValidation {
|
||||
// eslint-disable-next-line regexp/no-unused-capturing-group
|
||||
const VMODEL_REGEXP = /(^_([a-z0-9]_?)*$)|(^[a-z](_?[a-z0-9])*_?$)/i
|
||||
|
||||
// v0.11h+ (2026-06-28): 共享 _encode_validator.ts (BS-56 增强)
|
||||
// 镜像 web 端 formValidate('enCode') (formValidate.ts:24-28) 禁下划线/连字符
|
||||
// 增强: 校验失败时输出清晰原因 + 自动建议别名 (去下划线/连字符)
|
||||
// 共享 _encode_validator.ts (增强)
|
||||
// 镜像 web 端 formValidate('enCode') (formValidate.ts:24-28) 禁下划线/连字符
|
||||
// 增强: 校验失败时输出清晰原因 + 自动建议别名 (去下划线/连字符)
|
||||
// eslint-disable-next-line @typescript-eslint/no-unused-vars
|
||||
import { ENCODE_REGEXP, FULLNAME_REGEXP, validateEnCode, validateFullName } from '../_encode_validator.ts'
|
||||
|
||||
/** v0.11e+ upload folder name 正则 — 镜像 Generator.getData() line 295 */
|
||||
/** upload folder name 正则 — 镜像 Generator.getData() line 295 */
|
||||
// eslint-disable-next-line regexp/no-unused-capturing-group
|
||||
const FOLDER_REGEXP = /^[a-z0-9][\w-]{0,99}$/i
|
||||
|
||||
/** v0.11e+ billRule startNumber 正则 — 镜像 Generator.getData() line 263
|
||||
* 数字, 不能为 0 */
|
||||
/** billRule startNumber 正则 — 镜像 Generator.getData() line 263
|
||||
* 数字, 不能为 0 */
|
||||
// eslint-disable-next-line regexp/no-unused-capturing-group
|
||||
const STARTNUMBER_REGEXP = /^\d*[1-9]$/
|
||||
|
||||
/** v0.11e+ 合法 type 集合 — 镜像 Form.vue:107 type 默认 1, 合法 {1,2,3,4} */
|
||||
/** 合法 type 集合 — 镜像 Form.vue:107 type 默认 1, 合法 {1,2,3,4} */
|
||||
const VALID_TYPES = [1, 2, 3, 4] as const
|
||||
|
||||
/** v0.13+ BS-新3 (2026-06-30 testspace): fullName 关键字前置校验
|
||||
*
|
||||
/** fullName 关键字前置校验
|
||||
* 后端 VisualdevController.java:509 create() 调 GenerateConstant.containKeyword(entity.getFullName())
|
||||
* → 检查 ALL_KEYWORD = SYS_KEYWORD (26 个) + JAVA_KEYWORD (50 个) + SQL_KEYWORD (2030 个)
|
||||
* → 命中即返 "表单名称xxx不能使用系统、开发语言及数据库关键字命名" (SYS128)
|
||||
* → VisualdevController.java:437 update() 同样检查
|
||||
* → VisualdevController.java:598 publish() 同样检查 (即使 create 通过了, publish 也再查)
|
||||
*
|
||||
* → 检查 ALL_KEYWORD = SYS_KEYWORD (26 个) + JAVA_KEYWORD (50 个) + SQL_KEYWORD (2030 个)
|
||||
* → 命中即返 "表单名称xxx不能使用系统、开发语言及数据库关键字命名" (SYS128)
|
||||
* → VisualdevController.java:437 update() 同样检查
|
||||
* → VisualdevController.java:598 publish() 同样检查 (即使 create 通过了, publish 也再查)
|
||||
* 之前 dacli form create step machine 只检查 FULLNAME_REGEXP (`/^([一-龥a-z0-9])+$/i`)
|
||||
* → 字符格式 (. / _ / 特殊符号) 被拦截
|
||||
* → 但关键字 (fullName='admin' 或 fullName='user') 漏检, runtime 后端 400
|
||||
*
|
||||
* 修复: 抽 SYS_KEYWORD + JAVA_KEYWORD + SQL_KEYWORD 共享集合 (复用 dm/_validate.ts 模式),
|
||||
* form create validateBasicInfo step 0 加 fullName 关键字校验, 镜像后端 GenerateConstant.containKeyword()
|
||||
*
|
||||
* → 字符格式 (. / _ / 特殊符号) 被拦截
|
||||
* → 但关键字 (fullName='admin' 或 fullName='user') 漏检, runtime 后端 400
|
||||
* 抽 SYS_KEYWORD + JAVA_KEYWORD + SQL_KEYWORD 共享集合 (复用 dm/_validate.ts 模式),
|
||||
* form create validateBasicInfo step 0 加 fullName 关键字校验, 镜像后端 GenerateConstant.containKeyword()
|
||||
* 注意: SQL_KEYWORD 全集 2030 个太大, 这里用 dm create 之前验证的"高频子集 + 高频业务词"组合,
|
||||
* 未收录的仍由后端运行时再校验 (dacli 这里主要解决前置拦截, 不替代后端). */
|
||||
* 未收录的仍由后端运行时再校验 (dacli 这里主要解决前置拦截, 不替代后端). */
|
||||
const FULLNAME_SYS_KEYWORDS = new Set([
|
||||
// GenerateConstant.SYS_KEYWORD (镜像后端)
|
||||
'tenantid', 'id', 'foreignid', 'flowid', 'flowtaskid', 'deleteuserid', 'deletetime',
|
||||
@@ -279,9 +271,9 @@ const FULLNAME_SQL_KEYWORDS = new Set([
|
||||
'zero', 'zone', 'zoned',
|
||||
])
|
||||
|
||||
/** v0.11e+ noVModelList — 镜像 web FormGenerator helper/config.ts:4-8
|
||||
* 这些控件无 vmodel, 跳过 vmodel 必填校验 (但 isStorage=true 例外)
|
||||
* vModelIgnoreList + dyStorageList
|
||||
/** noVModelList — 镜像 web FormGenerator helper/config.ts:4-8
|
||||
* 这些控件无 vmodel, 跳过 vmodel 必填校验 (但 isStorage=true 例外)
|
||||
* vModelIgnoreList + dyStorageList
|
||||
*/
|
||||
const NO_VMODEL_LIST = [
|
||||
'divider', 'text', 'link', 'alert', 'groupTitle', 'button', 'barcode', 'qrcode', 'iframe',
|
||||
@@ -293,7 +285,7 @@ const NO_VMODEL_LIST = [
|
||||
export function validateBasicInfo(opts: {
|
||||
fullName?: string
|
||||
enCode?: string
|
||||
/** v0.11e+ 新增: 表单分类 (镜像 Form.vue:60-66 schemas required) */
|
||||
/** 新增: 表单分类 (镜像 Form.vue:60-66 schemas required) */
|
||||
category?: string
|
||||
type: number
|
||||
webType: number
|
||||
@@ -311,12 +303,12 @@ export function validateBasicInfo(opts: {
|
||||
errors.push({ field: 'fullName', message: '名称不能含有特殊符号', code: 'VS032-FORMAT' })
|
||||
}
|
||||
|
||||
// v0.13+ BS-新3 (2026-06-30 testspace): fullName 关键字前置校验
|
||||
// fullName 关键字前置校验
|
||||
// 后端 VisualdevController.create():509 调 GenerateConstant.containKeyword(entity.getFullName())
|
||||
// → 检查 ALL_KEYWORD (SYS + JAVA + SQL 共 ~2106 关键字), 命中即报 SYS128.
|
||||
// → 检查 ALL_KEYWORD (SYS + JAVA + SQL 共 ~2106 关键字), 命中即报 SYS128.
|
||||
// 之前 dacli step machine 漏检 → 用户 fullName='admin' 等过 step machine,
|
||||
// runtime 后端 400 "表单名称admin不能使用系统、开发语言及数据库关键字命名".
|
||||
// 修复: 镜像后端 GenerateConstant.containKeyword (case-insensitive), 前置 step 0 拦截.
|
||||
// runtime 后端 400 "表单名称admin不能使用系统、开发语言及数据库关键字命名".
|
||||
// 镜像后端 GenerateConstant.containKeyword (case-insensitive), 前置 step 0 拦截.
|
||||
// 注: 后端 ALL_KEYWORD 命中即拒, 这里强制用 lower-case 比较 (与后端 containKeyword 一致).
|
||||
if (opts.fullName && opts.fullName.trim()) {
|
||||
const fn = String(opts.fullName).trim().toLowerCase()
|
||||
@@ -333,7 +325,7 @@ export function validateBasicInfo(opts: {
|
||||
}
|
||||
|
||||
// enCode: 必填 + 长度 ≤ 50 + formValidate('enCode') 禁下划线 (formValidate.ts:24-28)
|
||||
// v0.11h+ (2026-06-28): 共享 _encode_validator.ts (BS-56 增强: 清晰信息 + 自动建议别名)
|
||||
// 共享 _encode_validator.ts (增强: 清晰信息 + 自动建议别名)
|
||||
const encErr = validateEnCode(opts.enCode, 'enCode')
|
||||
if (encErr) {
|
||||
errors.push({
|
||||
@@ -343,8 +335,8 @@ export function validateBasicInfo(opts: {
|
||||
})
|
||||
}
|
||||
|
||||
// v0.11e+ 新增 category 必填校验 (镜像 Form.vue:60-66 schemas required: true)
|
||||
// v0.12+ jxcj-2026-06-29 fix: 加可执行建议 (按 appCode 派生 + 复用 crmOrder 通用)
|
||||
// 新增 category 必填校验 (镜像 Form.vue:60-66 schemas required: true)
|
||||
// app-fix: 加可执行建议 (按 appCode 派生 + 复用 crmOrder 通用)
|
||||
if (!opts.category || !opts.category.trim()) {
|
||||
errors.push({
|
||||
field: 'category',
|
||||
@@ -358,7 +350,7 @@ export function validateBasicInfo(opts: {
|
||||
})
|
||||
}
|
||||
|
||||
// v0.11e+ 新增 type 合法性校验 (合法集合 {1,2,3,4})
|
||||
// 新增 type 合法性校验 (合法集合 {1,2,3,4})
|
||||
if (!VALID_TYPES.includes(opts.type as any)) {
|
||||
errors.push({
|
||||
field: 'type',
|
||||
@@ -370,7 +362,7 @@ export function validateBasicInfo(opts: {
|
||||
// state.tables 检查 (Form.vue:329-345 handleNext step 0)
|
||||
if (!opts.tables || opts.tables.length === 0) {
|
||||
const type = opts.type
|
||||
// 默认表兜底: type=3 (树) 或 type=4 (视图) 必须有物理表 (BS-55 规则)
|
||||
// 默认表兜底: type=3 (树) 或 type=4 (视图) 必须有物理表 (规则)
|
||||
// type=1/2 不强制 (场景 A 默认 fallback)
|
||||
if (type === 3 || type === 4) {
|
||||
errors.push({ field: 'tables', message: '请至少选择一个数据表', code: 'VS408' })
|
||||
@@ -388,7 +380,7 @@ export function validateBasicInfo(opts: {
|
||||
}
|
||||
}
|
||||
}
|
||||
// B-8 (2026-06-27 tds): 主表 primaryKey 字段禁止是业务字段 (PK 必须留给 JNPF f_id)
|
||||
// B-8 主表 primaryKey 字段禁止是业务字段 (PK 必须留给 JNPF f_id)
|
||||
// 后端 FlowFormDataUtil.getKey() (L170-187) 选 primaryKey=1 字段作为 INSERT 列名 (排除 f_tenant_id).
|
||||
// 用户在 tables[].fields 标业务字段 primaryKey=1 → getKey() 返该字段 → INSERT 重复拼列.
|
||||
// 这是 dm create step machine 的镜像 (dm/_validate.ts PRIMARY_KEY_FIELDS), 在 form create 兜底拦截.
|
||||
@@ -440,7 +432,7 @@ export function validateFormData(formData: { fields?: any[] } | null, type: numb
|
||||
const label = config.label || parentLabel || '(未命名)'
|
||||
|
||||
// colFormItem 控件: vmodel 必填 + 格式 (line 256-259)
|
||||
// v0.11e+ 镜像 web: noVModelList 跳过 (但 isStorage=true 例外)
|
||||
// 镜像 web: noVModelList 跳过 (但 isStorage=true 例外)
|
||||
if (config.layout === 'colFormItem') {
|
||||
const skipVModel = NO_VMODEL_LIST.includes(config.jnpfKey) && !e.isStorage
|
||||
if (!skipVModel) {
|
||||
@@ -472,7 +464,7 @@ export function validateFormData(formData: { fields?: any[] } | null, type: numb
|
||||
if (!e.relationField) errors.push({ field: formId, message: `回显字段不能为空 (label: ${label})`, code: 'VS-AUTO-FIELD' })
|
||||
}
|
||||
|
||||
// relationQuery (v0.11e+ 新镜像 line 317-320): modelId + columnOptions 二必填
|
||||
// relationQuery (新镜像 line 317-320): modelId + columnOptions 二必填
|
||||
if (config.jnpfKey === 'relationQuery') {
|
||||
if (!e.modelId) errors.push({ field: formId, message: `关联功能不能为空 (label: ${label})`, code: 'VS-RELQUERY-MODEL' })
|
||||
if (!e.columnOptions || e.columnOptions.length === 0) {
|
||||
@@ -558,7 +550,7 @@ export function validateFormData(formData: { fields?: any[] } | null, type: numb
|
||||
}
|
||||
|
||||
/** step 2: columnData 校验 (镜像 ColumnDesign.getData() 核心规则: columnList ≥ 1 当 webType≠1)
|
||||
* v0.11e+ 严格镜像 Main.vue:283-340 树形/分组/父级/卡片/导入模板/打印模板 7 类校验
|
||||
* 严格镜像 Main.vue:283-340 树形/分组/父级/卡片/导入模板/打印模板 7 类校验
|
||||
*/
|
||||
export function validateColumnData(columnData: any | null, webType: number): StepValidation {
|
||||
const errors: ValidationError[] = []
|
||||
@@ -578,7 +570,7 @@ export function validateColumnData(columnData: any | null, webType: number): Ste
|
||||
return { ok: false, step: 2, stepName: '列表设计', errors }
|
||||
}
|
||||
|
||||
// v0.11e+ 严格镜像 ColumnDesign.getData() line 283-310 树形校验
|
||||
// 严格镜像 ColumnDesign.getData() line 283-310 树形校验
|
||||
// type=2 是树形列表 (Main.vue columnConfig column.type=2)
|
||||
if (columnData.type == 2) {
|
||||
if (columnData.treeDataSource === 'dictionary' && !columnData.treeDictionary) {
|
||||
@@ -651,7 +643,7 @@ export function validateColumnData(columnData: any | null, webType: number): Ste
|
||||
export function validateFormCreate(opts: {
|
||||
fullName?: string
|
||||
enCode?: string
|
||||
/** v0.11e+ 新增: 表单分类 (镜像 Form.vue:60-66 schemas required) */
|
||||
/** 新增: 表单分类 (镜像 Form.vue:60-66 schemas required) */
|
||||
category?: string
|
||||
type: number
|
||||
webType: number
|
||||
@@ -671,8 +663,8 @@ export function validateFormCreate(opts: {
|
||||
}
|
||||
}
|
||||
|
||||
/** v0.11e+ URL 校验 — 镜像 web Generator.getData() line 313 的 isUrl 简化版
|
||||
* web 端 isUrl 走 utils 包, 这里给一份最简实现覆盖 95% 场景
|
||||
/** URL 校验 — 镜像 web Generator.getData() line 313 的 isUrl 简化版
|
||||
* web 端 isUrl 走 utils 包, 这里给一份最简实现覆盖 95% 场景
|
||||
*/
|
||||
function isUrl(url: string): boolean {
|
||||
if (!url || typeof url !== 'string') return false
|
||||
|
||||
@@ -1,27 +1,23 @@
|
||||
/**
|
||||
* commands/workflow/create.ts — 新建流程模板 (v0.12+ BS-新27 6 步 webapi 路径)
|
||||
*
|
||||
* commands/workflow/create.ts — 新建流程模板 (6 步 webapi 路径)
|
||||
* 修复 Bug 3 (流程编辑页无节点 + 提交报"系统异常")
|
||||
*
|
||||
* 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 发起
|
||||
*
|
||||
* 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)
|
||||
* - 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)
|
||||
* 简化 (app 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'
|
||||
@@ -49,9 +45,9 @@ interface CreateOpts {
|
||||
iconBackground?: string
|
||||
showType?: string
|
||||
icon?: string
|
||||
/** v0.21+ BS-drift-W-4 fix: 手动设 sortCode (默认 0, baseline 拖拽排序丢失) */
|
||||
/** 手动设 sortCode (默认 0, baseline 拖拽排序丢失) */
|
||||
sortCode?: string
|
||||
/** BS-E14 (Round 8 P2): isLayoutNeeded 阈值 (默认 0.8 = 80% 重叠触发) */
|
||||
/** (Round 8 P2): isLayoutNeeded 阈值 (默认 0.8 = 80% 重叠触发) */
|
||||
layoutThreshold?: string
|
||||
json?: boolean
|
||||
/** 5.10.3 AI 创建流程 (--ai "<描述>") - 调 web 端 getAiInfo 拿 flowXml */
|
||||
@@ -81,7 +77,7 @@ export function buildWorkflowCreateCommand(): Command {
|
||||
.option('--flowConfig <json>', 'flowConfig JSON 字符串')
|
||||
.option('--iconBackground <color>', '图标背景色 (默认 #108ee9)', '#108ee9')
|
||||
.option('--icon <i>', '流程图标 (默认 icon-ym icon-ym-flow)', 'icon-ym icon-ym-flow')
|
||||
// v0.21+ BS-drift-W-4 fix: 手动设 sortCode (默认 0)
|
||||
// 手动设 sortCode (默认 0)
|
||||
.option('--sortCode <n>', 'sortCode 排序 (默认 0)', '0')
|
||||
.option('--showType <n>', '显示位置 (0=全局 1=流程 2=菜单, 默认 0)', '0')
|
||||
.option('--startFormId <id>', '绑定的 formId (绑到 start 节点 formId, 镜像 web 选表单步骤)')
|
||||
@@ -92,7 +88,7 @@ export function buildWorkflowCreateCommand(): Command {
|
||||
.action(async (opts: CreateOpts) => {
|
||||
const c = await JnpfClient.fromToken()
|
||||
|
||||
// v0.21+ (Round 12 BS-新38): enCode 含 `-`/`_` 自动 strip + WARN
|
||||
// (Round 12 enCode 含 `-`/`_` 自动 strip + WARN
|
||||
if (opts.enCode) {
|
||||
const _encStrip = autoStripEnCode(opts.enCode)
|
||||
if (_encStrip.wasStriped) {
|
||||
@@ -101,7 +97,7 @@ export function buildWorkflowCreateCommand(): Command {
|
||||
}
|
||||
}
|
||||
|
||||
// v0.21+ R14 fix (BS-新52): fullName 含 space/parens 自动 strip + WARN
|
||||
// fix (fullName 含 space/parens 自动 strip + WARN
|
||||
if (opts.fullName) {
|
||||
const _fnStrip = autoStripFullName(opts.fullName)
|
||||
if (_fnStrip.wasStriped) {
|
||||
@@ -110,21 +106,21 @@ export function buildWorkflowCreateCommand(): Command {
|
||||
}
|
||||
}
|
||||
|
||||
// BS-E3 (Round 8 P0): workflow 没绑 startFormId → 浏览器报 "workFlowForm/undefined.vue"
|
||||
// step 1 拦截: 提示用户传 --startFormId (web NodeFormParser.vue:59-64)
|
||||
// (Round 8 P0): workflow 没绑 startFormId → 浏览器报 "workFlowForm/undefined.vue"
|
||||
// step 1 拦截: 提示用户传 --startFormId (web NodeFormParser.vue:59-64)
|
||||
if (!opts.startFormId) {
|
||||
log.warn(`BS-E3: workflow 未传 --startFormId, 浏览器流程设计器点击节点时会报 'workFlowForm/undefined.vue'`)
|
||||
log.warn(` 建议: dacli workflow create --startFormId=<formId> ... (参考 web NodeFormParser.vue:59-64 动态 import)`)
|
||||
}
|
||||
|
||||
// BS-E4 (Round 8 P0): --ai 描述过短 → AI 返回乱流程
|
||||
// (Round 8 P0): --ai 描述过短 → AI 返回乱流程
|
||||
if (opts.ai && opts.ai.trim().length < 10) {
|
||||
log.warn(`BS-E4: --ai 描述过短 (${opts.ai.trim().length} 字符), AI 可能返回不完整流程`)
|
||||
log.warn(` 建议: 描述至少 10 字符, 含完整审批环节 (例: "员工提交 → 主管审批 → 财务付款")`)
|
||||
}
|
||||
|
||||
// BS-E5 (Round 8 P0): workflow --category=<id> 不存在 → 后端 400 模糊
|
||||
// step 0 拦截: 跑 selector 查表, 不存在直接 exit 2
|
||||
// (Round 8 P0): workflow --category=<id> 不存在 → 后端 400 模糊
|
||||
// step 0 拦截: 跑 selector 查表, 不存在直接 exit 2
|
||||
if (opts.category) {
|
||||
try {
|
||||
await initWebapi(c)
|
||||
@@ -160,10 +156,10 @@ export function buildWorkflowCreateCommand(): Command {
|
||||
flowXml = data.flowXml
|
||||
log.info(` ↳ AI 返回 flowXml 长度 ${flowXml.length} 字符`)
|
||||
|
||||
// v0.21+ (Round 12 BS-新43): 检测 AI 返回是否 trivial (≤1 userTask).
|
||||
// Round 12: 5/5 workflow --ai 都生 "Start → 审批 → End" 3-node trivial, baseline 节点全丢.
|
||||
// NCPF backend LLM prompt 缺节点规格, dacli 端不可修.
|
||||
// 客户端侦测 + WARN 推荐用 --flowXml 直传 baseline
|
||||
// (Round 12 检测 AI 返回是否 trivial (≤1 userTask).
|
||||
// Round 12: 5/5 workflow --ai 都生 "Start → 审批 → End" 3-node trivial, baseline 节点全丢.
|
||||
// NCPF backend LLM prompt 缺节点规格, dacli 端不可修.
|
||||
// 客户端侦测 + WARN 推荐用 --flowXml 直传 baseline
|
||||
const trivial = detectTrivialFlowXml(flowXml)
|
||||
if (trivial.isTrivial) {
|
||||
log.warn(trivial.warning)
|
||||
@@ -171,9 +167,9 @@ export function buildWorkflowCreateCommand(): Command {
|
||||
}
|
||||
|
||||
// C方案: 自动布局 (镜像 web handleAutoLayoutByHorizontal 思路)
|
||||
// AI 返回的 XML 所有节点 bounds=(400,300) 完全重叠, 不自动布局浏览器打开会全挤在一起
|
||||
// bpmn-moddle 纯 XML 解析 (无 DOM 依赖), Node 端跑 BFS 水平布局
|
||||
// BS-E14 (Round 8 P2): --layout-threshold 参数, 默认 0.8 (80% 重叠触发)
|
||||
// AI 返回的 XML 所有节点 bounds=(400,300) 完全重叠, 不自动布局浏览器打开会全挤在一起
|
||||
// bpmn-moddle 纯 XML 解析 (无 DOM 依赖), Node 端跑 BFS 水平布局
|
||||
// (Round 8 P2): --layout-threshold 参数, 默认 0.8 (80% 重叠触发)
|
||||
const layoutThreshold = parseFloat(opts.layoutThreshold || '0.8')
|
||||
if (await isLayoutNeeded(flowXml, layoutThreshold)) {
|
||||
log.info(` ↳ 检测到 AI XML 节点/waypoint 坐标重叠 (阈值 ${layoutThreshold * 100}%), 触发自动布局 (B方案: 镜像 web bpmn-js handleAutoLayoutByHorizontal)`)
|
||||
@@ -208,7 +204,7 @@ export function buildWorkflowCreateCommand(): Command {
|
||||
flowXml,
|
||||
flowNodes: {},
|
||||
flowConfig: opts.flowConfig || '{}',
|
||||
// v0.21+ BS-drift-W-4 fix: --sortCode 透传 (默认 0)
|
||||
// --sortCode 透传 (默认 0)
|
||||
sortCode: parseInt(opts.sortCode || '0', 10),
|
||||
showType: Number(opts.showType ?? '0'),
|
||||
iconBackground: opts.iconBackground ?? '#108ee9',
|
||||
@@ -220,9 +216,9 @@ export function buildWorkflowCreateCommand(): Command {
|
||||
const enhanced = enhanceFromBackend(createResp.msg || '', 'workflow', { entity: 'workflow' })
|
||||
log.error(` ${formatErrorLine(enhanced, { step: 2, stepName: 'create template' })}`)
|
||||
|
||||
// v0.21+ R14 fix (BS-新43b): stale pre-validate "已存在 SU001" cleanup + retry ONCE
|
||||
// R13 现象: 前次失败留的 partial workflow (templateId 已知 or enCode 已注册) 阻塞 retry.
|
||||
// 修法: 检测 "已存在/SU001/预校验" → 找 stale id → 删除 → 重试一次.
|
||||
// fix (stale pre-validate "已存在 SU001" cleanup + retry ONCE
|
||||
// 现象: 前次失败留的 partial workflow (templateId 已知 or enCode 已注册) 阻塞 retry.
|
||||
// 修法: 检测 "已存在/SU001/预校验" → 找 stale id → 删除 → 重试一次.
|
||||
const isStalePreValidate = /已存在|SU001|预校验|already exists/i.test(String(createResp.msg || ''))
|
||||
if (isStalePreValidate) {
|
||||
log.warn(`BS-新43b: stale pre-validate detected, 尝试清理 + retry`)
|
||||
@@ -290,7 +286,7 @@ export function buildWorkflowCreateCommand(): Command {
|
||||
const hasGlobal = 'global' in flowNodes
|
||||
log.ok(` ↳ ${nodeCount} 个节点 (含 global=${hasGlobal}, start.formId=${opts.startFormId || '(none)'})`)
|
||||
|
||||
// v0.21+ BS-drift-W-3 fix: 镜像 web bpmnLintUtil.ts 结构校验 (不创角色/节点数校验)
|
||||
// 镜像 web bpmnLintUtil.ts 结构校验 (不创角色/节点数校验)
|
||||
const structCheck = validateFlowNodeStructure(flowNodes)
|
||||
if (structCheck.errorList.length > 0) {
|
||||
// 镜像 web 端 DesignForm.vue:130-134 (setErrorList + validatePopoverRef 弹窗)
|
||||
@@ -418,7 +414,7 @@ export function buildWorkflowCreateCommand(): Command {
|
||||
}
|
||||
|
||||
/**
|
||||
* v0.11d+ step machine 校验 (3 步镜像 web flowEngine/Form.vue + 后端 TemplateController.create)
|
||||
* step machine 校验 (3 步镜像 web flowEngine/Form.vue + 后端 TemplateController.create)
|
||||
*/
|
||||
async function runWorkflowStepMachine(
|
||||
c: JnpfClient,
|
||||
|
||||
Reference in new issue
Block a user