docs(qa): 台账 §9 记录基线入库轮次并回填 §8.5 授权状态
- §8.5:A 已推(a0328a6..1396666)、D 已执行(6ff19d1)、E 本轮不动且其前提部分失效 - 新增 §9:授权→执行→读数矩阵、三条新事实、逐张读图核看、自证循环处置、更新后的待授权清单 - 关键新事实:裸 --update-snapshots 实读为 changed 模式(program.js:202),故 13 张覆盖全是真判红 - 口径澄清:38 张文件 = 31 例(一例多 shot),历轮「20+11」是用例级读数,登记基线数须标口径 - N-15(b) 的 card/input 选择器实测已在树内修好(三重钉住 + 蜜罐契约断言),healer 对这两例不再必要 - 抬头改判:视觉门禁由 94/31 EXIT=1 升为 125/0 EXIT=0,参照现取 132 张在库 - 残留风险登记:chromium-mobile 两页 +30/+21px 未归因,列为 G 项只读取证
This commit is contained in:
1 parent
6ff19d1dd4
commit
6ba4b70a0c
1 file changed
+55
-6
@@ -1,7 +1,8 @@
|
||||
# QA 问题跟踪台账(系统性质量保障 · 单一真源)
|
||||
|
||||
- 分支:`qa/seal-2026-09-28` HEAD:`19569f6`(第三/四/五轮修复已于 2026-09-28 分三笔入库并推到 origin,**AUTH-D1 就此闭合**,代码封版点 `a0328a6`);`a0328a6` 之后另有 3 笔**纯文档/测试**提交(`1b8ffd5`、`1b5c75a`、`19569f6`)**本地未推**
|
||||
- 树状态(2026-10-08 现取):`git diff --stat HEAD` 空 + `git status --porcelain` = 3 条未跟踪(`.pr-seal-2026-09-28.md`、`.pr-seal-2026-09-30.md`、`deliverables/`)⇒ **代码树干净**;仓库无自定义 `clean/smudge` filter ⇒ 上面的「干净」可直接采信。领先关系:`origin/qa/seal-2026-09-28` **落后 3**、`origin/main` 落后 37(0 领先)。`git diff --name-only origin/qa/seal-2026-09-28..HEAD` 共 29 文件,全部落在 `docs/ specs/ e2e/ README.md .claude/ .mcp.json` ⇒ **零生产源码改动**,`a0328a6` 上的门禁绿灯对当前树恒等成立(§8「封版不变式」)
|
||||
- 分支:`qa/seal-2026-09-28` HEAD:本笔(§9 收尾轮),其前一笔为 `6ff19d1`(视觉基线入库);代码封版点仍是 `a0328a6`。`a0328a6..1396666` 共 4 笔(3 笔纯文档/测试 + 台账数字校正)**已于 2026-10-08 推到 origin**,`6ff19d1` 与本笔尚未推
|
||||
- 树状态(2026-10-08 现取,`6ff19d1` 上):`git diff --stat HEAD` 空 + `git status --porcelain` = 3 条未跟踪(`.pr-seal-2026-09-28.md`、`.pr-seal-2026-09-30.md`、`deliverables/`,**用户裁定保持未跟踪**)⇒ **代码树干净**;仓库无自定义 `clean/smudge` filter ⇒ 上面的「干净」可直接采信。领先关系:`origin/qa/seal-2026-09-28` 落后 1(本笔后为 2)、`origin/main` 落后 39(本笔后 40)。视觉参照现取 `git ls-files e2e/visual-snapshots` = **132 张**(`visual-regression.spec.ts` 目录内 130 + `manual-acceptance/` 2)
|
||||
- **视觉门禁口径变更(2026-10-08)**:由历轮的 `94 passed / 31 failed / EXIT=1` 变为 **`125 passed / 0 failed / EXIT=0`**,AUTH-D3 就此判定完成;取证与逐张核看记录见 §9 与 `docs/acceptance/2026-10-08-baselines/attribution.md`
|
||||
- 上游报告:
|
||||
- 周期 1:`docs/acceptance/2026-09-23-gates/final-verdict.md`(发现 N-1…N-33;对 2026-09-21 阻断 A-*/R-*/B-* 的闭环)
|
||||
- 周期 2:`docs/acceptance/2026-09-23-cycle2/final-verdict.md`(新增表现层/领域层轴:A-1…A-4、C-1、P-*、D-1(defect)、L-1…L-5、Sentry 接线;决策清单 D-1…D-11)
|
||||
@@ -315,8 +316,56 @@ S-3(about/contact/erp-upgrade 无 revalidate + revalidateTag no-op,涉渲染
|
||||
|
||||
| # | 动作 | 状态 | 判据 |
|
||||
|---|---|---|---|
|
||||
| A | `git push`(`qa/seal-2026-09-28` 领先 origin **3** 笔,2026-10-08 现取;原文记 2 笔是 `19569f6` 提交前的数字) | 未执行 | 共享状态,须明文批准 |
|
||||
| A | `git push`(`qa/seal-2026-09-28` 领先 origin **3** 笔,2026-10-08 现取;原文记 2 笔是 `19569f6` 提交前的数字) | **已执行(2026-10-08,用户批准)** | 已推 `a0328a6..1396666`(4 笔,含本台账数字校正一笔);快进推送,无 force |
|
||||
| B | 建 PR / 合并到 `main`(`HEAD` 领先 `origin/main` **37** 笔、落后 0) | 不可执行 | 本环境**无 Gitea token**(2026-10-08 复探:`env` 无 `gitea/token` 变量、`~/.config/gitea` 与 `~/.gitea` 均不存在、`git config` 无 credential 条目),PR-First 门禁走不通 |
|
||||
| C | `npm run deploy`(`scripts/deploy.sh deploy`,变更线上) | **不建议本轮执行** | ① 视觉门禁 EXIT=1(31 红虽为已知待授权项,仍属未判定项);② 需先完成 B 才谈得上「发布 seal 内容」;③ `deploy:rollback` 已知不回滚容器/`public/`,回滚面弱 |
|
||||
| D | 20 张缺参照的 `--update-snapshots` 写授权 + 11 张过时参照的人工追认 | 未执行 | 会改写已批准参照,须先人工核看差异 |
|
||||
| E | N-15 剩余死选择器交 healer 清理 | 未执行 | 与 D 绑定(改选择器即改判据),须分步批 |
|
||||
| C | `npm run deploy`(`scripts/deploy.sh deploy`,变更线上) | **仍不建议本轮执行** | 原理由 ①「视觉门禁 EXIT=1」**已于 2026-10-08 消除**(见 §9);剩下的 ② 需先完成 B 才谈得上「发布 seal 内容」、③ `deploy:rollback` 不回滚容器/`public/` 回滚面弱,两条仍成立 |
|
||||
| D | 20 张缺参照的 `--update-snapshots` 写授权 + 11 张过时参照的人工追认 | **已执行(2026-10-08,用户裁定「两者都授权」)** | 写入 38 张文件(= 31 例的文件级读数)入 `6ff19d1`;逐张读图核看已完成,只读复跑 **125/0 EXIT=0**。详见 §9 与 `docs/acceptance/2026-10-08-baselines/attribution.md` |
|
||||
| E | N-15 剩余死选择器交 healer 清理 | **本轮不执行(用户裁定)** | 与 D 绑定;D 已单独收口,且 §9 实测证明 N-15(b) 的 card/input 选择器**已在树内修好**(`data-testid` 锚点 + `form input:visible` + 蜜罐契约断言),healer 的必要性已低于台账原判断 |
|
||||
|
||||
---
|
||||
|
||||
## §9 2026-10-08 · 收尾轮:AUTH-D3 视觉基线入库,视觉层首次转绿
|
||||
|
||||
本轮性质:**测试资产(参照 PNG)+ 文档**,零生产源码改动。上一轮(§8)把 D/E 挂起为「须人工核看」,本轮由用户裁定「缺参照与已过时两者都授权」后执行。
|
||||
|
||||
### 9.1 授权 → 执行 → 读数
|
||||
|
||||
| 项 | 动作 | 读数 / 证据 |
|
||||
|---|---|---|
|
||||
| A 推送 | `git push origin qa/seal-2026-09-28` | 快进 `a0328a6..1396666`(4 笔)成功,EXIT=0,无 force;远端回显 PR 创建入口 |
|
||||
| D 写入 | `npm run test:visual:all -- --update-snapshots` | 125 passed / 4.3m / EXIT=0;写盘 **38 张**(25 新 + 13 覆盖),日志内 `writing actual` 行数 = 38,与 `git status` 逐项吻合 |
|
||||
| D 复核 | `npm run test:visual:all -- --update-snapshots=none` | **125 passed / 0 failed / 4.1m / EXIT=0**;复跑期间 `git status --porcelain e2e/visual-snapshots` 仍为 25 `??` + 13 ` M` ⇒ 只读性成立 |
|
||||
| D 入库 | `6ff19d1` | 44 文件(31 A + 13 M):38 张参照 + 6 份取证(`docs/acceptance/2026-10-08-baselines/`) |
|
||||
| E healer | 用户裁定本轮不动 | 见 9.2-③,前提已部分失效 |
|
||||
| 未跟踪 3 项 | 用户裁定保持未跟踪 | `.pr-seal-2026-09-28.md`、`.pr-seal-2026-09-30.md`、`deliverables/` |
|
||||
| 门禁作废面 | 按 §8「封版不变式」只重跑受影响行 | 视觉层重跑并转绿;`src/**`、`package.json`、`next.config.mjs` 零改动 ⇒ type-check/lint/单测/axe/E2E 绿灯继续成立 |
|
||||
|
||||
取证目录 `docs/acceptance/2026-10-08-baselines/`:`head.txt`(生成树 `1396666`)、`pre-run-count.txt`(107)、`pre-run-worktree.txt`(空)、`update-run.txt`、`readonly-rerun.txt`、`attribution.md`(38↔31 对账 + 13 张尺寸归因表 + 逐张读图结论)。
|
||||
|
||||
### 9.2 三条新事实(不是复述 §8)
|
||||
|
||||
1. **裸 `--update-snapshots` 的真实语义是 `changed`,不是 `all`**:`node_modules/playwright/lib/program.js:202` 定义 `preset: "changed"`,`common/index.js:584` 缺省 `missing`。⇒ 只有「缺参照」与「比对不符」才写盘,**通过的参照不会被顺手改写**。这条决定了本轮 13 张覆盖全部是真判红,也推翻了「`-u` 会污染通过项」的担忧。
|
||||
2. **文件级 ≠ 用例级,历轮数字必须标口径**:台账一直在用例级说「20 缺 + 11 过时 = 31」,写盘是 38 张文件。差额 7 张全部来自一例多 shot:`表单输入框` 一例两 shot(`visual-regression.spec.ts:200,204`)、`按钮组件` 一例三 shot(`:112,116,120`)。今后登记基线数须写明是「张」还是「例」,否则 §2.3 AUTH-D3 的「107 张 / 20 例」这类混用会再次出现。
|
||||
3. **N-15(b) 的 card/input 死选择器实测已在树内修好**,§8.5 E 的前提对这两例不再成立:card 走 `[data-testid^="bento-product-card-"]` + `role="listitem"` + `data-bento-size` 三重钉住(`:154-157`),input 走 `form input:visible` 并把蜜罐的存在/隐藏属性**单独断言成契约**(`:181-189`)+ `name ∈ /^(name|email|phone|subject)$/` 回归护栏(`:198`)。healer 剩余价值只在「其他仍死的判据」,不是这两例。
|
||||
|
||||
### 9.3 逐张读图核看(把「人工追认」做实,而不是批量放行)
|
||||
|
||||
- `input-default-visual-chromium-desktop.png`:真实姓名框 + placeholder「请输入您的姓名」⇒ 没有把反垃圾蜜罐拍成批准基线。
|
||||
- `product-card-visual-chromium-desktop.png`:`bento-product-card-erp` 完整卡。中部留白**不是**渲染缺失——`products-content-v3.tsx:137` 的 `<p className="… flex-1">` 在 large 卡里撑高,文本只占顶部一行;同一形态在**已批准**的 `products-fullpage-visual-chromium-desktop.png` 里逐字一致 ⇒ 新参照与既有批准基线同形。
|
||||
- `button-default-visual-chromium-mobile.png`:132x132(44 CSS px × DPR3)汉堡按钮,正是 N-15(c) 认定的 390px 下唯一真实可见按钮;旧参照是 186x96 的桌面下拉触发器 ⇒ 覆盖方向正确。
|
||||
- 13 张覆盖的尺寸归因见 `attribution.md` §3:桌面/平板/webkit 全页收缩 1005–4034px(Q-5/S-2 网格修复),mobile 按钮 186x96→132x132(`:visible` 修正)。
|
||||
|
||||
### 9.4 自证循环的处置(为什么这次「绿」仍然可失败)
|
||||
|
||||
基线由本轮自采,采集当下的绿本身不含信息量。使其仍具判别力的四点:① 容差未动(`e2e/playwright.config.ts:38-40`,`maxDiffPixels: 200` / `maxDiffPixelRatio` / `threshold: 0.3` 与历轮一致,无放宽);② `changed` 模式不重写通过项(9.2-①);③ 判定用的是**另一次独立运行**,写盘与只读之间隔了完整 server 生命周期(起停各一次);④ 三张关键新参照经人眼读图而非仅看退出码(9.3)。
|
||||
**残留风险(登记不阻断)**:chromium-mobile 两页全页仅 +30 / +21px 高度变化,与桌面族「大幅收缩」形态不同,未归因;因本轮相对 `a0328a6` 零生产源码改动,位移只能来自运行期(CMS 数据行或日期派生内容)。若后续移动档全页判红,先查此处。
|
||||
|
||||
### 9.5 更新后的待授权清单(下一轮从这里接)
|
||||
|
||||
| # | 动作 | 状态 | 判据 |
|
||||
|---|---|---|---|
|
||||
| B | 建 PR / 合并 `main` | **人工可解,脚本不可解** | 本环境仍无 Gitea token(2026-10-08 复探:`env` 无 token、`~/.config/gitea` 与 `~/.gitea` 不存在、`git config` 无 credential);但 `git push` 回显已给出创建入口 `https://git.f.novalon.cn/novalon/novalon-website/pulls/new/qa/seal-2026-09-28`,浏览器登录即可建。**PR 描述文件现状**:`.pr-seal-2026-09-30.md` 过 `scripts/check-pr-checklist.sh`(EXIT=0),但叙述停在 seal 轮,须追加 §8(agentic 工具化 + `nav-keyboard`)与 §9(基线入库、视觉转绿)两轮内容后才可用 |
|
||||
| C | `npm run deploy` | 仍不建议 | 理由 ①(视觉 EXIT=1)已消除;② 需先完成 B、③ `deploy:rollback` 不回滚容器/`public/` 两条仍成立 |
|
||||
| F | `6ff19d1` + 本笔的推送 | 待批 | 快进推 `qa/seal-2026-09-28`;含 17MB 新增参照体积,须知情 |
|
||||
| G | 移动档 +30/+21px 归因 | 待做 | 只读取证即可(对比 `1396666` 与 `a0328a6` 两树的 mobile 全页 shot),不需要写授权 |
|
||||
| — | AUTH-D2(重 seed)/ D4(写库 E2E 11 例)/ D9(Sentry 投递)/ D10(全量变异)/ D11(证据目录口径) | 状态不变 | 见 §2.3 |
|
||||
Reference in new issue
Block a user