diff --git a/CONTEXT.md b/CONTEXT.md index c530065..da5b319 100644 --- a/CONTEXT.md +++ b/CONTEXT.md @@ -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 新增) diff --git a/docs/acceptance/2026-10-17-ia-e2e/probe-drawer.mjs b/docs/acceptance/2026-10-17-ia-e2e/probe-drawer.mjs new file mode 100644 index 0000000..337bc84 --- /dev/null +++ b/docs/acceptance/2026-10-17-ia-e2e/probe-drawer.mjs @@ -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(); diff --git a/docs/acceptance/2026-10-17-ia-e2e/probe-news.mjs b/docs/acceptance/2026-10-17-ia-e2e/probe-news.mjs new file mode 100644 index 0000000..d2fecd6 --- /dev/null +++ b/docs/acceptance/2026-10-17-ia-e2e/probe-news.mjs @@ -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(); diff --git a/docs/acceptance/2026-10-17-ia-e2e/probe-tabbar.mjs b/docs/acceptance/2026-10-17-ia-e2e/probe-tabbar.mjs new file mode 100644 index 0000000..9b98b91 --- /dev/null +++ b/docs/acceptance/2026-10-17-ia-e2e/probe-tabbar.mjs @@ -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(); diff --git a/docs/acceptance/qa-tracker.md b/docs/acceptance/qa-tracker.md index 6edb8d7..c73ca28 100644 --- a/docs/acceptance/qa-tracker.md +++ b/docs/acceptance/qa-tracker.md @@ -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`**(收集期解析)才算"能加载" | diff --git a/docs/adr/0008-benchmark-grammar-takeover.md b/docs/adr/0008-benchmark-grammar-takeover.md index 9f834b2..f0c54ac 100644 --- a/docs/adr/0008-benchmark-grammar-takeover.md +++ b/docs/adr/0008-benchmark-grammar-takeover.md @@ -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` 的口径就永久是「类名通道」;若裁定去掉,属模板批的视觉改动 + 基线重采。 diff --git a/docs/lessons-learned.md b/docs/lessons-learned.md index dbd7945..4db0876 100644 --- a/docs/lessons-learned.md +++ b/docs/lessons-learned.md @@ -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 --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 的范围、管道的退出码, +都会让人把**没测**读成**测过并通过**。 diff --git a/e2e/mobile-user-journeys.spec.ts b/e2e/mobile-user-journeys.spec.ts index c15a308..e159617 100644 --- a/e2e/mobile-user-journeys.spec.ts +++ b/e2e/mobile-user-journeys.spec.ts @@ -70,10 +70,43 @@ async function navigateViaMobileMenu(page: Page, targetPath: string) { return; } - // 移动端菜单中所有项都是 `` 链接,直接点击 - 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` 超时 + 日志里 `
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: 潜在客户从首页到联系表单的完整旅程 ==================== diff --git a/e2e/uj-08-service-journey.spec.ts b/e2e/uj-08-service-journey.spec.ts index 4d272cd..14ed08b 100644 --- a/e2e/uj-08-service-journey.spec.ts +++ b/e2e/uj-08-service-journey.spec.ts @@ -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: 服务探索者旅程 ==================== diff --git a/e2e/user-journey.spec.ts b/e2e/user-journey.spec.ts index 8d322fd..3e5377c 100644 --- a/e2e/user-journey.spec.ts +++ b/e2e/user-journey.spec.ts @@ -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)'); }); }); diff --git a/e2e/visual-regression.spec.ts b/e2e/visual-regression.spec.ts index ed2b284..a0d99a6 100644 --- a/e2e/visual-regression.spec.ts +++ b/e2e/visual-regression.spec.ts @@ -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 }) => { diff --git a/src/components/layout/header.tsx b/src/components/layout/header.tsx index 52219be..fa48f8d 100644 --- a/src/components/layout/header.tsx +++ b/src/components/layout/header.tsx @@ -220,30 +220,76 @@ function HeaderContent() {