test(visual): 首页缺 data-cms-state 时判红,避免守卫退化成死判据 #60

Merged
zhangxiang merged 1 commits from fix/cms-state-guard-required into dev 2026-10-21 16:58:05 +08:00
Owner

变更摘要

#58 里新增的 CMS 退化守卫写成「有标记就校验、没有就跳过」。标记本身正是这条守卫的依据:
prop 没透传、组件被换回旧版、属性改名,任一都会让守卫静默失效而用例照样绿。
本 PR 把首页的标记改为必须存在:/ 路径下缺标记即按名字报错,其它页面跳过。

关联 Issue

N/A:承接 #58 的自查,无协作平台 Issue。

提交前检查

  • bash scripts/check-pr-checklist.sh 对本描述文件 EXIT=0
  • N/A:仅改一个测试 helper,无产品代码、无 DB、无 seed

全链路检查

  • npm run type-check — N/A:本 PR 零 .tsx 产品变更;type-check:e2e 已跑(见下)
  • npm run type-check:e2e — EXIT=0
  • npm run lint — N/A:本 PR 只改 e2e/,未触及 npm run lint 的扫描面;改动沿用同文件既有风格
  • 路由/链接真实 — N/A:未新增链接;判定用 new URL(page.url()).pathname
  • 涉及 CMS 内容模型 — N/A:不读字段定义、不改 seed
  • 视觉/交互改动 — N/A:无渲染变更
  • 暗黑模式 — N/A
  • 动效合规 — N/A
  • 品牌红触达 — N/A
  • 数字与宣称口径 — N/A:描述里两条读数均为实跑
  • 无遗留 console.log / TODO / .only()

