Files
eip4-web/e2e/master-detail.spec.ts
zhengwr c735f24c64 refactor(设计中心): 合并「新建功能/新建主子表」为单一入口 + 页面类型选择
设计中心两个「新建」按钮(新建功能 / 新建主子表)合为一个「+ 新建功能」入口:
进去先选页面类型(维护型 CRUD / 树形 / 主子表),再走对应向导。扩展新页型只加一个
选项,不再加顶级按钮;recipe 类型从内部实现差异回归为向导内的一个选择。

- NewFeatureShell 重写:RecipeChooser 类型选择卡 → 按类型【构建时(JS)】分支向导步骤
  (主子表才有「建子表」步及派生/汇总字段)。不依赖 amis 运行时 step hiddenOn——
  amis Wizard.normalizeSteps 只在 props.data 变时重算,向导内选择改 store.data 不触发,
  故 step 级动态跳步不可靠;类型进向导前定、构建时分支才健壮。
- 删 MasterDetailShell.tsx + /new-feature-md 路由 + 设计中心「新建主子表」按钮
  → 设计中心回到「新建功能 + AI 建功能」两入口
- e2e:five-ring/master-detail 改为先点类型选择卡(dc-recipe-*)再进向导;3/3 绿,build 绿

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 18:54:16 +08:00

