docs(qa): §14 合并后补跑全量功能 E2E,并把 PR #33 里一条不实勾选改回未勾选

本批只跑过 test:e2e:fast + 视觉 + GA4 + 受影响旅程,从未跑过全量 test:functional,
而 #33 的描述把那条链勾成了已过 —— 与 §5.47 同族(引用未成立的读数)。
在 HEAD 0da1fa42 补跑后实取 1032 passed / 36 failed / 44 skipped(24.5m,EXIT=1)。

- 对照:基线 worktree cov-base @ da9a5cb6 只跑其中 8 个红 spec × chromium ⇒ 163 passed / 7 failed。
  7 条与 A 层既有红同位(mobile.spec.ts、p2-functional-e2e、user-journey UJ-01/02、website-acceptance)。
- 混杂自己说破:对照树缺 dev.db 与 .env,是我从本批树拷的当前库 ⇒ 旧代码 + 新数据,
  对依赖导航/内容数据的 spec 不是纯净对照;纯净对照未做 ⇒ B 层不下"与本批无关"的结论。
- 分层登记:A 既有红 / B 待归因(证言区零断言守卫、ARIA 与焦点、触摸目标 ≥24px 硬门禁)/
  C 环境权限类(3 条 @admin 旅程仅 ~170ms 失败)。四条下一步含「把 fast ≠ 全量写进 AGENTS.md §5 口径」。
- PR-DESCRIPTION.md 该项保持未勾选 ⇒ 该文件的 checklist 现在 EXIT=1,是刻意状态;
  本笔另出 PR-CORRECTION.md 作为后续 PR 的描述(checklist EXIT=0)。
- 对照树已清场:拷过去的 dev.db / .env / .env.production 与 WAL sidecar 全删,恢复原状。

复算:tsc EXIT=0、check:package-keys EXIT=0、新描述文件 checklist EXIT=0、旧描述文件 checklist EXIT=1(刻意)。
This commit was merged in pull request #36.
This commit is contained in:
zhangxiang committed 2026-10-17 10:02:36 +08:00
1 parent 0da1fa4255
commit fe80e4dcb7
3 files changed
+133 -1

No files matched your search

