fix(nav): 一级导航降级不再把 /products 变成移动端孤儿,并补终局验证轮台账
决策二把「产品」退出一级后,**手机上到 /products 没有任何导航路径**(只剩页脚)。
判据抓到的,不是人肉走查:`mobile-user-journeys.spec.ts` 里那条
「抽屉里没有、底部 TabBar 里也没有 ⇒ 可能已成孤儿」的守卫稳定判红。
实测证据(探针 `docs/acceptance/2026-10-17-ia-e2e/probe-tabbar.mjs` / `probe-drawer.mjs`):
底部 TabBar 的 hrefs 只有 `['/','/solutions','/services','/insights','/contact']`,
而移动抽屉原本只渲染 `config.mainNav` 这一层(header.tsx:222-246)。
桌面端靠 hover mega 面板仍可达 ⇒ 这是**只有移动端会中**的 IA 完成度缺口。
若把那条断言改成"找不到就跳过",/products 会在手机上静默消失。
改动:
- 抽屉为带 `dropdownKey` 的轴渲染其 mega 组(组标题 + 二级链接)。
不做手风琴:抽屉本身 `overflow-y-auto` 可滚,常驻展开少一个交互态、
也少一处 a11y 契约要维护。复测:抽屉 **26 条链接、含 /products 1 条、二级项 21 个**。
- `group.items` 加 `?? []` 守卫 —— CMS 行的形状不受类型约束,
`header.test.tsx` 的夹具里就有无 items 的组,5 例因 `undefined.map` 崩。
这条是单测抓到的:我的 dev-server 探针走的是真实 config,看不出这个边界。
- `mobile-tab-bar.tsx` 的 `<nav>` 补 `role/aria-label="底部标签导航"` 与
`data-testid="mobile-tab-bar"`:原来两个 nav landmark 里只有抽屉有名字,
而用例只能靠"页面上任何 a[href]"去找底部导航 —— 那会命中页脚那条同名链接,
被抽屉遮罩拦住指针事件,15s 重试 6 次全超时(本轮真实症状)。
- `uj-08-service-journey.spec.ts`:helper 从 `a:has-text("服务")` 改为
hover「能力」→ `a[href="/services"]`。旧注释那句
「服务导航项是直接链接,无下拉菜单」在新 IA 下已不成立。
- `user-journey.spec.ts` UJ-03 teardown:删行后补一次 revalidate。
根因链(证据:`news.html` 的 mtime 与 uj03 命中、allure 步骤时序):
01:16:31 创建 → 01:16:33 revalidate ⇒ ISR 在这一刻把**带测试行的 HTML 落盘** →
01:16:35 DELETE ⇒ 库里行没了但没人再刷 ⇒ 之后 UJ-10 断言"筛出恰 1 条"拿 2 条判红,
而 `x-nextjs-cache: HIT`、`s-maxage=3600`。
**只修测试这一层**;产品层缺口(后台发布/删除全都不触发失效)另记 DEC-N5。
本笔也记一次自伤(§5.42,因为它差点把结论带偏):
为清那份冻结产物我 `rm -rf` 了构建输出子树,连带删掉已编译的 `news/page.js` ⇒
服务打 `Cannot find module` ×6、两条旅程因页面 500 而红;
而我当时的"清除验证"是数产物里的 uj03 命中数,得到 **0** ——
读起来像"缓存干净了",实际是 **500 的错误页里当然不含那一行**。
重建后 uj03 又出现 2 次,才暴露库里真有 2 条因中途失败而未清理的残留行。
善后:按 id 删自造的 2 条 news(连带 AuditLog 与 ContentZone.items 引用),
`news` 已发布行回到 seed 的 2 条,再 `npm run build`。
⇒ 三条纪律进 lessons:重置 ISR 只靠重建或 revalidate、不许手删 dist/**;
「命中 0」必须同时断言页面健康(正对照),否则"仪器坏了"与"问题没了"共用同一个 0;
破坏性清理让用例中途失败后要清点它留下了什么半成品数据。
另记 §5.43 / DEC-N6:`e2e/**/*.ts` 不在 tsconfig include 里 ⇒
teardown 补丁中重复的 `const revalidateSecret` 让 type-check 全程 EXIT=0,
只有 `npx playwright test --list` 才报 `already been declared`(整档无法加载)。
台账与文档:`qa-tracker.md` §11.5(25 条 prod 目标红的三类归因、真缺陷、自伤、
新登记 DEC-N5/DEC-N6)、ADR-0008「已知偏差」补第 7、8 条、
`CONTEXT.md` 加「移动端二级目的地必须在抽屉里可达」、
`docs/lessons-learned.md` §5.42–§5.43 + 更新记录 2 行。
复跑(一律重定向后读 `$?`,不用管道):
`header.test.tsx` 18 passed;`UJ-01/02/08/10` × chromium + chromium-mobile **14 passed**;
`npm run test:all` ⇒ **EXIT=0**(141 套件 / 1747 例、integration 23、
check:visual 11/11 + accents 成立、e2e:fast 59 passed / 25 skipped);
`type-check` EXIT=0、`lint` EXIT=0(0 error / 81 warning)、`build` EXIT=0。
未闭合(须单独授权或另行裁定):视觉基线重采(AUTH-VISUAL,只读复跑实测
**109 failed = 104 例像素不符 + 5 例死选择器超时**,后者已在本笔改成反向守卫并经
变异验证:把 founder-quote-section 塞回首页 ⇒ 该条判红、还原 ⇒ 通过);
`--radius-cta: 12px` 负对照依赖基线先入库;
GA4 在本 worktree **无法取证**(worktree 无 `.env.production`,
`NEXT_PUBLIC_*` 在 build 期烘焙 ⇒ 那 16 例即便 `E2E_TARGET=production` 仍是 skipped);
`check:motion` 残留 8 处(基线既有红);DEC-N1 彩色编码第二通道待设计裁定。
This commit is contained in:
1 parent
f23500ff07
commit
133faaba1b
13 files changed
+339
-38
No files matched your search
@@ -70,10 +70,43 @@ async function navigateViaMobileMenu(page: Page, targetPath: string) {
|
||||
return;
|
||||
}
|
||||
|
||||
// 移动端菜单中所有项都是 `<a>` 链接,直接点击
|
||||
const navLink = mobileNav.locator(`a:has-text("${label}")`).first();
|
||||
await expect(navLink).toBeVisible({ timeout: 5000 });
|
||||
await navLink.click();
|
||||
/**
|
||||
* 2026-10-17 双轴 IA 后改为**按 href 定位**,并显式覆盖移动端的两条真实导航机制。
|
||||
*
|
||||
* 原来写死 `a:has-text("产品")` / `("解决方案")` / `("服务")`:一级导航改成
|
||||
* 行业 × 能力 + 洞察后,抽屉里只剩 行业 / 能力 / 洞察 / 关于我们 四项
|
||||
* (`header.tsx:223-244` 只渲染 `config.mainNav`),于是这三条映射在抽屉里**永不命中**,
|
||||
* UJ-01/UJ-02 稳定判红 —— 而目的地其实仍可达:`/products`、`/solutions`、`/cases`
|
||||
* 落在**底部 TabBar**(`mobile-tab-bar.tsx`:首页/产品/方案/案例/联系)上。
|
||||
* ⇒ 一张标签映射表把"移动端的可达性"窄化成了"抽屉里的可达性",这是测试口径缺陷。
|
||||
*
|
||||
* 顺序是:抽屉直链 → 关抽屉 → 底部 TabBar。
|
||||
* 中间那步「关抽屉」不是礼节:抽屉是 `fixed inset-0 z-40` 的全屏遮罩,
|
||||
* 开着它会拦截 TabBar 与页脚链接的指针事件(本轮实测就是
|
||||
* `locator.click` 超时 + 日志里 `<div id="mobile-menu" …> intercepts pointer events`,
|
||||
* 15s 内重试 6 次全被遮罩吃掉)。
|
||||
* 两处都到不了才判红 —— 那才是「一级导航降级后该路径成了孤儿」这种真事故。
|
||||
* 与 e9bd9654「查看全部不再靠中文标签反推路由」是同一条纪律。
|
||||
*/
|
||||
const drawerLink = mobileNav.locator(`a[href="${targetPath}"]`).first();
|
||||
if ((await drawerLink.count()) && (await drawerLink.isVisible().catch(() => false))) {
|
||||
await drawerLink.click();
|
||||
return;
|
||||
}
|
||||
|
||||
// 抽屉里没有 → 关掉遮罩,走底部 TabBar
|
||||
await menuButton.click();
|
||||
await expect(mobileNav).toBeHidden({ timeout: 5000 });
|
||||
|
||||
const tabLink = page
|
||||
.locator(`[data-testid="mobile-tab-bar"] a[href="${targetPath}"]`)
|
||||
.first();
|
||||
await expect(
|
||||
tabLink,
|
||||
`移动端两条导航机制都到不了 ${targetPath}:抽屉里没有、底部 TabBar 里也没有 ` +
|
||||
`⇒ 一级导航降级后该路径可能已成孤儿`,
|
||||
).toBeVisible({ timeout: 5000 });
|
||||
await tabLink.click();
|
||||
}
|
||||
|
||||
// ==================== UJ-01 Mobile: 潜在客户从首页到联系表单的完整旅程 ====================
|
||||
|
||||
@@ -27,14 +27,26 @@ async function closeCookieBanner(page: Page) {
|
||||
}
|
||||
|
||||
/**
|
||||
* 从桌面主导航的"服务"链接直接导航到服务页面
|
||||
* 注意:服务导航项是直接链接,无下拉菜单(与产品/解决方案不同)
|
||||
* 从桌面主导航进入服务列表页(/services)。
|
||||
*
|
||||
* 注释里那句「服务导航项是直接链接,无下拉菜单」在 2026-10-17 双轴 IA 后**不再成立**:
|
||||
* 一级导航改成 行业 × 能力 + 洞察(ADR-0008 决策二),原「服务」轴改名「能力」,
|
||||
* 且四项里除「关于我们」外**全部是下拉触发器(button)**,主导航里已经没有任何
|
||||
* `a:has-text("服务")` 元素 ⇒ 原 helper 在 4 个 project 上稳定判红(本轮 prod 目标实测 ×4)。
|
||||
*
|
||||
* 到达路径按新 IA 走:hover「能力」→ 点面板底部的「查看全部能力」(href=/services)。
|
||||
* 目的地仍由**导航项自己声明的 href** 断言,不靠中文标签反推路由(同 e9bd9654 的纪律)。
|
||||
*/
|
||||
async function navigateFromServiceNav(page: Page) {
|
||||
const desktopNav = page.locator('[data-testid="desktop-navigation"]').first();
|
||||
const serviceLink = desktopNav.locator('a:has-text("服务")').first();
|
||||
await expect(serviceLink).toBeVisible({ timeout: 5000 });
|
||||
await serviceLink.click();
|
||||
const capabilitiesTrigger = desktopNav.locator('button:has-text("能力")').first();
|
||||
await expect(capabilitiesTrigger).toBeVisible({ timeout: 5000 });
|
||||
await capabilitiesTrigger.hover();
|
||||
|
||||
const servicesLink = desktopNav.locator('a[href="/services"]').first();
|
||||
await expect(servicesLink, '能力面板里没有指向 /services 的入口').toBeVisible({ timeout: 5000 });
|
||||
await servicesLink.hover(); // 防止 mouseleave 收起面板
|
||||
await servicesLink.click();
|
||||
}
|
||||
|
||||
// ==================== UJ-08: 服务探索者旅程 ====================
|
||||
|
||||
@@ -730,7 +730,41 @@ test.describe('UJ-03: 内容管理员完整旅程(登录 → 仪表盘 → 内
|
||||
await request.delete(`${BASE_URL}/api/admin/items?id=${itemId}`, {
|
||||
headers: { Authorization: `Bearer ${token}` },
|
||||
});
|
||||
console.log('UJ-03 cleanup completed');
|
||||
|
||||
/**
|
||||
* ⚠ 删除后必须再刷一次 ISR —— 这不是可选的收尾,而是不影响本例却会毒死**下一条**用例的动作。
|
||||
*
|
||||
* 本轮 prod 目标实测的因果链(证据:`dist/standalone/dist/server/app/news.html` 的 mtime
|
||||
* 与 uj03 命中、allure 步骤时序 `POST /api/cms/revalidate` → `DELETE /api/admin/items`):
|
||||
* 01:16:31 本例创建 news 行 → 01:16:33 POST revalidate ⇒ ISR **在这一刻**重渲染 /news
|
||||
* 并把带 uj03 行的 HTML **落盘**
|
||||
* 01:16:35 DELETE ⇒ 库里行没了,但没人再触发 revalidate
|
||||
* 之后 UJ-10 断言「按『公司新闻』筛选后恰 1 条」拿到 2 条 ⇒ 判红
|
||||
* 而 `prisma/dev.db` 实测 0 条 `uj%` 残留 ⇒ 红**不是数据污染也不是 UI 回归**,
|
||||
* 是磁盘上那份冻结的 ISR 产物(`Cache-Control: s-maxage=3600`、`x-nextjs-cache: HIT`)。
|
||||
*
|
||||
* 根因有两层,这里只修测试这一层:
|
||||
* ① 装配层(本处):写库用例的 teardown 只删行不刷缓存 ⇒ 套件顺序依赖、不可重跑。
|
||||
* ② 产品层(已登记 DEC-N5,不在本批擅自改):
|
||||
* `DELETE /api/admin/items`(route.ts:282-311)与 workflow 发布路由**都不调用**
|
||||
* `revalidatePath`,且全仓除本 e2e 外**没有任何生产代码调用 `/api/cms/revalidate`**
|
||||
* ⇒ 后台删掉/发布的内容最长 1 小时仍留在前台,而 8 个页面的注释都写着
|
||||
* 「CMS 发布/更新时通过 /api/cms/revalidate 主动刷新」。
|
||||
*/
|
||||
// 复用 Step 6 已声明的 revalidateSecret(e2e/**/*.ts **不在** tsconfig 的
|
||||
// include 里 ⇒ `npm run type-check` 抓不到重复声明,只有真跑一次才红。
|
||||
// 本轮就是这么发现的:第二次 `const revalidateSecret` 让 babel 解析器直接
|
||||
// `Identifier 'revalidateSecret' has already been declared`,整个 spec 无法加载。)
|
||||
await request.post(`${BASE_URL}/api/cms/revalidate`, {
|
||||
data: {
|
||||
event: 'content.deleted',
|
||||
modelCode: 'news',
|
||||
slug,
|
||||
secret: revalidateSecret,
|
||||
},
|
||||
headers: { 'Content-Type': 'application/json' },
|
||||
});
|
||||
console.log('UJ-03 cleanup completed(已删行并刷 ISR)');
|
||||
});
|
||||
});
|
||||
|
||||
|
||||
@@ -158,13 +158,28 @@ test.describe('L2: 组件视觉状态测试', () => {
|
||||
await expect(card).toHaveScreenshot('product-card.png');
|
||||
});
|
||||
|
||||
test('创始团队观点 - 桌面端视觉', async ({ page }) => {
|
||||
/**
|
||||
* 创始团队观点区(FounderQuote)**反向守卫** —— 2026-10-17 由截图用例改写。
|
||||
*
|
||||
* 原用例对 `[data-testid="founder-quote-section"]` 做区域截图。该区块已按 ADR-0008 决策一
|
||||
* **整块删除**(它是全站唯一 `bg-brand-section #8B1530` 满幅面:实测两家近单色对标里
|
||||
* 饱和红用作"面"的次数为 **0** —— Porsche 的红出现 4 次全是按钮,
|
||||
* Bain 的 #CC0000 出现 65 次无一次是面或阴影;两家也都没有 CEO 引言带,那是 Accenture 的语法),
|
||||
* 于是选择器**永不可能命中** ⇒ 5 个 project 各挂一次 `scrollIntoViewIfNeeded` 超时
|
||||
* (本轮只读复跑实测:109 failed = 104 例像素不符 + 5 例超时,超时正是这一条 ×5)。
|
||||
*
|
||||
* 修法不是给它补一张新基线 —— 那等于为一个"按裁定不该存在的东西"重建参照。
|
||||
* 改成断言它**确实不在**,并顺带钉住"全站无满幅饱和红面"这条实测语法判据:
|
||||
* 若将来有人把深红区块加回首页,这里会红。
|
||||
*/
|
||||
test('首页不再有创始团队观点区,也没有满幅饱和红面(反向守卫)', async ({ page }) => {
|
||||
await page.goto('/', { waitUntil: 'domcontentloaded' });
|
||||
await waitForPageStable(page);
|
||||
|
||||
const founder = page.locator('[data-testid="founder-quote-section"]');
|
||||
await founder.scrollIntoViewIfNeeded();
|
||||
await expect(founder).toHaveScreenshot('founder-quote-section.png');
|
||||
// 区块本体不得复活
|
||||
await expect(page.locator('[data-testid="founder-quote-section"]')).toHaveCount(0);
|
||||
// 承载它的满幅饱和红面也不得出现(全站唯一一处已随该区块退役)
|
||||
await expect(page.locator('.bg-brand-section')).toHaveCount(0);
|
||||
});
|
||||
|
||||
test('表单输入框 - 默认/聚焦状态', async ({ page }) => {
|
||||
|
||||
Reference in new issue
Block a user