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:
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` 跑一遍确认无外溢)
|
||||
|
||||
@@ -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 当抖动"的留痕。
|
||||
Reference in new issue
Block a user