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:
zhangxiang committed 2026-10-17 01:48:34 +08:00
1 parent f23500ff07
commit 133faaba1b
13 files changed
+339 -38

No files matched your search

+52
View File
@@ -621,6 +621,8 @@ git config --get-regexp -i "gitea|credential" 2>/dev/null # ← 空
| 2026-10-17 | 增加 §5.39(注释写在 JSX children 位即成文字节点:type-check、1747 例单测、`npm run build` 三道全绿而页面上看得见 `/* … */`;唯一静态防线是 `react/jsx-no-comment-textnodes`。新增回归断言配「敏感性证明」——先断言被污染的两段 DOM 真渲染了,再用变异确认只有这一条转红)| `src/app/(marketing)/solutions/solution-detail-content-v3.test.tsx`、qa-tracker §11.2 D-2 |
| 2026-10-17 | 增加 §5.40(仪器只在被复用时才坏:`results` 累加器挂 module 层 ⇒ 第二次 `checkGrammar` 的 `.find("R10")` 取到第一份读数,棘轮负对照被读成不判红;同族第二例是自证夹具把「营销面违规」与「豁免全命中」两个互斥前提写进同一份数据,使腐化那一维永远测不到 ⇒ 拆成三个各测一维的情景,含一个全绿情景防恒红)| `scripts/check-visual-grammar.mjs`、`scripts/check-accents.mjs` |
| 2026-10-17 | 增加 §5.41(僵尸令牌:CSS 声明退役而 tailwind 映射未删 ⇒ 类照生成、`var()` 静默取空;R5/R7 各看一侧所以两条都绿。删映射并新增 R11 反向守卫(外部所有者按名豁免且豁免腐化亦判红),负对照实测 `EXIT=1 / 悬空 2 条` ⇒ 还原 11/11。附两条仪器纪律:豁免名单单一真源、先怀疑夹具再怀疑判据)| `tailwind.config.js`、`scripts/check-visual-grammar.mjs` R11、`docs/acceptance/2026-10-17-ia-e2e/` |
| 2026-10-17 | 增加 §5.42(自伤型验证:为清 ISR 缓存手删 `dist/**` 连带删掉已编译的 `news/page.js`,页面 500 而「uj03 命中 0」被读成清除成功;重建后才发现库里真有 2 条因中途失败而未清理的测试行。三条纪律:重置 ISR 只靠重建或 revalidate、「命中 0」必须配页面健康的正对照、破坏性清理后要清点留下的半成品数据。附正面收获:`/products` 移动端孤儿由守卫抓到,判红是对的)| `docs/acceptance/qa-tracker.md` §11.5 |
| 2026-10-17 | 增加 §5.43(`e2e/**/*.ts` 不在 tsconfig include ⇒ type-check EXIT=0 而 spec 里重复 `const revalidateSecret` 让整档无法加载;改 e2e 后必须 `npx playwright test <spec> --list` 才算验证「能加载」)| `e2e/user-journey.spec.ts`、qa-tracker §11.5 DEC-N6 |
### 5.36 判据的适用对象没写进判据:diff 包围盒对全页截图必然假红
@@ -721,3 +723,53 @@ npm run --silent lint | tail -6; echo "EXIT=$?" # 错:拿到的
① 豁免名单写在规则里、夹具里再手抄一遍 ⇒ 改一处另一处悄悄失效(把名单提到 module 层共用);
② 夹具不带那条外部所有者引用 ⇒ 「豁免腐化」先判红,把"已声明不误报"这一维污染成假红,
差点被读成判据坏。**先怀疑夹具,再怀疑判据**。
### 5.42 自伤型验证:为了清缓存手删构建产物,然后把自己的破坏读成"问题已消失"
为了去掉一份冻结在磁盘上的 ISR 产物(`dist/standalone/dist/server/app/news.html` 里
还带着早已删除的 `uj03-test-news-*` 行),我对构建输出目录做了 `rm -rf`——
连带删掉了**已编译的页面模块** `…/(marketing)/news/page.js`。
于是发生三件连起来才看得出全貌的事:
1. standalone 服务打 `Error: Cannot find module '…/news/page.js'`(×6),
依赖 `/news` 的旅程因页面 500 而红。
2. 我当时的"清除验证"是数产物里的 `uj03` 命中数,得到 **0**,看起来像"缓存已干净"。
真相是 **500 的错误页里当然不含那一行**。
这条 0 是自伤的副作用,却被读成了修复成功 —— 与 §5.34(部署判据只看 HTML 200、
不看它引用的资源)同族,但方向更坏:**它把"页面挂了"读成"数据干净了"**。
3. 重建 `npm run build` 后 `news.html` 里 `uj03` 又出现 2 次 —— 才暴露库里真有 2 条残留:
是 UJ-03 因为我破坏的产物而**中途失败、teardown 没跑完**留下的半成品数据。
⇒ 三条纪律:
- **重置 ISR 只能靠重新构建或调用 revalidate,不许手删 `dist/**`**。
`dist` 里既有可丢弃的缓存也有必需的编译产物,二者同层,肉眼分不开。
- 任何「命中 0 / 计数 0」式的清除验证,必须**同时断言页面是健康的**
(正对照:状态码 200 且关键锚点在场)。否则"仪器坏了"与"问题没了"共用同一个 0。
- 破坏性清理让用例中途失败之后,要回头清点它**留下了什么数据**,
而不是只修那条红的断言。本轮善后:按 id 删除自造的 2 条 news 行
(连带 `AuditLog.targetId` 与 `ContentZone.items` 里的 JSON 引用),
`news` 已发布行回到 seed 的 2 条,再重建产物。
顺带一条 IA 层面的正面收获:为「降级后 `/products` 是否仍可到达」写的守卫断言**判红是对的** ——
实测移动端底部 TabBar 只有 `['/', '/solutions', '/services', '/insights', '/contact']`,
而抽屉只渲染一级 `mainNav` ⇒ 一级导航去掉「产品」后,手机上到 `/products` 没有任何导航路径。
修法是在抽屉里渲染该轴的 mega 组(复测:抽屉 26 条链接、含 `/products`、二级项 21 个)。
**如果当时把这条断言改成"找不到就跳过",`/products` 会在手机上静默消失。**
### 5.43 `e2e/**/*.ts` 不在 tsconfig include 里:type-check 全绿也加载不了的重复声明
给 UJ-03 teardown 补 revalidate 时写了第二个 `const revalidateSecret`(同作用域内 Step 6 已有一个)。
`npm run type-check` 全程 **EXIT=0**,因为 `e2e/` 不在 include 范围内;
只有真去收集用例时 babel 解析器才报
`Identifier 'revalidateSecret' has already been declared`,**整个 spec 文件无法加载**(不是某条用例红,是整档红)。
⇒ 改过 e2e 之后,至少跑一次不启服务的解析:
```bash
cd e2e && npx playwright test <改动的 spec> --list # Total: N tests in M files 即"能加载"
```
这条与 §5.38 同属"绿灯的载体没覆盖到那一维":type-check 的范围、管道的退出码,
都会让人把**没测**读成**测过并通过**。