@@ -0,0 +1,91 @@
# PR(仅文档更正):§14 全量功能 E2E 补跑 + 一条不实勾选的更正
承接已合并的 #33/#34/#35。本 PR **不含任何代码改动**,只落两件事:
`docs/acceptance/qa-tracker.md` 新增 §14,以及把 `PR-DESCRIPTION.md` 里那条不实的勾选项改成**保持未勾选的更正记录**。
## 变更摘要
在 #33 合入 dev 之后,我才补跑了**本批从未跑过**的全量 `npm run test:functional`(4 project):
- 本批树 `0da1fa42`:**1032 passed / 36 failed / 44 skipped**(24.5m,EXIT=1)
- 对照(基线 worktree `cov-base` @ `da9a5cb6`,只跑其中 8 个红 spec × chromium):**163 passed / 7 failed / 1 skipped**
于是 #33 描述里那条「`npm run test`(Playwright E2E):功能 + 视觉两条链读数见其他说明」被证明是
**引用未成立的读数**(我实际只跑过 `test:e2e:fast` + 视觉 + GA4 + 受影响旅程)。本 PR 把它改为未勾选并写明原因;
`check-pr-checklist.sh` 对该文件现在返回 1 —— 这是刻意的,未过的门不能用措辞洗成已过。
红项按证据强度分三层(全文见 §14):A 既有红(对照组同一 spec 同一位置同错,7 条,多为旧导航锚点);
B 待归因(对照组未红:证言区"零断言"守卫、ARIA/焦点、触摸目标 ≥24px 硬门禁、3 条 `@admin` 旅程);
C 环境/权限类(`@admin` 失败仅 ~170ms)。**对照实验的混杂我自己说破**:对照树缺 `dev.db` 与 `.env`,
是我从本批树拷了当前这份库过去 ⇒ 代码旧、数据新,对依赖导航/内容数据的 spec 不是纯净对照;
纯净对照(用 `da9a5cb6` 自己的 seed 库)我没做,因此**不据此下"与本批无关"的结论**。
## 关联 Issue
N/A:本 PR 是对已合并批次的一次自报更正与台账登记,来源是我自己的合并后补跑(见 §14 触发行)。
## 提交前检查
- [x] `bash scripts/check-pr-checklist.sh docs/acceptance/2026-10-17-final/PR-CORRECTION.md` 通过(本文件;EXIT=0,读数见「其他说明」)
- [x] N/A:本 PR 仅两文件文档改动,无代码/无迁移/无样式 ⇒ 下方多数子项按 N/A + 理由登记
## 全链路检查
- [x] `npm run type-check` 通过(0 error)——本 PR 未改代码,复算于 HEAD
- [x] `npm run lint`:N/A(未改代码);沿用 #33 的 0 error 读数,warning 数未因此变更动
- [x] 路由/链接真实:N/A(未新增/改动任何 `href` 或 `Link`)
- [x] 涉及 CMS 内容模型:N/A(本 PR 未碰 `content-types.ts`/seed)。相关事实已在 §12.12 记录:三处 `caseStudies` 已声明 `authorized/basis`,本地 dev.db 已随 `db:seed` 生效,生产侧属部署期核对
- [x] 涉及视觉/交互改动:N/A(无 UI 改动);§14 的 B 层待归因项若定性为视觉外溢,会在修复 PR 里按视觉基线口径重跑
- [x] 暗黑模式:N/A(无样式改动)
- [x] 动效合规:N/A(无动效改动);#33 已把 `check:motion` 收到 0 违反并留负对照
- [x] 品牌红触达与面积:N/A(无改动),判据仍由 `check:contrast`/`check:brand-token`/`check:accents` 断言
- [x] 数字与宣称口径:本 PR 恰恰是一次口径收紧——把"跑过子集"冒充"整链已过"的措辞撤掉,改为显式未勾选
- [x] 无遗留 `console.log` / `TODO` / `.only()`:N/A(纯文档)
## 测试分层检查(L0–L3)
- [x] L0 单元:N/A(无代码改动);#33 已留 146 套件 / 1799 例 EXIT=0
- [x] L1 组件:N/A(同上)
- [x] L2 E2E:N/A 于本 PR(无代码改动);**但全量 `test:functional` 在 dev 上实取 36 failed,已在 §14 分层归因,作为后续修复 PR 的验收条件**,本 PR 不声明其通过
- [x] L3 视觉回归:N/A 于本 PR;#33 的重采读数(113 重采 + 125/125 只读 + `--radius-cta` 负对照 15 failed)不变
- [x] 新增机械守卫带正对照:N/A(本 PR 无新仪器);§14 的第 4 条待办里已提议把「fast ≠ 全量」写进 `AGENTS.md` §5 口径表,避免同类误勾再发生
- [x] 已运行相关测试并如实记录:本 PR 的"测试"就是复算 `tsc`、`check:package-keys`、两个 checklist(一个刻意返回 1)
## 质量门禁
- [x] `npm run test:unit`:N/A(无代码改动);引用 #33 终版读数 146 套件 / 1799 例 EXIT=0
- [x] `npm run test:coverage`:N/A(同上,阈值未动)
- [x] `npm run test`(全量 Playwright):**本项即本 PR 要更正的对象** ⇒ 按 N/A 登记而非勾选为通过:全量在 dev 上 36 failed,见 §14;修复属后续 PR
- [x] `npm run check:contrast` 与 `check:headings`:N/A(无样式/无 DOM 改动);#33 的 `check:a11y` EXIT=0 读数不变
- [x] `npm run lighthouse`:N/A(无产物变更);#33 已在重建装配上取过 EXIT=0
- [x] `npm run test:security:headers`:N/A(未碰响应头/CSP/部署配置)
- [x] 文档已同步:本 PR 就是文档同步(`qa-tracker.md` §14 + `PR-DESCRIPTION.md` 更正),并在 `AGENTS.md` §5 口径待办里留了防复发条目
- [x] 提交信息符合 Conventional Commits,且本笔是可独立评审的单一切片(只含更正与台账)
- [x] 破坏性/共享状态动作:N/A —— 无 seed 重跑、无 DB 写入、无 force push、无部署。**对照实验产生的临时文件已从 `cov-base` worktree 清场**(拷过去的 `prisma/dev.db`、`.env`、`.env.production` 与 WAL sidecar 全部删除,该树恢复原状)
## 假绿灯纪律
- [x] 门禁命令实际执行过并粘贴真实输出(见「其他说明」),**且本 PR 的存在本身就是一次假绿灯自纠**
- [x] 未通过删测试、放宽断言、`skip`、下调阈值让门禁变绿:本 PR 反而把一条已勾的项改回未勾
- [x] 未把误报当问题「修掉」:§14 的 B 层明确写「待归因,不据此下结论」,A 层写明对照组也红的同一位置证据
- [x] 结论以 `origin/*` 与实测为准:dev tip 与两把读数都从远端/日志实取
- [x] UI 改动人工复核:N/A(无 UI 改动);未验证项在本文件末尾显式列出而非沉默
## 其他说明
**未验证项 / 未通过项(不沉默)**
1. 全量 `npm run test:functional`(4 project)在 dev 上 **36 failed**:A 层 7 条有对照组同位证据(旧导航锚点遗留)、
B 层若干条**待用纯净对照(`da9a5cb6` 自带 seed 库)定性**、C 层 3 条 `@admin` 疑为环境/权限。
2. 对照实验存在已披露的混杂(旧代码 + 新数据),因此 B 层目前**没有结论**,只有候选与怀疑方向。
3. `check-pr-checklist.sh` 对 `2026-10-17-final/PR-DESCRIPTION.md` 返回 1(未勾项即上面那条更正),属刻意状态,不是待修。
**本 PR 的复算读数**
| 命令 | 读数 |
|---|---|
| `npx tsc --noEmit` | EXIT=0 |
| `node scripts/check-package-keys.mjs` | EXIT=0(键唯一性由父路径分组计数保证) |
| `bash scripts/check-pr-checklist.sh <本文件>` | EXIT=0(本文件全部子项已勾且三节完整) |
| `bash scripts/check-pr-checklist.sh PR-DESCRIPTION.md` | **EXIT=1(刻意)**:更正后的该项保持未勾选 |
| 对照树清场 | `cov-base` 恢复无 `dev.db` / 无 `.env` 的原状 |
@@ -77,7 +77,13 @@ 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 新增的是纯函数与调用点断言,覆盖率只增不减;读数见「其他说明」)
- [x] `npm run test`(Playwright E2E):功能 + 视觉两条链读数见「其他说明」
- [ ] **更正(合并后补记,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] `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` 跑一遍确认无外溢)
+35
View File
@@ -960,3 +960,38 @@ schema 落地后不能拿"之前绿过"当终版读数,故整链重跑(`docs
| **Gitea merge API 的一处口径**(踩过才记) | 首发 `POST /pulls/33/merge` 带 `{merge_style:"fast-forward-only", …}` ⇒ **HTTP 422 `"[Do]: Required"`**。那不是权限、不是缺审批(`GET /pulls/33/reviews` = `[]`,`mergeable=true`、`draft=false`),而是**这套 Gitea 版本的 merge 端点把表单字段 `do` 当必填**。补上 `{"do":"fast-forward-only", "merge_style":"fast-forward-only", …}` ⇒ **HTTP 200**。⇒ 422 的报文要按字面读,别翻译成「需要审批/我被授权不足」;另 `GET /pulls/{n}/merge`、`/branches/protection` 在本实例是 404(端点不存在),别把它当「无保护」的证据 |
| **为什么 dev→main 不由我执行** | 同 §10.9:`Jenkinsfile` 的「🚀 部署到生产环境」带 `when { branch 'main' }` ⇒ 合 main = 授权一次无人值守的线上发布。生产仍停在既有已验证发布,本批要在线上生效需决策人显式发起发布动作(含生产侧 `ContentModel.fields` 与 `navigation` 行的同形核对,见 §12.12、PR 未验证项②) |
| 本批终版门禁读数 | `tsc` 0、`type-check:e2e` 0、`check:package-keys` 0、`check:visual` 0、`check:dead` 0、`check:motion` 0、`jest` 146 套件/1799 例 0、`build` 0、`check:axe` 0、视觉逐名清单 125/125、GA4 16 passed、`lighthouse` 0、`test:all` 0(同条件复跑;首跑 1 已按 §12.13 三把读数归因) |
## §14 2026-10-17 · 合并后补跑全量功能 E2E:一条不实的勾选被我自己抓到,36 条红的分层归因
**触发**:#33/#34/#35 已 FF-only 合入 dev 之后,我才去补跑**本批从未跑过**的全量 `test:functional`
(4 project)。PR 描述里那条 `- [x] npm run test(Playwright E2E)…` 因此是**引用未成立的读数**——
与 §5.47 同一族(我把「跑过的子集」写成了「这条链已过」)。已在描述文件里改成
**保持未勾选的更正记录**,代价是该校验文件现在让 `check-pr-checklist.sh` 返回 1,这是刻意的。
**读数**
| 跑什么 | 树 / HEAD | 结果 |
|---|---|---|
| 全量 `test:functional`(4 project) | 本批 `0da1fa42` | **1032 passed / 36 failed / 44 skipped**,24.5m,EXIT=1 |
| 对照:只跑其中 8 个红 spec × chromium | 基线 worktree `cov-base` @ `da9a5cb6`(本批的**基线**) | **163 passed / 7 failed / 1 skipped**,2.5m |
**对照实验的混杂必须自己说破**:对照树里没有 `prisma/dev.db` 也没有 `.env`,是我从本批树**拷了当前这份库**
(39 条 `ContentItem`,即本批之后的数据状态)过去,代码才是 `da9a5cb6`。
⇒ 对「断言依赖导航/内容数据」的 spec,这不是纯净对照,只能说那 7 条在「旧代码 + 新数据」下也红。
纯净对照需要用 `da9a5cb6` 自己的 seed 库重跑,**这一步我没做,不据此下结论**。
**分层(按证据强度排)**
| 层 | spec | 依据 | 结论 |
|---|---|---|---|
| A 既有红(对照组也红) | `mobile.spec.ts:45/61`、`p2-functional-e2e.spec.ts:99/132`、`user-journey.spec.ts:56/200`、`website-acceptance.spec.ts:139` | 对照实验同一 spec 同一位置报同一类错 | 不是本批引入;但**它们仍在 dev 上红**,属遗留待修(多为旧导航标签/旧锚点) |
| B 待归因(对照组未红) | `p1-brand-visual-audit.spec.ts:579`(「未找到任何可见的客户评价区域,本用例等于零断言」)、`p4-performance-a11y.spec.ts:338/396`(ARIA、焦点可见)、`user-journey.spec.ts:562/773/854`(UJ-03/06/07 `@admin`)、`mobile-accessibility.spec.ts:76` 与 `mobile-performance.spec.ts:287`(触摸目标 AA 2.5.8 ≥24px 硬门禁) | 只在基线绿、在本批红 | **候选与本批相关**:证言/案例区正是 DEC-N4 门槛的作用面(B 的实测说隐藏条目 0 条,而这条守卫说区域整块不见了 ⇒ 必须重测,不接受"应该无关");触摸目标与 hover 去抬升/直角档是 §11 语法批的作用面 |
| C 环境/权限类 | 三条 `@admin` 旅程失败仅 ~170ms | 失败过快 ⇒ 更像登录/权限或写库用例在本环境的固有问题 | 待复现 |
**下一步(不在本批内,登记为待办)**
1. 用 `da9a5cb6` 自己的 seed 库做**纯净对照**,把 B 层逐条定性(本批引入 / 既有)。
2. 定性为本批引入的,按 §5.42/§12.13 的口径修根因,不允许改断言迁就。
3. A 层那 7 条属 §11 IA 改动的遗留锚点,另开修复 PR(与 `p6-missing-paths`/`nav-dropdown` 同法重锚)。
4. 全量 `test:functional` 纳入交付门禁的口径要写进 `AGENTS.md` §5——现 `test:all` 只含 `test:e2e:fast`,
「跑过 fast」与「跑过全量」必须在文档里区分开,否则下一次还会有人把前者当后者勾上。