weichen
b594d2748e
Why: after login the store's identity epoch and the capability probe each settle once more; the app closes open workspaces on identity change, so clicking the sidebar entry too early raced the overlay close (intermittent 加载中 hang, caught across I4 e2e runs). Evidence: instrumented probe (rows=2 parsed then overlay closed on identity bump); settled-login rerun follows on the Dev I4 card. Impact: spec stability only. Refs: rollout I4
172 lines
10 KiB
TypeScript
172 lines
10 KiB
TypeScript
// I4 组合验收（Playwright）：文档驾驶舱七场景（rollout §3.I4 最小场景集）。
|
||
// 驱动方：Dev 仓 scripts/e2e.sh——构建 RDM 二进制（含 I1/I3 命令面）+ frontend dist，
|
||
// 种子：审计演示项目（rdm-self + cockpit-e2e 结构装载；两个章节经草稿流落正文；
|
||
// 一个章节留空；第二个账号 e2e-reader 不入项目做权限负例）。
|
||
// 环境契约与 rdm-audit.playwright.ts 一致；PLAYWRIGHT_BASE_URL 未设置时整组跳过。
|
||
import { test, expect, type Page } from '@playwright/test'
|
||
|
||
const OWNER = process.env.E2E_OWNER || 'e2e-auditor'
|
||
const PASSWORD = process.env.E2E_PASSWORD2 || 'E2eAudit#2026b'
|
||
const READER = process.env.E2E_READER || 'e2e-reader'
|
||
const READER_PASSWORD = process.env.E2E_READER_PASSWORD || 'E2eReader#2026'
|
||
const MAIN = process.env.E2E_PROJECT_MAIN || '审计演示项目'
|
||
|
||
test.skip(!process.env.PLAYWRIGHT_BASE_URL, 'set PLAYWRIGHT_BASE_URL (scripts/e2e.sh drives this suite)')
|
||
|
||
async function login(page: Page, user: string, password: string) {
|
||
await page.goto('/')
|
||
await expect(page.getByPlaceholder('由管理员分配')).toBeVisible()
|
||
await page.getByPlaceholder('由管理员分配').fill(user)
|
||
await page.getByPlaceholder('初始密码或常用密码').fill(password)
|
||
await page.getByRole('button', { name: '登录', exact: true }).click()
|
||
}
|
||
|
||
async function loginOwner(page: Page) {
|
||
await login(page, OWNER, PASSWORD)
|
||
await expect(page.locator('.tsb-tool', { hasText: '文档驾驶舱' })).toBeVisible({ timeout: 15_000 })
|
||
// 登录后身份纪元与能力探针仍可能各跳一次；应用在身份变更时会关闭已开
|
||
// 工作区——等落定再点入口，避免 overlay 被身份刷新关掉（竞态实测）。
|
||
await page.waitForLoadState('networkidle').catch(() => {})
|
||
await page.waitForTimeout(1_500)
|
||
}
|
||
|
||
async function openCockpit(page: Page) {
|
||
await page.locator('.tsb-tool', { hasText: '文档驾驶舱' }).click()
|
||
await expect(page.locator('.cockpit-project')).toBeVisible({ timeout: 15_000 })
|
||
// 默认选中首个项目（种子=审计演示项目）。
|
||
await expect(page.locator('.cockpit-stats')).toBeVisible({ timeout: 15_000 })
|
||
}
|
||
|
||
async function openReaderOnDoc(page: Page, title: string) {
|
||
await page.locator('.cockpit-tree-title', { hasText: title }).first().click()
|
||
await page.getByRole('button', { name: '在阅读器中打开' }).click()
|
||
await expect(page.locator('.cockpit-reader')).toBeVisible()
|
||
}
|
||
|
||
test.describe.serial('I4 文档驾驶舱组合验收', () => {
|
||
// 场景 1：首次进入项目——统计带、结构树、全景可见（DV-R01/R02）。
|
||
test('1 首屏：统计、树、全景可见且统计可判读', async ({ page }) => {
|
||
await loginOwner(page)
|
||
await openCockpit(page)
|
||
// placeholder
|
||
await expect(page.locator('.cockpit-stat', { hasText: '完成度' })).toBeVisible()
|
||
await expect(page.locator('.cockpit-stat', { hasText: '文档' })).toBeVisible()
|
||
// 空 vs 不可算不得互相冒充：有数据项目的空缺计数显示数字。
|
||
await expect(page.locator('.cockpit-stat', { hasText: '空缺节点' }).locator('.cockpit-stat-num')).toHaveText(/^\d+$/)
|
||
await expect(page.locator('.cockpit-tree-title', { hasText: '验证主体报告' }).first()).toBeVisible()
|
||
await expect(page.getByText('文档概览')).toBeVisible()
|
||
await expect(page.locator('.cockpit-snap')).toContainText(/快照 wm:\d+/)
|
||
})
|
||
|
||
// 场景 2：文档→章节，全景与阅读器双向定位（DV-R03）。
|
||
test('2 定位：树选章节→阅读器正文；返回全景仍同一节点', async ({ page }) => {
|
||
await loginOwner(page)
|
||
await openCockpit(page)
|
||
// 展开目标文档（树按标题排序，branch 作用域防跨文档串扰），点「概述」。
|
||
const branch = page.locator('.cockpit-tree-branch', { hasText: '验证主体报告' }).first()
|
||
await branch.locator('.cockpit-tree-caret').click()
|
||
const sec = branch.locator('.cockpit-tree-title', { hasText: '概述' }).first()
|
||
await expect(sec).toBeVisible()
|
||
sec.click()
|
||
await expect(page.locator('.cockpit-nodehead')).toBeVisible()
|
||
// 全景→阅读器：同一 nodeRef（阅读器显示该节标题与正文）。
|
||
await page.getByRole('button', { name: '在阅读器中打开' }).click()
|
||
await expect(page.locator('.cockpit-reader')).toBeVisible()
|
||
await expect(page.locator('.cockpit-nodetitle', { hasText: '概述' })).toBeVisible()
|
||
const body = page.locator('.cockpit-reader-para', { hasText: '本报告' }).first()
|
||
await expect(body).toBeVisible()
|
||
// 阅读器→全景：返回后仍是选中节点（节点头仍在）。
|
||
await page.getByRole('button', { name: '← 返回全景' }).click()
|
||
await expect(page.locator('.cockpit-nodehead')).toBeVisible()
|
||
})
|
||
|
||
// 场景 3：四面板展开并正确显示计数；受限与空态诚实（DV-R04）。
|
||
test('3 面板：来源/历史/影响/冲突计数与空态、截断旗标', async ({ page }) => {
|
||
await loginOwner(page)
|
||
await openCockpit(page)
|
||
const branch = page.locator('.cockpit-tree-branch', { hasText: '验证主体报告' }).first()
|
||
await branch.locator('.cockpit-tree-caret').click()
|
||
await branch.locator('.cockpit-tree-title', { hasText: '概述' }).first().click()
|
||
const panel = page.locator('.cockpit-panel')
|
||
await expect(panel).toBeVisible()
|
||
// 来源：草稿落版本挂了依据切片（种子经 ingest 提供）。
|
||
await panel.getByRole('tab', { name: '内容来源' }).click()
|
||
await expect(panel.locator('.cockpit-panel-count')).toContainText(/来源 \d+ 条/)
|
||
// 历史：已提交事件（structure + draft 链）。
|
||
await panel.getByRole('tab', { name: '修改历史' }).click()
|
||
await expect(panel.locator('.cockpit-panel-count')).toContainText('已提交事件')
|
||
await expect(panel.locator('.cockpit-panel-row').first()).toBeVisible()
|
||
// 影响：一跳；空/计数二态都诚实。
|
||
await panel.getByRole('tab', { name: '影响对象' }).click()
|
||
await expect(panel.locator('.cockpit-panel-count')).toContainText(/影响 \d+ 项/)
|
||
// 冲突：种子无开放碰撞 → 明确「无开放冲突」而非空白。
|
||
await panel.getByRole('tab', { name: '冲突与风险' }).click()
|
||
await expect(panel.getByText('无开放冲突')).toBeVisible()
|
||
// 版本块（I3）：当前版本+差异折叠入口可见。
|
||
await expect(page.locator('.cockpit-versions-toggle')).toBeVisible()
|
||
})
|
||
|
||
// 场景 4：后台变更后所有投影一致（DV-R05）——测试经 API 采纳新版本，
|
||
// 驾驶舱刷新后统计水位/树时间/详情版本块同步前进。
|
||
test('4 一致性：API 采纳新版本后，刷新入口与各投影同步', async ({ page }) => {
|
||
await loginOwner(page)
|
||
await openCockpit(page)
|
||
await page.locator('.cockpit-tree-caret').first().click()
|
||
await page.locator('.cockpit-tree-title', { hasText: '设计说明' }).first().click()
|
||
const snapBefore = await page.locator('.cockpit-snap').innerText()
|
||
// 通过应用自身 API 采纳一个新提案（同源会话；与浏览器渲染解耦）。
|
||
await page.request.post('/api/commands/rdm.draft.propose', {
|
||
data: { params: { projectId: (await page.locator('.cockpit-project option:checked').textContent()) || '', sectionId: '', content: '一致性探针内容——不应出现' }, meta: {} },
|
||
failOnStatusCode: false,
|
||
})
|
||
// 上面缺 sectionId 必然 400：真正的驱动是 e2e.sh 早已留好的第二个提案
|
||
// （种子阶段 propose 未采纳的「一致性探针」），这里经面板刷新读取。
|
||
await page.getByRole('button', { name: '刷新' }).click()
|
||
await expect(page.locator('.cockpit-snap')).not.toHaveText(snapBefore)
|
||
// 版本块前进：出现新版本条目。
|
||
await expect(page.locator('.cockpit-versions-toggle')).toContainText(/版本 v\d+/)
|
||
})
|
||
|
||
// 场景 5：断线/失败保留旧快照并给出重试（DV-R08）——page.route 掐断命令面。
|
||
test('5 失败：命令面断连时保留旧快照并出现重试入口', async ({ page }) => {
|
||
await loginOwner(page)
|
||
await openCockpit(page)
|
||
await expect(page.locator('.cockpit-stats')).toBeVisible()
|
||
// 掐断后续命令面：切换项目触发重取 → 失败横幅 + 旧内容保留。
|
||
await page.route('**/api/commands/rdm.cockpit.**', route => route.abort())
|
||
await page.locator('.cockpit-refresh').click()
|
||
await expect(page.locator('.cockpit-banner-err')).toBeVisible()
|
||
await expect(page.locator('.cockpit-stats')).toBeVisible() // 旧快照未被清空
|
||
await page.unroute('**/api/commands/rdm.cockpit.**')
|
||
await page.locator('.cockpit-refresh').click()
|
||
await expect(page.locator('.cockpit-banner-err')).toBeHidden()
|
||
})
|
||
|
||
// 场景 6：权限负例——非成员账号看不到项目（无项目诚实空态；不泄露存在性）。
|
||
test('6 权限：非成员账号无项目可见', async ({ page }) => {
|
||
await login(page, READER, READER_PASSWORD)
|
||
await page.locator('.tsb-tool', { hasText: '文档驾驶舱' }).click()
|
||
await expect(page.getByText('暂无可见研发项目')).toBeVisible({ timeout: 15_000 })
|
||
await expect(page.locator('.cockpit-tree-title', { hasText: '验证主体报告' })).toHaveCount(0)
|
||
})
|
||
|
||
// 场景 7：窄屏、键盘、减少动效（DV-R07）。
|
||
test('7 可用性：390 宽无横向溢出、键盘可达、减少动效可用', async ({ page }) => {
|
||
await page.emulateMedia({ reducedMotion: 'reduce' })
|
||
await page.setViewportSize({ width: 390, height: 844 })
|
||
await loginOwner(page)
|
||
await openCockpit(page)
|
||
// 无横向溢出。
|
||
const overflow = await page.evaluate(() => document.documentElement.scrollWidth - document.documentElement.clientWidth)
|
||
expect(overflow).toBeLessThanOrEqual(1)
|
||
// 键盘：统计卡/树行可聚焦（tab 序含驾驶舱交互件）。
|
||
await page.locator('.cockpit-tree-title').first().focus()
|
||
await expect(page.locator('.cockpit-tree-title').first()).toBeFocused()
|
||
// 18px 大字（html font-size 注入）不破坏统计带布局。
|
||
await page.addStyleTag({ content: 'html{font-size:18px !important}' })
|
||
await expect(page.locator('.cockpit-stats')).toBeVisible()
|
||
const overflowBig = await page.evaluate(() => document.documentElement.scrollWidth - document.documentElement.clientWidth)
|
||
expect(overflowBig).toBeLessThanOrEqual(8)
|
||
})
|
||
})
|