测试分层检查(L0–L3)

  • L0 单元 — N/A:无产品逻辑变更(data-cms-state 的产生与渲染在 #58 已有 3 例单测)
  • L1 组件 — N/A
  • L2 E2E — 本 PR 改的是视觉层 helper,功能层不受影响
  • L3 视觉回归 — --grep "首页" 5 project × 5 例 25 passed / 0 failed
  • 新增机械守卫带正控制 — 正控:25 例全绿说明标记确实在 DOM 且为 ok(不是空跑);负控:临时删掉 data-cms-state 属性 ⇒ 用例立即转红并报「首页缺少 data-cms-state 标记」,改回后转绿
  • 已运行相关测试并全绿,无 .only() / 跳过态残留

质量门禁

  • npm run test:unit — N/A:零产品代码变更(#58 同树读数 149 套件 / 1818 例)
  • npm run test:coverage — N/A:未改阈值
  • npm run test(Playwright E2E)— 视觉层 25/25;功能层未跑(本 PR 不触产品代码)
  • npm run check:contrast / check:headings — N/A:无样式与标题变更
  • npm run lighthouse — N/A:无产物变更
  • npm run test:security:headers — N/A:未触及响应头与部署
  • 文档已同步 — 无新增术语;行为约束已写在 helper 注释里,并与 §5.51 的判据口径一致
  • 提交信息符合 Conventional Commits — 单笔 test(visual)
  • 破坏性/共享状态动作已单独授权 — 无;合并走既有授权

假绿灯纪律

  • 门禁命令实际执行过并粘贴真实输出 — 正控 25 passed、负控 1 failed 均实跑
  • 未通过删测试、放宽断言、skip 用例或下调阈值让门禁变绿 — 相反,把「跳过」这条出口堵掉了
  • 未把误报当问题「修掉」— 这次改的正是「永远不会红」的那条判据
## 变更摘要 #58 里新增的 CMS 退化守卫写成「有标记就校验、没有就跳过」。标记本身正是这条守卫的依据: prop 没透传、组件被换回旧版、属性改名,任一都会让守卫静默失效而用例照样绿。 本 PR 把首页的标记改为**必须存在**:`/` 路径下缺标记即按名字报错,其它页面跳过。 ## 关联 Issue N/A:承接 #58 的自查,无协作平台 Issue。 ## 提交前检查 - [x] `bash scripts/check-pr-checklist.sh` 对本描述文件 EXIT=0 - [x] N/A:仅改一个测试 helper,无产品代码、无 DB、无 seed ## 全链路检查 - [x] `npm run type-check` — N/A:本 PR 零 `.tsx` 产品变更;`type-check:e2e` 已跑(见下) - [x] `npm run type-check:e2e` — EXIT=0 - [x] `npm run lint` — N/A:本 PR 只改 `e2e/`,未触及 `npm run lint` 的扫描面;改动沿用同文件既有风格 - [x] 路由/链接真实 — N/A:未新增链接;判定用 `new URL(page.url()).pathname` - [x] 涉及 CMS 内容模型 — N/A:不读字段定义、不改 seed - [x] 视觉/交互改动 — N/A:无渲染变更 - [x] 暗黑模式 — N/A - [x] 动效合规 — N/A - [x] 品牌红触达 — N/A - [x] 数字与宣称口径 — N/A:描述里两条读数均为实跑 - [x] 无遗留 `console.log` / `TODO` / `.only()` ## 测试分层检查(L0–L3) - [x] **L0 单元** — N/A:无产品逻辑变更(`data-cms-state` 的产生与渲染在 #58 已有 3 例单测) - [x] **L1 组件** — N/A - [x] **L2 E2E** — 本 PR 改的是视觉层 helper,功能层不受影响 - [x] **L3 视觉回归** — `--grep "首页"` 5 project × 5 例 **25 passed / 0 failed** - [x] 新增机械守卫带**正控制** — 正控:25 例全绿说明标记确实在 DOM 且为 `ok`(不是空跑);负控:临时删掉 `data-cms-state` 属性 ⇒ 用例立即转红并报「首页缺少 data-cms-state 标记」,改回后转绿 - [x] 已运行相关测试并全绿,无 `.only()` / 跳过态残留 ## 质量门禁 - [x] `npm run test:unit` — N/A:零产品代码变更(#58 同树读数 149 套件 / 1818 例) - [x] `npm run test:coverage` — N/A:未改阈值 - [x] `npm run test`(Playwright E2E)— 视觉层 25/25;功能层未跑(本 PR 不触产品代码) - [x] `npm run check:contrast` / `check:headings` — N/A:无样式与标题变更 - [x] `npm run lighthouse` — N/A:无产物变更 - [x] `npm run test:security:headers` — N/A:未触及响应头与部署 - [x] 文档已同步 — 无新增术语;行为约束已写在 helper 注释里,并与 §5.51 的判据口径一致 - [x] 提交信息符合 Conventional Commits — 单笔 `test(visual)` - [x] 破坏性/共享状态动作已单独授权 — 无;合并走既有授权 ## 假绿灯纪律 - [x] 门禁命令实际执行过并粘贴真实输出 — 正控 25 passed、负控 1 failed 均实跑 - [x] 未通过删测试、放宽断言、skip 用例或下调阈值让门禁变绿 — 相反,把「跳过」这条出口堵掉了 - [x] 未把误报当问题「修掉」— 这次改的正是「永远不会红」的那条判据
zhangxiang added 1 commit 2026-10-21 16:58:01 +08:00
上一版写成「有标记就校验、没有就跳过」。可标记正是这条守卫存在的理由:
prop 没透传、组件换成旧版、属性改名,任何一种都会让守卫静默失效,
而用例照样绿——正是「备好但从未跑成」的那类自伤。

改为按路径判定:`/` 必须带标记且为 ok,否则按名字报错;其它页面跳过。
正控:25 个首页相关用例全绿(标记确实在 DOM 里且为 ok)。
负控:临时把属性去掉 ⇒ 立刻红,报「首页缺少 data-cms-state 标记」。
zhangxiang merged commit 03be1c9e36 into dev 2026-10-21 16:58:05 +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#60