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
@@ -215,6 +215,7 @@ Novalon 的 6 个核心产品,互为互补关系,常以组合形式出现在
|
||||
| **替代信号槽 / L3SignalsSlot** | 真实案例/认证需客户授权才能公开,在那之前 L3 不得整段消失(信任真空)。四条替代信号全部指向站内**真实路由**(方法论 / 团队 / 发展历程 / 联系),零编造;服务承诺卡在业务确认前显示「待业务确认」且不可点击 | ✅ 2026-10-17(`src/components/detail/l3-signals-slot.tsx`)|
|
||||
| **承诺单一真源**(commitments) | 一个 `about` 只留一条承诺,散落的 SLA 文案改由 `src/lib/constants/commitments.ts` 派生。历史上存在四条互斥 SLA(`<4小时` / `7×24` / `48小时` / `工作日 2 小时`)+ 一条形似项;现仅保留有授权口径的「工作日 2 小时内回复您的咨询」(basis = target),其余退役 | ✅ 2026-10-17(`src/lib/constants/commitments.ts`)|
|
||||
| **`/* */` 写在 JSX children 位 = 页面文字** | 合法 JSX,`type-check` / 1747 例单测 / `npm run build` 全绿也不会拦,唯一静态防线是 ESLint `react/jsx-no-comment-textnodes`(error)。⇒ 注释要么进 `{/* */}`,要么移到 JSX 之外;新增此类守卫必须配**敏感性证明**(先断言被污染那段 DOM 真渲染了,再变异确认只有这一条转红)| ✅ 2026-10-17(`docs/lessons-learned.md` §5.39)|
|
||||
| **移动端二级目的地必须在抽屉里可达** | 一级导航降级任何轴时,移动抽屉必须渲染该轴的 mega 组(`header.tsx` 的 `config.megaDropdown[item.dropdownKey]`),底部 TabBar 不承载二级项。理由:决策二把「产品」退出一级后,实测 TabBar hrefs 只有 `['/','/solutions','/services','/insights','/contact']` 而抽屉只渲染一级 ⇒ `/products` 在手机上**没有任何导航路径**(只剩页脚)。这条由 e2e 可达性守卫判红发现,不是人肉走查 ⇒ **降级动作必须同时验证两个视口的可达性** | ✅ 2026-10-17(qa-tracker §11.5)|
|
||||
|
||||
#### 门禁断言的有效性口径(chain6/chain7 新增)
|
||||
|
||||
|
||||
@@ -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`**(收集期解析)才算"能加载" |
|
||||
@@ -90,6 +90,16 @@
|
||||
4. `ui/` 组件库里 53 个不可达原语是产品决定,本批不删。
|
||||
5. `.husky/pre-commit` 在 git 里是 mode 100644,因此任何克隆里 lint-staged 都不会随提交执行——这是治理缺口,本批只报告不擅改。
|
||||
6. **彩色编码的第二条通道未被本批的闸覆盖**:`hero-themes.ts` 的 7 个非品牌 `accentColor`
|
||||
7. **决策二的移动端连带缺陷已在终局验证轮修掉**:「产品」退出一级后,移动抽屉只渲染 `mainNav`
|
||||
这一层、底部 TabBar 也没有 `/products`,于是 `/products` 在手机上**没有任何导航路径**(只剩页脚)。
|
||||
这是由 e2e 的可达性守卫判红发现的(不是人肉走查),修法是抽屉为带 `dropdownKey` 的轴
|
||||
渲染其 mega 组。复测:抽屉 26 条链接含 `/products`、二级项 21 个。
|
||||
8. **后台发布/删除不触发缓存失效(DEC-N5,未修)**:`DELETE /api/admin/items` 与 workflow 发布路由
|
||||
都不调 `revalidatePath`,全仓除一条 e2e 外没有任何生产代码调用 `/api/cms/revalidate`,
|
||||
而 8 个页面的注释都写着「CMS 发布/更新时通过 /api/cms/revalidate 主动刷新」
|
||||
⇒ 实测后果是最长 1 小时(`s-maxage=3600`)前台仍显示已删/旧内容。
|
||||
修法是把 `modelCode → paths` 映射从路由里提成可导入函数,再在发布/更新/删除三处调用;
|
||||
属生产内容行为变更,需单独授权。
|
||||
仍以内联样式渲染在产品·方案·服务详情页 hero 徽章上。需要决策人裁定"逐产品色相身份要不要保留";
|
||||
若裁定保留,`check:accents` 的口径就永久是「类名通道」;若裁定去掉,属模板批的视觉改动 + 基线重采。
|
||||
|
||||
|
||||
@@ -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 的范围、管道的退出码,
|
||||
都会让人把**没测**读成**测过并通过**。
|
||||
@@ -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 }) => {
|
||||
|
||||
@@ -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"
|
||||
|
||||
@@ -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;
|
||||
|
||||
Reference in new issue
Block a user