docs(qa): §14.4–§14.5 收口——数据层自伤防线、两处真根因,全量功能 E2E 1068/0

- §14.4:跨 worktree 的绝对 DATABASE_URL 让旧代码 seed 覆盖本树整库(§14.3 残差读数作废、
  AUTH-NAV 误判的源头);防线 checkSeedTarget 写前中止 + 活体负对照(外部库未被创建)。
  以及 contact 5 次/小时的进程内桶(结构性 429)与 uj-08 面板 280ms 动画 not stable。
- §14.5:曾记为「并行墙钟残差」的 1~3 条逐条查出真因(hydration 前点击、logo 混入菜单选择器、
  contact/login 限流、hover 撞动画),修完即 0。
  最终读数:test:functional(4 project、默认 workers)1068 passed / 0 failed / 44 skipped,EXIT=0。
- 口径修正:隔离能绿 + 集合每轮不同,不足以判为墙钟抖动;先读完整报错、再找同文件已修同类的
  前置约定(如 expectHydrated)。
- PR 描述里 npm run test 一项由「合并后补记的未勾选更正」改为闭合陈述(记录了最初勾错这件事)。
- 终版复算:test:all EXIT=0(149 套件 / 1815 例、真库 23 例、e2e:fast 59 passed)、
  check-pr-checklist EXIT=0(0 个未勾项)、tsc EXIT=0。
This commit was merged in pull request #39.
This commit is contained in:
zhangxiang committed 2026-10-20 06:19:20 +08:00
1 parent 3859d2a966
commit 9971fb54bb
2 files changed
+32 -7

No files matched your search

@@ -77,13 +77,16 @@ N/A:本批是 §11 收尾时决策人留给自己的编号待拍清单(DEC-N
- [x] `npm run test:unit` 全部通过(145 套件 / 1795 例,较 §11 增 4 套件 48 例)
- [x] `npm run test:coverage` 通过 `config/test/jest.config.js` 的 `coverageThreshold`,**未下调任何阈值**
(DEC-N5 新增的是纯函数与调用点断言,覆盖率只增不减;读数见「其他说明」)
- [ ] **更正(合并后补记,2026-10-17)**:原写「`npm run test`(Playwright E2E):功能 + 视觉两条链读数见其他说明」——
**这条勾得不对**。本批实际跑过的是 `test:e2e:fast`(59 passed)、`test:visual:all`(125 passed / 0 failed)、
prod 目标 GA4(16 passed)与受影响旅程(14 passed);**全量 `test:functional`(4 project)本批从未跑过**。
在 HEAD `0da1fa42` 补跑后实取 **1032 passed / 36 failed / 44 skipped(24.5m,EXIT=1)**。
分层归因与对照实验的混杂披露见 `docs/acceptance/qa-tracker.md` §14。
⇒ 本项**保持未勾选**,作为后续修复 PR 的验收条件。这不是「不适用」,是**未通过**;
因此本文件现在会让 `check-pr-checklist.sh` 返回 1 —— 这是刻意的:未过的门不能用措辞洗成已过。
- [x] **合并后补记 → 已闭合(2026-10-17 起,2026-10-19 收口)**:这条最初写的是
「`npm run test`:功能 + 视觉两条链读数见其他说明」,但本批实际只跑过 `test:e2e:fast`、
`test:visual:all`、prod 目标 GA4 与受影响旅程 —— **全量 `test:functional` 从未跑过,勾得不对**。
补跑后走完一整轮定性 → 修根因:`36 failed → 2 → 1 → **0**`,
最终读数 **1068 passed / 0 failed / 44 skipped,EXIT=0**(4 project、默认 workers)。
期间修掉的真因包括:一条 fail-open(门槛算而不施)、4 个触摸目标 23px、
`role="region"` 缺名、登录与联系表单两处进程内限流的结构性 429、
三处 hydration 前的点击(logo/导航/焦点)、面板 280ms 动画下的 hover、以及
跨 worktree 绝对 DATABASE_URL 造成的整库覆盖(含写前中止的守卫)。
全量过程与逐条读数见 `docs/acceptance/qa-tracker.md` §14.1–§14.5。
- [x] `npm run check:contrast` 与 `npm run check:headings` 通过(在 `check:a11y` 内,`test:all` 跑)
- [x] `npm run lighthouse` 满足 `lhci` 断言(**在终版重建产物上重跑**,非 00:04 前的旧装配)
- [x] `npm run test:security:headers` 通过(本批不改响应头/CSP/部署配置,仍随 `test:all` 跑一遍确认无外溢)
+22
View File
@@ -1103,3 +1103,25 @@ webkit/mobile 的 Tab 引擎差异取证法、`pollBoundingBox` 的二次读取
`a[href^="/"]` 把 logo 也算进来。两处都修,**连跑 5/5 绿**(4.7s,此前 15s 超时)。
同时 `uj-08` 的 helper 命中的是工具行那条 `/services`(不是面板入口),且面板正播 280ms 动画
⇒ `not stable` 重试到 15s;改语义锚点「查看全部能力」+ 等 320ms 并断言其 href。
### 14.5 收口:全量功能 E2E **1068 passed / 0 failed / 44 skipped(EXIT=0)**
§14.3 曾把 1~3 条超时记为「并行墙钟残差」,并说 CI 的 retries 兜住。**那个解释是错的**——
继续按「能复现就查根因」推进后发现,它们各自有真因,修完即 **0**:
| 曾记为"残差"的项 | 真因 | 修法 |
|---|---|---|
| `website-acceptance` 导航菜单功能正常(firefox/webkit 15s) | 日志实取 `navigated to "/"` ⇒ 点击命中了 logo;缺 `expectHydrated` + 选择器把 logo 算进菜单 | 补 hydration 前置 + 选择器排除 `href="/"`;**连跑 5/5 绿**(4.7s) |
| `p2:136` Logo点击返回首页(webkit 17.7s) | 同一根因:可见 ≠ 可交互,hydration 窗口内的 click 被丢弃 | 补 `expectHydrated`;**4 project × 3 轮 12/12 绿** |
| `p2:431` 表单必填验证 / 多次提交类 | `/api/contact` 5 次/小时/IP 的**进程内**桶,全量跑里必然 429 | 额度可按环境覆盖(默认 5 不动),e2e harness 抬到 200;`readRateLimitMax` 3 例判据 |
| `@admin` 三条(UJ-03/06/07) | 登录 10 次/15 分钟/IP,同族 | 同上(默认 10 不动,harness 500) |
| `uj-08`(firefox 隔离也红) | helper hover 命中工具行的 `/services` 链接,且面板正播 280ms 动画 ⇒ `not stable` 到 15s | 语义锚点「查看全部能力」+ 等 320ms + 断言其 href |
⇒ 口径修正(这条比数字重要):**「隔离能绿 + 集合每轮不同」不足以判为墙钟抖动**。
这次每一个都被"把报错读到具体那一行"推翻了。以后遇到同类,先做两件事:
①读完整报错(是 goto 超时还是 expect 失败、naviaged to 哪里);②找同文件里**已经修过同类**的用例,
把它的前置(如 `expectHydrated`)当成约定补上。
**最终读数**:`npm run test:functional`(4 project,默认 workers)⇒
**1068 passed / 0 failed / 44 skipped,EXIT=0,13.1m**。
§14.3 的残差表就此作废,仅作为"我一度把真 bug 当抖动"的留痕。