docs(qa): §14 全量功能 E2E 补跑与一条不实勾选的更正(仅文档) #36

Merged
zhangxiang merged 1 commits from worktree-ui-grammar-two-axis into dev 2026-10-17 10:02:57 +08:00
Owner

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 的原状
# 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` 的原状 |
zhangxiang added 1 commit 2026-10-17 10:02:56 +08:00
本批只跑过 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(刻意)。
zhangxiang merged commit fe80e4dcb7 into dev 2026-10-17 10:02:57 +08:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: novalon/novalon-website#36