封版收敛:五轮 QA 修复 + 视觉基线闭合 + 发布链修正(qa/seal → dev) #29

Merged
zhangxiang merged 18 commits from qa/seal-2026-09-28 into dev 2026-10-08 18:21:42 +08:00
Owner

目标分支 dev:差异 = origin/dev..qa/seal-2026-09-28 共 15 笔,含代码封版点三笔生产修复(a366bd1 fix(qa) / 6bb7c55 test(qa) / a0328a6 chore(qa)),其余为验收证据、视觉基线补齐与发布链修正。

生产已于 2026-10-08 17:31 按 a0328a6 代码封版点发布并完成线上验证(详见 docs/acceptance/qa-tracker.md §10);本 PR 补的是治理痕迹——让产物与分支同源。

合并到 main 请另开 dev→main PR,不要在本 PR 上直接改 base:Jenkinsfile:407-429 在 branch main 上挂有「🚀 部署到生产环境」阶段,会触发无人值守的二次发布。

变更摘要

分支收敛轮(2026-10-08),承接 qa/seal-2026-09-28 上的五轮系统性 QA 与 2026-09-30 封版判定。代码封版点仍是 a0328a6(a366bd1 fix(qa) / 6bb7c55 test(qa) / a0328a6 chore(qa) 三笔为其全部生产改动);a0328a6 之后的 8 笔(1b8ffd5、1b5c75a、19569f6、1396666、6ff19d1、6ba4b70、c66dfca、bcd32b3)零 src/ 改动,内容为:封版证据入库、作者侧 agentic 工具化 + 主导航键盘用例、台账数字校正、视觉基线补齐与追认、归因改判与 lessons。

本 PR 相对上一份描述(.pr-seal-2026-09-30.md)的唯一判定级变化:视觉回归层由历轮的 94 passed / 31 failed / EXIT=1 变为 125 passed / 0 failed / EXIT=0,AUTH-D3 就此闭合。台账现行段落:docs/acceptance/qa-tracker.md §8(agentic 轮)与 §9(基线轮);封版判定书:docs/acceptance/2026-09-30-seal/final-verdict.md。

新增测试资产:e2e/nav-keyboard.spec.ts(4 例 @a11y,主导航 mega dropdown 的键盘契约,此前只有 hover 路径)、.claude/agents/playwright-test-{planner,generator,healer}.md + .mcp.json(Playwright 1.60 自带 init-agents,未新增依赖、运行期零模型)。

关联 Issue

关闭:N/A(无 issue 系统;来源为 docs/acceptance/qa-tracker.md §2 五轮缺陷登记与 §8.5/§9.5 待授权清单)

提交前检查

  • 已通过 bash scripts/check-pr-checklist.sh .pr-seal-2026-10-08.md(本文件,退出码记于「假绿灯纪律」末条)

全链路检查

  • npm run type-check:EXIT=0,0 error。本轮(§9)在 1396666 树上复跑过(§8.2 表),且 a0328a6..HEAD 零 src/ 改动 ⇒ 封版不变式成立,无需重跑(git diff --name-only a0328a6..HEAD 全落在 docs/ specs/ e2e/ README.md .claude/ .mcp.json)
  • npm run lint:0 error / 104 warning,EXIT=0,本轮零新增。口径权威位在 docs/development/quality-gates.md(AGENTS.md §5 曾记 105,已按现测更正);新增的 e2e/nav-keyboard.spec.ts 自身 0 告警
  • 路由/链接真实:本 PR 未新增任何 href。新增 spec 只导航到已存在路由(/、/products、/contact);/products/erp-upgrade 与 /about/brand 此前是「列在 VISUAL_TEST_PAGES 但无参照」,本轮已补齐参照(不再是死覆盖)
  • 涉及 CMS 内容模型:须重跑 npm run db:seed,且截至本描述定稿仍未执行(AUTH-D2 未闭合)。依据:本分支改过 prisma/seed.ts 与 prisma/seeds/{products,solutions,standalone-products}.ts 的 modelCode(team→team-page、legal→legal-page、+contact-page、+shellReadModels),而 src/lib/permissions.ts:26 按 modelCode 精确匹配 ⇒ 不重 seed 则生产非 super_admin 角色持失效授予且缺 content-model/content-zone 读权(admin/models、admin/stats、zones 三处消费)。2026-09-30 判定书 §58 行记的是「发布计划内含」,不是已执行;本地 dev.db 同样仍旧权限行。DB 写入须单独授权,不静默假定生效
  • 涉及视觉/交互改动:a0328a6 的 Q-5/S-2 网格修复改变产品/方案详情页版面(单列→多列),已在 sealed 树用真实浏览器结构实证(grid-structure-report.json:/products/erp 五个网格 computedCols = 3/2/4/4/12)+ 目视截图(visual-check/)。本轮已完成基线追认:13 张覆盖全部是真判红(裸 --update-snapshots 实为 changed 模式,只写缺失/不符,node_modules/playwright/lib/program.js:202),逐张读图核看过(docs/acceptance/2026-10-08-baselines/attribution.md §4)
  • 暗黑模式:本 PR 无新增样式;axe 门禁在 light/dark 双主题各扫 34 页,themeMismatch=0、bgMismatch=0;check:axe EXIT=0 / PASSED=true(sealed 树实测)
  • 动效合规:npm run check:motion = EXIT=1,23 处(R4 曲线 20 + R3 裸时长 2 + R2 超上限 1),与周期 2 同数 ⇒ 零新增,属 DEC-P2-motion 待裁定,未并入 check:a11y。诚实边界:4 个违规文件确在本 PR 改动清单内,不得简化为「本轮无涉动效」
  • 品牌红:本 PR 无新增页面,触达点与面积不变;check:brand-token 0 违规(§7.4 产物实测)
  • 数字与宣称口径:业务已裁定按例外上线——DEC-N30(4 条互斥 SLA 同时在线)与 DEC-D5(/products/erp-upgrade 的 99.2%/100%/「从5天到1天」无 basis 无角注)不改文案,作为签核例外登记于判定书 §4;basis 缺失/非法按最弱 target 处理并自动附角注的机制在 a0328a6 已带测试
  • 无遗留 console.log/TODO/FIXME/.only():新增的 e2e/nav-keyboard.spec.ts 与 docs/acceptance/2026-10-08-baselines/row-diff.cjs(取证脚本)均无 .only;row-diff.cjs 是一次性归因工具,随证据目录入库以便复跑

