docs(pr): §12.13 终版复验读数回填(test:all 首跑 EXIT=1 的三把归因读数、逐名对账闭合、Lighthouse 复跑)

- test:all:终版首跑 EXIT=1、同条件复跑 EXIT=0(59 passed / 25 skipped)。
  归因不是「记成 flake 翻篇」:①数据面 —— db:seed 前后逐模型行数与 product 的 slug 集合逐一对账未变;
  ②代码面 —— 单跑该 spec --project=firefox ⇒ 9 passed / EXIT=0;
  ③机理 —— playwright.config.ts:12-15 的 fullyParallel + retries:CI?2:0 + workers:CI?1:undefined
  ⇒ 本地全速并行零重试下 firefox 大页墙钟抖动,CI 侧有 retries=2 + workers=1 兜住。
  没有用放宽断言或加 retry 的方式「修」它。
- 视觉基线:125 = 113 重采 + 12 未重写(具名)与 5 张孤儿参照删除后的恒等式写进读数表;
  终版复验再取的逐名清单 visual-manifest-post-schema.json = total 125 / failed 0。
- Lighthouse:schema 落地后重跑仍 EXIT=0(车道 run-post-schema-lane.sh)。
- 复算以 HEAD 为准:check-pr-checklist EXIT=0(31 子项)、tsc EXIT=0。
This commit was merged in pull request #33.
This commit is contained in:
zhangxiang committed 2026-10-17 09:26:48 +08:00
1 parent fd3e4f9cad
commit 6d46dbe81a
2 files changed
+31 -3

No files matched your search

