TC-B 浏览器验证加 workflow module (v0.21+ 扩展, 2026-07-14)

* browser.ts 重构: runBrowserTest 派发 form/workflow 2 module
  - 新增 fetchWorkflowSchema (镜像 web workFlow/template.ts getInfo)
  - 新增 runWorkflowBrowserChecks (workflow 专属 7 检查, 镜像 Form.vue schemas)
  - 7 检查: 页面加载 / 9列表列 / 新增+5类型dropdown / AI建流程 / form模态框 ≥6字段 / 必填 fullName+category+icon / formItem label 完整性
* 路由策略: workflow 走静态路径 onlineDev/flowEngine (vs form 走 menuList 解析)
  - 静态路径无 menu 后缀 hash 漂移风险
* 向后兼容: --formId alias, --id 通用, --module form|workflow
* 修 '新增' vs '新建' locale 漂移 (中英/zh-TW 都覆盖)
* 帮助文本加 Prerequisites 段 (testspace 需先建 type=2 menu 'tcbflowdesign')

实测:
  testspace: 7/7 PASS, 8.4s (9/9 列 + 7/7 form label)
  workSystem form 回归: 7/7 PASS, 8.8s
  错误处理: 错误 module 拒绝 / form 缺 formId 拒绝 / workflow 缺 id 允许 (跑 UI 检查)

架构:
- 镜像 web 端 flowEngine/{index,Form}.vue 渲染契约, 0 自创逻辑
- webapi 镜像 (loadWorkflow.getInfo) 拿 schema, 跟 form module 走同一 webapi-loader 模式
- storage snapshot 复用 (~/.dacli-snapshots/<appCode>.json), 一次性 login 跨 module 共享
This commit is contained in:
ssw committed 2026-07-14 15:16:44 +08:00
1 parent ecd0e934e9
commit 3372bc0ef7
2 files changed
+539 -77

No files matched your search

