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

+69 -23
View File
@@ -220,30 +220,76 @@ function HeaderContent() {
<ThemeToggle className="w-11 h-11" />
</div>
<nav className="max-w-container mx-auto px-4 sm:px-6 py-6">
{config.mainNav.map((item, index) => (
<motion.div
key={item.id}
initial={{ x: 20, opacity: 0 }}
animate={{ x: 0, opacity: 1 }}
transition={{ delay: index * 0.05 }}
>
<StaticLink
href={item.href}
onClick={handleNavClick}
className={`
block px-4 py-4 text-base font-medium
transition-all duration-normal ease-out
${isActive(item)
? 'text-text-primary bg-bg-secondary'
: 'text-text-secondary hover:text-text-primary hover:bg-bg-secondary'
}
`}
style={{ minHeight: '48px', display: 'flex', alignItems: 'center' }}
{config.mainNav.map((item, index) => {
/**
* 抽屉必须把该轴的**二级目的地**也铺出来(2026-10-17 补,缺陷由 e2e 守卫发现)。
*
* 一级导航改双轴后「产品」退出一级、降为能力面板里的组
* (ADR-0008 决策二)。桌面端靠 hover mega 面板仍可达,
* 但移动端抽屉原本**只渲染 `config.mainNav` 这一层** ⇒
* `/products` 在手机上彻底不可达(实测底部 TabBar 的 hrefs 只有
* `['/', '/solutions', '/services', '/insights', '/contact']`),
* 变成只有页脚能到的**移动端孤儿路径**。
* `mobile-user-journeys.spec.ts` 里那条
* 「两条导航机制都到不了 ⇒ 可能已成孤儿」的断言就是这么红的 ——
* 判据命中了真事故,不是测试写坏。
*
* 这里不手风琴化:抽屉本身 `overflow-y-auto` 可滚,
* 而常驻展开少一个交互态、也少一处 a11y 契约要维护。
*/
const groups = item.dropdownKey ? config.megaDropdown?.[item.dropdownKey] : undefined;
return (
<motion.div
key={item.id}
initial={{ x: 20, opacity: 0 }}
animate={{ x: 0, opacity: 1 }}
transition={{ delay: index * 0.05 }}
>
{item.label}
</StaticLink>
</motion.div>
))}
<StaticLink
href={item.href}
onClick={handleNavClick}
className={`
block px-4 py-4 text-base font-medium
transition-all duration-normal ease-out
${isActive(item)
? 'text-text-primary bg-bg-secondary'
: 'text-text-secondary hover:text-text-primary hover:bg-bg-secondary'
}
`}
style={{ minHeight: '48px', display: 'flex', alignItems: 'center' }}
>
{item.label}
</StaticLink>
{groups?.length ? (
<div className="px-4 pb-4">
{groups.map((group) => (
<div key={group.id} className="mt-3 first:mt-0">
<div className="text-[11px] tracking-[0.15em] uppercase font-bold text-text-muted mb-1.5">
{group.title}
</div>
<ul className="list-none m-0 p-0 space-y-1">
{(group.items ?? []).map((sub) => (
<li key={sub.id}>
<StaticLink
href={sub.href}
onClick={handleNavClick}
className="block px-2 py-2 text-sm text-text-secondary hover:text-brand-ink transition-colors duration-hover"
style={{ minHeight: '40px', display: 'flex', alignItems: 'center' }}
>
{sub.title}
</StaticLink>
</li>
))}
</ul>
</div>
))}
</div>
) : null}
</motion.div>
);
})}
<div className="mt-6 px-4 pt-6 border-t border-border-primary">
<Button
className="w-full"
+2 -1
View File
@@ -28,7 +28,8 @@ export function MobileTabBar() {
const isActive = (href: string) => isNavItemActive(pathname, href);
return (
<nav className="fixed bottom-0 left-0 right-0 z-50 md:hidden bg-bg-primary/95 backdrop-blur-xl border-t border-border-primary" style={{ paddingBottom: 'env(safe-area-inset-bottom, 0px)' }}>
<nav role="navigation" aria-label="底部标签导航" data-testid="mobile-tab-bar"
className="fixed bottom-0 left-0 right-0 z-50 md:hidden bg-bg-primary/95 backdrop-blur-xl border-t border-border-primary" style={{ paddingBottom: 'env(safe-area-inset-bottom, 0px)' }}>
<div className="flex items-center justify-around h-16">
{tabs.map((tab) => {
const Icon = tab.icon;