From fe80e4dcb73184b15ff7d551f0fe6195a4c7a50c Mon Sep 17 00:00:00 2001 From: zhangxiang Date: Sat, 17 Oct 2026 10:02:36 +0800 Subject: [PATCH] =?UTF-8?q?docs(qa):=20=C2=A714=20=E5=90=88=E5=B9=B6?= =?UTF-8?q?=E5=90=8E=E8=A1=A5=E8=B7=91=E5=85=A8=E9=87=8F=E5=8A=9F=E8=83=BD?= =?UTF-8?q?=20E2E=EF=BC=8C=E5=B9=B6=E6=8A=8A=20PR=20#33=20=E9=87=8C?= =?UTF-8?q?=E4=B8=80=E6=9D=A1=E4=B8=8D=E5=AE=9E=E5=8B=BE=E9=80=89=E6=94=B9?= =?UTF-8?q?=E5=9B=9E=E6=9C=AA=E5=8B=BE=E9=80=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 本批只跑过 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-final/PR-CORRECTION.md | 91 +++++++++++++++++++ .../2026-10-17-final/PR-DESCRIPTION.md | 8 +- docs/acceptance/qa-tracker.md | 35 +++++++ 3 files changed, 133 insertions(+), 1 deletion(-) create mode 100644 docs/acceptance/2026-10-17-final/PR-CORRECTION.md diff --git a/docs/acceptance/2026-10-17-final/PR-CORRECTION.md b/docs/acceptance/2026-10-17-final/PR-CORRECTION.md new file mode 100644 index 0000000..ccc1975 --- /dev/null +++ b/docs/acceptance/2026-10-17-final/PR-CORRECTION.md @@ -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` 的原状 | diff --git a/docs/acceptance/2026-10-17-final/PR-DESCRIPTION.md b/docs/acceptance/2026-10-17-final/PR-DESCRIPTION.md index ba0039a..2db5b84 100644 --- a/docs/acceptance/2026-10-17-final/PR-DESCRIPTION.md +++ b/docs/acceptance/2026-10-17-final/PR-DESCRIPTION.md @@ -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` 跑一遍确认无外溢) diff --git a/docs/acceptance/qa-tracker.md b/docs/acceptance/qa-tracker.md index a241e73..7cface0 100644 --- a/docs/acceptance/qa-tracker.md +++ b/docs/acceptance/qa-tracker.md @@ -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」与「跑过全量」必须在文档里区分开,否则下一次还会有人把前者当后者勾上。 -- 2.54.0