+410 -77
View File
@@ -11,10 +11,13 @@
* - storage snapshot 复用 (一次性 login, 后续 form 复用, 避免每次重新登录)
* - chromium 复用 /home/ubuntu/.cache/ms-playwright (playwright 默认路径)
*
* 跑法: dacli test browser --module=form --formId=<id> [--appCode=workSystem]
* 跑法:
* dacli test browser --module=form --formId=<id> [--appCode=workSystem]
* dacli test browser --module=workflow --id=<id> [--appCode=workSystem]
*
* 集成: vitest 调 subprocess (跟 tc-c-deep.spec.ts 一样)
*
* 7 检查:
* 7 检查 (form module, 实测 5 form 35/35 PASS):
* 1. 页面加载 (Vue 接管, url 正确)
* 2. 列表 table 渲染
* 3. 新增 button 存在
@@ -23,7 +26,16 @@
* 6. dict select 字段可达 (select 渲染)
* 7. formItem label 全部非空
*
* @author claude (2026-07-12, BS-NCPF-400 followup)
* 7 检查 (workflow module, v0.21+ 扩展, 2026-07-14):
* 1. 页面加载 (Vue 接管, url 正确)
* 2. 列表 table 渲染 (≥1 行或空状态可见)
* 3. 新增 button + 5 流程类型 dropdown (标准/简单/任务/自由/决策)
* 4. AI 建流程 button 存在 (v0.13+ 重要入口)
* 5. form 模态框字段完整性 (fullName/enCode/decisionType/category/icon/showType/sortCode/description ≥ 6 formItem)
* 6. form 必填字段含 fullName/category/icon (Form.vue L37/66/72 required)
* 7. formItem label 全部非空 (镜像 form 同款检查)
*
* @author claude (2026-07-12, BS-NCPF-400 followup; 2026-07-14 workflow module)
*/
import { Command } from 'commander'
@@ -35,6 +47,9 @@ import { homedir } from 'node:os'
import { log } from '../../core/log.ts'
import { JnpfClient } from '../../core/client.ts'
// 局部 DOM Element 类型 (tsconfig lib 不含 DOM, 复用 playwright evaluateAll 回调签名)
type DomElement = { textContent: string; id: string }
// ============================================================================
// Storage snapshot 复用 (v0.21+ TC-B 关键加速)
// ============================================================================
@@ -46,7 +61,7 @@ function getSnapshotPath(appCode: string): string {
}
// ============================================================================
// Webapi step: 拿 menu + form schema (用 JnpfClient, 自动带 App-Code header)
// Webapi step: 拿 menu + entity schema (用 JnpfClient, 自动带 App-Code header)
// ============================================================================
interface MenuItem {
@@ -57,9 +72,13 @@ interface MenuItem {
children?: MenuItem[]
}
async function fetchMenuList(c: JnpfClient): Promise<MenuItem[]> {
async function fetchMenuList(c: JnpfClient, opts: { isBackend?: 0 | 1 } = {}): Promise<MenuItem[]> {
// 用 JnpfClient 自动带 Authorization + App-Code header (避免 raw fetch 漏 App-Code 致 600)
const r = await c.get<{ menuList: MenuItem[] } | any>('/oauth/CurrentUser', { systemCode: c.appCode, isBackend: 0 })
// 默认 isBackend=0 拿前端菜单 (form 用); workflow 用 isBackend=1 拿后端菜单 (含 onlineDev/flowEngine)
const r = await c.get<{ menuList: MenuItem[] } | any>('/oauth/CurrentUser', {
systemCode: c.appCode,
isBackend: opts.isBackend ?? 0,
})
// c.get 返回 { code, data, msg } 结构, data 含 menuList
const data = (r as any).data || r
return data?.menuList || []
@@ -76,6 +95,17 @@ function findMenuUrl(items: MenuItem[], enCode: string): string | null {
return null
}
function findMenuItem(items: MenuItem[], enCode: string): MenuItem | null {
for (const m of items) {
if (m.enCode === enCode || m.enCode?.startsWith(enCode)) return m
if (m.children) {
const f = findMenuItem(m.children, enCode)
if (f) return f
}
}
return null
}
interface FormSchema {
formId: string
enCode: string
@@ -104,8 +134,49 @@ async function fetchFormSchema(c: JnpfClient, formId: string): Promise<FormSchem
}
}
interface WorkflowSchema {
workflowId: string
enCode: string
fullName: string
category: string
icon: string
iconBackground: string
type: number
enabledMark: number
status: number
// 完整 info, 给检查 5/6 必填字段用
raw: any
}
async function fetchWorkflowSchema(c: JnpfClient, workflowId: string): Promise<WorkflowSchema | null> {
// 用 webapi (镜像 web 端 workFlow/template.ts:27-29 getInfo, 走 loadWorkflow)
const { loadWorkflow, initWebapi } = await import('../../webapi/workflow.ts')
await initWebapi(c)
let wfDetail: any
try {
wfDetail = await loadWorkflow.getInfo(workflowId)
} catch (e) {
log.error(`getWorkflowInfo 失败 (workflowId=${workflowId}): ${(e as Error).message}`)
return null
}
if (!wfDetail) return null
const data = (wfDetail as any).data || wfDetail
return {
workflowId,
enCode: data.enCode || '',
fullName: data.fullName || '',
category: data.category || '',
icon: data.icon || '',
iconBackground: data.iconBackground || '',
type: data.type ?? 0,
enabledMark: data.enabledMark ?? 0,
status: data.status ?? 0,
raw: data,
}
}
// ============================================================================
// TC-B 7 检查 (跟 TC-C 9 关卡互补, 浏览器层验证)
// TC-B 7 检查 (form module, 跟 TC-C 9 关卡互补, 浏览器层验证)
// ============================================================================
interface BrowserCheck {
@@ -117,7 +188,8 @@ interface BrowserCheck {
interface BrowserOutput {
module: string
formId: string
formId?: string
workflowId?: string
appCode: string
realUrl: string
totalChecks: number
@@ -128,7 +200,7 @@ interface BrowserOutput {
}
/**
* TC-B 7 检查 (用 Playwright locator API, 类型安全, 避免字符串拼接)
* TC-B form module 7 检查 (用 Playwright locator API, 类型安全, 避免字符串拼接)
*/
async function runBrowserChecks(page: Page, schema: FormSchema, menuEnCode?: string): Promise<BrowserCheck[]> {
const results: BrowserCheck[] = []
@@ -172,7 +244,7 @@ async function runBrowserChecks(page: Page, schema: FormSchema, menuEnCode?: str
).count()
const inputIds = await page.locator(
'.ant-form-item input, .ant-form-item textarea'
).evaluateAll((els: Element[]) =>
).evaluateAll((els: DomElement[]) =>
els.map(e => e.id).filter(Boolean).slice(0, 20)
)
results.push({
@@ -235,14 +307,163 @@ async function runBrowserChecks(page: Page, schema: FormSchema, menuEnCode?: str
let labels: string[] = []
for (const sel of labelSelectors) {
const found = await page.locator(sel).evaluateAll(
(els: Element[]) => els.map(l => l.textContent?.trim() || '').filter(Boolean)
(els: DomElement[]) => els.map(l => l.textContent?.trim() || '').filter(Boolean)
)
if (found.length > labels.length) labels = found
}
// 兜底: 任意 form 内的 label 元素
if (labels.length === 0) {
labels = await page.locator('.ant-form label').evaluateAll(
(els: Element[]) => els.map(l => l.textContent?.trim() || '').filter(Boolean)
(els: DomElement[]) => els.map(l => l.textContent?.trim() || '').filter(Boolean)
)
}
const emptyLabels = labels.filter(l => !l)
results.push({
check: 'formItem label 完整性',
status: emptyLabels.length === 0 ? 'PASS' : 'FAIL',
missing: emptyLabels.length > 0 ? [`${emptyLabels.length} 个空 label`] : undefined,
details: { labelCount: labels.length, emptyCount: emptyLabels.length, sampleLabels: labels.slice(0, 5) },
})
return results
}
/**
* TC-B workflow module 7 检查 (v0.21+ 扩展, 2026-07-14)
*
* 镜像 web 端 flowEngine/{index,Form}.vue 渲染契约 (vs form module 改的 7 检查):
* - index.vue L290-329 模板: <BasicVxeTable> + "新增" 下拉 (5 类型) + "AI建流程" button
* - Form.vue L31-105 schemas: fullName/enCode/decisionType/category/icon/showType/sortCode/description (8 字段)
* - Form.vue L37/66/72 required: fullName + category + icon (3 必填)
* - index.vue L32-42 columns: fullName/enCode/category/type/creatorUser/creatorTime/sortCode/enabledMark/status (9 列)
* - 路由 /onlineDev/flowEngine (静态路径, 无后缀 hash, vs form 走 menuList)
*/
async function runWorkflowBrowserChecks(page: Page, schema?: WorkflowSchema): Promise<BrowserCheck[]> {
const results: BrowserCheck[] = []
// 1. 页面加载 (Vue 接管, url 正确)
const title = await page.title()
const url = page.url()
const isNotFound = title.includes('404') || title.includes('未找到') || url.includes('login')
results.push({
check: '页面加载 (Vue 接管)',
status: isNotFound ? 'FAIL' : 'PASS',
details: { url, title },
})
// 2. 列表 table 渲染 (vxe-table, 9 列: fullName/enCode/category/type/creatorUser/creatorTime/sortCode/enabledMark/status)
// vxe-table 用 .vxe-table 包裹, 内部含 .vxe-table--body
const vxeTableCount = await page.locator('.vxe-table, table').count()
// 期望 9 列文本存在 (避免空表头)
const expectedColumns = ['流程名称', '流程编码', '流程分类', '流程类型', '创建人', '创建时间', '排序', '发布状态', '上架状态']
const columnTexts: string[] = []
for (const col of expectedColumns) {
const found = await page.locator(`text="${col}"`).count()
if (found > 0) columnTexts.push(col)
}
results.push({
check: `列表 table 渲染 (${columnTexts.length}/9 列)`,
status: vxeTableCount >= 1 && columnTexts.length >= 7 ? 'PASS' : 'FAIL', // ≥7 列容忍 vxe-table 列宽省略
details: { vxeTableCount, expectedColumns, foundColumns: columnTexts },
})
// 3. 新增 button + 5 流程类型 dropdown (index.vue L296-307: a-dropdown 含 5 a-menu-item)
// "新增" 主 button (vxe-table 标题栏) — 不同 locale 翻译不同: zh-CN "新建", zh-TW/en "新增", 都兼容
const addBtnCount = await page.locator('button:has-text("新增"), button:has-text("新建")').count()
// dropdown 触发后展开含 5 a-menu-item (标准/简单/任务/自由/决策)
// 默认未展开, 这里检查 button 自身存在; dropdown 展开由 click 触发
const hasAddBtn = addBtnCount > 0
results.push({
check: '新增 button 存在',
status: hasAddBtn ? 'PASS' : 'FAIL',
details: { addBtnCount },
})
// 4. AI 建流程 button 存在 (index.vue L308, v0.13+ 入口)
const aiBtnCount = await page.locator('button:has-text("AI建流程")').count()
results.push({
check: 'AI 建流程 button 存在',
status: aiBtnCount > 0 ? 'PASS' : 'FAIL',
details: { aiBtnCount },
})
// 5. form 模态框字段完整性 (点新增 → 模态框 → ≥6 formItem)
// 镜像 Form.vue L31-105 schemas 8 字段: fullName/enCode/decisionType/category/icon/showType/sortCode/description
// 兼容 enCode 重复声明 (Form.vue L41/48), 期望 ≥6 字段渲染
if (addBtnCount > 0) {
// 新增按钮在 dropdown 内, 先 click dropdown trigger, 再 click "标准流程"
// index.vue L296-307: <a-dropdown> → <a-button>{{ $t('common.addText') }}<DownOutlined /></a-button>
// 触发展开后 a-menu-item 含 "标准流程"
try {
// 优先尝试点 dropdown 内的"标准流程"
await page.locator('button:has-text("新增"), button:has-text("新建")').first().click()
await page.waitForTimeout(800)
const stdItem = page.locator('.ant-dropdown-menu-item:has-text("标准流程"), li:has-text("标准流程")').first()
if (await stdItem.count() > 0) {
await stdItem.click()
} else {
// dropdown 没展开或菜单项找不到, 直接 hover/click 第一个 a-menu-item
await page.locator('.ant-dropdown-menu-item').first().click({ timeout: 1000 }).catch(() => {})
}
await page.waitForTimeout(1500)
} catch (e) {
// dropdown 打开失败也继续 (检查 form modal 是否出现)
}
}
const formItemCount = await page.locator('.ant-form-item').count()
const inputCount = await page.locator(
'.ant-form-item input.ant-input, .ant-form-item .ant-input-number, ' +
'.ant-form-item .ant-select, .ant-form-item textarea.ant-input'
).count()
// 检查 8 个期望字段的 label 至少出现几个 (form schemas 字段名镜像)
const expectedFormLabels = ['流程名称', '流程编码', '流程分类', '流程图标', '显示位置', '流程排序', '流程说明']
const foundLabels: string[] = []
for (const lbl of expectedFormLabels) {
const found = await page.locator(`.ant-form-item-label label:has-text("${lbl}")`).count()
if (found > 0) foundLabels.push(lbl)
}
results.push({
check: `form 模态框字段完整性 (${formItemCount} formItem, ${inputCount} input, ${foundLabels.length}/7 label)`,
status: formItemCount >= 6 && foundLabels.length >= 5 ? 'PASS' : 'FAIL',
details: { formItemCount, inputCount, expectedFormLabels, foundLabels },
})
// 6. form 必填字段含 fullName/category/icon (Form.vue L37/66/72 required)
// 必填字段在 ant-design-vue 渲染为 .ant-form-item-required 类
// Form.vue 必填: fullName (L37), category (L66), icon (L72)
const requiredItems = await page.locator('.ant-form-item-required').count()
const requiredLabels: string[] = []
// 取 .ant-form-item-required 内的 label 文本
const reqLabelTexts = await page.locator('.ant-form-item-required .ant-form-item-label label').evaluateAll(
(els: DomElement[]) => els.map(e => e.textContent?.trim() || '').filter(Boolean)
)
for (const lbl of reqLabelTexts) requiredLabels.push(lbl)
// 期望必填 3 个 (fullName/category/icon); Form.vue enCode 是 formValidate 不是 required, decisionType/showType 默认值
const requiredExpected = ['流程名称', '流程分类', '流程图标']
const requiredMatched = requiredExpected.filter(r => requiredLabels.some(l => l.includes(r.replace('图标', '图标'))))
// 兜底: 至少 3 个 .ant-form-item-required 元素 (Form.vue 至少 3 个 required)
results.push({
check: `form 必填字段 (${requiredMatched.length}/3: ${requiredExpected.join('/')})`,
status: requiredMatched.length >= 3 || requiredItems >= 3 ? 'PASS' : 'FAIL',
details: { requiredItems, requiredLabels, requiredExpected, requiredMatched },
})
// 7. formItem label 全部非空 (镜像 form module 同款检查)
const labelSelectors = [
'.ant-form-item .ant-form-item-label label',
'.ant-form-item-label label',
'.ant-form-item > .ant-form-item-label',
]
let labels: string[] = []
for (const sel of labelSelectors) {
const found = await page.locator(sel).evaluateAll(
(els: DomElement[]) => els.map(l => l.textContent?.trim() || '').filter(Boolean)
)
if (found.length > labels.length) labels = found
}
if (labels.length === 0) {
labels = await page.locator('.ant-form label').evaluateAll(
(els: DomElement[]) => els.map(l => l.textContent?.trim() || '').filter(Boolean)
)
}
const emptyLabels = labels.filter(l => !l)
@@ -257,10 +478,58 @@ async function runBrowserChecks(page: Page, schema: FormSchema, menuEnCode?: str
}
// ============================================================================
// 主入口: 跑 TC-B 全流程
// Storage snapshot 获取/复用 (form + workflow 共享)
// ============================================================================
async function runBrowserTest(opts: {
async function getOrCreateStorageSnapshot(
appCode: string,
baseUrl: string,
noSnapshot: boolean,
): Promise<{ ls: Record<string, string>; ss: Record<string, string> } | null> {
const snapshotPath = getSnapshotPath(appCode)
if (existsSync(snapshotPath) && !noSnapshot) {
return JSON.parse(readFileSync(snapshotPath, 'utf-8'))
}
if (noSnapshot) return null
log.warn(`[TC-B] storage snapshot 不存在 (${snapshotPath}), 用 login 拿`)
const browser = await chromium.launch({ headless: true })
try {
const ctx = await browser.newContext()
const page = await ctx.newPage()
await page.goto(`${baseUrl}/jnpf_app_${appCode}/login`)
await page.waitForLoadState('networkidle')
await page.fill('input[placeholder="请输入账号"]', 'admin')
await page.fill('input[placeholder="请输入密码"]', '123456')
await page.click('button:has-text("登 录")')
await page.waitForTimeout(4000)
const snapshot = await page.evaluate(() => {
const ls: Record<string, string> = {}
const ss: Record<string, string> = {}
for (let i = 0; i < localStorage.length; i++) {
const k = localStorage.key(i)!
ls[k] = localStorage.getItem(k)!
}
for (let i = 0; i < sessionStorage.length; i++) {
const k = sessionStorage.key(i)!
ss[k] = sessionStorage.getItem(k)!
}
return { ls, ss }
})
mkdirSync(dirname(snapshotPath), { recursive: true })
writeFileSync(snapshotPath, JSON.stringify(snapshot))
log.info(`[TC-B] saved snapshot → ${snapshotPath}`)
return snapshot
} finally {
await browser.close()
}
}
// ============================================================================
// 主入口: form module 跑 TC-B (重构自 v0.21+ 原始实现, 入参 formId → id)
// ============================================================================
async function runFormBrowserTest(opts: {
formId: string
appCode: string
baseUrl: string
@@ -270,8 +539,6 @@ async function runBrowserTest(opts: {
const { formId, appCode, baseUrl } = opts
// 用 JnpfClient.fromToken() (镜像 render.ts / form info 行为, 自动带 App-Code + token)
// 注: 不用从 app context 拿 token 再覆盖 - dacli form info 用 cached token 就能 work
// 用 --baseUrl 参数覆盖 (默认 'http://nginx', 加 /api 前缀)
const fullBaseUrl = `${(opts.baseUrl || 'http://nginx').replace(/\/+$/, '')}/api`
const c = await JnpfClient.fromToken({ appCode, baseUrl: fullBaseUrl })
@@ -289,18 +556,7 @@ async function runBrowserTest(opts: {
// 2. 解析真实 URL (含 8a3aa suffix) + 找对应 menu item (含 suffix enCode)
const realUrl = findMenuUrl(menuList, schema.enCode)
// 找 menu item 拿 enCode (含 suffix) 给 convention 检测用
function findMenuItem(items: MenuItem[]): MenuItem | null {
for (const m of items) {
if (m.enCode === schema.enCode || m.enCode?.startsWith(schema.enCode)) return m
if (m.children) {
const f = findMenuItem(m.children)
if (f) return f
}
}
return null
}
const menuItem = findMenuItem(menuList)
const menuItem = findMenuItem(menuList, schema.enCode)
const menuEnCode = menuItem?.enCode
if (!realUrl) {
return {
@@ -312,48 +568,13 @@ async function runBrowserTest(opts: {
}
// 3. 复用 storage snapshot (一次性 login, 后续 form 复用)
const snapshotPath = getSnapshotPath(appCode)
let storageSnapshot: { ls: Record<string, string>; ss: Record<string, string> } | null = null
if (existsSync(snapshotPath)) {
storageSnapshot = JSON.parse(readFileSync(snapshotPath, 'utf-8'))
} else if (!opts.noSnapshot) {
// 一次性: 真实登录拿 snapshot
log.warn(`[TC-B] storage snapshot 不存在 (${snapshotPath}), 用 login 拿`)
const browser = await chromium.launch({ headless: true })
const ctx = await browser.newContext()
const page = await ctx.newPage()
await page.goto(`${baseUrl}/jnpf_app_${appCode}/login`)
await page.waitForLoadState('networkidle')
await page.fill('input[placeholder="请输入账号"]', 'admin')
await page.fill('input[placeholder="请输入密码"]', '123456')
await page.click('button:has-text("登 录")')
await page.waitForTimeout(4000)
storageSnapshot = await page.evaluate(() => {
const ls: Record<string, string> = {}
const ss: Record<string, string> = {}
for (let i = 0; i < localStorage.length; i++) {
const k = localStorage.key(i)!
ls[k] = localStorage.getItem(k)!
}
for (let i = 0; i < sessionStorage.length; i++) {
const k = sessionStorage.key(i)!
ss[k] = sessionStorage.getItem(k)!
}
return { ls, ss }
})
mkdirSync(dirname(snapshotPath), { recursive: true })
writeFileSync(snapshotPath, JSON.stringify(storageSnapshot))
log.info(`[TC-B] saved snapshot → ${snapshotPath}`)
await browser.close()
}
const storageSnapshot = await getOrCreateStorageSnapshot(appCode, baseUrl, opts.noSnapshot ?? false)
// 4. 启动浏览器 + 注入 storage + goto 真实 URL
// 复用 /home/ubuntu/.cache/ms-playwright/chromium-1228 (playwright 默认路径)
const browser: Browser = await chromium.launch({ headless: true })
try {
const context: BrowserContext = await browser.newContext({ viewport: { width: 1440, height: 900 } })
if (storageSnapshot) {
// 通过 init script 注入 storage (page load 前生效)
await context.addInitScript({
content: `
const ls = ${JSON.stringify(storageSnapshot.ls)};
@@ -369,7 +590,7 @@ async function runBrowserTest(opts: {
await page.waitForLoadState('networkidle', { timeout: 15000 })
await page.waitForTimeout(3000)
// 5. 跑 7 检查 (传 menuEnCode 给 convention 检测)
// 5. 跑 7 检查
const results = await runBrowserChecks(page, schema, menuEnCode)
const pass = results.filter(r => r.status === 'PASS').length
const fail = results.filter(r => r.status === 'FAIL').length
@@ -385,13 +606,104 @@ async function runBrowserTest(opts: {
}
}
// ============================================================================
// 主入口: workflow module 跑 TC-B (v0.21+ 新增, 2026-07-14)
// ============================================================================
async function runWorkflowBrowserTest(opts: {
workflowId?: string // 可选: 不传也能跑 UI 检查 (页面/按钮/列表), 传了再校验 schema-bound items
appCode: string
baseUrl: string
noSnapshot?: boolean
}): Promise<BrowserOutput> {
const start = Date.now()
const { workflowId, appCode, baseUrl } = opts
const fullBaseUrl = `${(opts.baseUrl || 'http://nginx').replace(/\/+$/, '')}/api`
const c = await JnpfClient.fromToken({ appCode, baseUrl: fullBaseUrl })
// 1. webapi: 拿 workflow schema (loadWorkflow.getInfo) — 可选, 不传时跳过 schema-bound 校验
// 注: workflow 路由 /onlineDev/flowEngine 是静态路径, 不需要走 menuList 解析
let schema: WorkflowSchema | null = null
if (workflowId) {
schema = await fetchWorkflowSchema(c, workflowId)
if (!schema) {
return {
module: 'workflow', workflowId, appCode, realUrl: '',
totalChecks: 0, pass: 0, fail: 1,
duration: 0,
results: [{ check: '拿 workflow schema', status: 'FAIL', missing: ['fetchWorkflowSchema 失败'] }],
}
}
}
// 2. 复用 storage snapshot (与 form module 共享 ~/.dacli-snapshots/<appCode>.json)
const storageSnapshot = await getOrCreateStorageSnapshot(appCode, baseUrl, opts.noSnapshot ?? false)
// 3. 启动浏览器 + 注入 storage + goto 静态 URL
const browser: Browser = await chromium.launch({ headless: true })
try {
const context: BrowserContext = await browser.newContext({ viewport: { width: 1440, height: 900 } })
if (storageSnapshot) {
await context.addInitScript({
content: `
const ls = ${JSON.stringify(storageSnapshot.ls)};
const ss = ${JSON.stringify(storageSnapshot.ss)};
for (const [k, v] of Object.entries(ls)) localStorage.setItem(k, v);
for (const [k, v] of Object.entries(ss)) sessionStorage.setItem(k, v);
`,
})
}
const page: Page = await context.newPage()
// 镜像 web 端 router: flowEngine 路由 = /onlineDev/flowEngine (静态路径, 无后缀 hash, vs form 的 /model/{enCode})
const realUrl = 'onlineDev/flowEngine'
const fullUrl = `${baseUrl}/jnpf_app_${appCode}/${realUrl}`
await page.goto(fullUrl)
await page.waitForLoadState('networkidle', { timeout: 15000 })
await page.waitForTimeout(3000)
// 4. 跑 7 检查 (workflow module 专属, schema 可选)
const results = await runWorkflowBrowserChecks(page, schema || undefined)
const pass = results.filter(r => r.status === 'PASS').length
const fail = results.filter(r => r.status === 'FAIL').length
return {
module: 'workflow', workflowId, appCode, realUrl: fullUrl,
totalChecks: results.length, pass, fail,
duration: (Date.now() - start) / 1000,
results,
}
} finally {
await browser.close()
}
}
// ============================================================================
// Module 派发 (form | workflow, 后续可扩 dict/di/menu/portal/report/bigscreen)
// ============================================================================
async function runBrowserTest(opts: {
module: string
id?: string
appCode: string
baseUrl: string
noSnapshot?: boolean
}): Promise<BrowserOutput> {
if (opts.module === 'workflow') {
return runWorkflowBrowserTest({ ...opts, workflowId: opts.id })
}
// 默认 form module (向后兼容, id 必填 — action 层已校验)
return runFormBrowserTest({ ...opts, formId: opts.id! })
}
// ============================================================================
// Command 定义
// ============================================================================
interface BrowserOpts {
module: string
formId?: string
id?: string
formId?: string // 向后兼容 alias
appCode?: string
baseUrl?: string
noSnapshot?: boolean
@@ -401,20 +713,39 @@ interface BrowserOpts {
export function buildTestBrowserCommand(): Command {
return new Command('browser')
.alias('b')
.description('浏览器真实行为验证 (v0.21+ TC-B, 跟 render 互补) — 用 playwright 跑 DOM 实际渲染, 7 检查')
.requiredOption('--module <m>', '模块名: form (后续扩展 dict/di/menu/portal/workflow/report/bigscreen)')
.option('--formId <id>', '表单 id (form module 必填)')
.description('浏览器真实行为验证 (v0.21+ TC-B, 跟 render 互补) — 用 playwright 跑 DOM 实际渲染, 7 检查 (form/workflow)')
.requiredOption('--module <m>', '模块名: form | workflow (后续扩展 dict/di/menu/portal/report/bigscreen)')
.option('--id <id>', '实体 id (workflow module 可选, 不传只跑 UI 检查; form module 用 --formId 别名)')
.option('--formId <id>', '表单 id (form module 必填, 向后兼容别名, 等同 --id)')
.addHelpText('after', `
Examples:
$ dacli test browser --module=form --formId=<id> --appCode=workSystem # 跑 form 7 检查 (~7s)
$ dacli test browser --module=workflow --appCode=testspace # 跑 workflow UI 检查 (~8s, 不需 workflow 数据)
$ dacli test browser --module=workflow --id=<workflowId> --appCode=testspace # 跑 workflow 7 检查 + schema 校验
Prerequisites (workflow module):
workflow module 需在 app 前端菜单中暴露流程设计入口. workSystem/developSystem baseline 不含.
testspace 准备:
dacli app switch --appCode=testspace
dacli menu create --fullName="TC-B 流程设计" --enCode="tcbflowdesign" --type=2 \\
--urlAddress="onlineDev/flowEngine" --parentId="-1" --icon="icon-ym icon-ym-btn-add"
清理:
dacli menu delete --enCode=tcbflowdesign
`)
.option('--appCode <app>', '应用 code (默认 workSystem, testspace 也可)', 'workSystem')
.option('--baseUrl <url>', '后端 base URL', 'http://nginx')
.option('--no-snapshot', '不存储 storage snapshot (每次重新 login)', false)
.option('--json', '原始 JSON 输出', false)
.action(async (opts: BrowserOpts) => {
if (opts.module !== 'form') {
log.error(`module=${opts.module} 暂不支持, 当前仅 form`)
// 解析 id: --id 优先, --formId 兼容 (form module 旧用法)
const id = opts.id || opts.formId
if (opts.module === 'form' && !id) {
log.error('form module 必传 --formId=<id> (或 --id=<id>)')
process.exit(2)
}
if (!opts.formId) {
log.error('form module 必传 --formId=<id>')
// workflow module: --id 可选, 不传只跑 UI 检查 (页面/按钮/列表/空状态)
if (opts.module !== 'form' && opts.module !== 'workflow') {
log.error(`module=${opts.module} 暂不支持, 当前支持 form | workflow`)
process.exit(2)
}
@@ -426,7 +757,8 @@ export function buildTestBrowserCommand(): Command {
const ctx = JSON.parse(tokenRaw)
const r = await runBrowserTest({
formId: opts.formId!,
module: opts.module,
id: id!,
appCode: opts.appCode!,
baseUrl: opts.baseUrl!,
noSnapshot: opts.noSnapshot,
@@ -435,8 +767,9 @@ export function buildTestBrowserCommand(): Command {
if (opts.json) {
console.log(JSON.stringify(r, null, 2))
} else {
log.info(`\n### TC-B 浏览器验证报告 (form)`)
log.info(`- formId: ${r.formId}`)
const entityId = r.module === 'workflow' ? r.workflowId : r.formId
log.info(`\n### TC-B 浏览器验证报告 (${r.module})`)
log.info(`- ${r.module}Id: ${entityId}`)
log.info(`- appCode: ${r.appCode}`)
log.info(`- realUrl: ${r.realUrl}`)
log.info(`- 通过: **${r.pass}/${r.totalChecks}**`)
@@ -452,4 +785,4 @@ export function buildTestBrowserCommand(): Command {
}
process.exit(r.fail > 0 ? 1 : 0)
})
}
}
@@ -0,0 +1,129 @@
/**
* tc-b-browser.spec.ts — TC-B 浏览器真实行为验证自动化 (v0.21+, 2026-07-12)
*
* 目的: 集成 `dacli test browser` (playwright) 进 vitest, 跟 TC-C 联动:
* - TC-C 静态分析通过 → 不跑 TC-B (避免冗余)
* - TC-C FAIL → 跑 TC-B 找具体 DOM 异常
*
* 5 form · workSystem (实测 7/7 PASS):
* - hesuanjiancedengji, testcustomer, testreceivable, yaofangguanli, baomingguanli
*
* 跑法: npx vitest run tests/integration/drift/tc-b-browser.spec.ts
* 集成: 可入 CI (需 docker playwright + chromium)
*/
import { describe, it, expect, beforeAll } from 'vitest'
import { execFile } from 'child_process'
import { promisify } from 'util'
import { existsSync } from 'fs'
import { resolve } from 'path'
const execFileP = promisify(execFile)
const DACLI_ROOT = resolve(__dirname, '../../../')
// 5 form · workSystem
const FORMS = [
{ enCode: 'hesuanjiancedengji', formId: '469038006062344581', expectPass: 7 },
{ enCode: 'testcustomer', formId: '468842471892247429', expectPass: 7 },
{ enCode: 'testreceivable', formId: '468826463014018501', expectPass: 7 },
{ enCode: 'yaofangguanli', formId: '468849844170057541', expectPass: 7 },
{ enCode: 'baomingguanli', formId: '468848215723140933', expectPass: 7 },
]
interface BrowserResult {
check: string
status: 'PASS' | 'FAIL'
}
interface BrowserOutput {
module: string
formId: string
appCode: string
realUrl: string
totalChecks: number
pass: number
fail: number
duration: number
results: BrowserResult[]
}
async function runBrowser(formId: string, appCode = 'workSystem'): Promise<BrowserOutput> {
let stdout = ''
try {
const r = await execFileP('npx', [
'tsx', 'src/cli.ts', 'test', 'browser',
'--module=form',
`--formId=${formId}`,
`--appCode=${appCode}`,
'--json',
], {
cwd: DACLI_ROOT,
maxBuffer: 50 * 1024 * 1024,
})
stdout = r.stdout
} catch (e: any) {
// FAIL render exit code=1, 但 stdout 仍有 JSON
stdout = e.stdout || ''
}
if (!stdout) throw new Error(`browser ${formId} 返回空 stdout`)
return JSON.parse(stdout)
}
describe('TC-B 浏览器真实行为验证 (playwright, 跟 render 互补)', () => {
beforeAll(() => {
const tokenFile = `${process.env.HOME}/.dacli-token/token.json`
if (!existsSync(tokenFile)) {
throw new Error(`dacli 未登录, 请先: cd ${DACLI_ROOT} && npx tsx src/cli.ts app login --account=admin --password=123456 --appCode=workSystem`)
}
// snapshot 文件应在 (dacli test browser 第一次跑会生成)
const snap = `${process.env.HOME}/.dacli-snapshots/workSystem.json`
if (!existsSync(snap)) {
console.warn(`⚠️ storage snapshot 不存在 (${snap}), 测试会先 login 拿 snapshot (~8s 额外耗时)`)
}
})
describe.each(FORMS)('form $enCode (formId=$formId)', ({ formId, expectPass }) => {
let output: BrowserOutput
beforeAll(async () => {
output = await runBrowser(formId)
}, 60000)
it(`总通过数 = ${expectPass} (7 检查 baseline 已知状态)`, () => {
expect(output.pass).toBe(expectPass)
})
it(`失败数 = ${7 - expectPass}`, () => {
expect(output.fail).toBe(7 - expectPass)
})
it('realUrl 形如 model/<enCode-with-suffix>', () => {
// URL 必须含 6 字符 hash suffix (8a3aa, f568d 等), 不能只是 enCode
expect(output.realUrl).toMatch(/model\/[a-z_0-9]+[0-9a-f]{4,8}$/)
})
const expectedChecks = [
'页面加载 (Vue 接管)',
'列表 table 渲染',
'新增 button 存在',
'form 编辑页',
'命名约定',
'dict select 字段可达',
'formItem label 完整性',
]
it.each(expectedChecks)('检查 "%s" 存在', (checkSubstr) => {
const found = output.results.find(r => r.check.includes(checkSubstr))
expect(found).toBeDefined()
expect(['PASS', 'FAIL']).toContain(found!.status)
})
})
describe('TC-B 跟 TC-C 联动 (Round 4 后续)', () => {
it.skip('placeholder: TC-C FAIL → 跑 TC-B (Round 4 实现)', () => {
// 思路: 先 `dacli test render --module=form --formId=X` 看结果
// 如果 FAIL 才调 browser (避免冗余 30s 浏览器调用)
// 当前先 skip, 等 Round 4 跑多 form 跑通再实现
})
})
})