@@ -126,11 +126,11 @@ N/A:本批是 §11 收尾时决策人留给自己的编号待拍清单(DEC-N
| `check:package-keys` | EXIT=0 | 活体注入重复 `"lint"` ⇒ EXIT=1 点名 `scripts.lint`,还原 ⇒ 0 |
| `type-check` / `type-check:e2e` | EXIT=0 / EXIT=0 | 后者的敏感证据:注入重复 `const` ⇒ EXIT=2(TS2451×2) |
| `check:visual` / `check:dead` | EXIT=0 / EXIT=0(dead 0) | 自证先跑 |
| **`npm run test:all`(十段伞形)** | **EXIT=0** | 含 `type-check`+`check:package-keys`+`type-check:e2e`+`lint`+`test:coverage`+`test:integration:real`(23 例)+`check:a11y`+`check:visual`+`test:e2e:fast`(59 passed)+`test:security:headers`;coverage 阈值一行未动 |
| **`npm run test:all`(十段伞形)** | 终版(§12.12 之后)**首跑 EXIT=1 → 同条件复跑 EXIT=0**(59 passed / 25 skipped);上一轮全绿 | 含 `type-check`+`check:package-keys`+`type-check:e2e`+`lint`+`test:coverage`+`test:integration:real`(23 例)+`check:a11y`+`check:visual`+`test:e2e:fast`+`test:security:headers`,coverage 阈值一行未动。**那一次 EXIT=1 有归因读数**:两条红全在 `p6-missing-paths.spec.ts` 的 firefox 单 project ⇒ ①数据面排除:`db:seed` 前后逐模型行数与 `product` 的 slug 集合逐一对账未变;②代码面排除:单跑该 spec `--project=firefox` ⇒ 9 passed;③机理:`playwright.config.ts:12-15` 是 `fullyParallel:true` + `retries: CI?2:0` + `workers: CI?1:undefined` ⇒ 本地全速并行零重试下 firefox 大页墙钟抖动,CI 有 retries=2+workers=1 兜住。**未**用放宽断言或加 retry「修」;全文见 `qa-tracker.md` §12.13 |
| GA4 `@critical`(终版产物) | 16 passed / 0 skipped | 产物内 `G-LGTLCR15KM` 两处 chunk 命中 |
| 全站 axe(终版产物) | `check:axe:routes` EXIT=0、`check:axe` **EXIT=0**(34 路由 × chromium/firefox × light/dark,bgMismatch=0、contrastNodes=0、violationNodes=0、unexpectedStatus=0、non2xxResponses=1 = 期望内的 `/_not-found`) | BASE 按 CI 约定取 **:3100** |
| 视觉基线 | 重采 **113 张**(23/23/23/21/23,按 project 分 5 笔提交);终版只读复跑 **125 passed / 0 failed**;负对照 `--radius-cta=12px` ⇒ **15 failed / EXIT=1**,还原 ⇒ 25 passed | 113 与 §11.6 预测 104 差 9 张,逐名对账未做(见未验证项③) |
| Lighthouse | `npm run lighthouse` **EXIT=0**(11 URL × 3 跑) | 在 DEC-N1 后**重建**的装配产物上取数,非旧装配 |
| 视觉基线 | 重采 **113 张**(23/23/23/21/23,按 project 分 5 笔提交);只读复跑 **125 passed / 0 failed**(终版复验再取一次:`visual-manifest-post-schema.json` total=125 / failed=0);负对照 `--radius-cta=12px` ⇒ **15 failed / EXIT=1**,还原 ⇒ 25 passed | **逐名对账已闭合**:125 = 113 重采 + 12 未重写(具名:`input-default/focused` × 4 桌面类 project、mobile 的 `button-*` 3 张与 `header-navigation`),并删掉 **5 张孤儿参照** `founder-quote-section-*`(该区块已退役、断言早改成 `toHaveCount(0)` 反向守卫);删后每 project 恰好 25 张 = 用例数 |
| Lighthouse | `npm run lighthouse` **EXIT=0**(11 URL × 3 跑) | 在 DEC-N1 后重建的装配上取一次,§12.12 schema 落地后**又重跑一次仍 EXIT=0**(车道 `run-post-schema-lane.sh`) |
评审者请特别关注:`revalidateContent` 是**尽力而为**(数据与审计已落库后执行,逐条 try + `[revalidation-failed]` 日志 + `failed` 回报),
因为刷缓存失败不该把一次成功的写入连带变成 500;HTTP 入口 `/api/cms/revalidate` 仍用严格的 `applyRevalidation`,500 语义不变。
+28
View File
@@ -921,3 +921,31 @@ dev 下 `GoogleAnalytics.tsx` 提前 return null ⇒ 那 16 个 `@critical` 是
空 stdout 被我读成"没有这行"。⇒ 与 §5.44(`sed` 按行号删错行)、§5.45(正则只扫顶层)三条同判:
**查询工具的报错也是证据,不能丢;空结果必须同时证明"这次查询本身成功了"**。
本条结论已改用 `select count(*) …`(不含未知列)与逐字节长度对账重取。
### 12.13 终版复验(§12.12 之后重跑)与一条**有读数的**间歇红归因
schema 落地后不能拿"之前绿过"当终版读数,故整链重跑(`docs/acceptance/2026-10-17-final/run-post-schema-lane.sh`):
| 门禁 | 终版读数 |
|---|---|
| `npm run build` | EXIT=0 |
| `check:axe:routes` → `check:axe` | EXIT=0 / **EXIT=0**(`bgMismatch=0`、`violationNodes=0`、`unexpectedStatus=0`) |
| 视觉只读复跑 + 逐名清单 | EXIT=0;`visual-manifest-post-schema.json` ⇒ **total=125 passed=125 failed=0** |
| GA4 × 4 project | EXIT=0(16 passed / 0 skipped) |
| `npm run test:all` | **首跑 EXIT=1**,同条件复跑 **EXIT=0(59 passed / 25 skipped)**;Lighthouse 见车道尾 |
**那条 EXIT=1 不能记成"已知 flake"就翻篇**,本轮的处理是把归因做成读数:
1. 红因面:两条红都在 `p6-missing-paths.spec.ts` 的 **firefox** 单一 project(`@smoke` 首页→产品列表 / 列表→详情),
其余 project 全过;同一时刻 `check:coverage`、`check:a11y`、`check:visual`、`test:integration:real`(23 例)均已绿。
2. 排除数据面:怀疑过是我 `db:seed` 把 dev.db 内容 upsert 回 seed 值 ⇒ 逐模型对账
`product 6 / solution 6 / service 4 / standalone-product 1 / news 2` **与 seed 前备份完全一致**,
且 `product` 的 slug 集合用 `cmp` 比过为**未变**。
3. 排除代码面:单跑 `p6-missing-paths --project=firefox` ⇒ **9 passed / EXIT=0**;
全量 `test:e2e:fast` 同条件复跑 ⇒ **59 passed / EXIT=0**。
4. 机理:`playwright.config.ts:12-15` 是 `fullyParallel: true` + `retries: CI ? 2 : 0` + `workers: CI ? 1 : undefined`
⇒ **本地全速并行且零重试**,firefox 在大页面上的墙钟抖动就露在这里;CI 侧有 `retries=2 + workers=1` 兜住。
这与 `README.md` 早已记的「唯一红为 firefox 并发墙钟」是同一类,本轮第一次给它配上可复算的三把读数。
⇒ **不通过放宽断言或加 retry 来"修"**(那是把判据调瞎);如需本地稳定复现绿,编排上加 `--workers=1`,
并把这一条留给 CI 口径。登记为口径事实而非缺陷关闭。