Files
novalon-website/docs/acceptance/2026-10-17-final/PR-CORRECTION.md
T
zhangxiang fe80e4dcb7 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(刻意)。
2026-10-17 10:02:36 +08:00

7.1 KiB
Raw Blame History

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 触发行)。

提交前检查

  • bash scripts/check-pr-checklist.sh docs/acceptance/2026-10-17-final/PR-CORRECTION.md 通过(本文件;EXIT=0,读数见「其他说明」)
  • N/A:本 PR 仅两文件文档改动,无代码/无迁移/无样式 ⇒ 下方多数子项按 N/A + 理由登记

全链路检查

  • npm run type-check 通过(0 error)——本 PR 未改代码,复算于 HEAD
  • npm run lint:N/A(未改代码);沿用 #33 的 0 error 读数,warning 数未因此变更动
  • 路由/链接真实:N/A(未新增/改动任何 href 或 Link)
  • 涉及 CMS 内容模型:N/A(本 PR 未碰 content-types.ts/seed)。相关事实已在 §12.12 记录:三处 caseStudies 已声明 authorized/basis,本地 dev.db 已随 db:seed 生效,生产侧属部署期核对
  • 涉及视觉/交互改动:N/A(无 UI 改动);§14 的 B 层待归因项若定性为视觉外溢,会在修复 PR 里按视觉基线口径重跑
  • 暗黑模式:N/A(无样式改动)
  • 动效合规:N/A(无动效改动);#33 已把 check:motion 收到 0 违反并留负对照
  • 品牌红触达与面积:N/A(无改动),判据仍由 check:contrast/check:brand-token/check:accents 断言
  • 数字与宣称口径:本 PR 恰恰是一次口径收紧——把"跑过子集"冒充"整链已过"的措辞撤掉,改为显式未勾选
  • 无遗留 console.log / TODO / .only():N/A(纯文档)

测试分层检查(L0–L3)

  • L0 单元:N/A(无代码改动);#33 已留 146 套件 / 1799 例 EXIT=0
  • L1 组件:N/A(同上)
  • L2 E2E:N/A 于本 PR(无代码改动);但全量 test:functional 在 dev 上实取 36 failed,已在 §14 分层归因,作为后续修复 PR 的验收条件,本 PR 不声明其通过
  • L3 视觉回归:N/A 于本 PR;#33 的重采读数(113 重采 + 125/125 只读 + --radius-cta 负对照 15 failed)不变
  • 新增机械守卫带正对照:N/A(本 PR 无新仪器);§14 的第 4 条待办里已提议把「fast ≠ 全量」写进 AGENTS.md §5 口径表,避免同类误勾再发生
  • 已运行相关测试并如实记录:本 PR 的"测试"就是复算 tsc、check:package-keys、两个 checklist(一个刻意返回 1)

质量门禁

  • npm run test:unit:N/A(无代码改动);引用 #33 终版读数 146 套件 / 1799 例 EXIT=0
  • npm run test:coverage:N/A(同上,阈值未动)
  • npm run test(全量 Playwright):本项即本 PR 要更正的对象 ⇒ 按 N/A 登记而非勾选为通过:全量在 dev 上 36 failed,见 §14;修复属后续 PR
  • npm run check:contrast 与 check:headings:N/A(无样式/无 DOM 改动);#33 的 check:a11y EXIT=0 读数不变
  • npm run lighthouse:N/A(无产物变更);#33 已在重建装配上取过 EXIT=0
  • npm run test:security:headers:N/A(未碰响应头/CSP/部署配置)
  • 文档已同步:本 PR 就是文档同步(qa-tracker.md §14 + PR-DESCRIPTION.md 更正),并在 AGENTS.md §5 口径待办里留了防复发条目
  • 提交信息符合 Conventional Commits,且本笔是可独立评审的单一切片(只含更正与台账)
  • 破坏性/共享状态动作:N/A —— 无 seed 重跑、无 DB 写入、无 force push、无部署。对照实验产生的临时文件已从 cov-base worktree 清场(拷过去的 prisma/dev.db、.env、.env.production 与 WAL sidecar 全部删除,该树恢复原状)

假绿灯纪律

  • 门禁命令实际执行过并粘贴真实输出(见「其他说明」),且本 PR 的存在本身就是一次假绿灯自纠
  • 未通过删测试、放宽断言、skip、下调阈值让门禁变绿:本 PR 反而把一条已勾的项改回未勾
  • 未把误报当问题「修掉」:§14 的 B 层明确写「待归因,不据此下结论」,A 层写明对照组也红的同一位置证据
  • 结论以 origin/* 与实测为准:dev tip 与两把读数都从远端/日志实取
  • 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 的原状