221 lines
12 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
/**
* 主子表(master-detail)· 浏览器全程点穿 e2e —— 走统一「新建功能」向导。
* 设计中心「+ 新建功能」→ amis wizard:① 建实体(选「主子表」页面类型) → ②【主子表才出现】建子表
* → ③ 生成主子页(compile master-detail-v1) → ④ 发布。
* 断言:发布后经 API 对主表 _ADD 提交主+子行,引擎按主 LIST 列级联落库(status 0);_LOAD 回读子行。
* 后端走 8094(playwright.fivering.config 反代)。数据纪律:afterAll 删主/子实体;其余跑后 psql 清。
*/
import { expect, test, type Page } from '@playwright/test';
import http from 'node:http';
const BACKEND_PORT = 8094;
const TS = Date.now();
const MASTER = `EIP4PT_MDW${TS}M`;
const CHILD = `EIP4PT_MDW${TS}C`;
// 第二个用例(派生+汇总)专用表
const MASTER2 = `EIP4PT_MDD${TS}M`;
const CHILD2 = `EIP4PT_MDD${TS}C`;
function api(method: string, path: string, token?: string, body?: unknown): Promise<{ status: number; json: any }> {
return new Promise((resolve, reject) => {
const data = body ? JSON.stringify(body) : undefined;
const req = http.request({ hostname: 'localhost', port: BACKEND_PORT, path, method,
headers: { 'Content-Type': 'application/json', ...(token ? { Authorization: `Bearer ${token}` } : {}),
...(data ? { 'Content-Length': Buffer.byteLength(data) } : {}) } },
(res) => { let b = ''; res.on('data', (c) => (b += c)); res.on('end', () => {
try { resolve({ status: res.statusCode ?? 0, json: b ? JSON.parse(b) : null }); }
catch { resolve({ status: res.statusCode ?? 0, json: b }); } }); });
req.on('error', reject); if (data) req.write(data); req.end();
});
}
async function adminToken(): Promise<string> {
const r = await api('POST', '/api/auth/login', undefined, { account: 'admin', password: '111111' });
return r.json.token as string;
}
// 在 schema 任意层的 input-table 里按列名找子列(不依赖 JSON 键序,标准层会重序列化打乱键序)。
function findInputTableColumn(node: any, colName: string): any {
if (Array.isArray(node)) {
for (const n of node) { const r = findInputTableColumn(n, colName); if (r) return r; }
return null;
}
if (node && typeof node === 'object') {
if (node.type === 'input-table' && Array.isArray(node.columns)) {
const c = node.columns.find((x: any) => x?.name === colName);
if (c) return c;
}
for (const k of Object.keys(node)) { const r = findInputTableColumn(node[k], colName); if (r) return r; }
}
return null;
}
// 登录 + 进统一新建功能向导 + 选「主子表」页面类型(使②建子表步出现)。
async function openWizardAsMasterDetail(page: Page) {
await page.goto('/login');
await page.getByRole('textbox').first().fill('admin');
await page.locator('input[type="password"]').fill('111111');
await page.getByRole('button', { name: '登录' }).click();
await page.waitForURL((u) => !u.pathname.endsWith('/login'), { timeout: 15_000 });
await page.goto('/design-center');
await page.getByTestId('dc-new-feature').click();
await expect(page.getByTestId('new-feature-shell')).toBeVisible();
// 先选页面类型 = 主子表(统一入口的类型选择卡)→ 进主子表向导(含②建子表步)。
await page.getByTestId('dc-recipe-master-detail').click();
await expect(page.getByPlaceholder('OA_DEMO')).toBeVisible({ timeout: 15_000 });
}
test.afterAll(async () => {
try { const tok = await adminToken();
await api('DELETE', `/api/meta/entity/${CHILD}`, tok);
await api('DELETE', `/api/meta/entity/${MASTER}`, tok);
await api('DELETE', `/api/meta/entity/${CHILD2}`, tok);
await api('DELETE', `/api/meta/entity/${MASTER2}`, tok);
} catch { /* best effort */ }
});
test('主子表 · 统一向导全程点穿(选主子表 → 建主+子 → 生成主子页 → 发布 → 级联保存子行)', async ({ page }) => {
test.setTimeout(120_000);
await openWizardAsMasterDetail(page);
// 步① 建主实体
await page.getByPlaceholder('OA_DEMO').fill(MASTER);
await page.getByPlaceholder('演示(可选)').fill('采购申请');
await page.locator('.cxd-Select').first().click(); // 所属分类
await page.locator('.cxd-Select-option').first().click();
await page.getByRole('button', { name: '加字段' }).click();
await expect(page.getByPlaceholder('TITLE').first()).toBeVisible({ timeout: 10_000 });
await page.getByPlaceholder('TITLE').first().fill('TITLE');
await page.getByPlaceholder('标题').first().fill('标题');
await page.getByRole('button', { name: '保存并下一步' }).click();
// 步② 建子表(选主子表后才出现)
await expect(page.getByPlaceholder('OA_PURCHASE_ITEM')).toBeVisible({ timeout: 15_000 });
await page.getByPlaceholder('OA_PURCHASE_ITEM').fill(CHILD);
await page.getByPlaceholder('采购明细').fill('采购明细');
await page.getByRole('button', { name: '加子表字段' }).click();
await expect(page.getByPlaceholder('TITLE').first()).toBeVisible({ timeout: 10_000 });
await page.getByPlaceholder('TITLE').first().fill('ITEMNAME');
await page.getByPlaceholder('标题').first().fill('物料');
await page.getByRole('button', { name: '保存并下一步' }).click();
// 步③ 生成主子页
await expect(page.getByPlaceholder('如:客户等级维护')).toBeVisible({ timeout: 20_000 });
await page.getByPlaceholder('如:客户等级维护').fill('采购申请主子');
await page.getByRole('button', { name: '保存并下一步' }).click();
// 步④ 发布
await page.getByRole('button', { name: '完成(发布)' }).click();
// ★ 后端断言:发布后主表 _ADD 主+2子行级联落库(LIST 列经引擎自动回填子表外键)
const tok = await adminToken();
await expect.poll(async () => {
const r = await api('POST', `/api/flow/${MASTER}_ADD`, tok,
{ TITLE: '采购单A', DETAILS: [{ ITEMNAME: '水泥' }, { ITEMNAME: '钢筋' }] });
return r.json?.status;
}, { timeout: 25_000, message: '发布后主表 _ADD(含 DETAILS 子行)应级联成功' }).toBe(0);
const s = await api('POST', `/api/flow/${MASTER}_SEARCH`, tok, {});
expect(s.json?.status).toBe(0);
// 子行经 _LOAD 回读,实证级联真落库(_SEARCH 列表不嵌充子数组,_LOAD 才填充)。
const rowA = (s.json?.data?.items ?? []).find((r: any) => r.TITLE === '采购单A');
expect(rowA, '应查到采购单A').toBeTruthy();
const pk = `${MASTER}_ID`;
const loaded = await api('POST', `/api/flow/${MASTER}_LOAD`, tok, { [pk]: String(rowA[pk]).trim() });
const names = (loaded.json?.data?.result?.DETAILS ?? []).map((d: any) => d.ITEMNAME).sort();
expect(names, '子行水泥/钢筋应级联落库').toEqual(['水泥', '钢筋']);
});
test('主子表派生字段+父级汇总 · 统一向导加派生/汇总 → 发布页 tpl+SUM预览+__derive+__rollup → _ADD 服务端派生再聚合', async ({ page }) => {
test.setTimeout(120_000);
await openWizardAsMasterDetail(page);
// 步① 建主实体(含 TOTAL 汇总目标列)
await page.getByPlaceholder('OA_DEMO').fill(MASTER2);
await page.getByPlaceholder('演示(可选)').fill('派生采购');
await page.locator('.cxd-Select').first().click();
await page.locator('.cxd-Select-option').first().click();
await page.getByRole('button', { name: '加字段' }).click();
await expect(page.getByPlaceholder('TITLE').first()).toBeVisible({ timeout: 10_000 });
await page.getByPlaceholder('TITLE').first().fill('TITLE');
await page.getByPlaceholder('标题').first().fill('标题');
await page.getByRole('button', { name: '加字段' }).click();
await expect(page.getByPlaceholder('TITLE').nth(1)).toBeVisible({ timeout: 10_000 });
await page.getByPlaceholder('TITLE').nth(1).fill('TOTAL');
await page.getByPlaceholder('标题').nth(1).fill('总额');
await page.getByRole('button', { name: '保存并下一步' }).click();
// 步② 建子表:4 列 ITEMNAME/ITEMQTY/ITEMPRICE/AMOUNT(默认 string,求值器会数字强转)
await expect(page.getByPlaceholder('OA_PURCHASE_ITEM')).toBeVisible({ timeout: 15_000 });
await page.getByPlaceholder('OA_PURCHASE_ITEM').fill(CHILD2);
await page.getByPlaceholder('采购明细').fill('派生明细');
const childCols = ['ITEMNAME', 'ITEMQTY', 'ITEMPRICE', 'AMOUNT'];
for (let i = 0; i < childCols.length; i++) {
await page.getByRole('button', { name: '加子表字段' }).click();
await expect(page.getByPlaceholder('TITLE').nth(i)).toBeVisible({ timeout: 10_000 });
await page.getByPlaceholder('TITLE').nth(i).fill(childCols[i]);
}
await page.getByRole('button', { name: '保存并下一步' }).click();
// 步③ 生成主子页 + 派生字段 AMOUNT=ITEMQTY*ITEMPRICE + 汇总 TOTAL=SUM(AMOUNT)
await expect(page.getByPlaceholder('如:客户等级维护')).toBeVisible({ timeout: 20_000 });
await page.getByPlaceholder('如:客户等级维护').fill('派生采购主子');
await page.getByRole('button', { name: '加派生字段' }).click();
await expect(page.getByPlaceholder('MONEY')).toBeVisible({ timeout: 10_000 });
await page.getByPlaceholder('MONEY').fill('AMOUNT');
await page.getByPlaceholder('QTY*PRICE').fill('ITEMQTY*ITEMPRICE');
await page.getByRole('button', { name: '加汇总字段' }).click();
await expect(page.getByPlaceholder('TOTAL')).toBeVisible({ timeout: 10_000 });
await page.getByPlaceholder('TOTAL').fill('TOTAL');
await page.getByPlaceholder('AMOUNT').fill('AMOUNT');
// 捕获 compile 响应拿 templateId(验 UI→编译产物)
const compileResp = page.waitForResponse(
(r) => r.url().includes('/api/design/recipe/compile') && r.request().method() === 'POST');
await page.getByRole('button', { name: '保存并下一步' }).click();
const tid = (await (await compileResp).json())?.data?.templateId as string;
expect(tid, 'compile 应返回 templateId').toBeTruthy();
// 步④ 发布
await page.getByRole('button', { name: '完成(发布)' }).click();
const tok = await adminToken();
// ★ 断言1:子表 AMOUNT 列只读 tpl 实时预览 + 表单 api 透传 __derive
const schema = (await api('GET', `/api/page/schema/${tid}`, tok)).json;
expect(JSON.stringify(schema), '表单 api 应透传 __derive').toContain('__derive');
const amountCol = findInputTableColumn(schema, 'AMOUNT');
expect(amountCol, 'AMOUNT 列应存在于 input-table').toBeTruthy();
expect(amountCol.type).toBe('tpl');
expect(amountCol.tpl).toBe('${ITEMQTY*ITEMPRICE}');
expect(amountCol.quickEdit, '派生列 quickEdit 必须显式 false 才保留只读 tpl 预览').toBe(false);
// ★ 断言1b:主表 TOTAL 汇总列只读 static + SUM 实时预览 + 表单 api 透传 __rollup
expect(JSON.stringify(schema), '表单 api 应透传 __rollup').toContain('__rollup');
expect(JSON.stringify(schema), '主表 TOTAL 应为 SUM(ARRAYMAP) 实时预览')
.toContain('SUM(ARRAYMAP(DETAILS, item => item.ITEMQTY*item.ITEMPRICE))');
// ★ 断言2:_ADD 带 __derive+__rollup,子行不带 AMOUNT、主体不带 TOTAL,服务端逐行派生再聚合
await expect.poll(async () => {
const r = await api('POST',
`/api/flow/${MASTER2}_ADD?__derive=${encodeURIComponent('DETAILS|AMOUNT=ITEMQTY*ITEMPRICE')}`
+ `&__rollup=${encodeURIComponent('TOTAL=SUM:DETAILS:AMOUNT')}`, tok,
{ TITLE: '派生单A', DETAILS: [
{ ITEMNAME: '水泥', ITEMQTY: 3, ITEMPRICE: 10 },
{ ITEMNAME: '钢筋', ITEMQTY: 2, ITEMPRICE: '12.5' }] });
return r.json?.status;
}, { timeout: 25_000, message: '派生+汇总 _ADD 应成功' }).toBe(0);
const s = await api('POST', `/api/flow/${MASTER2}_SEARCH`, tok, {});
expect(s.json?.status).toBe(0);
const rows: any[] = s.json?.data?.items ?? [];
const rowA = rows.find((r) => r.TITLE === '派生单A');
expect(rowA, '应查到派生单A').toBeTruthy();
const pk = `${MASTER2}_ID`;
const loaded = await api('POST', `/api/flow/${MASTER2}_LOAD`, tok, { [pk]: String(rowA[pk]).trim() });
const details: any[] = loaded.json?.data?.result?.DETAILS ?? [];
const amts = details.map((d) => Number(d.AMOUNT)).sort((a, b) => a - b);
expect(amts, '服务端派生 AMOUNT=数量×单价(3×10=30,2×12.5=25)').toEqual([25, 30]);
expect(Number(loaded.json?.data?.result?.TOTAL), '服务端聚合 TOTAL=55').toBe(55);
});