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
@@ -0,0 +1,15 @@
|
||||
import { chromium } from 'playwright';
|
||||
const b = await chromium.launch();
|
||||
const p = await b.newPage({ viewport: { width: 390, height: 844 } });
|
||||
await p.goto('http://localhost:3214/', { waitUntil: 'domcontentloaded' });
|
||||
await p.waitForTimeout(3500);
|
||||
await p.locator('[data-testid="mobile-menu-button"]').click();
|
||||
await p.waitForTimeout(900);
|
||||
const drawer = p.locator('[data-testid="mobile-navigation"]');
|
||||
const hrefs = await drawer.locator('a').evaluateAll(as => as.map(x => x.getAttribute('href')));
|
||||
console.log('抽屉链接总数:', hrefs.length);
|
||||
console.log('含 /products:', hrefs.filter(h => h === '/products').length);
|
||||
console.log('前 12 条:', hrefs.slice(0, 12).join(' '));
|
||||
const groups = await drawer.locator('ul li a').count();
|
||||
console.log('二级项个数:', groups);
|
||||
await b.close();
|
||||
@@ -0,0 +1,16 @@
|
||||
import { chromium } from 'playwright';
|
||||
const b = await chromium.launch();
|
||||
const p = await b.newPage({ viewport: { width: 390, height: 844 } });
|
||||
await p.goto('http://localhost:3212/news', { waitUntil: 'domcontentloaded' });
|
||||
await p.waitForTimeout(3000);
|
||||
const links = await p.locator('a[href*="/news/"]').evaluateAll(a => a.map(x => ({
|
||||
href: x.getAttribute('href'), text: x.textContent.trim().slice(0, 30),
|
||||
inFooter: !!x.closest('footer'), inHeader: !!x.closest('header')})));
|
||||
console.log('全部 /news/ 链接:', JSON.stringify(links));
|
||||
await p.locator('button', { hasText: '公司新闻' }).first().click();
|
||||
await p.waitForTimeout(1200);
|
||||
const after = await p.locator('a[href*="/news/"]').evaluateAll(a => a.map(x => ({
|
||||
href: x.getAttribute('href'), text: x.textContent.trim().slice(0, 24),
|
||||
inFooter: !!x.closest('footer'), inHeader: !!x.closest('header')})));
|
||||
console.log('筛选后:', JSON.stringify(after));
|
||||
await b.close();
|
||||
@@ -0,0 +1,15 @@
|
||||
import { chromium } from 'playwright';
|
||||
const b = await chromium.launch();
|
||||
const p = await b.newPage({ viewport: { width: 390, height: 844 } });
|
||||
await p.goto('http://localhost:3214/', { waitUntil: 'domcontentloaded' });
|
||||
await p.waitForTimeout(3000);
|
||||
console.log('tab bar count:', await p.locator('[data-testid="mobile-tab-bar"]').count());
|
||||
console.log('tab bar a count:', await p.locator('[data-testid="mobile-tab-bar"] a').count());
|
||||
console.log('/products in tabbar:', await p.locator('[data-testid="mobile-tab-bar"] a[href="/products"]').count());
|
||||
console.log('all tabbar hrefs:', await p.locator('[data-testid="mobile-tab-bar"] a').evaluateAll(as => as.map(x => x.getAttribute('href'))));
|
||||
// 打开抽屉后再看
|
||||
await p.locator('[data-testid="mobile-menu-button"]').click();
|
||||
await p.waitForTimeout(800);
|
||||
console.log('抽屉打开后 /products in tabbar:', await p.locator('[data-testid="mobile-tab-bar"] a[href="/products"]').count());
|
||||
console.log('tabbar visible:', await p.locator('[data-testid="mobile-tab-bar"]').isVisible());
|
||||
await b.close();
|
||||
@@ -561,3 +561,54 @@ D-2 的回归守卫:`solution-detail-content-v3.test.tsx` 新增断言,且**
|
||||
| DEC-N4 | `CaseStudiesSection` / `detail-trust-section` **没有**授权与 basis 门槛(只有新成果槽有) | 应同闸;改的是既有转化页文案可见性,需与业务确认口径后再动 |
|
||||
| AUTH-VISUAL | 视觉基线重采(radius / 阴影 / hover / CTA 全变)+ `--radius-cta: 12px` 负对照 | 写基线需单独授权;负对照若 N=0 则只读复跑的绿灯作废 |
|
||||
| AUTH-NAV | CMS `navigation/default` 行改写 | 写库是共享状态动作;现行由代码 fail-closed 供数,不改库也能上线 |
|
||||
|
||||
### 11.5 终局验证轮(2026-10-17 续):三条 prod 目标读数 + 一个真缺陷 + 一次自伤
|
||||
|
||||
`test:e2e:prod`(harness 起 `node dist/standalone/server.js`,非 `next start`)首跑
|
||||
**94 passed / 25 failed / 25 skipped**。25 条红逐条归因后**只剩 1 类是真事故**:
|
||||
|
||||
| 红因类 | 条数 | 定性 | 处置 |
|
||||
|---|---|---|---|
|
||||
| 旧导航标签硬编码(`a:has-text("服务")`、抽屉里 `("产品")`/`("解决方案")`) | 6 | 本批 IA 变更的连带,**测试口径落后于 IA** | 已重写(见下) |
|
||||
| `/news` 筛选计数 2≠1 | 8 | **冻结的 ISR 落盘产物**:`dist/standalone/dist/server/app/news.html` 里含 `uj03-test-news-*`,而 `prisma/dev.db` 实测 0 条 `uj%` 行;响应头 `x-nextjs-cache: HIT`、`s-maxage=3600` | 装配层已修(UJ-03 teardown 删行后补 revalidate);**产品层缺口另记 DEC-N5** |
|
||||
| `check:axe` 未能度量 | — | `EXIT=2`,路由清单 `/tmp/axe-routes.xml` 不存在(须先跑 `check:axe:routes`)——**不是判红,是没测** | 按序补跑 |
|
||||
|
||||
#### 真缺陷:一级导航降级把 `/products` 变成了**移动端孤儿路径**(已修)
|
||||
|
||||
- 现象:守卫断言 `[data-testid="mobile-tab-bar"] a[href="/products"]` 稳定读不到元素。
|
||||
- 实测:底部 TabBar 的 hrefs 只有 `['/', '/solutions', '/services', '/insights', '/contact']`,
|
||||
而移动抽屉原本**只渲染 `config.mainNav` 这一层**(`header.tsx:222-246`)⇒
|
||||
「产品」退出一级后,手机上**没有任何导航路径**能到 `/products`(只剩页脚)。
|
||||
桌面端靠 hover mega 面板仍可达,所以这是**只有移动端会中**的 IA 完成度缺口。
|
||||
- 修法:抽屉为带 `dropdownKey` 的轴渲染其 mega 组(常驻展开,不做手风琴 ——
|
||||
抽屉本身 `overflow-y-auto` 可滚,少一个交互态就少一处 a11y 契约要维护)。
|
||||
复测:抽屉链接 **26 条,含 `/products` 1 条,二级项 21 个**;
|
||||
`UJ-01/02/08/10` × chromium + chromium-mobile ⇒ **14 passed / 0 failed**。
|
||||
- 记一笔正面价值:**这条红是判据抓对了,不是测试写坏了**。
|
||||
「降级后仍可到达」这个断言的全部意义就在于此;若当时把它调成"找不到就跳过",
|
||||
`/products` 会在手机上静默消失。
|
||||
|
||||
#### 本轮的自伤(必须记,否则下一轮还会做)
|
||||
|
||||
为了"清掉那份冻结的 ISR 产物",我对构建输出目录做了 `rm -rf`(含 `(marketing)/news` 子树),
|
||||
结果连**已编译的页面模块** `dist/standalone/dist/server/app/(marketing)/news/page.js` 一起删了:
|
||||
|
||||
- 直接症状:standalone 服务打 `Error: Cannot find module '…/(marketing)/news/page.js'` ×6,
|
||||
`UJ-01 Mobile` / `UJ-03` 因页面 500 而红。
|
||||
- 更糟的是**验证被自己的破坏污染**:我当时跑「产物里 uj03 命中数 = 0」得到 0,
|
||||
读起来像"缓存已干净",实际是**页面根本渲染失败**(500 的 HTML 里当然不含那行)。
|
||||
`npm run build` 重建后 `news.html` 里 uj03 又出现 2 次,才暴露 DB 里真有 2 条残留行
|
||||
——那是 UJ-03 因我破坏的产物而**中途失败、teardown 没跑完**留下的。
|
||||
- 三条纪律:① 重置 ISR 只能靠 **重新构建** 或调用 revalidate,不许手删 `dist/**`;
|
||||
② 任何"命中 0"式的清除验证必须同时断言**页面是健康的**(正对照:状态码 200 且关键锚点在),
|
||||
否则"仪器坏了"与"问题没了"共用同一个 0;③ 破坏性清理若让用例中途失败,
|
||||
要回头查它留下了什么**半成品数据**,而不是只修红的那条断言。
|
||||
- 善后:自造的 2 条 `uj03-test-news-*` 已按 id 删除(连带 AuditLog 与 ContentZone.items 引用),
|
||||
`news` 已发布行回到 seed 的 2 条;随后 `npm run build`(EXIT=0)重建产物。
|
||||
|
||||
#### 新登记
|
||||
|
||||
| 编号 | 项 | 说明 |
|
||||
|---|---|---|
|
||||
| DEC-N5 | **后台发布/删除不触发缓存失效**:`DELETE /api/admin/items`(`route.ts:282-311`)与 workflow 发布路由都不调 `revalidatePath`;全仓除 `e2e/user-journey.spec.ts` 外**没有任何生产代码调用 `/api/cms/revalidate`**,而 8 个页面注释都写着「CMS 发布/更新时通过 /api/cms/revalidate 主动刷新」 | 实测后果:最长 1 小时(`s-maxage=3600`)前台上仍是已删/旧内容。修法是把 `modelCode → paths` 的映射从 `api/cms/revalidate/route.ts` 里**提成可导入的函数**(同 §5.30「安全抽象必须可导入」),再在发布/更新/删除三处调用。属生产内容行为变更,本批不擅改 |
|
||||
| DEC-N6 | `e2e/**/*.ts` 不在 `tsconfig` 的 include 内 ⇒ `npm run type-check` 抓不到 e2e 里的类型/重复声明错误 | 本轮实例:teardown 补丁里第二个 `const revalidateSecret` 与既有声明重名,type-check 全程 EXIT=0,只有 `npx playwright test --list` 才报 `Identifier 'revalidateSecret' has already been declared`。口径:**改 e2e 后必须至少跑一次 `--list`**(收集期解析)才算"能加载" |
|
||||
Reference in new issue
Block a user