diff --git a/docs/acceptance/2026-10-17-final/PR-DESCRIPTION.md b/docs/acceptance/2026-10-17-final/PR-DESCRIPTION.md index 2db5b84..8e6927e 100644 --- a/docs/acceptance/2026-10-17-final/PR-DESCRIPTION.md +++ b/docs/acceptance/2026-10-17-final/PR-DESCRIPTION.md @@ -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` 跑一遍确认无外溢) diff --git a/docs/acceptance/qa-tracker.md b/docs/acceptance/qa-tracker.md index 8bfb247..c4214fa 100644 --- a/docs/acceptance/qa-tracker.md +++ b/docs/acceptance/qa-tracker.md @@ -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 当抖动"的留痕。