diff --git a/docs/acceptance/2026-10-17-final/PR-DESCRIPTION.md b/docs/acceptance/2026-10-17-final/PR-DESCRIPTION.md index 073bb1a..ba0039a 100644 --- a/docs/acceptance/2026-10-17-final/PR-DESCRIPTION.md +++ b/docs/acceptance/2026-10-17-final/PR-DESCRIPTION.md @@ -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 语义不变。 diff --git a/docs/acceptance/qa-tracker.md b/docs/acceptance/qa-tracker.md index f2bf901..07f365b 100644 --- a/docs/acceptance/qa-tracker.md +++ b/docs/acceptance/qa-tracker.md @@ -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 口径。登记为口径事实而非缺陷关闭。