测试分层检查(L0–L3)

  • L0 单元:沿用 a0328a6(test:coverage 143 套件 / 1772 例 EXIT=0);本 PR 后 8 笔无源码改动 ⇒ 无新用例需求
  • L1 组件:同上。check:motion 的自证伪测试(19 例,双向断言 + 规则全集元测试)在 scripts/utils/__tests__/,需 --roots 指定,不在 test:unit 口径内(已登记)
  • L2 E2E(功能):生产目标 E2E_TARGET=production + 排除两个写库 spec ⇒ 91 passed / 1 failed,唯一红 [firefox] uj-09:124 按 §2.4 定性为并发/墙钟族(同批次另三引擎绿、隔离单跑 passed、4-project 并发复跑两次各 4 passed);prisma/dev.db 跑前后 inode/size/mtime 一致 ⇒ 未写库。写库 11 例(AUTH-D4)仍未执行
  • L2 E2E(本轮新增键盘层):e2e/nav-keyboard.spec.ts 四读数——dev 目标四 project 10 passed / 6 skipped、production 三桌面 project 10 passed / 2 skipped、稳定性 --workers=1 --repeat-each=3 24 passed / 0 failed,两目标 EXIT=0。两条引擎/目标差异已定性且未用守卫压红:① macOS WebKit 不响应真实 Tab(activeElement 恒 BODY,与 N-27 同源)⇒ 2 例按 browserName==='webkit' 跳过;② dev 下触发器节点 hydration 后被整体替换(生产不复现)⇒ openWithKeyboard() 用 toPass() 重发交互。tag 为 @a11y,不在 test:e2e:fast 的 @smoke|@critical 集合内 ⇒ test:all 时长不变
  • L3 视觉回归:本轮转绿。写盘 npm run test:visual:all -- --update-snapshots ⇒ 125 passed / 4.3m / EXIT=0,落盘 38 张(25 新 + 13 覆盖);判定用另一次独立只读运行 --update-snapshots=none ⇒ 125 passed / 0 failed / 4.1m / EXIT=0,期间 git status --porcelain e2e/visual-snapshots 保持 25 ?? + 13 M 未变 ⇒ 只读性成立。未放宽任何容差(e2e/playwright.config.ts:38-40 三项与历轮逐字一致)。已核:不接受盲更新快照——三张关键新参照经人眼读图(见 attribution.md §4),且「一例多 shot」使 38 张对应 31 例,已逐组对账
  • 机械守卫带正控制:axe 门禁以退出码判定(0/1/2),crawl-routes.mjs 在清单 0 条时不写出并 exit 2(防空输入假绿);nav-keyboard 的断言对象是 aria-expanded + activeElement 双重锚点而非「不报错即绿」;row-diff.cjs 的定位结论经旧/新裁图对照复核(发散行 y=7440 落在 benefits 段)
  • 相关测试全绿,无 .only()/跳过残留:如实登记三处非全绿或跳过——L2 91/1(并发族)、check:motion 23 处、nav-keyboard 的 webkit 2 例跳过(有引擎级依据);视觉层本轮无跳过残留

