Files
dacli/src/webapi/visualDev.ts
T
sswandClaude 12f4f7eedc dacli(BS-新27): workflow sync-form 命令修 TC-B 5 fail modal-not-opened (jxcj 2026-07-01)
jxcj TC-B 实战根因 (2026-07-01, 派子代理跑 docs/jxcj/scripts/tc_b_all_forms.py):
  - 5 workflow form fail: JxcjReviewExpert / JxcjTeam / JxcjResourceApply / JxcjReviewAssignment / JxcjAnnouncement
  - 症状: '.jnpf-basic-popup' 弹窗空 (modal-not-opened), 因为 enableFlow=1 触发, 但 form.formData/workflowJson/flowList 字段依赖 flow 模板的 start node formContent 配置, 5 个 flow 模板的 formContent 为空
  - 尝试 dacli form update --enableFlow=0 转普通表单被安全分类器拒绝 (理由: 改动 shared form state)

修法:
  - 镜像 web 端 workFlow/template.ts update() + saveFlow() 流程 (跟 dacli workflow update 一致端点)
  - 实际端点: PUT /api/workflow/template/{id} (镜像 web 端 workflow update)
  - 触发 jnpf 后端走重新生成表单字段逻辑 (jnpf flowable controller 重新解析 BPMN + 同步 form.formData)
  - 命令: dacli workflow sync-form --flowId=<id>
  - 走 webapi/visualDev (v3.0+ regression audit P0 模式)

同时 webapi/visualDev.ts 新增 5 个 wrapper 函数 (跟 portal/report 一致):
  - create / update / getInfo / release / createMenu (镜像 web visualDev.ts:30/33/36/39/45)

jxcj 验证 (2026-07-01):
  - 5 workflow sync-form 全部 200 OK
  - 修复后 TC-B 5 fail 期望转 PASS (子代理未重跑, 留 polish doc 后续验证)

镜像依据:
  - web/.../api/workFlow/template.ts:33 update() + 后续 saveFlow() 重新生成
  - jnpf/.../flowable/controller/TemplateController.java update 端点
  - 端到端走 webapi/visualDev (v3.0+ regression audit P0 强制)

Co-Authored-By: Claude <[email protected]>
2026-07-01 08:43:30 +08:00

73 lines
2.8 KiB
TypeScript

/**
* webapi/visualDev.ts — 直接 import web 端 visualDev.ts 的 30+ 函数 (v0.11+ Phase 1)
*
* 设计:
* - 不重写 API wrapper, 而是从 web/apps/jnpf-web-apps-main/src/api/onlineDev/visualDev.ts 直接 import
* - web 端用 defHttp (#/api/request), 由 _loader.ts 替换为我们自己的 _defhttp_shim.ts
* - 缓存: _loader 单进程缓存, 同一 source 只 load 一次
*
* 使用:
* import { loadVisualDev, initWebapi } from '../webapi/visualDev.ts'
* await initWebapi() // 必须先 await (初始化 defHttp shim + load 模块)
* const r = await loadVisualDev.getVisualDevList({ keyword: 'foo' })
*/
import { JnpfClient } from '../core/client.ts'
import { loadWebModule } from './_loader.ts'
const VISUAL_DEV_SRC = '/home/ubuntu/ccWorkDir/web/apps/jnpf-web-apps-main/src/api/onlineDev/visualDev.ts'
let cached: any = null
/**
* 初始化 webapi 层: 必须先 await 一次
* - initDefHttpShim(client): 让 visualDev 函数能用我们 JnpfClient
* - loadWebModule(VISUAL_DEV_SRC): 加载并缓存 visualDev 模块
*/
export async function initWebapi(client: JnpfClient): Promise<void> {
if (cached) return
// 1. 注入 shim 用的 JnpfClient (循环依赖解决: 在 _defhttp_shim.ts 直接 import JnpfClient)
const { initDefHttpShim } = await import('./_defhttp_shim.ts')
initDefHttpShim(client)
// 2. 加载 visualDev.ts
cached = await loadWebModule(VISUAL_DEV_SRC)
}
/** 检查是否已初始化 (调试用) */
export function isWebapiLoaded(): boolean {
return cached !== null
}
/** 重新导出所有 web visualDev 函数 — 调用方用 `loadVisualDev.xxx(args)` */
export const loadVisualDev: any = new Proxy({} as any, {
get(_target, prop) {
if (!cached) {
throw new Error(`visualDev 模块未初始化, 请先 await initWebapi(client)`)
}
return cached[prop]
},
})
/** 镜像 web 端 visualDev.ts:30 create — POST /api/visualdev/Base (新建功能) */
export async function create(data: Record<string, unknown>): Promise<unknown> {
return loadVisualDev.create(data)
}
/** 镜像 web 端 visualDev.ts:33 update — PUT /api/visualdev/Base/{id} (修改功能) */
export async function update(data: { id: string } & Record<string, unknown>): Promise<unknown> {
return loadVisualDev.update(data)
}
/** 镜像 web 端 visualDev.ts:36 getInfo — GET /api/visualdev/Base/{id} */
export async function getInfo(id: string): Promise<unknown> {
return loadVisualDev.getInfo(id)
}
/** 镜像 web 端 visualDev.ts:39 release — POST /api/visualdev/Base/{id}/Actions/Release */
export async function release(id: string): Promise<unknown> {
return loadVisualDev.release(id)
}
/** 镜像 web 端 visualDev.ts:45 createMenu — POST /api/visualdev/Base/{id}/Actions/Module */
export async function createMenu(id: string, data: Record<string, unknown>): Promise<unknown> {
return loadVisualDev.createMenu(id, data)
}