质量门禁

  • npm run test:unit / test:coverage:沿用 §7.4 的 143 套件 / 1772 例 EXIT=0,阈值未下调(唯一真源 config/test/jest.config.js 的 coverageThreshold,根 jest.config.js 仅转发)
  • npm run test:integration:real:23 例 EXIT=0(§7.4),teardown 以 inode+size+mtime 守卫 prisma/dev.db 未被写入
  • npm run check:a11y(contrast + headings + brand-token):44/44 · 10/10 页 · 0 违规(§7.4 产物实测)
  • npm run check:axe(全站节点计数):EXIT=0 / PASSED=true,34 路由 × (chromium,firefox) × (light,dark) = 136 页,violationNodes=0、contrastNodes=0、bgMismatch=0;唯一 non-2xx 为 /_not-found(设计如此)。证据 docs/acceptance/2026-09-30-seal/axe/axe-evidence.json。诚实边界:该门禁不在 test:all 内,本地需手动跑
  • npm run lighthouse:EXIT=0,9 URL × 3 = 27 run 断言全通过,a11y 9/9 = 100(前提是先修 N-9:standalone 产物须自带 dist/static,否则在全站 CSS 404 的裸 HTML 上出数仍会错误 exit 0)
  • npm run test:security:headers:两个口径分开出数——① 打本分支产物 --url http://localhost:3100/ ⇒ EXIT=0,7 PASS / 1 WARN(HSTS) / 0 FAIL,每头单次;② 默认打线上 ⇒ 现测重复下发,根因 nginx + next.config.mjs 两层叠加,修复须单独投递 nginx conf(deploy.sh 从不投递),登记为待办未夹带
  • npm run test(默认 dev 目标 E2E):EXIT=0,但 GA4 的 16 个 @critical 用例在 dev 下是 skipped 而非 passed(NEXT_PUBLIC_GA_MEASUREMENT_ID 只在 .env.production)⇒ 该覆盖只在 test:e2e:prod 下真正断言,两者不可混为一谈
  • 文档已同步:docs/acceptance/qa-tracker.md(抬头改判、§8.5 状态回填、新增 §9 含授权→执行→读数矩阵与自证循环处置)、docs/acceptance/2026-10-08-baselines/(attribution.md + 两次运行日志 + head.txt/pre-run-* + row-diff.cjs)、docs/lessons-learned.md(新增 §5.33:基线判红须对「采集树 vs 当前树」)、docs/testing.md / docs/development/quality-gates.md(口径行)、README.md(进度)
  • 提交信息符合 Conventional Commits,且每笔可独立评审:1b8ffd5 docs(seal) / 1b5c75a test(qa) / 19569f6+1396666+6ba4b70+c66dfca+bcd32b3 docs(qa) / 6ff19d1 test(visual)
  • 破坏性/共享状态动作逐项分离且已单独取得授权:本 PR 周期内实际执行者 = 本地提交 + 快进推 qa/seal-2026-09-28(用户批准)+ 视觉基线写入与追认(用户裁定「两者都授权」)。未执行:PR 创建(本环境无 Gitea token)、合并 dev/main、npm run deploy、nginx conf 投递、生产 db:seed、healer 清理。真实恢复锚点是合并后打 prod/* tag(deploy:rollback 只回 dist,不回容器、不回 public/)

假绿灯纪律

  • 门禁命令实际执行并记录真实退出码:判绿一律以日志内 EXIT= 行为准,不信后台任务通知的 exit 0(历轮两次踩到 cmd; echo EXIT=$? 包装层吞红)。本轮证据全部落盘:docs/acceptance/2026-10-08-baselines/{update-run,readonly-rerun}.txt
  • 未通过删测试/放宽断言/skip 用例/下调阈值让门禁变绿:视觉转绿的路径是补齐缺失参照 + 追认已过时参照,容差与阈值三项参数逐字未动;check:motion 保持判红且不并入伞形门禁
  • 未把误报当缺陷「修掉」,也未把自己的错判当事实留下:§9.4 初稿把 chromium-mobile 两页 +30/+21px 记为「零源码改动 ⇒ 运行期漂移」,本轮内以 row-diff.cjs 定位发散行 + git diff <采集树>..<当前树> 证伪——旧参照采集树是 040951c(09-22),当前树含 a366bd1(09-28 第五轮),真因是 Q-6 把 count-up 动画从 render 体迁入 useEffect,旧参照冻结的是动画中间帧。该错判已在台账与 attribution 就地作废,教训入 docs/lessons-learned.md §5.33
  • 封版不变式机械核验:git diff --name-only a0328a6..HEAD 输出全部落在 docs/**、specs/**、e2e/**、README.md、.claude/**、.mcp.json ⇒ 生产代码未变,§7.4 与 sealed 树的绿灯对本次提交恒等成立(不是「重跑一遍做样子」)。受影响面已单独重跑:视觉层(写盘 + 只读两次)、nav-keyboard(两目标 + 稳定性)、type-check、lint
  • 基线「绿」的自证循环已声明边界:参照由本轮自采,采集当下的绿不含信息量;使其仍可失败的四点是容差未动、changed 模式不重写通过项、判定用独立第二次运行、三张关键新参照经人眼读图。125/0 只证明当前树自洽可复现,不证明「参照 = 用户所见」;Q-6 族若还有其他 render 体内动画,仍可能冻结中间帧(登记于 §9.4 末)
  • check-pr-checklist.sh 实跑并记录退出码,未凭「模板已填」推断通过
> **目标分支 `dev`**:差异 = `origin/dev..qa/seal-2026-09-28` 共 **15 笔**,含代码封版点三笔生产修复(`a366bd1` fix(qa) / `6bb7c55` test(qa) / `a0328a6` chore(qa)),其余为验收证据、视觉基线补齐与发布链修正。 > > 生产已于 2026-10-08 17:31 按 `a0328a6` 代码封版点发布并完成线上验证(详见 `docs/acceptance/qa-tracker.md` §10);本 PR 补的是治理痕迹——让产物与分支同源。 > > **合并到 `main` 请另开 dev→main PR,不要在本 PR 上直接改 base**:`Jenkinsfile:407-429` 在 `branch main` 上挂有「🚀 部署到生产环境」阶段,会触发无人值守的二次发布。 ## 变更摘要 **分支收敛轮(2026-10-08)**,承接 `qa/seal-2026-09-28` 上的五轮系统性 QA 与 2026-09-30 封版判定。代码封版点仍是 **`a0328a6`**(`a366bd1` fix(qa) / `6bb7c55` test(qa) / `a0328a6` chore(qa) 三笔为其全部生产改动);`a0328a6` 之后的 8 笔(`1b8ffd5`、`1b5c75a`、`19569f6`、`1396666`、`6ff19d1`、`6ba4b70`、`c66dfca`、`bcd32b3`)**零 `src/` 改动**,内容为:封版证据入库、作者侧 agentic 工具化 + 主导航键盘用例、台账数字校正、**视觉基线补齐与追认**、归因改判与 lessons。 本 PR 相对上一份描述(`.pr-seal-2026-09-30.md`)的**唯一判定级变化**:视觉回归层由历轮的 `94 passed / 31 failed / EXIT=1` 变为 **`125 passed / 0 failed / EXIT=0`**,AUTH-D3 就此闭合。台账现行段落:`docs/acceptance/qa-tracker.md` §8(agentic 轮)与 §9(基线轮);封版判定书:`docs/acceptance/2026-09-30-seal/final-verdict.md`。 新增测试资产:`e2e/nav-keyboard.spec.ts`(4 例 `@a11y`,主导航 mega dropdown 的键盘契约,此前只有 hover 路径)、`.claude/agents/playwright-test-{planner,generator,healer}.md` + `.mcp.json`(Playwright 1.60 自带 `init-agents`,**未新增依赖、运行期零模型**)。 ## 关联 Issue 关闭:N/A(无 issue 系统;来源为 `docs/acceptance/qa-tracker.md` §2 五轮缺陷登记与 §8.5/§9.5 待授权清单) ## 提交前检查 - [x] 已通过 `bash scripts/check-pr-checklist.sh .pr-seal-2026-10-08.md`(本文件,退出码记于「假绿灯纪律」末条) ## 全链路检查 - [x] `npm run type-check`:**EXIT=0,0 error**。本轮(§9)在 `1396666` 树上复跑过(§8.2 表),且 `a0328a6..HEAD` 零 `src/` 改动 ⇒ 封版不变式成立,无需重跑(`git diff --name-only a0328a6..HEAD` 全落在 `docs/ specs/ e2e/ README.md .claude/ .mcp.json`) - [x] `npm run lint`:**0 error / 104 warning**,EXIT=0,本轮零新增。口径权威位在 `docs/development/quality-gates.md`(`AGENTS.md` §5 曾记 105,已按现测更正);新增的 `e2e/nav-keyboard.spec.ts` 自身 0 告警 - [x] 路由/链接真实:**本 PR 未新增任何 `href`**。新增 spec 只导航到已存在路由(`/`、`/products`、`/contact`);`/products/erp-upgrade` 与 `/about/brand` 此前是「列在 `VISUAL_TEST_PAGES` 但无参照」,本轮已补齐参照(不再是死覆盖) - [x] 涉及 CMS 内容模型:**须重跑 `npm run db:seed`,且截至本描述定稿仍未执行**(AUTH-D2 未闭合)。依据:本分支改过 `prisma/seed.ts` 与 `prisma/seeds/{products,solutions,standalone-products}.ts` 的 `modelCode`(`team→team-page`、`legal→legal-page`、`+contact-page`、`+shellReadModels`),而 `src/lib/permissions.ts:26` 按 `modelCode` **精确匹配** ⇒ 不重 seed 则生产非 super_admin 角色持失效授予且缺 `content-model`/`content-zone` 读权(`admin/models`、`admin/stats`、`zones` 三处消费)。2026-09-30 判定书 §58 行记的是「发布计划内含」,**不是已执行**;本地 `dev.db` 同样仍旧权限行。DB 写入须单独授权,不静默假定生效 - [x] 涉及视觉/交互改动:`a0328a6` 的 Q-5/S-2 网格修复改变产品/方案详情页版面(单列→多列),已在 sealed 树用真实浏览器结构实证(`grid-structure-report.json`:`/products/erp` 五个网格 computedCols = 3/2/4/4/12)+ 目视截图(`visual-check/`)。**本轮已完成基线追认**:13 张覆盖全部是真判红(裸 `--update-snapshots` 实为 `changed` 模式,只写缺失/不符,`node_modules/playwright/lib/program.js:202`),逐张读图核看过(`docs/acceptance/2026-10-08-baselines/attribution.md` §4) - [x] 暗黑模式:本 PR 无新增样式;axe 门禁在 `light`/`dark` 双主题各扫 34 页,`themeMismatch=0`、`bgMismatch=0`;`check:axe` **EXIT=0 / `PASSED=true`**(sealed 树实测) - [x] 动效合规:`npm run check:motion` = **EXIT=1,23 处**(R4 曲线 20 + R3 裸时长 2 + R2 超上限 1),与周期 2 同数 ⇒ 零新增,属 DEC-P2-motion **待裁定**,未并入 `check:a11y`。诚实边界:4 个违规文件确在本 PR 改动清单内,不得简化为「本轮无涉动效」 - [x] 品牌红:本 PR 无新增页面,触达点与面积不变;`check:brand-token` 0 违规(§7.4 产物实测) - [x] 数字与宣称口径:**业务已裁定按例外上线**——DEC-N30(4 条互斥 SLA 同时在线)与 DEC-D5(`/products/erp-upgrade` 的 `99.2%`/`100%`/「从5天到1天」无 basis 无角注)不改文案,作为签核例外登记于判定书 §4;`basis` 缺失/非法按最弱 `target` 处理并自动附角注的机制在 `a0328a6` 已带测试 - [x] 无遗留 `console.log`/`TODO`/`FIXME`/`.only()`:新增的 `e2e/nav-keyboard.spec.ts` 与 `docs/acceptance/2026-10-08-baselines/row-diff.cjs`(取证脚本)均无 `.only`;`row-diff.cjs` 是一次性归因工具,随证据目录入库以便复跑 ## 测试分层检查(L0–L3) - [x] L0 单元:沿用 `a0328a6`(`test:coverage` 143 套件 / 1772 例 EXIT=0);本 PR 后 8 笔无源码改动 ⇒ 无新用例需求 - [x] L1 组件:同上。`check:motion` 的自证伪测试(19 例,双向断言 + 规则全集元测试)在 `scripts/utils/__tests__/`,需 `--roots` 指定,不在 `test:unit` 口径内(已登记) - [x] L2 E2E(功能):生产目标 `E2E_TARGET=production` + 排除两个写库 spec ⇒ **91 passed / 1 failed**,唯一红 `[firefox] uj-09:124` 按 §2.4 定性为并发/墙钟族(同批次另三引擎绿、隔离单跑 passed、4-project 并发复跑两次各 4 passed);`prisma/dev.db` 跑前后 inode/size/mtime 一致 ⇒ 未写库。**写库 11 例(AUTH-D4)仍未执行** - [x] L2 E2E(本轮新增键盘层):`e2e/nav-keyboard.spec.ts` 四读数——dev 目标四 project **10 passed / 6 skipped**、production 三桌面 project **10 passed / 2 skipped**、稳定性 `--workers=1 --repeat-each=3` **24 passed / 0 failed**,两目标 EXIT=0。两条引擎/目标差异已定性且未用守卫压红:① macOS WebKit 不响应真实 Tab(`activeElement` 恒 `BODY`,与 N-27 同源)⇒ 2 例按 `browserName==='webkit'` 跳过;② dev 下触发器节点 hydration 后被整体替换(生产不复现)⇒ `openWithKeyboard()` 用 `toPass()` 重发交互。tag 为 `@a11y`,不在 `test:e2e:fast` 的 `@smoke|@critical` 集合内 ⇒ `test:all` 时长不变 - [x] L3 视觉回归:**本轮转绿**。写盘 `npm run test:visual:all -- --update-snapshots` ⇒ 125 passed / 4.3m / EXIT=0,落盘 38 张(25 新 + 13 覆盖);判定用**另一次独立只读运行** `--update-snapshots=none` ⇒ **125 passed / 0 failed / 4.1m / EXIT=0**,期间 `git status --porcelain e2e/visual-snapshots` 保持 25 `??` + 13 ` M` 未变 ⇒ 只读性成立。**未放宽任何容差**(`e2e/playwright.config.ts:38-40` 三项与历轮逐字一致)。**已核**:不接受盲更新快照——三张关键新参照经人眼读图(见 attribution.md §4),且「一例多 shot」使 38 张对应 31 例,已逐组对账 - [x] 机械守卫带正控制:axe 门禁以退出码判定(0/1/2),`crawl-routes.mjs` 在清单 0 条时不写出并 exit 2(防空输入假绿);`nav-keyboard` 的断言对象是 `aria-expanded` + `activeElement` 双重锚点而非「不报错即绿」;`row-diff.cjs` 的定位结论经旧/新裁图对照复核(发散行 y=7440 落在 `benefits` 段) - [x] 相关测试全绿,无 `.only()`/跳过残留:如实登记三处非全绿或跳过——L2 91/1(并发族)、`check:motion` 23 处、`nav-keyboard` 的 webkit 2 例跳过(有引擎级依据);视觉层本轮无跳过残留 ## 质量门禁 - [x] `npm run test:unit` / `test:coverage`:沿用 §7.4 的 143 套件 / 1772 例 EXIT=0,阈值**未下调**(唯一真源 `config/test/jest.config.js` 的 `coverageThreshold`,根 `jest.config.js` 仅转发) - [x] `npm run test:integration:real`:23 例 EXIT=0(§7.4),teardown 以 inode+size+mtime 守卫 `prisma/dev.db` 未被写入 - [x] `npm run check:a11y`(contrast + headings + brand-token):44/44 · 10/10 页 · 0 违规(§7.4 产物实测) - [x] `npm run check:axe`(全站节点计数):**EXIT=0 / `PASSED=true`**,34 路由 × (chromium,firefox) × (light,dark) = 136 页,`violationNodes=0`、`contrastNodes=0`、`bgMismatch=0`;唯一 non-2xx 为 `/_not-found`(设计如此)。证据 `docs/acceptance/2026-09-30-seal/axe/axe-evidence.json`。诚实边界:该门禁**不在** `test:all` 内,本地需手动跑 - [x] `npm run lighthouse`:EXIT=0,9 URL × 3 = 27 run 断言全通过,a11y **9/9 = 100**(前提是先修 N-9:standalone 产物须自带 `dist/static`,否则在全站 CSS 404 的裸 HTML 上出数仍会错误 exit 0) - [x] `npm run test:security:headers`:两个口径分开出数——① 打本分支产物 `--url http://localhost:3100/` ⇒ **EXIT=0,7 PASS / 1 WARN(HSTS) / 0 FAIL,每头单次**;② 默认打线上 ⇒ 现测**重复下发**,根因 nginx + `next.config.mjs` 两层叠加,**修复须单独投递 nginx conf**(`deploy.sh` 从不投递),登记为待办未夹带 - [x] `npm run test`(默认 dev 目标 E2E):EXIT=0,但 **GA4 的 16 个 `@critical` 用例在 dev 下是 skipped 而非 passed**(`NEXT_PUBLIC_GA_MEASUREMENT_ID` 只在 `.env.production`)⇒ 该覆盖只在 `test:e2e:prod` 下真正断言,两者不可混为一谈 - [x] 文档已同步:`docs/acceptance/qa-tracker.md`(抬头改判、§8.5 状态回填、**新增 §9** 含授权→执行→读数矩阵与自证循环处置)、`docs/acceptance/2026-10-08-baselines/`(`attribution.md` + 两次运行日志 + `head.txt`/`pre-run-*` + `row-diff.cjs`)、`docs/lessons-learned.md`(**新增 §5.33**:基线判红须对「采集树 vs 当前树」)、`docs/testing.md` / `docs/development/quality-gates.md`(口径行)、`README.md`(进度) - [x] 提交信息符合 Conventional Commits,且每笔可独立评审:`1b8ffd5` docs(seal) / `1b5c75a` test(qa) / `19569f6`+`1396666`+`6ba4b70`+`c66dfca`+`bcd32b3` docs(qa) / `6ff19d1` test(visual) - [x] 破坏性/共享状态动作**逐项分离且已单独取得授权**:本 PR 周期内实际执行者 = 本地提交 + 快进推 `qa/seal-2026-09-28`(用户批准)+ 视觉基线写入与追认(用户裁定「两者都授权」)。**未执行**:PR 创建(本环境无 Gitea token)、合并 dev/main、`npm run deploy`、nginx conf 投递、生产 `db:seed`、healer 清理。真实恢复锚点是合并后打 `prod/*` tag(`deploy:rollback` 只回 `dist`,不回容器、不回 `public/`) ## 假绿灯纪律 - [x] 门禁命令**实际执行并记录真实退出码**:判绿一律以日志内 `EXIT=` 行为准,不信后台任务通知的 exit 0(历轮两次踩到 `cmd; echo EXIT=$?` 包装层吞红)。本轮证据全部落盘:`docs/acceptance/2026-10-08-baselines/{update-run,readonly-rerun}.txt` - [x] 未通过删测试/放宽断言/skip 用例/下调阈值让门禁变绿:视觉转绿的路径是**补齐缺失参照 + 追认已过时参照**,容差与阈值三项参数逐字未动;`check:motion` 保持判红且不并入伞形门禁 - [x] 未把误报当缺陷「修掉」,也**未把自己的错判当事实留下**:§9.4 初稿把 chromium-mobile 两页 `+30/+21px` 记为「零源码改动 ⇒ 运行期漂移」,本轮内以 `row-diff.cjs` 定位发散行 + `git diff <采集树>..<当前树>` 证伪——旧参照采集树是 `040951c`(09-22),当前树含 `a366bd1`(09-28 第五轮),真因是 Q-6 把 count-up 动画从 render 体迁入 `useEffect`,**旧参照冻结的是动画中间帧**。该错判已在台账与 attribution 就地作废,教训入 `docs/lessons-learned.md` §5.33 - [x] **封版不变式机械核验**:`git diff --name-only a0328a6..HEAD` 输出全部落在 `docs/**`、`specs/**`、`e2e/**`、`README.md`、`.claude/**`、`.mcp.json` ⇒ 生产代码未变,§7.4 与 sealed 树的绿灯对本次提交恒等成立(不是「重跑一遍做样子」)。受影响面已单独重跑:视觉层(写盘 + 只读两次)、`nav-keyboard`(两目标 + 稳定性)、type-check、lint - [x] 基线「绿」的自证循环已声明边界:参照由本轮自采,采集当下的绿不含信息量;使其仍可失败的四点是容差未动、`changed` 模式不重写通过项、判定用独立第二次运行、三张关键新参照经人眼读图。**125/0 只证明当前树自洽可复现,不证明「参照 = 用户所见」**;Q-6 族若还有其他 render 体内动画,仍可能冻结中间帧(登记于 §9.4 末) - [x] `check-pr-checklist.sh` 实跑并记录退出码,未凭「模板已填」推断通过
zhangxiang added 15 commits 2026-10-08 17:53:26 +08:00
安全/鉴权:登出清服务端 httpOnly 令牌、登录 IP 限流前置 bcrypt、停用账号
令牌在 6 个内联 role handler 失效、admin/items 存在性 oracle 认证前置、
同意偏好 sanitize fail-closed、api-crypto 按 HTTP 方法判体。

CMS:workflow 状态更新+审计收进交互式 $transaction(失败即回滚)、编辑器
richtext 走 textarea 防换行损毁、array/object 子字段按作用域读写防污染、
about/contact/erp-upgrade 补 ISR revalidate 与路由映射。

UI/a11y:AnimatedCounter 入视口前显起点、CLS 累计上报、MetricCard 动画入
effect 并卸载取消 rAF、后台状态四态映射/搜索防抖+序号守卫/媒体单 input/
吞错改横幅/表单 label-aria 关联。

新增对应判别性单测与 pagination/rate-limit/client-ip/sanitize/validate-content-data
等模块及 tests-integration 真库集成层。
- e2e:修死选择器与蜜罐误命中、补断言、GA4/security-headers 用例诚实标注
  skip 边界;新增 assert-helpers/fixtures/hydrated/primary-nav/touch-targets
  等复用桩。
- 集成层:config/test/jest.integration.config.js + tests-integration/ 真库
  一次性 SQLite 用例,teardown 守卫开发库指纹。
- 门禁工具链:jest.setup 归位到根、scripts/accessibility 全站 axe 节点计数、
  check-brand-text-token/check-motion-constraints 机械守卫、stryker/lighthouse
  配置收敛。
- docs/acceptance/qa-tracker.md:跨周期缺陷单一真源台账(§7=第五轮)。
- 周期 1/2 + iPhone SE/axe 验收证据目录、ACCEPTANCE_REVIEW 快照入库。
- 同步 README/CONTEXT/CLAUDE/DESIGN/testing/deployment/lessons-learned 口径;
  next.config/Dockerfile/nginx/Jenkinsfile/docker-compose/sentry/prisma 对齐
  standalone 产物装配与部署形态。
代码封版点仍是 a0328a6;本提交只含验收证据与文档,用于把台账
§0 的「未达可判验收通过(唯一阻断 AUTH-D1)」改判为「封版通过
(含例外清单)」。

补齐 sealed 树上从未跑过的 5 项门禁并如实记录非全绿:
- 全站 check:axe EXIT=0(34 路由 × 双引擎 × 双主题,violation=0)
- 产物安全头 EXIT=0(每头单次,WARN 仅 HSTS 边缘注入)
- 生产目标 E2E 91 passed / 1 failed(唯一红 = firefox 并发墙钟,
  隔离与 4-project 复跑均绿;dev.db 指纹前后一致,未写库)
- 视觉只读 94 passed / 31 failed(20 缺参照 + 11 已过时参照,
  逐条归因;未写任何基线)
- check:motion EXIT=1 / 23 处(与周期 2 同数,未新增)

更正 4 处文档假事实:DEC-N21b(/admin 实有服务端 gating,入口是
src/proxy.ts 而非 middleware.ts)、视觉基线「85 张未提交」(实测
107 张全在库)、「无需重跑 db:seed」(seed 改过 modelCode 而
permissions 精确匹配)、lint 105→104。
选型:AI 只用在「写/修/探索」,运行期保持零模型、零外部服务。不引入
tester-army/e2e —— 它是第二套 runner,且与本仓最值钱的三块错配(无像素
基线可比、不模拟 touch/color-scheme/reduced-motion、另起 json/junit 产物
口径)。判据、对照表与边界见 docs/testing/agentic-test-authoring.md。

- init-agents 产物:.claude/agents/{planner,generator,healer}.md + .mcp.json
  指向仓内自带的 run-test-mcp-server(不装 @playwright/mcp;Playwright 自身
  不调 LLM,模型由宿主 loop 提供 ⇒ 无新增密钥依赖,也不外发应用内容)
- 故意不入库 init-agents 生成的 seed.spec.ts:空占位会被 test:functional
  的 4 个 project 当空用例收集
- specs/nav-keyboard-navigation.plan.md:7 个场景,3 个延后并写明原因
- e2e/nav-keyboard.spec.ts(tag @a11y,4 例):补「键盘打不开/走不出主导航
  下拉」。hover 路径早有覆盖,jsdom 单测替不了浏览器层的 relatedTarget 与
  真实焦点顺序;契约逐行取自 src/components/layout/mega-dropdown.tsx:35-76
- 实测读数:dev 四 project 10 passed / 6 skipped(EXIT=0);E2E_TARGET=
  production 10 passed / 2 skipped(EXIT=0);--workers=1 --repeat-each=3
  24/24;type-check 与 lint 均 0 error
- 测到并定性两条「非产品缺陷」:① WebKit 本机不响应真实 Tab 键(连续 4 次
  后 activeElement 仍是 BODY,而 .focus() 有效),与 N-27 同源;② dev 目标
  下触发器 DOM 节点在 hydration 后被整体替换(失败样本 click=1 而 aria 恒
  false,通过样本相反 ⇒ 监听绑在已被换掉的旧节点上),生产产物不复现
  ⇒ openWithKeyboard 用 toPass() 重发交互;跳过范围按引擎收窄,没有用守卫
  把红压掉
- 不在本提交:AGENTS.md 已被 .gitignore 排除,其「85 张基线未提交」的日期
  更正只落本地;该假事实的已入库更正记录在 docs/lessons-learned.md:505
- 选型判定与淘汰依据(采用 Playwright Test Agents,本轮不引入 tester-army/e2e)
- nav-keyboard.spec.ts 四个读数(dev 10/6、production 10/2、稳定性 24/24、lint/tsc 0)
- 两条引擎/目标差异定性:WebKit 不响应真实 Tab(N-27 同源);dev 下触发器节点被整体替换
- 视觉只读复跑 94/31 与 §7 同数,分层 20 缺参照 + 11 已过时参照;只读性已验(0 写入)
- 更正 AGENTS.md 的「85 张未提交」假事实(该文件 gitignore,仅本机)并作废我自己
  写错的「^1.58.2 vs 1.60.0」一条
- §8.5 待授权清单:push / PR(无 token) / deploy(不建议本轮) / 基线写 / healer
- 抬头 HEAD 由 a0328a6 改为 19569f6,并区分「代码封版点」与其后 3 笔未推的纯文档/测试提交
- 树状态口径更新:未跟踪 2→3 条;补记仓库无自定义 clean/smudge filter,故 porcelain 可直接采信
- 领先关系现取 origin 分支落后 3、origin/main 落后 37;29 个变更文件全在 docs/specs/e2e/README/.claude/.mcp
- §8.5 A/B 两行的 2 笔/36 笔为 19569f6 提交前读数,就地更正并注明来源
- B 行补 2026-10-08 复探依据:env 无 token、~/.config/gitea 与 ~/.gitea 不存在、git config 无 credential
AUTH-D3 长期是视觉层唯一未判定项(94/31),本轮经用户裁定「缺参照与已过时
两者都授权」后一次性收口:

- 写入 38 张(25 新 + 13 覆盖)= 台账 31 例的文件级读数,一例多 shot 已逐组对账
- 裸 --update-snapshots 实读为 changed 模式(program.js:202 preset),只写缺失/不符,
  故 13 张覆盖全是真判红,不存在通过项被顺手改写
- 桌面/平板/webkit 全页高度收缩 1005–4034px,归 Q-5/S-2 网格修复;chromium-mobile
  按钮参照从 186x96 桌面下拉触发器改为 132x132 真实可见汉堡按钮(N-15(c))
- 逐张读图核看关键新参照:input-default 拍到真实姓名框而非蜜罐,product-card 中部
  留白与已批准的 products-fullpage 同形(flex-1 段落撑高),非渲染缺失
- 复跑 --update-snapshots=none:125 passed / 0 failed / EXIT=0,期间零写入
- 取证入 docs/acceptance/2026-10-08-baselines/(生成树 1396666、两次运行日志、
  归因表与未归因的移动端 +30/+21px 观察项)
- §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 项只读取证
台账 §9.4 初稿把 chromium-mobile 两页 +30/+21px 记为「零源码改动 ⇒ 只能来自
运行期」,参照系用错:旧参照的采集树是 040951c(09-22),当前树含 a366bd1
(09-28 第五轮),参照比树旧了一个修复轮次。

- 实测归因:row-diff.cjs(sharp 逐行比对)定位发散行 y=7440 落在 /products/erp
  的 benefits 段;git diff 显示 Q-6 把指标 count-up 从 render 体迁入 useEffect
  并加取消 ⇒ 旧参照冻结的是动画中间帧,新参照是稳定终态,属预期改进
- 排除数据侧:prisma/seeds/products.ts 在该窗口零改动
- 三条口径落到 lessons §5.33:归因须对「采集树 vs 当前树」;基线数量须标「例/张」
  (本轮 38 张 = 31 例);裸 --update-snapshots 实为 changed 模式,不重写通过项
- §9.5 的 G 项就此关闭,取证脚本随证据目录入库
本文件所在提交本身会让「领先 N 笔」过期(§8.5 A 行就因这个失效过一次),
改为给出取数命令;本轮链以 sha 序列明示,HEAD 与未推集合标注现取方式。
- quality-gates.md §6.2:原文称裸 --update-snapshots 取 missing,实为 changed
  (program.js:202 preset);missing 是完全不带旗标时的缺省(common/index.js:584)。
  两种触发条件差异改写,读数补 125/0 与「例数 ≠ 张数」「归因须对采集树 vs 当前树」口径
- docs/testing.md:参照计数 107→132(每 project 21→26),原「用例数−参照数=覆盖空洞」
  算式已不成立,改为三个 shot 归组来源;N-15 空洞标注已闭合
- README.md:撤下「视觉 94/31」现行口径(改历史 + 125/0),例外清单移出视觉基线,
  新增 2026-10-08 轮次条目,台账指针 §8→§9
- qa-tracker 新增 §9.6:本树一手复测 type-check EXIT=0 / lint 0 error 104 warning
  (此前 PR 引用沿用他轮读数,不满足「命令实际执行过」条)+ 四处同步清单 +
  PR 描述 .pr-seal-2026-10-08.md 过门禁 EXIT=0
2026-10-08 生产事故:deploy.sh 打出「🎉 部署成功」而线上 CSS/JS/图标全 404。
根因是 nginx 站点根就是上传后的 dist/(nginx-static-production.conf:132 的
root /var/www/novalon + :136-142 的 try_files $uri =404),要求磁盘上存在
dist/_next/static/**;而 next build 出的是 dist/static/**,postbuild 只补
standalone 容器形态。历史镜像由旧流程产出,被本次 rsync --delete 抹掉。

- 步骤 1.5:上传前本地生成镜像(dist/static → dist/_next/static、public/. → dist/),
  dist/static 缺失即终止部署而非静默继续
- verify_remote:从首页 HTML 实际引用的 URL 取前 5 个 /_next/static/*.{js,css}
  加 /favicon.ico 逐个断言 200,任一非 200 即 return 1。负对照实测:换成不存在
  的取样 URL ⇒ RED 404 且 failed=1,断言可失败
- 只查五个 HTML 路径的门禁,在破站状态下会判绿——这是本次事故的直接放大原因
- §10:发布内容/序列(build EXIT=0 → 真 prod.db 副本预生产演练 14 路由全 200 →
  prod.db.bak.20261008_173048 快照 → dist_backup_20261008_173111 → DEPLOY_EXIT=0)
- §10.2:本次部署引入的回归与恢复(≈4 分钟),并用 nginx access.log 现取 10-07
  同一 URL 为 200 的证据把回归定性为自己引入而非既有状态
- §10.4:Playwright 三页线上健康证据(stylesheets=2、品牌红命中、4xx/5xx GET=0、
  console error=0)
- §10.5:发布后仍未闭合项,含 AUTH-D2 的真凭据——prod.db 里 Permission.modelCode
  仍是旧码 team/legal(各 11 条授予)而 ContentModel 已是 team-page/legal-page/
  contact-page 等 16 个模型;并列出三条 seed 执行候选与建议
- deployment.md §七:两种产物形态的契约、镜像生成命令、回滚须连容器一起、
  compose/Dockerfile 从不同步导致的挂载漂移
- lessons §5.34:三条规则 + 两条取证法 + 管理归零(预生产演练、资源级门禁)
zhangxiang added 1 commit 2026-10-08 17:58:25 +08:00
- AUTH-D2 生产 db:seed 已执行:esbuild 打包真 seed → 生产库副本演练 → 逐表差异
  (Permission +63/−0、ContentItem 37→38、24 条随 seed 源更新、User 口令逐字节未变)
  → 停容器窗口内用生产镜像跑 → 事后取回比对。快照 prod.db.bak.20261008_174734-preseed
- H compose 漂移已消除:先 diff 证明只差挂载一行,备份后同步并重建,
  docker inspect 现取 ./uploads -> /app/public/uploads
- I cmd_rollback 追加 docker-compose build && up -d 与就绪轮询,并复用资源级 verify
- J PR #29 建成(qa/seal-2026-09-28 → dev,mergeable true);同时作废「本环境无 Gitea
  token」这条由 `2>/dev/null` 吞掉报错造成的假事实,教训入 lessons §5.35
- 新登记 K:navigation 与 site-config 在 seed 的 permissionMatrix 里无授予项
- 证据:docs/acceptance/2026-10-08-release/(build/deploy/type-check/lint 日志、
  seed 演练与逐表差异脚本及输出)
zhangxiang added 1 commit 2026-10-08 18:02:34 +08:00
prisma/seed.ts:241-242 注释写明这两个模型仅 super_admin 可维护,
src/lib/seed-permissions.test.ts:18-19,50 用 SUPER_ADMIN_ONLY_MODELS 双向钉住。
我上一笔只看了 permissionMatrix 里没有就判为覆盖缺口,违反本仓 lessons §5.32
已立的「按缺推断机制不存在须给三条证据」规则,就地作废并留痕。
zhangxiang added 1 commit 2026-10-08 18:05:15 +08:00
- 新 BUILD_ID HCvsEIztksM1GCWBJBrRP 上线;步骤 1.5 生成的镜像使 verify_remote
  的六项资源级断言在真实部署中全 200 —— 破站路径已由脚本自身堵住,不再靠人工复核
- 线上首页引用的 chunk 逐个回查本地产物确认同源;Playwright 三页 0 失败资源、0 控制台错误
- 证据补 deploy-2.txt 与可复跑的 probe.mjs
zhangxiang merged commit 104ec7db07 into dev 2026-10-08 18:21:42 +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#29