重新 seed 把 contact-page 的两段文案恢复成 seed 版本(785→792 字节,差异键 heroDescription 与 commitmentItems[0]),而现有基线是在被污染的旧内容上采的 ⇒ 终版产物门禁里视觉只读 6 failed,全部是内容型整页/表单裁图,不是样式回归。 - 重采后两次运行均 125 passed / 0 failed(--update-snapshots 与 --update-snapshots=none)。 - §14.6 写死口径:重跑 db:seed 或改 CMS 文案会让内容型基线失效, 按「内容变更 ⇒ 重采 + 只读复验」处理;若只有 /contact、/news 整页红而组件裁图全绿, 先查数据而不是查 CSS。
1143 lines
150 KiB
Markdown
1143 lines
150 KiB
Markdown
# QA 问题跟踪台账(系统性质量保障 · 单一真源)
|
||
|
||
- 分支:`qa/seal-2026-09-28`,**与 `origin` 同步**(2026-10-08 两次快进推送完成,见 §9.5 F 行)。代码封版点仍是 `a0328a6`;其后的 2026-10-08 收尾链起点为 `1396666`(数字校正)→ `6ff19d1`(视觉基线 38 张入库)→ §9 记录 / 归因改判 / 四处文档同步等数笔,**完整序列现取 `git log --oneline a0328a6..HEAD`,不在本行复制笔数**
|
||
- 树状态(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 ⇒ 上面的「干净」可直接采信。领先关系**不写死笔数**(本文件所在提交自身会让笔数过期):现取用 `git rev-list --count origin/qa/seal-2026-09-28..HEAD` 与 `git rev-list --count origin/main..HEAD`。视觉参照现取 `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)
|
||
- 本台账的作用:把上述**分散编号统一到一处**,作为「问题跟踪机制」的执行面;**不重复**两份报告的证据叙述,只登记**状态 + 归属阶段 + 闭合阻塞项**。
|
||
- 编号消歧:周期 2 的缺陷 `D-1`(detail-trust-section)与决策清单 `D-1`(入库)同名,本台账分别记为 **DEF-D1**(缺陷)与 **AUTH-D1**(决策/授权项)。
|
||
|
||
## 0. 验收判定(对齐 objective 五阶段)
|
||
|
||
| objective 阶段 | 交付物 | 状态 |
|
||
|---|---|---|
|
||
| 1 代码审查 | 两份周期报告 + 本台账 §1 | **已达成**(多轴、subagent + 主线逐条复核) |
|
||
| 2 测试 | 门禁实测表(周期 1 §1 / 周期 2 §0)+ `docs/testing.md` | **已达成**(可自主执行的门禁全部出数;写库/基线/线上/全量变异等需授权项见 §3) |
|
||
| 3 修复 + 跟踪机制 | 本台账(单一真源) | **机制已建立**;修复的**可复现性未达成**(未入库) |
|
||
| 4 优化 | 性能(Lighthouse 9/9=100、a11y 节点计数、限流键、死资源清理)+ 安全(提权/XSS/越权/令牌/开放重定向) | **已达成**,余留项见 §2/§3 |
|
||
| 5 验收确认 | 本报告 + 门禁凭据 | **封版通过(含例外清单)**——AUTH-D1 已闭合,2026-09-30 补齐从未在 sealed 树上跑过的 4 项门禁;判定书见 `docs/acceptance/2026-09-30-seal/final-verdict.md`,例外见其 §4 |
|
||
|
||
> **【2026-09-30 改判 · 现行判定】封版通过(含例外清单)**。AUTH-D1 已于 2026-09-28 闭合(三笔提交入 `qa/seal-2026-09-28`,`a0328a6`);本轮补齐 sealed 树上从未跑过的全站 `check:axe`、生产目标 E2E、视觉只读比对、产物安全头、`check:motion` 五项,三处判红已逐条定性。判定书:`docs/acceptance/2026-09-30-seal/final-verdict.md`。**下面两条历史结论仅作过程留痕,不再代表现状。**
|
||
>
|
||
> ~~**结论不变**~~(历史,2026-09-30 作废;承接周期 1「有条件通过」/周期 2「未达可判验收通过」):技术面已闭环并有实测凭据;验收不能判完成的**唯一实质原因**是 §3 AUTH-D1(约 363 条改动未提交,评审者/CI/下一位开发者无法复现本台账任何结论)。
|
||
>
|
||
> ~~**2026-09-28 更新**~~(历史:该轮改动随后即入库):第三/四/五轮(§4/§5/§7)在此结论上继续累积修复(第五轮再修 S-21/S-22/Q-10②/S-3 两个 P2 + 12 个 P3,全带判别测试与门禁凭据),未提交的工作树现 **394 条**——AUTH-D1 仍是唯一硬阻断。
|
||
|
||
## 1. 本台账建立时的独立复核(trust-but-verify,2026-09-25)
|
||
|
||
对**最高后果**的 12 项「已修」声明做了只读源码复核(读当前工作树,未采信报告自述),结论:
|
||
|
||
| ID | 声明 | 复核结果 | 证据(本次亲读) |
|
||
|---|---|---|---|
|
||
| N-18 | draft/disable 开放重定向防护 | **CONFIRMED** | `src/lib/cms/internal-redirect.ts:8`;`disable/route.ts:13-21` 先校验后副作用 |
|
||
| N-19 | admin/stats 越权读取 | **CONFIRMED** | `src/app/api/admin/stats/route.ts:11` 用 `requirePermission('content-model','read')` |
|
||
| N-20 | 停用账号令牌仍可用 | **CONFIRMED** | `src/lib/permissions.ts:41-45` 读 `User.status`,早于 `:52` 的 super_admin 短路 |
|
||
| N-25 | 限流 XFF 伪造绕过 | **CONFIRMED** | `src/lib/client-ip.ts:14-23` 优先 `x-real-ip`、XFF 取最右;`contact/route.ts:4,51` 消费 |
|
||
| N-22 | 安全头门禁恒不成立 | **CONFIRMED** | `check-security-headers.ts:63-78,101,128-132` cookie 状态按 flag 推导并计入退出码;缺 CSP=fail;HSTS 分 http/https |
|
||
| N-1 | JSON-LD `</script>` 注入 | **CONFIRMED** | `src/components/seo/structured-data.tsx:8-9` `jsonLd()` 转义 `<`/`>`,8 个 sink 全用 |
|
||
| DEF-A1..A4 | 后台编辑器定位/守卫 | **CONFIRMED** | `admin/content/[modelCode]/[itemId]/page.tsx` `id` 过滤 + `itemNotFound`(:691) + `canEdit`(:252,736,917) 收口 |
|
||
| C-1 | 案例页缺键整页崩溃 | **CONFIRMED(边界归一)** | 归一在唯一 importer `(marketing)/cases/[slug]/client.tsx:22,30-35`,恰在未受信任 CMS 强转处;报告所称组件文件为归属笔误,非漏洞(见 §2.2 REG-C1) |
|
||
| L-5 | 媒体派生命名冲突 | **CONFIRMED** | `src/lib/media/image-processor.ts:75` 追加 `Math.random()` 后缀 |
|
||
| L-1 | admin-api 吞掉 4xx/5xx | **CONFIRMED** | `src/lib/admin-api.ts:85-102` 解密后按 `res.ok` 抛错 |
|
||
| N-4/5/6 | 保存/发布状态通道 | **CONFIRMED** | 保存载荷无 `status`;发布走 `runWorkflow`;POST 拒非 draft |
|
||
| DEF-D1 | 指标前导符号错位 | **CONFIRMED** | `detail-trust-section.tsx:26-48` 用 `[^0-9.]` 否定类 + prefix/suffix 分列 |
|
||
|
||
> Sentry 接线亦复核为真:`src/instrumentation.ts`、`src/instrumentation-client.ts` 存在且 import `@sentry/nextjs`;`next.config.mjs:131` `export default withSentryConfig(nextConfig)`。
|
||
> 覆盖扫描(非定点复核):`src/`+`scripts/` 内无条件 `status:'pass' as const` = **0**;`\|\| echo` = 12(均在 CI/部署 shell 的信息性回退,非门禁判据);`e2e/*.spec.ts` 内 `if (.count()>0)` 守卫 = 11 处(周期 1/2 已逐条定性为视口/角色合法分支,见 N-27)。
|
||
|
||
## 2. 缺陷登记(按闭合状态分组)
|
||
|
||
图例 · 状态:`FIXED-UNCOMMITTED`=已修且§1或原报告有 RED/GREEN 凭据,但未入库;`DECISION`=待产品/设计裁定;`AUTH`=待单独授权动作;`RECORDED`=已知、诚实披露、本轮不动。
|
||
|
||
### 2.1 已修复(代码在工作树内,含 §1 复核标记)
|
||
| ID | 级别 | 类别 | 摘要 | 状态 | 凭据 |
|
||
|---|---|---|---|---|---|
|
||
| N-18/19/20/25 | P1 | 安全 | 开放重定向 / 越权读取 / 停用账号令牌 / 限流绕过 | FIXED-UNCOMMITTED | §1 全部 CONFIRMED + 原报告 RED 实测 |
|
||
| N-22 | P1 | 门禁可信度 | 安全头门禁恒不成立断言 | FIXED-UNCOMMITTED | §1 CONFIRMED + 双向对照 |
|
||
| N-1 | P1 | 安全 | JSON-LD 存储型 XSS 面 | FIXED-UNCOMMITTED | §1 CONFIRMED |
|
||
| N-4/5/6/7 | P0/P1 | 功能 | 后台保存必 400 / 发布必失效 / 状态死控件 / 状态回写 | FIXED-UNCOMMITTED | page.test.tsx |
|
||
| N-9 | P0 | 门禁可信度 | standalone 产物缺 `dist/static`(CSS 404) | FIXED-UNCOMMITTED | postbuild 落地 |
|
||
| N-11 | P2 | 性能/BP | `/contact` CSP 违规(Zod eval 探测) | FIXED-UNCOMMITTED | `z.config({jitless})` + Lighthouse A/B |
|
||
| N-12 | P1 | 门禁可信度 | 补测自身把 rAF 变只读致套件静默不跑 | FIXED-UNCOMMITTED | 隔离复跑 |
|
||
| N-17 | P2 | 测试诚实性 | security-headers 裸 `return` 伪装通过 | FIXED-UNCOMMITTED | 68 passed + 4 skipped |
|
||
| N-24②③④ | P2 | 门禁可信度 | 404 即就绪 / 不受支持的 next start / pr-checklist 空转 | FIXED-UNCOMMITTED | 双向对照 |
|
||
| N-27(部分)| P2 | 测试装配 | 零断言用例 / `expect()\|\|expect()` JS bug / 死选择器 | FIXED-UNCOMMITTED | 四 project 实测 |
|
||
| N-30(删兜底)| P1 | 内容零编造 | 两处凭空 `40%` 兜底已删(含反转被锁死的测试) | FIXED-UNCOMMITTED | 23→23 通过 |
|
||
| N-31 / N-33(部分)| P2 | 文档一致性 | 不可执行命令 / 假阈值 / 口径回填 | FIXED-UNCOMMITTED | 机械比对 |
|
||
| A-1..A-15, R-1..R-5, B-1/3/4/7 | P0-P2 | 安全/功能/规范/UI | 2026-09-21 阻断项 | FIXED-UNCOMMITTED | 周期 1 §2 |
|
||
| DEF-A1..A4, C-1, P-1/4/5, DEF-D1, L-1, L-5 | P1-P2 | 表现/领域层 | 后台编辑器数据损毁 / 案例页崩溃 / 滑动 / 进度条 / 前导符号 / 错误吞没 / 命名冲突 | FIXED-UNCOMMITTED | 周期 2 §1;C-1 见 §2.2 REG-C1 |
|
||
| Sentry 接线 | P1 | 可观测性 | 「声明未接线」→ 已接(含 Turbopack 约定文件) | FIXED-UNCOMMITTED | 周期 2 §1.3;§1 复核存在 |
|
||
| N-24① | P2 | 门禁可信度 | axe 逐页状态断言(期望集感知) | FIXED-UNCOMMITTED | 周期 2 §3.7 双向对照 |
|
||
|
||
### 2.2 待产品 / 设计决策(代码侧不该替业务作答)
|
||
| ID | 级别 | 事项 | 入口 |
|
||
|---|---|---|---|
|
||
| REG-C1 | P3(**已复核,非活跃缺陷**) | C-1 归一在 `cases/[slug]/client.tsx:22,30-35`(唯一 importer),位置**正确**:恰在未受信任的 CMS 强转 `item.data as unknown as CaseStudyData` 边界处 `?? ''`/`?? []` 一次归一,`case-detail-page.tsx` 消费已定型 props 可信任(无第二个真实调用方)。周期 2 报告把它记在组件文件属**归属笔误**,非漏洞;**不**在组件内加冗余守卫(违反"不为不可能发生的场景加校验") | 仅更正周期 2 §1.2 的 file:line 归属 |
|
||
| DEC-N21 | P2→潜伏 | `'content-item'` 幻影 modelCode:周期 2 §5.3 以源码推翻「越权」定性,实为 **fail-closed**;真风险是将来被补进种子即成跨模型读取闸口。建议「缺 modelCode ⇒ 400」 | `admin/items/route.ts:79` |
|
||
| DEC-N21b | ~~P2~~ **2026-09-30 撤销该定性(原为假事实)** | 原文称「`/admin` 无服务端 gating、HTML 外壳无会话也下发,入口=无 `middleware.ts`」——**不成立**:Next 16 已把该约定文件更名为 `src/proxy.ts`(在 HEAD 内、已跟踪,`2297f01` 迁入),`:77-105` 对 `matcher: ['/admin/:path*']` 做 Edge HS256 校验并在缺令牌/验签失败时重定向登录页 ⇒ 服务端 gating **存在**。**改登记两条真残留**:① 只验签名与 `exp`、**不查 `User.status`** ⇒ 停用令牌的持有者仍能拿到 `/admin` 外壳 HTML(数据面由 Q-4 的 `authenticateActiveRequest` fail-closed 兜住);② `src/proxy.ts` **零测试**(`git ls-files` 无任何 proxy 测试) | `src/proxy.ts:77-105` |
|
||
| DEC-N30 | P1 | 四条互斥 SLA(工作日 2h / <4h / 48h / <2h·7×24)留哪一条 | 周期 1 §8.2 / 周期 2 §5.2 |
|
||
| DEC-D5 | P1 | `/products/erp-upgrade` 在线数字(`99.2%`/`40%+`/`从5天到1天`)在**活组件** `erp-upgrade-content-v2.tsx:63,69,77`,无 basis 无 MetricsBasisNote,且该路由无视觉基线 | 周期 2 §5.1 |
|
||
| DEC-D7 | P2 | news 正文字段声明 `richtext` 而 `renderField` 无该分支(能力缺口) | 周期 2 §5.3 |
|
||
| DEC-P2-motion | P2 | 动效门禁 23 处判红(20 缓动曲线 + 2 裸时长 + `--transition-gentle:1000ms`):改代码 or 承认为设计例外 | 周期 2 §3.5 |
|
||
| DEC-L3 | P3 | `client-ip.ts` 头部信任无条件;直暴露(非 nginx)时限流可被 `X-Real-IP` 自报绕过(须与部署协同,勿单独改) | 周期 2 §5.3 |
|
||
| DEC-L4 | P3 | 对称加密密钥来自公开 bundle 的 `NEXT_PUBLIC_ENCRYPTION_SECRET` ⇒ 仅混淆无机密性,文档口径不得当安全控制引用 | `crypto.ts:36` |
|
||
| DEC-P-2 | P3 | 死码族删除(`loading-state` 是 brand-token 唯一白名单豁免 N-8;另有 hero-section-v2/insight-card/industry-grid/三份 product-card/breadcrumb/micro-interactions/PullToRefresh 等) | 周期 2 §5.3 |
|
||
| DEC-N4-N23 | P1 | 安全头门禁默认打**线上** `novalon.cn` 而非本分支产物(声明与行为相反);改法涉 CI/`test:all` 语义 | 周期 1 N-23 |
|
||
|
||
### 2.3 待授权动作(阻塞验收;须逐项明文批准)
|
||
| ID | 动作 | 命令 | 为何阻塞 |
|
||
|---|---|---|---|
|
||
| **AUTH-D1** | ~~入库 / PR(验收唯一硬阻断)~~ **已闭合(2026-09-28)** | 三笔提交 `a366bd1`/`6bb7c55`/`a0328a6` 已入 `qa/seal-2026-09-28` 并推到 origin;工作树现仅 2 条未跟踪(PR 描述文件、`deliverables/`) | 原「363 条只在工作树 ⇒ 不可复现」的前提消失。**分叉真相已查明(2026-09-30 复核)**:内容层面 `git diff --name-status f543e47 origin/dev` = **15 文件全为新增(A)、+2092/−0**,即 origin/dev 是本链 rebase 后版本 + 一条 `chore(infra)`;但拓扑层面 `f543e47` **仍不是** `origin/dev` 的祖先(`rev-list --left-right` = 30↔31,同标题异 hash 的 rebase 残留)。⇒ 上面「须逐笔裁定冲突」的配方对本轮不再适用:实际做法是从 `origin/dev` 新切分支 + cherry-pick 三笔,PR diff 只含本轮 QA |
|
||
| AUTH-D2 | 重跑 seed | `npm run db:seed` | **2026-09-30 用户已裁定本轮含「生产库重 seed」**(前置硬条件:先 `cp data/prod.db prod.db.bak-<ts>` 快照——现网**无任何 DB 备份机制**)。必要性已升级:本分支改过 `prisma/seed.ts` 与 `prisma/seeds/*`(`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` 三处消费)。本地 `dev.db` 同样仍旧权限行 |
|
||
| AUTH-D3 | 视觉基线写入 | `npx playwright test visual-regression.spec.ts --update-snapshots` | **2026-09-30 实测口径(只读比对:94 passed / 31 failed)**:31 = **20 缺参照**(4 subject × 5 project:`/products/erp-upgrade` 全页、`/about/brand` 全页、L2 `product-card`、L2 `input-default`)+ **11 张已过时参照**(`/products/erp` ×5、`/solutions/manufacturing` ×5 = Q-5/S-2 网格修复的预期版面收缩,真实浏览器实证 computed 3/4/12 列;chromium-mobile `button-default` ×1 = 基线早于 N-15(c) `:visible` 选择器修正)。**两处更正**:① 原记「85 张 modified 未提交、视觉通过依赖未提交状态」**已失效**——107 张基线全部在库(`git ls-files e2e/visual-snapshots`),工作树干净;② 原记「`cases/[slug]` 从无基线」不准——`/cases` 与 `/cases/[slug]` **根本不在 `VISUAL_TEST_PAGES`(`e2e/visual-regression.spec.ts:26-43`)内**,属覆盖缺口而非缺参照 |
|
||
| AUTH-D4 | 写库 E2E | 完整 `npm run test` / `test:e2e:prod`(差 `cms-workflow`+`user-journey` 共 11 例) | 真写 `prisma/dev.db`;只读边界已实证,此 11 例是唯一未执行的功能层 |
|
||
| AUTH-D9 | Sentry 实投递 | 真实 DSN 起服务验证事件与 source map 上传 | 接线惰性有码路证据已足,但投递未线上验证 |
|
||
| AUTH-D10 | 全量变异测试 | 去 `--inPlace`(config 默认沙箱)跑 `mutate` 全集 | 成本/磁盘(峰值 1.7G 曾致 ENOSPC,周期 2 §3.9);须 ≥2G 余量与无并发门禁窗口 |
|
||
| AUTH-D11 | 门禁证据落盘 | `check:axe` 默认 `OUT` 按日期分目录(同步 Jenkinsfile);`docs/acceptance/**` 是否纳入版本控制 | 现固定目录互相覆盖证据且未跟踪(周期 2 §3.9) |
|
||
|
||
### 2.4 已知不稳定清单(**禁止用 retry / 放宽阈值「修」**)
|
||
- `mobile-user-journeys` UJ-10(firefox,隔离复跑通过)、`website-acceptance:111` 响应式(隔离通过)、`@accessibility` webkit 四例(周期 1 N-32,隔离不复现)。同属**并发 / 墙钟**族(周期 1 N-28:同一代码三轮失败数 8→1→5)。墙钟型用例(`p4:31`、`p4:68`)不该进共享并发门禁。
|
||
- **2026-09-30 新增同族实例**:`[firefox] uj-09-product-browsing.spec.ts:124` 在生产目标 92 例满并发批次里判红(`toHaveURL(/\/products\/?$/)` 收到 `""`,15s 等「返回 /products」的导航没完成),而**同批次另三引擎全绿、隔离单跑 1 passed(11.5s)、该文件 4-project 并发复跑两次各 4 passed**。⇒ 定性为并发/墙钟族而非代码回归;本轮 E2E 诚实口径是 **91 passed / 1 failed**,不得写成「92 例全绿」。取证:`docs/acceptance/2026-09-30-seal/e2e-production-writefree.txt`。
|
||
|
||
## 3. 提交前强制提醒(承接 memory 纪律)
|
||
- 提交只加自己的路径,**勿 `git add -A`**:`prisma/dev.db-shm`/`-wal` 未被 `.gitignore` 覆盖(周期 1 §7),`git add -A` 会把 SQLite 边车与陈旧 `dev.db`/`data.db`(周期 2 §3.9)扫入。
|
||
- 破坏性 / 共享状态动作(fetch/rebase/commit/push/merge/seed/写库 E2E/写基线/force-push)须**单独明文授权**,不夹带在常规变更里。
|
||
- 会话结束前披露工作树状态(本台账 §0/§2.3 AUTH-D1 即披露)。
|
||
|
||
## 4. 第三轮审查轴(2026-09-25 本会话,subagent 并行 + 主线逐条复核)
|
||
|
||
两条并行 subagent:① 全部 `src/app/api/**` 路由处理器安全/正确性审计;② `src/lib/**`+`src/components/**` 逻辑缺陷狩猎。均要求 CONFIRMED 附 file:line + 触发条件,并给出已知项围栏以防重报。**主线未照抄任何一条子代理结论**:定点复核 → 对拟修复项做 RED→GREEN。
|
||
|
||
### 4.1 主线已复核确认 + 已修 + RED 测试(工作树内,未提交)
|
||
| ID | 级别 | 缺陷 | 触发/影响 | 修复 | RED→GREEN 凭据 |
|
||
|---|---|---|---|---|---|
|
||
| **Q-1** | **P1** | **登出未清除服务端 httpOnly cookie**:`auth-context.tsx` `logout()` 只清 localStorage;但 login 经 `setTokenCookie` 写 `novalon_token`(24h)/`novalon_refresh`(7d),而 `authenticateRequest`(`auth.ts:74`) 回退读 cookie。`/api/auth/logout` 路由**存在却从无调用者** ⇒ 点「登出」后全站受守卫 API 仍凭 cookie 放行至多 24h/7d | 后台「登出」是**假登出**;共享/被盗机器上会话延续 | `logout()` 先 `POST /api/auth/logout`(触发 `clearTokenCookie`),网络失败也清本地并跳转 | 新增 `auth-context.test.tsx`(2 例):断言 fetch 到 `/api/auth/logout`+POST 与网络失败仍清理;**改前 1 failed(fetch 0 calls)→ 改后 2 passed** |
|
||
| **Q-2** | **P2** | **缩略图格式伪标**:`image-processor.ts` thumbnail 声明 ext `'webp'`(`buildDerivative(..., 'webp', ...)`)但缓冲只 `.resize().toBuffer()` 未调 `.webp()` ⇒ PNG/JPEG 上传的 `-thumbnail.webp` 实为原格式字节,Content-Type 与内容不符、零 WebP 压缩收益 | 落盘文件内容 ≠ 扩展名/MIME;`source type` 消费方受影响 | 缩略图管道加 `.webp({quality:80})` | 既有测试只断路径/尺寸、**从不验格式**(覆盖空洞);新增例断 `sharp(thumb.buffer).metadata().format==='webp'`(PNG/JPEG 双输入);**改前 `Received:"png"` → 改后 media 4 套件/60 例全通过** |
|
||
| **Q-3** | **P2** | **登录端点无限流**:`contact` 有 IP 限流但 `POST /api/auth/login` 无任何节流 ⇒ 匿名者可无限驱动 cost-10 bcrypt(CPU DoS)+ 离线式撞库 | 凭据填充 / CPU 耗尽 | 抽出可复用 `src/lib/rate-limit.ts`(时钟可注入 + `reset()`,**放进覆盖率棘轮内**),登录按 IP `max:10/15min` 且**判定在 bcrypt 之前**;contact 重构复用同一实现(消除副本) | 新增 `rate-limit.test.ts` 4 例(边界/独立 key/窗口过期/reset)+ 扩展 `login/route.test.ts` 一例:前 10 次 200、第 11 次 429 且 `verifyPassword` **仍只 10 次**(证限流省掉 bcrypt);**4/4 + 全 login/contact/auth 73 例通过**,`type-check` EXIT=0,改动文件 `eslint --quiet` 0 error |
|
||
| **Q-4** | **P2** | **停用账号令牌在 6 个内联 role handler 仍全权(N-20 同类,绕开已收口的 `checkUserPermission`)**:`admin/users` GET/POST/PUT/DELETE 与 `admin/roles` GET/PUT 用 `authenticateRequest`(仅验签名,不看 `User.status`)+ 内联 `userRole` 检查。⇒ 被停用但持 ≤24h 有效令牌的 super_admin 仍能列/建/改/删用户、重写权限矩阵 | 停用/离职管理员的残留令牌保留完整后台写权 | 抽出可复用 `authenticateActiveRequest(request)`(`permissions.ts`,`prisma.user.count({id,status:1})` 判活),**6 个 handler 全部改用它**并在角色检查/任何写入前 fail-closed | 在 `users/route.test.ts` 与 `roles/route.test.ts` 各加 2 例(停用超管 → 401 且 `user.create`/`user.update`/`$transaction`/`permission.*` 均未触达);既有 30+ 例在默认存活下保持通过 ⇒ **admin users/roles/permissions 3 套件/54 例全绿**,`type-check` EXIT=0,5 改动文件 `eslint --quiet` 0 error |
|
||
| **Q-5** | **P2** | **响应式网格被 `StaggerReveal` 单子吞成单列**:`content/sections.tsx` 的 `TechStackShowcase`/`DataProofSection` 把 `grid md:grid-cols-N` 挂在外层 div,而该 div 的唯一子元素是 `StaggerReveal`(渲染一个 motion.div,再为每卡片包 motion.div)⇒ 网格只有 1 个网格项,卡片在 md/lg 断点堆成单列、`gap`/`space-y` 失效;`FAQSection` 的 `space-y-3` 同理被吞。**这些组件是活的**(`product-detail-content-v3.tsx:335,343,357` 渲染产品详情页)。正确写法见 `l3-signals-slot.tsx:109-119`(网格类挂 StaggerReveal,其注释即记此坑) | 产品详情页技术栈/数据佐证/FAQ 桌面端单列,UX 退化 | 把网格/间距类移到 `StaggerReveal className`,删除多余外层 grid div(FAQ 仅移 `space-y-3`,保留 col-span 外层) | 在 `sections.test.tsx` 加 3 例,断言 `[class*="grid-cols-3"]`/`grid-cols-4`/`space-y-3` 元素的**直接子元素数 == 条目数**(旧结构下恒为 1 ⇒ RED);sections.test **28 例全通过**,`type-check` EXIT=0,`eslint --quiet` 0 error |
|
||
| **Q-7** | **P3** | **列表路由分页参数未校验(NaN→500 + 无界 take)**:`admin/items` GET 用 `parseInt(searchParams.get('page') \|\| '1')` ⇒ `?page=abc`→NaN→`skip:NaN`→真库 Prisma 抛错→500(应安全回落);`?pageSize=99999`→无界 `take`(任何 read 权限者可整表拉取大 `data` JSON)。`admin/users` GET 有 `Math.max/min` 夹取但 `Math.max(1,NaN)` 仍是 NaN ⇒ 同类未愈 | 500 崩溃 + 无界读取 | 抽出可复用 `src/lib/pagination.ts` `parsePagination(sp,{defaultPageSize,maxPageSize})`(NaN/0/负数→默认,超上限→夹取,取整),**items + users 两路都接入**(max 100) | `pagination.test.ts` 6 例(缺省/合法/非数字回退/夹取/取整,含"移除即崩"的核心 NaN 面)+ `items/route.test.ts` 1 例(`?page=abc&pageSize=99999` ⇒ 200 且 `findMany({skip:0,take:100})`,旧码为 `skip:NaN/take:NaN` ⇒ RED)。**pagination 6 + items 38 + users 18 全通过**,`type-check` EXIT=0,改动文件 `eslint --quiet` 0 error |
|
||
| **Q-8** | **P3** | **内容 ID 存在性枚举 oracle**:`admin/items` PUT/DELETE 与 `admin/items/[id]/workflow` POST 都先 `contentItem.findUnique`→`notFound('内容不存在')` **再** `requirePermission` ⇒ 匿名调用者可用「404=该 ID 存在 vs 401/403=权限屏障」枚举有效内容 ID(无写入先于鉴权,纯信息泄露面) | 未鉴权可枚举内容 ID | 三个 handler 均在存在性探针**之前**加 `if (!authenticateRequest(request)) return unauthorized();`(先认证→再 404→再 per-model 权限),关闭匿名枚举;记残留:已登录但无该模型权限者仍能分辨 404/403(把 notFound 与 forbidden 合流需改契约,未做) | `items` 2 例 + `workflow` 1 例:匿名 PUT/DELETE/workflow ⇒ **401 且 `findUnique` 未被调用**(证探针在认证门之后);两测试文件补 `jest.mock('@/lib/auth')` 默认有效会话使既有授权用例不受影响 ⇒ **items+workflow+pagination 3 套件/47 例全通过**,`type-check` EXIT=0,5 改动文件 `eslint --quiet` 0 error |
|
||
| **Q-10a** | **P3** | **`ui/button.tsx` 涟漪 id 用 `Date.now()`**:同毫秒两次点击 ⇒ 重复 React key + 清理 `filter(r=>r.id!==id)` 会一次删掉同 id 的多条涟漪;且 600ms `setTimeout` 卸载时从不清除(setState-after-unmount / 定时器泄漏)。Button 是全站在用组件 | 真实浏览器下重复 key 告警 + 卸载后定时器泄漏 | 涟漪 id 改自增 `useRef` 计数器(保证唯一);定时器收入 `useRef` 数组,`useEffect` 卸载时 `clearTimeout` 全部 | **诚实标注**:真正判别性(重复 key)在本环境不可测——做过 RED 探针(还原 `Date.now()` 后断言仍绿),因 Jest 跑 production React 构建、dev key 告警被剥离,React 18 也不再就 setState-after-unmount 告警。故只补**被改代码路径**的行为用例(点击→涟漪出现→600ms→清除,能捕获"永不清除/不出现"类回归),不谎称它是缺陷锁。**button 21 例通过**,`type-check` EXIT=0,`eslint --quiet` 0 error |
|
||
| **Q-10c** | **P3(隐私/同意 fail-open)** | **`analytics.ts` `getStoredPreferences` 把 `JSON.parse(...) as CookiePreferences` 原样透传,无字段校验**:而 `updateConsentDetailed` 用 `preferences.analytics ? 'granted':'denied'` 判定 ⇒ 被篡改/写坏的 `localStorage`(如 `{"analytics":"yes","marketing":1}`,或数组/数字等非对象)会以真值非布尔**意外授予** analytics/ad 同意 | 同意管理可被污染存储绕过(GDPR/隐私面) | 新增 `sanitizePreferences(raw)`:四个开关严格 `=== true` 才算同意(否则 false),`necessary` 恒真,`timestamp` 仅数字保留;`getStoredPreferences` 走它 | 2 例真判别(未修即 RED:旧码原样返回 `'yes'/1`,断言 `false` 必红):truthy 非布尔→false、非对象载荷→全 false 且 necessary 恒真;既有有效对象用例(`{necessary:true,analytics:false,marketing:true,functionality:true}`)经 `toEqual` 仍通过 ⇒ **analytics 31 例全通过**,`type-check` EXIT=0,`eslint --quiet` 0 error |
|
||
| **Q-10b** | **P3** | **`api-crypto.ts` 用客户端 `content-length` 判定是否有请求体**:`hasBody = contentLength && parseInt(contentLength) > 0`。加密的 POST/PUT/PATCH 若走**分块传输**(无 `content-length` 头,或该头被省略/伪造为 0)⇒ 被判「无 body」跳过解密,密文 `{data:"..."}` 原样交给 handler(`isEncrypted:true` 但体未解),handler `.json()` 拿到信封而非真实字段 | 加密通道在分块/缺头时静默不解密(功能正确性/健壮性) | 改按 **HTTP 方法**判体存在:`method ∈ {POST,PUT,PATCH}` 即尝试读体+解密(空体自然落回原路径),不再信 content-length | 新 1 例真判别(RED 探针实测:还原 content-length 版 ⇒ 该例判红;恢复 ⇒ 通过):加密 POST **无 content-length** ⇒ 断言 `mockDecrypt` 被调用且 handler 收到解密体;既有 26 例(全部 method+content-length 配对)不受影响 ⇒ **api-crypto 27 例通过**,`type-check` EXIT=0,`eslint --quiet` 0 error |
|
||
| **Q-9** | **P3** | **`admin/media` 多文件上传无原子性**:上传循环内 ① 某文件超 10MB 直接 `return validationError`,但**前面文件已 `uploadMedia` 落盘+入库**;② 某文件在 `uploadMedia` 内被 magic-byte/类型策略拒(抛 `UploadPolicyError`,外层 catch 返 400)同样留下前面已写入的文件 ⇒ 请求返回错误却已产生孤儿媒体资产(磁盘 + `MediaAsset` 行),无返回、无清理路径 | 半途失败留下孤儿资产(磁盘/DB 泄漏 + 计费/存储面) | 把尺寸校验提到**任何写入之前**(整批预检);上传循环包 try,失败时对本请求已成功的 `results` 逐个 `deleteMedia` 回滚再返回错误 | 新 2 例真判别(旧码必 RED):① 第二个文件抛 `UploadPolicyError` ⇒ 断言 `mockDeleteMedia('asset-1')` 被调用(旧码无回滚 ⇒ 不调用);② 批次含一个超限文件 ⇒ 断言 `mockUploadMedia` 从未被调用(预检在任何写入前拒整批)。既有单/多文件成功用例仍通过 ⇒ **media route 14 例通过**,`type-check` EXIT=0,`eslint --quiet` 0 error |
|
||
|
||
### 4.2 子代理上报、**主线尚未逐一复核**(登记为待验证,不当作已确认,不据此宣称已修)
|
||
| ID | 级别 | 摘要 | 位置(子代理所引) | 主线状态 |
|
||
|---|---|---|---|---|
|
||
| Q-4 | ~~P2 待复核~~ | ~~6 个内联 role 数组的 handler~~ | — | **已复核确认为真缺陷并已修**(见 §4.1 Q-4):status 维度缺位属实,role 授予逻辑本身仍正确 |
|
||
| Q-5 | ~~P2 待复核~~ | ~~外层 grid/space 被 StaggerReveal 单子吞成单列~~ | `content/sections.tsx` | **已复核确认为真缺陷并已修**(见 §4.1 Q-5):3 处组件为活代码(产品详情页),已把网格类挂回 StaggerReveal 并加 3 例结构断言 |
|
||
| Q-10 | P3 | 四条子代理上报:① `api-crypto.ts` `hasBody` 信任客户端 `content-length`;② `workflow.ts:84` `updateMany`+`auditLog.create` 非 `$transaction`;③ `analytics.ts:33` 同意偏好无字段校验;④ `button.tsx` ripple `Date.now()` 键碰撞 + 卸载不清 timeout | 各处 | **④=Q-10a、③=Q-10c、①=Q-10b 均已修**(见 §4.1,各带判别测试)。**仅 ② 未做**:修法需 interactive `$transaction(async tx=>…)`(update→读回→审计有数据依赖),会牵动 workflow 路由测试的 prisma mock 边界,风险高于其 P3 权重,暂缓并附精确配方 |
|
||
| Q-6 | P2 | `detail-product-value.tsx:73-91` render 体内 `setDisplayValue + requestAnimationFrame`(StrictMode/重渲染派生多串未取消动画) | 组件 `detail-product-value.tsx` | **待复核**:grep 显示该组件仅被 `products/erp-upgrade-v3/page.tsx` 引用,而周期 2 判定 `erp-upgrade-v3` 为**死路由** ⇒ 若确死则非在线缺陷,仅登记;render 副作用面仍宜在组件复用时修 |
|
||
| Q-7 | ~~P3 待复核~~ | ~~`admin/items`/`users` GET 分页未校验~~ | — | **已复核确认为真缺陷并已修**(见 §4.1 Q-7):新增 `parsePagination` 复用件,items + users 两路接入,6+1 例覆盖 |
|
||
| Q-8 | ~~P3 待复核~~ | ~~内容 ID 存在性 oracle~~ | — | **已复核确认为真缺陷并已修**(见 §4.1 Q-8):三 handler 认证前置于存在性探针,3 例证 `findUnique` 不被匿名触达 |
|
||
| Q-9 | ~~P3 待复核~~ | ~~多文件上传中途失败留孤儿~~ | — | **已复核确认为真缺陷并已修**(见 §4.1 Q-9):整批尺寸预检 + 失败回滚已成功文件,2 例真判别 |
|
||
|
||
### 4.3 主线**证伪**的子代理结论(不修,防把假发现写进代码/文档)
|
||
- **Q-FP-1**:子代理称 `detail-product-value.tsx:69` `parseFloat(value.replace(/[^0-9.]/g,''))` 把 `"1,000+"` 变成 `1`(千倍低估)。**不成立**——`[^0-9.]` 会删掉逗号、保留数字与点,`"1,000+"`→`"1000."`→`parseFloat=1000`,正确。故该解析点**不是缺陷**(其 render-副作用面另见 Q-6,属不同问题,仍待复核)。
|
||
|
||
> **本轮验证层级诚实说明**:`type-check` 为**全程序** `tsc --noEmit` 且 EXIT=0(覆盖 Q-1/2/3 全部改动);受影响单元套件(auth/login/contact/media/rate-limit)**73 例全通过**;改动文件 `eslint --quiet` **0 error**。但**全量 `test:coverage`(1725 例)本轮未重跑**,且 Q-1(表现层登出)与 Q-3(登录 API 行为)**不在**任何已跑过的 E2E 子集里 ⇒ 其生产目标凭据待 AUTH-D1 入库 + AUTH-D4 后统一复跑。Q-2(media 派生)真 `sharp` 单测覆盖格式,最直接。**Q-4 的凭据层级**:6 个 handler 的存活判定由 `admin/users`+`admin/roles` 路由级 jest(mock prisma.user.count)端到端覆盖(默认存活 30+ 例仍绿 + 停用 4 例判 401/零写入),属**单测层**,非 E2E;其"移除 helper ⇒ 停用令牌被放行"的 RED 逻辑由"旧码走 `authenticateRequest` 不看 status、新 mock 的 `count` 遂成死参数、断言 401 必红"反证。**验收判定不变**:新增修复同样只在主工作树,AUTH-D1 仍是唯一硬阻断。
|
||
|
||
### 4.4 本会话全量回归证据(2026-09-25,覆盖 Q-1…Q-5/Q-7/Q-8 全部改动之后)
|
||
| 门禁 | 命令 | 结果 |
|
||
|---|---|---|
|
||
| 全量单元 | `npm run test:unit` | **142 套件 / 1760 例全通过,0 失败**(较周期 2 的 137/1725 净增 5 套件 35 例,全为本会话新增 RED 测试;无一处回归) |
|
||
| 覆盖率棘轮 | `npm run test:coverage` | **EXIT=0,阈值全达标**:global **85.96 stmts / 87.57 branch / 81.38 funcs / 85.96 lines**(门限 75/82/75/75 **未下调**);本会话新增 `src/lib/pagination.ts`、`src/lib/rate-limit.ts` 各 **100/100/100/100**(在 `collectCoverageFrom` 的 `src/lib/**` 内,随棘轮受约束) |
|
||
| 真库集成层 | `npm run test:integration:real` | **EXIT=0,4 套件 / 23 例全通过**;一次性 `/tmp/novalon-itest.db`,teardown 守卫实测 `prisma/dev.db`、`dev.db`、`data.db` 的 inode+size+mtime 与运行前完全一致 ⇒ 本会话对 `permissions.ts`(新增 `authenticateActiveRequest`)与 users/roles/items/workflow 鉴权路由的改动在真库鉴权层无回归,且未污染开发库 |
|
||
| 静态 a11y(对比度/令牌) | `npm run check:contrast` + `check:brand-token` | 两者 **EXIT=0**:contrast 44/44 令牌配对满足 WCAG 2.1 AA;brand-token 扫描 406 文件 **0 违规**(1 处已知白名单降级 = `loading-state.tsx` 死组件,见 N-8/D-8)⇒ 本会话改动无对比度/品牌令牌回归 |
|
||
| 生产构建 + 装配 | `npm run build`(含 postbuild 拷贝) | **EXIT=0**,`dist/standalone/{server.js,dist/static,public}` 三项齐备(`ASSEMBLY_OK`)⇒ 本会话对 `api-crypto`/`permissions`/users·roles·items·workflow·media 路由的服务端改动可干净构建(N-9 前提成立);产物 `heading-hierarchy-report.json` 等落盘物均被 `.gitignore` 覆盖,不脏提交面 |
|
||
| 标题层级(产物上) | `npm run check:headings`(自起 standalone 扫 10 页) | **EXIT=0**:10 页全通过、0 问题 ⇒ 与 contrast/brand-token 合起来 **完整 `check:a11y` 三件套在本会话构建产物上全绿**(不再仅沿用周期 1/2 结论) |
|
||
| Lighthouse(产物上) | `npm run lighthouse`(lhci autorun 自起 standalone) | **EXIT=0**:对 9 URL × 3 次运行 = 27 次跑的全部断言通过(含本会话前几轮新加的 `inspector-issues` minScore 断言)⇒ 性能/a11y/BP/SEO 门禁在当前源码产物上仍达标 |
|
||
|
||
| 类型检查 | `npm run type-check`(全程序 tsc) | **EXIT=0** |
|
||
| Lint | `npm run lint` | **0 error / 104 warning**(与周期 2 口径 104 完全一致 ⇒ 本会话新文件 `rate-limit.ts`/`pagination.ts` 等**零新增债**) |
|
||
|
||
> 说明:**本会话已在含全部 Q 修复 + S-1 修复的最终树上重跑并 EXIT=0**:`test:unit`(1758)、`test:coverage`(阈值棘轮)、`test:integration:real`(23)、`check:contrast`/`check:brand-token`/`check:headings`(完整 check:a11y)、`npm run build`+装配、`npm run lighthouse`;`type-check`/`lint` 全程 EXIT=0。**仍未在本会话重跑**:全站 `check:axe`(需自起 standalone + crawl-routes 清单,端口/残留进程需专管)、生产目标 E2E(**注意 `npm run test:e2e:prod` 不排除写库 spec,跑它即触发 AUTH-D4**)、视觉只读比对(Q-5/S 系列改了布局,需 AUTH-D3 重基线)。周期 1/2 的这三项结论仍登记于各自报告。
|
||
|
||
## 5. 第四轮审查轴(2026-09-25,2 路并行 subagent:`src/app/**` 页面 + 余下 `src/components/**`)
|
||
|
||
两条只读 subagent 分别扫前几轮**只 grep 未逐行**读过的面。主线**未照抄任何一条**:S-1 我逐行核实并修复;其余登记为「待主线复核」,其中标注与前序已知项同机制的(Q-5/C-1 新点位)优先,因为修法现成。
|
||
|
||
### 5.1 主线已核实 + 已修(工作树内,未提交)
|
||
| ID | 级别 | 缺陷 | 触发/影响 | 修复 | 凭据 |
|
||
|---|---|---|---|---|---|
|
||
| **S-1** | **P2** | **首页 CMS 数组未逐条守卫 ⇒ 整页 RSC 崩溃**:`home-content-v15.tsx` 的 `ServicesSection` 只在 `:510` 校验 `services[0].subtitle`,随后 `:546` `service.highlights.map`(**无 `?.`/`Array.isArray`**,而 `:552` metrics 却有 `&&` 守卫);`CasesSection` 的 spotlight `:789` 用 `?.` 但 `restCases` `:828` `caseItem.metrics.slice` **未守卫** | 发布任一缺 `highlights`/`metrics` 的服务或案例 ⇒ 流量最高的首页 500 到 error.tsx | 两处改 `Array.isArray(x) ? x : []` 逐条守卫(与既有 `?.` 惯例一致) | `type-check` EXIT=0、`eslint --quiet` 0 error(改动文件);纯渲染守卫,行为对合法数据不变 |
|
||
|
||
### 5.2 子代理上报、待主线逐一复核(**不当作已确认/已修**)
|
||
| ID | 级别 | 位置 | 摘要 | 复核优先级/备注 |
|
||
|---|---|---|---|---|
|
||
| S-2 | P2 | `products/product-detail-content-v3.tsx:178,231` + `solutions/solution-detail-content-v3.tsx:121,168,223,278` | grid/`space-y` 挂在外层 div、唯一子为裸 `StaggerReveal` ⇒ `/products/[id]`、`/solutions/[id]` 桌面端塌成单列(**Q-5 同机制的新点位**) | **已复核+已修(6 处)**:同文件 :132 已是正确写法可佐证。安全修法——把网格/间距类移到 `StaggerReveal className`、外层 `<div>` 留作无类包裹(**不删闭合标签**,规避 Q-5 那次改动风险)。content-v3 三套件 25 例通过 + `type-check` EXIT=0 + `eslint --quiet` 0 error。需 AUTH-D3 视觉重基线确认像素 |
|
||
| S-6 | ~~P3 误报~~ | `cases/[slug]/page.tsx:27-34` | ~~`generateMetadata` 绕过 C-1 归一~~ | **主线核实为误报,未改**:`generateMetadata` 已用 `data.challenge?.substring` / `data.metrics?.map`,对**缺键**的保护与 `client.tsx` 的 `?? []` 同级,并非"绕过 C-1"。唯一残余是**类型错误值**(如 metrics 存成字符串),但那对 client 路径同样会崩,属通用运行时类型校验缺失(非元数据专属崩溃),不在本轮改 |
|
||
| S-3 | P2 | `about/page.tsx`、`contact/page.tsx`、`products/erp-upgrade/page.tsx` | 无 `export const revalidate`,且 `/api/cms/revalidate` 未映射这些模型 ⇒ 构建后发布新内容永不刷新(并含「`revalidateTag` 因 `data-server.ts:37` 用 React `cache()` 而非 `unstable_cache` 实为 no-op」的重断言) | 高但**涉渲染配置/缓存语义**,须逐条核 next 行为再定改否(可能引 ISR/构建变化) |
|
||
| S-4 | P2 | `home-content-v15.tsx:32-43`(用于 :510-516) | `FALLBACK_SERVICES` 兜底含 `40%`/`6个月` 等**无 basis 的数字**,N-30 类第三处残留,违背零编造 | 中:修法=删兜底 metrics(与 N-30 一致);属内容口径,宜确认后改 |
|
||
| S-5 | ~~P2 待复核~~ | `detail/detail-hero.tsx:171-184` + `micro-interactions.tsx:148-153` | `<a href><PressableButton/></a>`,而 PressableButton 渲 `<motion.button>` ⇒ button 嵌进 a(无效交互嵌套) | **已复核+已修**:根因在 `PressableButton` 的 href 分支本就产 `<a><button>`。改为有 href 时渲单个 `motion.a`(承载按钮样式),`detail-hero` 去掉外层 `<a>` 直接传 `href`;`onClick`/样式保留,导航语义不变。新增 `micro-interactions.test.tsx` 2 例真判别(旧码 `querySelector('button')` 非 null ⇒ RED;且发现 `detail.test.tsx` mock 掉了 PressableButton,故测真组件须单列)|
|
||
| S-7 | P3 | `services/[id]`/`solutions/[id]`/`products/[id]`/`news/[slug]` 的 page | `dynamic='force-dynamic'` 与 `generateStaticParams`/revalidate 冲突 ⇒ SSG 产物永不服务,注释与单测给假信心 | 中:涉渲染模式口径,须核 next16 行为再定 |
|
||
| S-8 | ~~P3 待复核~~ | `hero-particle-field.tsx:287-290` | `onVisibility` 未判相交态即 `start()` ⇒ 离屏 canvas rAF 空转 | **已复核+已修**:加 `intersecting` 跟踪(IO 回调置位),`onVisibility` 改为「可见且 `intersecting`」才启动,与 :271 契约对齐。凭现有 hero-particle-field 三套件/36 例(含 reduced-motion 降级、unmount 停环)无回归 + `type-check`/lint 绿;**未加专测**(jsdom 下 visibilitychange+IO 离屏组合难做判别性 RED,诚实标注)。首页活组件(home-content-v15) |
|
||
| S-9 | ~~P3 待复核~~ | `back-to-top.tsx:12-20`;`detail-trust-section.tsx:18-65` AnimatedCounter | 挂载未初始同步;裸 rAF 计数不查 `useReducedMotion` | **两处均已修**:back-to-top effect 内补 `handleScroll()` 初始同步;AnimatedCounter 在 `shouldReduceMotion` 时直接落终值不跑 rAF(`useReducedMotion` 自绘,因 `MotionConfig` 不管裸 rAF)。back-to-top by-construction(jsdom `scrollY` 只读难判别,未加专测,诚实标注);AnimatedCounter 由 detail.test 27 例 + 全量 `test:unit` 142/1760 + `type-check`/lint 绿佐证无回归 |
|
||
| S-10 | P3 | `admin/content/[modelCode]/page.tsx:210` 状态误标(review→「已归档」);`admin/roles/page.tsx:59-79` effect 依赖 `selectedRole` 覆未保存编辑;`admin/users/page.tsx:85` 搜索无防抖/序号守卫(`content/[modelCode]` 已修,此处未);`admin/media/page.tsx:38,131` 单 `fileInputRef` 挂两个 input ⇒ 顶部按钮重选同文件不触发 onChange;`admin/page.tsx:108`/`media/page.tsx:40` 吞错显示「空」非报错;`admin/login/page.tsx` label 无 htmlFor、密码切换钮无 aria-label | 后台多处 P3(错标/竞态/吞错/a11y 标签) | 中:逐条小修,部分与既有模式(防抖/seq)现成可搬 |
|
||
|
||
> 诚实边界:S-2…S-10 为 subagent 上报,**我尚未逐行独立复核**,不作「已确认/已修」主张;S-1 是我本轮亲自核实并修复的唯一项。子代理另排除了 `cta-section`(零 importer,其「30 分钟内响应」是 DEC-N30 的第 5 条 SLA 变体,仅附记)、Radix 包装件、`slider`(零消费者)等——同样待我复核后再采信。
|
||
|
||
## 6. 会话收尾与续工交接(2026-09-25,subagent 架构系统性 QA)
|
||
|
||
> 本文件(`qa-tracker.md`)即 objective 阶段3 要求的「问题跟踪机制」单一真源;§4 为第三轮(API+lib/组件)、§5 为第四轮(src/app 页面 + 余下组件)审查轴。
|
||
|
||
### 6.1 本会话已完成(均在工作树,**未提交**)
|
||
- **已核实并修复的缺陷(含判别性测试):Q-1、Q-2、Q-3、Q-4、Q-5、Q-7、Q-8、Q-9、Q-10a、Q-10b、Q-10c、S-1、S-2(6 点位)、S-5**;**S-8、S-9** 经检查修复(诚实标注:jsdom 无法做判别性 RED,仅 by-construction + 现有套件/类型门禁)。
|
||
- **主线证伪、未改的子代理断言**:`1,000+→1` 解析(实为 1000,正确)、C-1 归属笔误、S-6(metadata 已 `?.` 守卫,非绕过 C-1)。
|
||
- 自纠:一次 Edit 误删既有测试体(已复原);一次写了不能失败的假测试(已换成诚实版);一次 §4.4 表格被打断+留陈旧说明(已合并修正)。
|
||
|
||
### 6.2 本会话门禁证据(最终树,全部 EXIT=0,见 §4.4 表)
|
||
`test:unit` **142 套件/1760 例** · `test:coverage`(阈值未下调,新 lib 100%)· `test:integration:real`(23,`dev.db` 指纹未变)· 完整 `check:a11y`(contrast 44/44 · headings 10/10 · brand-token 0 违规)· `npm run build`+standalone 装配 · `npm run lighthouse`(9 URL×3)· `type-check` · `lint` 0 error/104 warning。
|
||
|
||
### 6.3 工作树披露(最高优先,勿静默留给下一个人)〔本节数字为 2026-09-25/28 当时实况,**已被 §8 封版记录取代**〕
|
||
`git status --porcelain` = **378 条**(54 未跟踪),HEAD 仍 `f543e47`。⇒ 两轮 + 本会话全部修复**只在工作树**,未提交/未 PR ⇒ 不可审、不可复现、不可 CI 验证。**这是 objective 阶段5「可交付」未达成的唯一实质原因。**
|
||
> **2026-09-28 第五轮后刷新**:`git status --porcelain` = **394 条**(55 未跟踪),HEAD 仍 `f543e47`。本轮净增 16 条改动/新文件(含新测试文件 `src/app/__tests__/cms-page-revalidate.test.ts`)。结论不变。
|
||
|
||
### 6.4 续工:待授权动作(逐项明文批准后才动;见 §2.3 / 周期报告 §5)
|
||
1. **AUTH-D1 入库/PR**(解锁验收):先 `git fetch origin dev` 取真值 → 裁定 `origin/dev`↔HEAD 双向分叉的重复提交对 → 按「表现层/后台编辑器/Sentry/测试装配/文档口径 + 本会话 Q/S」分笔提交 → 过 `scripts/check-pr-checklist.sh` → Gitea PR。**`git add` 按路径,禁 `-A`**:`.gitignore` 未挡 `prisma/dev.db-shm`/`-wal`,`-A` 会带入 SQLite 边车。
|
||
2. **AUTH-D4 写库 E2E**(11 例,真写 `dev.db`;⚠ `npm run test:e2e:prod` 不排除写库 spec,跑它即写库)。
|
||
3. **AUTH-D3 视觉基线**:Q-5/S-2/S-5 改了布局,产品/方案/案例详情页需人工核看后 `--update-snapshots`。
|
||
4. **AUTH-D2 seed**:使周期2 L-2 权限修复对数据生效。
|
||
|
||
### 6.5 续工:待复核/待决策的登记项(不阻断验收)
|
||
S-3(about/contact/erp-upgrade 无 revalidate + revalidateTag no-op,涉渲染配置)、S-7(force-dynamic vs generateStaticParams)、S-4(FALLBACK_SERVICES 无 basis 数字,宜按 N-30 删)、S-10(后台状态误标/搜索竞态/媒体双 input ref 冲突/登录表单 label 关联)、S-9 子项(detail-trust 裸 rAF 未查 reduced-motion)、以及周期1/2 遗留的 D-1…D-11 / DEC-* 决策项。
|
||
|
||
## 7. 第五轮审查轴(2026-09-27…28 会话,4 路并行 subagent + 主线逐条复核/修复)
|
||
|
||
承接 §6.5 的续工清单:S-3/S-4/S-7/S-10/Q-6/Q-10② + 未逐行覆盖的余下面(hooks、lib/cms 渲染器、seo/analytics 组件、marketing 残余页面)。主线未照抄任何子代理结论:逐条亲读源码复核后再修,修复均带判别性测试(RED→GREEN 实测)。
|
||
|
||
### 7.1 主线已复核并修复(工作树内,未提交)
|
||
| ID | 级别 | 缺陷(主线核实后口径) | 修复 | RED→GREEN 凭据 |
|
||
|---|---|---|---|---|
|
||
| **S-21**(=DEC-D7 落地) | **P2** | `renderField` 无 `richtext` 分支 ⇒ news 正文/legal 正文落 default 单行 `input[type=text]`,浏览器 value 消毒剥掉全部 `\n`,编辑一次即**静默损毁段落**(详情页 whitespace-pre-line 渲染) | richtext 走 `textarea`(rows=12);顺带收敛出作用域读写机制 | 新增 3 例读写保真测试;改前 `Expected TEXTAREA, Received INPUT` 判红 → 改后编辑器套件 **22/22** |
|
||
| **S-22** | P3 | array/object 子字段编辑器读写**顶层** `formData[field.name]`:编辑写不进数组,却把 `label/value` 垃圾顶层键混进保存载荷(假成功) | array 改整体 JSON 编辑(复用 JsonEditor);object 子字段以 `scope{parent,write}` 读写父对象并合并回写 | 同上:改前 `getByLabelText('指标')` 无 TEXTAREA / `作者` 值为空 判红;改后载荷断言 `metrics` 回写数组、无泄漏顶层键 |
|
||
| **Q-10②** | **P2** | `workflow.ts` 状态更新→读回→审计三条独立写:审计失败时**状态已落库但无审计**,调用方收 500 误以为流转未发生 | 交互式 `prisma.$transaction(async tx …)` 包住 CAS→读回→审计;通知保持在事务外(不回滚不上抛的既有语义不变) | 测试 mock 增加带快照回滚的 `$transaction` 桩(数组形态直接判红防退化);升级既有「审计失败 fatal」例为回滚断言:改前 storedItem 停在 published 判红 → 改后 28/28;**真库集成层 `test:integration:real` 23/23 EXIT=0(dev.db 指纹守卫通过)** |
|
||
| **S-3** | **P2** | `/about`、`/contact`、`/products/erp-upgrade` 无 `revalidate` 导出且 revalidate 路由无映射 ⇒ 构建后发布的 CMS 内容**永不刷新**(子代理实证:三页在 `prerender-manifest` 为 `static + initialRevalidateSeconds:false`)。附带断言 `revalidateTag` 全程 no-op **成立**(全站无 `unstable_cache`/`'use cache'`/fetch tags 消费点,React `cache()` 仅请求内去重) | 三页加 `export const revalidate = 3600`(与其余 14 页同档)+ 路由补 about-page/contact-page/product→`/products/erp-upgrade` 三条映射(推送即秒级失效,3600 为无推送兜底) | 新增 6 例(3 route 映射 + 3 页 revalidate 导出,新文件 `src/app/__tests__/cms-page-revalidate.test.ts`):改前 6 例全判红 → 改后 25/25;**产物级实证**:重建后 `dist/prerender-manifest.json` 三页 `initialRevalidateSeconds=3600` |
|
||
| **S-10 六条** | P3×6 | ①列表状态列把 review/archived 误标「已归档」②roles 的 `fetchRoles` 依赖 `selectedRole`,切角色 refetch 覆盖未保存编辑 ③users 搜索逐键打后端且无 seq 守卫(乱序响应覆盖新结果)④media 双 input 同挂一个 ref(重选同文件不触发 onChange)⑤admin 首页/media/zones 吞错显「空」(假绿)⑥login/zones/users 弹窗 label 无 htmlFor、密码显隐钮无可访问名 | ①四态 STATUS_LABELS 映射 ②`fetchRoles` 依赖清零 + `setSelectedRole(prev=>prev||…)` ③搬 SEARCH_DEBOUNCE_MS+fetchSeqRef 现成模式 ④全页单 input + 程序化 click ⑤error state + 横幅 ⑥补 id/htmlFor + `aria-label` 随状态切换(实施走 general-purpose subagent,主线逐 diff 复核 + `selectedRoleInfo` 等符号存在性核实) | 改动 8 文件 eslint --quiet 0 error;`content/[modelCode]/page.test.tsx`(防抖+乱序 2 例)通过;全量回归见 §7.4 |
|
||
| S-11/S-12/S-13/S-15 | P3 | zones 吞错显空 / notifications 翻页无 seq 守卫 / roles 矩阵 super_admin 全显「未授权」与「拥有所有权限」文案矛盾 / zones·users label 关联(S-10 同族扩散) | 与 S-10 一并修(error 横幅、fetchSeqRef、super_admin 整行按已授权呈现、htmlFor) | 同上 |
|
||
| **S-23** | P3 | `ui/animated-counter.tsx` `displayValue = start ? count : value`:未入视口直显**终值**,IO 异步首回调后跳回 0 再爬升(先给答案再数) | `displayValue = shouldReduceMotion ? value : count`(useCountUp 未启用期本就停在起点 0) | 新 1 例(IO 桩驱动):改前判红(旧码未相交即显 500)→ 改后 6/6;既有用例改 `startOnView={false}` 语义不变 |
|
||
| **S-24** | P3 | `PerformanceTracker` CLS 累加器在 observer 回调**内**:分批到达的 layout-shift 每批只报增量,GA 收到的永不是会话总 CLS | 累加器提到回调外,每批上报累计值 | 新 1 例双批次断言 [≈100, ≈150](旧码第二批报 50 ⇒ RED 由形状显然)→ 改后 17/17 |
|
||
| **Q-6** | P3 | `detail-product-value.tsx` MetricCard render 体内 setState+rAF:探针实证**每帧 setState 触发重渲染又 spawn 一条从 0 开始的动画链且从不 cancel**,假时钟下大字永远停在 '0';卸载后帧链继续排队 | 动画收入 `useEffect`,cleanup `cancelAnimationFrame`;NaN 回退同 effect | 新 1 例(faithful rAF 桩:cancel 真撤销排队):改前判红(旧实现卸载后 sched 继续增长)→ 改后 28/28。**注**:第一版测试命中 benefits 同名文本属假绿,已被探针推翻重写(诚实记录) |
|
||
|
||
### 7.2 主线复核后的定性变更(不改代码,只改台账口径)
|
||
| ID | 原登记 | 复核结论 |
|
||
|---|---|---|
|
||
| Q-6 路由定性 | 「`erp-upgrade-v3` 死路由 ⇒ 若非活码仅登记」 | **定性修正**:不是死路由,是**零入口孤儿路由**(不在 sitemap、src 内零内部链接,但静态可直达且有真实渲染)。缺陷本身属实已修(见 §7.1),影响面限直达 URL |
|
||
| S-4 | 「FALLBACK_SERVICES 无 basis 数字,N-30 类残留,宜删」 | **降为 DECISION(DEC-S4)**:子代理实证 fallback 与 CMS 数据走同一渲染 map,`:562` 对每张卡(含 fallback)渲染 `<MetricsBasisNote basis={weakestBasis(…)}>`,未声明 basis 一律保守落 `target` 角注 ⇒ **并非裸奔编造**,与 N-30(虚构佐证)不同类。残余问题:硬编码数字本身无出处 + fallback 触发条件(CMS service 缺失/首条无 subtitle)。是否删数字属内容口径,留业务裁定 |
|
||
| S-7 | 「force-dynamic + generateStaticParams 冲突 ⇒ SSG 产物永不服务」 | **CONFIRMED 但判为设计取舍**(子代理引 bundled docs `caching-without-cache-components.md:97` + `prerender-manifest` 实证四路由不在产物中;页内注释表明有意为之:硬 404 + 新内容首请求可见)。不自动改渲染模式,登记为 DECISION(承 DEC-N21b 同级) |
|
||
| S-14 | clipboard 无 catch | 随 S-10 批修(`.catch` + toast.error),SUSPECTED 定级不变 |
|
||
|
||
### 7.3 子代理上报、主线**证伪或不修**(防假发现入库)
|
||
- MetricCard `parseFloat('1,000+')→1` 类解析问题在本组件不成立(`[^0-9.]/` 保留数字与点),与 §4.3 Q-FP-1 同族。
|
||
- hooks 面(use-focus-trap/use-swipe-gesture/use-reduced-motion/useCountUp)、analytics 其余 tracker、structured-data、lib/cms 其余模块:子代理逐文件扫描后**无新缺陷上报**(含监听清理、capture 分工、XSS sink 检查均通过)。
|
||
- 死码新增:`CookieSettingsButton`(零 importer,连带「重开偏好面板不与已存同意同步」的潜在缺陷一并挂账)、`getInitialShowConsent` 三分支恒 false(死但无害)。
|
||
|
||
### 7.4 本轮收尾门禁(2026-09-28 最终树)
|
||
| 门禁 | 结果 |
|
||
|---|---|
|
||
| type-check | EXIT=0(一次 tsc 报错为 Q-6 测试 mock 类型断言丢失 `.mock`,已修后复跑绿) |
|
||
| lint | 0 error / **104 warning**(2026-09-30 在 sealed 树 `a0328a6` 复测仍为 104;本表 §4.4 记 104、此处曾记 105,且 `AGENTS.md` §5 亦记 105 并给出「分项相加=105」的自洽说明 ⇒ **现值以 104 为准**,105 口径已过期。本轮零新增债) |
|
||
| test:coverage | EXIT=0,**143 套件 / 1772 例全通过**(较 §6.2 净增 1 套件 12 例,全为本轮判别测试) |
|
||
| test:integration:real | EXIT=0,4 套件 / 23 例,dev.db/data.db inode+size+mtime 守卫通过(workflow `$transaction` 改动在真 SQLite 无回归) |
|
||
| check:contrast / brand-token / headings | 44/44 · 0 违规 · 10/10 页,均 EXIT=0 |
|
||
| build + standalone 装配 | EXIT=0,ASSEMBLY_OK;`prerender-manifest` 实证三页 ISR=3600(S-3 产物级) |
|
||
| lighthouse | EXIT=0,9 URL × 3 次 = 27 run 全部断言通过(lhci autorun 自起 standalone :3200) |
|
||
|
||
## 8. 封版记录(2026-09-30,现行判定)
|
||
|
||
**判定:封版通过(含例外清单)。** 代码封版点 = `a0328a6`;完整判定书、逐条判红定性与例外登记见 **`docs/acceptance/2026-09-30-seal/final-verdict.md`**,原始门禁输出同目录(`axe/`、`e2e-production-writefree.txt`、`visual-readonly.txt`、`security-headers-artifact.txt`、`check-motion.txt`、`lint.txt`、`type-check.txt`、`grid-structure-report.json`、`visual-check/*.png`)。
|
||
|
||
本轮在 sealed 树上补齐的 6 项(前几轮从未跑过):
|
||
|
||
| 门禁 | 退出码 | 结果 |
|
||
|---|---|---|
|
||
| `build:clean` + `postbuild` 装配 | 0 | `dist` 377M(清理前 2.5G,含 `dist/dev` 2.1G 开发缓存);standalone 三件套齐备 |
|
||
| 全站 `check:axe` | **0** | `PASSED=true`,34 路由 × (chromium,firefox) × (light,dark)=136 页,`violationNodes/contrastNodes/bgMismatch` 全 0;唯一 non-2xx = `/_not-found`(设计如此) |
|
||
| 产物安全头(`--url http://localhost:3100/`) | **0** | 7 PASS / 1 WARN(HSTS 边缘注入) / 0 FAIL,**每头单次** ⇒ 线上重复头确系 nginx+Next 两层叠加 |
|
||
| 生产目标 E2E(排除两个写库 spec) | **1** | **91 passed / 1 failed**;唯一红为 firefox UJ-09 并发墙钟(§2.4),`dev.db` 指纹跑前后一致 ⇒ 未写库 |
|
||
| 视觉只读比对(`--update-snapshots=none`) | **1** | **94 passed / 31 failed** = 20 缺参照 + 11 已过时参照(全部可归因,见 §2.3 AUTH-D3);未写任何基线 |
|
||
| `check:motion` | **1** | 23 处(20 曲线 + 2 裸时长 + 1 上限),与周期 2 同数未新增;属 DEC-P2-motion 待裁定 |
|
||
| `npm run lint` / `npm run type-check` | 0 / 0 | 0 error / **104 warning**(105 口径作废);tsc 0 error |
|
||
|
||
**封版不变式(为何不重跑全套)**:本轮唯一新提交是纯文档提交 S,`git diff --name-only a0328a6..S` 全部落在 `docs/**` 与 `*.md` 内 ⇒ `a0328a6` 上的绿灯对 S 恒等成立。S 的 sha 与清单见 `final-verdict.md` §6。
|
||
|
||
**本轮同步更正的台账假事实**(均为「文档写了但当场复核不成立」,已就地标注):§0 判定与 `:3-4` 的 HEAD/工作树状态、§2.2 **DEC-N21b**(`/admin` 其实有服务端 gating,入口是 `src/proxy.ts` 而非 `middleware.ts`;真残留=不查 `User.status` + 零测试)、§2.3 **AUTH-D1**(已闭合)、**AUTH-D3**(107 张基线全在库、缺参照实为 20 张、`/cases` 属覆盖缺口)、**AUTH-D2**(本轮含生产重 seed 及其权限依据)、§7.4 lint 104。
|
||
|
||
**发布侧未闭环(不属验收判定,见判定书 §5)**:`deploy:rollback` 不回滚容器/`public/`;`deploy.sh status` 不报磁盘;`rsync --delete public/` 与 `./uploads` 卷的关系部署前必须核实;nginx 安全头去重须单独投递。
|
||
|
||
---
|
||
|
||
## §8 2026-10-08 · agentic 工具化轮次(作者侧 AI),提交 `1b5c75a`(本地未推)
|
||
|
||
本轮性质:**新增 e2e spec + 文档**,零生产源码改动 ⇒ 按 §7「封版不变式」只作废受影响的门禁行(`test:functional`、视觉只读、type-check、lint),不重跑全套。
|
||
|
||
### §8.1 选型与落地
|
||
|
||
| 项 | 判定 | 证据 |
|
||
|---|---|---|
|
||
| 采用 Playwright Test Agents(planner/generator/healer)作**作者侧** AI | ✅ 已落地 | 随本仓实装 `playwright@1.60.0` 自带 `init-agents`;agent 定义源 `node_modules/playwright/lib/agents/*.agent.md`;`.mcp.json` 指向仓内 `run-test-mcp-server`,**未新增依赖、未装 `@playwright/mcp`**;Playwright 自身不调 LLM ⇒ 运行期零模型 |
|
||
| 引入 `tester-army/e2e`(agentic 框架,Apache-2.0,7.5k★,`e2e@0.18.0`) | ❌ 本轮不引入 | 第二套 runner + `playwright-core 1.63.0`(与实装 1.60 并存两套浏览器二进制);无像素基线比对;官方文档明确不模拟 touch / color-scheme / reduced-motion ⇒ 接管不了 107 张参照、5 个 visual project 的 `reducedMotion:'reduce'`+`scale:'device'` 体系与 axe light\|dark;PR 报告器为 GitHub 形状而本仓是自建 Gitea。判据全表见 `docs/testing/agentic-test-authoring.md` |
|
||
| 候选淘汰 | 记录 | `@antiwork/shortest` npm 冻结 0.4.9/2025-04-01;`magnitude-test` 0.3.13/2026-02-08 停更;Stagehand v4 缓存仅 Browserbase 云端(本地每次推理);Skyvern AGPL-3.0 且 npm 无 `skyvern` 包;商业侧(QA Wolf/Virtuoso/Mabl/Momentic/Autonoma/bug0)云端执行或 GitHub-only,无 Gitea |
|
||
|
||
### §8.2 本轮新增用例(`e2e/nav-keyboard.spec.ts`,tag `@a11y`,4 例)
|
||
|
||
补的是真实空白:主导航 mega dropdown 此前只有 hover 路径(`nav-dropdown.spec.ts:8,28`),jsdom 单测 `mega-dropdown.test.tsx:55-74` 用 `fireEvent` 测过 Escape,但 `relatedTarget` 与真实焦点顺序在 jsdom 不成立。契约逐行取 `src/components/layout/mega-dropdown.tsx:35-46,62-76,94-178`。
|
||
|
||
| 读数 | 值 |
|
||
|---|---|
|
||
| dev 目标四 project | **10 passed / 6 skipped**,EXIT=0 |
|
||
| `E2E_TARGET=production`(三桌面 project) | **10 passed / 2 skipped**,EXIT=0 |
|
||
| 稳定性(`--workers=1 --repeat-each=3`,firefox+chromium) | **24 passed / 0 failed** |
|
||
| 是否进快速集 | 否:`test:e2e:fast` grep `@smoke\|@critical`,本 spec 为 `@a11y` ⇒ `test:all` 时长不变 |
|
||
| type-check / lint(提交后树复跑) | EXIT=0 / EXIT=0,本文件 0 告警;全仓 **104 warning**(沿用 §7 口径) |
|
||
|
||
**两条测到并定性的引擎/目标差异(都不是本仓缺陷,未用守卫压红)**:① WebKit 本机不响应真实 Tab——连续 4 次后 `activeElement` 仍是 `BODY`,而 `.focus()` 有效且 `matches(':focus')=true`,与 §N-27 同源(macOS WebKit 未开全键盘访问)⇒ 仅依赖 Tab 遍历的 2 例按 `browserName==='webkit'` 跳过(含 `chromium-mobile`);② dev 目标下触发器 DOM 节点在 hydration 后被**整体替换**(失败样本 `click=1` 而 `aria-expanded` 恒 false,通过样本 `click=0` 而 `aria=true` ⇒ 监听绑在已被换掉的旧节点上),生产产物不复现 ⇒ `openWithKeyboard()` 用 `toPass()` 重发**交互**(对齐 `primary-nav.ts:11-14` 既有写法)。移动断点另记:桌面 mega dropdown 在 390px 下整体不渲染(`element(s) not found`),抽屉导航的键盘契约须另立 spec。
|
||
|
||
### §8.3 视觉只读比对(本轮当前树复跑)
|
||
|
||
`npx playwright test visual-regression.spec.ts --update-snapshots=none`(dev 目标,125 例,5.1 分钟):
|
||
|
||
- **94 passed / 31 failed,EXIT=1** ⇒ 与 §7(2026-09-30 实测 94/31)**逐项同数**,本轮提交对视觉**零外溢**。
|
||
- 分层读数(剥 ANSI 后现取):**20 例缺参照**(`A snapshot doesn't exist`:`/products/erp-upgrade`、`/about/brand`、L2 卡片、L2 输入框 × 5 project)+ **11 例参照已过时**(`toHaveScreenshot(expected) failed`:`/products/erp` ×5、`/solutions/manufacturing` ×5 = Q-5/S-2 网格修复的预期版面收缩,样例差异 2,578,230 px / ratio 0.22;chromium-mobile 按钮 ×1 = 基线早于 N-15(c) `:visible` 修正)。
|
||
- **只读性已验**:`git status --porcelain e2e/visual-snapshots` = 0 修改、0 新增未跟踪 PNG(显式带 `--update-snapshots=none`,否则默认 `missing` 模式会静默新建 20 张参照)。
|
||
- dev 侧仍见 `eval() is not supported... CSP` + `React will never use eval() in production mode` 成对刷屏,即 N-11 在 dev 的形态;产物目标与 Lighthouse 口径不受影响(9/9 全 100),不列为阻塞。
|
||
|
||
### §8.4 台账假事实更正(本轮)
|
||
|
||
- `AGENTS.md:159` 的「磁盘上 85 张基线 PNG 相对 HEAD modified / 视觉通过依赖未提交状态」就地加日期更正——现取 `git ls-files e2e/visual-snapshots` = **107 张全部已入库、工作树干净**(同 §5.32)。**注**:`AGENTS.md` 被 `.gitignore:316` 排除,更正只作用于本机,不入提交;已入库记录在 `docs/lessons-learned.md:505`。
|
||
- 作废一条我自己写错的待办:`@playwright/test ^1.58.2` 与实装 `1.60.0` **并非矛盾**(caret 允许),先前记为「过期数字」不成立。
|
||
- 既存错位登记不改:`@playwright/test` 声明在 `dependencies` 而非 `devDependencies`,移动会影响构建依赖面,须作为独立动作。
|
||
|
||
### §8.5 待授权清单(本轮一律未执行)
|
||
|
||
| # | 动作 | 状态 | 判据 |
|
||
|---|---|---|---|
|
||
| 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) | ~~不可执行~~ **判据作废**(2026-10-08 17:53 复核) | 原文「本环境**无 Gitea token**」是**假事实**:探测只 grep 了环境变量与 `~/.config/gitea`,漏了 `credential.helper=osxkeychain`(keychain 里确有 `git.f.novalon.cn` 条目,`GET /api/v1/user` 现取 200)。PR 实际已于 §10.7 建成 **#29**。教训入 `docs/lessons-learned.md` §5.35 |
|
||
| 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 数据行或日期派生内容)」。参照系用错了——旧参照的**采集树**是 `040951c`(2026-09-22),最后被改动是 `6bb7c55`(09-28 10:48),而当前树含 `a366bd1`(09-28 10:48:07 第五轮)与 `a0328a6`。实测归因:`src/components/detail/detail-product-value.tsx` 的 Q-6 修复把指标 count-up 动画从 **render 体内**(每帧 `setState` 再 spawn 一条从 0 起的 rAF 链、从不取消)迁入 `useEffect` 并加取消 ⇒ 旧参照拍到的是**动画竞态中间帧**,新参照是稳定终态,位移属预期改进。现场取证法:`docs/acceptance/2026-10-08-baselines/row-diff.cjs`(sharp 逐行比对)现取首个发散行 y=7440,正落在 `/products/erp` 的 `benefits` 价值列表段。
|
||
**管理归零(写进检查口径)**:「本轮相对上一轮零源码改动」只支撑**门禁绿灯平移**,**不支撑**「参照与当前树同源」;判红归因必须对「基线采集树 vs 当前树」做 diff。历轮把 11 例笼统记为「网格修复的预期收缩」正是漏了这个参照系,才让 mobile 那 2 例看起来「无因」。
|
||
**改判后仍留的一条风险**:Q-6 族若还有其他 render 体内动画,基线仍可能冻结中间帧;125/0 只证明**当前树自洽可复现**,不证明「参照 = 用户所见」。
|
||
|
||
### 9.5 更新后的待授权清单(下一轮从这里接)
|
||
|
||
| # | 动作 | 状态 | 判据 |
|
||
|---|---|---|---|
|
||
| B | 建 PR / 合并 `main` | ~~人工可解,脚本不可解~~ **脚本亦可解**(2026-10-08 17:53 作废本行判据) | 「本环境无 Gitea token」的探测是**假阴性**:我当时跑的 `git config --get-regexp -i ...` 因 `-i` 不是合法开关而**报错**,却被 `2>/dev/null` 吞掉 ⇒ 把「命令失败」读成「查无此项」。凭据其实在 `credential.helper=osxkeychain`(由 `/Applications/Xcode.app/.../git-core/gitconfig` 的**系统级**配置提供),`GET /api/v1/user` 现取 200 ⇒ PR 已建成 **#29**(§10.7)。教训入 `docs/lessons-learned.md` §5.35。**PR 描述文件现状**:`.pr-seal-2026-10-08.md`(过门禁 EXIT=0)已作为 #29 的 body;`.pr-seal-2026-09-30.md` 叙述停在 seal 轮,不再用于建 PR |
|
||
| C | `npm run deploy` | 仍不建议 | 理由 ①(视觉 EXIT=1)已消除;② 需先完成 B、③ `deploy:rollback` 不回滚容器/`public/` 两条仍成立 |
|
||
| F | 推送本轮基线与文档 | **已执行(2026-10-08,用户「采纳建议」)** | 两次快进推送、无 force:`a0328a6..1396666`(4 笔)与 `1396666..6c9900f`(5 笔,含 `6ff19d1` 的 **17MB 新增参照二进制**,已知情);现取 `git rev-list --count origin/qa/seal-2026-09-28..HEAD` = **0** |
|
||
| G | 移动档 +30/+21px 归因 | **已完成(本轮内,且推翻了自己的初判)** | 用 `row-diff.cjs` 定位发散行 y=7440 → `/products/erp` 的 `benefits` 段;根因是 `a366bd1` 的 Q-6 count-up 动画修复(旧参照冻结了动画中间帧)。取证法与教训见 9.4 |
|
||
| — | AUTH-D2(重 seed)/ D4(写库 E2E 11 例)/ D9(Sentry 投递)/ D10(全量变异)/ D11(证据目录口径) | 状态不变 | 见 §2.3 |
|
||
|
||
### 9.6 文档同步与本树一手复测(收尾轮末笔)
|
||
|
||
**一手复测**(此前只在 PR 描述里沿用他轮读数,不符合「门禁命令实际执行过」条):`npm run type-check` **EXIT=0**;`npm run lint` **EXIT=0 / 0 error / 104 warning**。日志 `/tmp/tc-1008.txt`、`/tmp/lint-1008.txt`(临时件,不入库)。
|
||
|
||
**四处文档同步**(视觉层转绿后原叙述即成假事实):
|
||
|
||
| 文件 | 更正 |
|
||
|---|---|
|
||
| `docs/development/quality-gates.md` §6.2 | **文档与代码矛盾**:原文写「`--update-snapshots` 不带值时 Playwright 取 `missing`」——实为 **`changed`**(`program.js:202` 的 `preset`),`missing` 是**完全不带旗标**时的缺省(`common/index.js:584`)。已改写两种触发条件的差异,并把读数更新为「封版树 94/31(历史)→ 2026-10-08 基线闭合后 125/0」,附「例数 ≠ 张数」与「归因须对采集树 vs 当前树」两条口径 |
|
||
| `docs/testing.md` 视觉节 | 参照计数 107 → **132**(5 project 各 **26** + `manual-acceptance/` 2);原「用例数 − 参照数 = 覆盖空洞」的算式已不成立,改为**三个 shot 归组来源**(按钮一例三张、输入框一例两张、L3 两例零张);N-15 覆盖空洞标注为已闭合并写明现在的语义锚点 |
|
||
| `README.md` 进度区 | 撤下「视觉回归在封版树上实测 94/31」的现行口径(改为历史 + 125/0 现况);例外清单里的「视觉基线」移出待授权项;新增 2026-10-08 轮次条目(agentic 选型 + `nav-keyboard` + AUTH-D3 闭合 + §5.33 教训);台账指针 §8 → **§9** |
|
||
| `AGENTS.md`(**被 `.gitignore:316` 排除,仅本机**) | 视觉回归行的 21 失败/104 通过/94-31 系列读数标注作废并指向 §9;lint 行补 2026-10-08 一手复测 104;`-u` 模式描述同 `quality-gates.md` 更正 |
|
||
|
||
**PR 描述**:新建 `.pr-seal-2026-10-08.md`(覆盖 `a0328a6..HEAD` 全链,含 §8/§9 两轮),`bash scripts/check-pr-checklist.sh .pr-seal-2026-10-08.md` ⇒ **EXIT=0 通过**。按用户裁定与 `.pr-seal-2026-09-*.md` 同列**保持未跟踪**,需要时直接粘进 Gitea 表单;上一份 `.pr-seal-2026-09-30.md` 的叙述已停在 seal 轮,**不得再用于建 PR**。
|
||
|
||
---
|
||
|
||
## §10 2026-10-08 · 生产发布(用户指令「提交变更并发布到生产」)
|
||
|
||
### 10.1 发布内容与序列
|
||
|
||
| 步 | 动作 | 读数 / 凭据 |
|
||
|---|---|---|
|
||
| 1 | `npm run build` | **BUILD_EXIT=0**,产物 BUILD_ID `uiV6QrbCH7jmurgLVp-nd`(树 `19079e1`,代码封版点仍是 `a0328a6`);`postbuild` 已装配 standalone 三件套(`dist/standalone/{server.js,dist/static,public}`) |
|
||
| 2 | 预生产演练(**部署前**) | 从服务器取 `prod.db` 副本(413,696 B)→ `PORT=3111 DATABASE_URL=file:/tmp/prod-copy.db node dist/standalone/server.js` → 14 条真实路由**全 200**(`/`、`/products/{,erp,erp-upgrade}`、`/solutions/{,manufacturing}`、`/about{,/brand}`、`/contact`、`/news`、`/cases`、`/services`、`/methodology`、`/admin/login`) |
|
||
| 3 | 生产库快照 | `data/prod.db.bak.20261008_173048`(AUTH-D2 的硬前置;此前仅有 `bak.20260820_093111`) |
|
||
| 4 | 远端 dist 快照 | 脚本自动产出 `dist_backup_20261008_173111` |
|
||
| 5 | `./scripts/deploy.sh deploy --skip-build` | **DEPLOY_EXIT=0**;步骤 3/5/6/6.5 全绿,容器重建后 `curl 127.0.0.1:3000` 就绪,`verify_remote` 五页 200 |
|
||
|
||
上传前把 `dist/dev`(606M) 与 `dist/cache`(193M) 清掉,实际上传 205M(服务器出网带宽仅 ≈1Mbps,见 `docs/deployment.md` §6.5)。
|
||
|
||
### 10.2 本次部署引入的线上回归(已恢复,≈4 分钟)
|
||
|
||
**症状**:部署后首页 HTML 200,但其引用的 `/_next/static/chunks/*.js|*.css`、`/favicon.ico` **全 404**(nginx 应答,`try_files $uri =404`)⇒ 真实用户看到的是无 CSS、无 JS 的破站。
|
||
|
||
**根因**:远端 nginx 的站点根 = 上传后的 `dist/`,要求磁盘上存在 `dist/_next/static/**`;而 `next build` 出的是 `dist/static/**`,`postbuild` 只补容器形态。**这份「web root 镜像」历史上由旧发布流程产出**(`dist_backup_20260905_113209/` 顶层确有 `_next/static` 与合并的 `fonts/ images/ *.svg`),本次 `rsync --delete` 把它抹掉了。`nginx access.log` 现取 **2026-10-07**(部署前)同一 URL 为 200 ⇒ 确证是本次部署引入,非既有状态。
|
||
|
||
**恢复**:在服务端补做镜像(`mkdir -p dist/_next && cp -R dist/static dist/_next/static && cp -R public/. dist/`,**纯新增、零删除**)+ `chown www-data` / `chmod 755`。恢复后:首页与 `/products/erp` 引用的 **19+ 件资源全 200**;`/images/logo-white.svg` 仍 404 属正确行为(该路径在 `public/` 里不存在,是我构造的探测 URL)。
|
||
|
||
**门禁盲区(管理归零)**:`verify_remote` 只 curl 五个 HTML 路径,所以它在破站状态下打印了「✅ 生产环境验证通过 / 🎉 部署成功」。**HTML 200 ≠ 站点可用**。
|
||
|
||
### 10.3 已落地的两处修复(`scripts/deploy.sh`,同笔提交)
|
||
|
||
1. **步骤 1.5**:上传前本地生成 web root 镜像(`dist/static → dist/_next/static`、`public/. → dist/`),并在 `dist/static` 缺失时**终止部署**而非静默继续。
|
||
2. **`verify_remote` 资源级断言**:部署后从首页 HTML **实际引用的 URL** 取前 5 个 `/_next/static/*.{js,css}` + `/favicon.ico`,逐个断言 200,任一非 200 即 `return 1`。**负对照已实测**:把取样 URL 换成不存在者 ⇒ `RED 404` 且 `failed=1`,证明该断言可失败。`bash -n` 通过,`deploy --dry-run` 复跑 ⇒ 六项取样全 200。
|
||
|
||
### 10.4 线上健康证据(Playwright 无头,`chromium`)
|
||
|
||
| URL | stylesheets | h1 / 字号 | 品牌红 | 4xx·5xx GET | console error |
|
||
|---|---|---|---|---|---|
|
||
| `/` | 2 | 「让每一家企业都拥有数据驱动的决策能力」/ 81px `geistSans` | 命中 | **0** | **0** |
|
||
| `/products/erp` | 2 | 「睿新ERP管理系统」/ 81px | 命中 | **0** | **0** |
|
||
| `/contact` | 2 | 「随时欢迎聊一聊」/ 108px | 命中 | **0** | **0** |
|
||
|
||
`TOTAL_FAILED_GETS=0`。安全头单次下发已核(`server: nginx` + CSP/HSTS/XP 等一组,无重复头报错);线上 nginx 的 `X-Frame-Options: SAMEORIGIN` 与仓内 `next.config.mjs` 的 `DENY` 叠加问题仍在(判定书 §5 已登记,修复须单独投递 nginx conf)。
|
||
|
||
### 10.5 发布后仍未闭合(须单独授权)
|
||
|
||
| # | 项 | 现状与依据 |
|
||
|---|---|---|
|
||
| AUTH-D2 | ~~生产 `db:seed` 未执行~~ **已执行(2026-10-08 17:47,用户「授权你完成」)** ⇒ 过程与事后核验见 **§10.6** | 原判据(保留作依据链):`prod.db` 里 `Permission.modelCode` 是旧码 `team`/`legal`(各 11 条),而 `ContentModel.code` 已是 `team-page`/`legal-page`/`contact-page`/`navigation`/`methodology`/`page-copy`/`site-config`(16 个模型)⇒ `src/lib/permissions.ts:26` 精确匹配下非 `super_admin` 四角色无授予。结果:**+63 条授予、删除 0**,覆盖 `contact-page,content-model,content-zone,legal-page,methodology,page-copy,team-page`。实际机制是第四条候选(esbuild 打包 + 停容器 + 用生产镜像跑),非原列 ①②③ |
|
||
| H | ~~compose 配置漂移~~ **已消除(2026-10-08 17:49)** ⇒ 见 §10.6 | 先 `diff` 证明服务器与仓内**只差那一行挂载**才动手;备份 `docker-compose.server.yml.bak.20261008_174943`;重建后 `docker inspect` 现取 `./uploads -> /app/public/uploads`。**未做**:真实上传一次验证持久化(需后台凭据) |
|
||
| I | ~~`cmd_rollback` 不重建容器~~ **已修(`722f08a`)** | `cmd_rollback` 在恢复 `dist/` + 重载 nginx 后追加 `docker-compose build && up -d` 与就绪轮询,并复用已升级为资源级的 `verify_remote`;`bash -n` 通过 |
|
||
| J | ~~无 PR 记录~~ **PR #29 已建(→ `dev`,`mergeable: true`)** ⇒ 见 §10.7 | 「本环境无 Gitea token」是**假事实**:`osxkeychain` 里有凭据,API `GET /user` 现取 200。`origin/main` 落后 46 笔,dev→main 须另开 PR(`Jenkinsfile:407-429` 在 `main` 上有自动部署阶段,不可由本 PR 顺带触发) |
|
||
| K | ~~新登记:seed 覆盖缺口~~ **撤销(2026-10-08 18:0x 复核,是我造的假事实)** | `navigation` 与 `site-config` **不是漏发**,而是刻意设计:`prisma/seed.ts:241-242` 原文写明「属站点级配置,刻意仅 super_admin 可维护(`hasPermission` 的 super_admin 全权短路,`src/lib/permissions.ts:24`),不进上表」,并由 `src/lib/seed-permissions.test.ts:18-19` 的 `SUPER_ADMIN_ONLY_MODELS = ['site-config','navigation']` 与 `:50` 的用例「每个真实内容模型都被授予非超管角色(**除刻意 super_admin 独有的站点配置**)」双向钉住。⇒ seed 跑完后这两个模型对非超管无授予是**预期状态**,无需改动。**我违反的是本仓 `docs/lessons-learned.md` §5.32 自己立过的规则**(「某能力缺失」的断言落笔前须给:现行约定、按能力检索、正向证据三条)——只看了矩阵里没有就下结论,没读矩阵上方的注释与同名门禁测试 |
|
||
|
||
### 10.6 发布后三项闭环(用户「授权你完成」,2026-10-08 17:47…17:52)
|
||
|
||
**AUTH-D2 生产 `db:seed` —— 已执行**。做法不是登记录制的三条候选,而是第四条:**用 esbuild 把真 seed 打成单文件,在停容器窗口内用同一生产镜像跑**(避开「服务器无源码、容器无 `tsx`、宿主 node 20 无 `node:sqlite`」三重限制,也不整库换文件)。
|
||
|
||
| 步 | 动作 | 凭据 |
|
||
|---|---|---|
|
||
| 1 | 打包 | `npx esbuild prisma/seed.ts --bundle --platform=node --format=esm --banner:js=createRequire` → 705 KB(cjs 格式会因 `import.meta` 报错,ESM 需补 `createRequire` 才能 `require('fs')`) |
|
||
| 2 | **先在生产库副本上演练** | `DATABASE_URL=file:/tmp/prod-seed-rehearsal.db` ⇒ REAL_EXIT=0,`🎉 数据库初始化完成` |
|
||
| 3 | 逐表差异(决定要不要动生产) | `Permission 132→195(+63,**删除 0**)`、`ContentItem 37→38`(新增 `methodology/default`)、**24 条条目 title/data 随 seed 源更新**、`User/Role/UserRole/ContentModel/ContentZone/MediaAsset/AuditLog/Notification` 行数全不变 |
|
||
| 4 | 风险量化后才动手 | `prisma.user.upsert` 的 `update:{}` ⇒ 口令不覆盖(事后逐字节比对三个账号 `password` 与 `createdAt` **全部 identical**);`contentItem.deleteMany` 仅在 `CASE_STUDIES.length===0` 时删 `case-study`,而生产该模型 **0 条** ⇒ 删除命中 0;prod.db 自 **Aug 20 12:03** 无写入 ⇒ 24 条 data 更新覆盖的是种子自身旧值,不存在人工编辑被抹 |
|
||
| 5 | 生产执行 | 快照 `data/prod.db.bak.20261008_174734-preseed` → `docker stop` → `docker run --rm --env-file .env.production -e DATABASE_URL=file:/app/data/prod.db -e PRISMA_QUERY_ENGINE_LIBRARY=... -v data:/app/data -v seed.bundle.mjs:/seed.mjs:ro --entrypoint node novalon-website:latest /seed.mjs` → `🎉 数据库初始化完成` → `docker start` |
|
||
| 6 | 事后核验 | 取回 `prod.db` 比对:**+63 / −0**,新授予恰好覆盖 `contact-page,content-model,content-zone,legal-page,methodology,page-copy,team-page`;容器 `health=healthy`;Playwright 三页 `4xx/5xx GET=0`、`console errors=0` |
|
||
| 7 | 清理 | 服务端 `seed.bundle.mjs` 已 `rm`(一次性工件,不留在生产目录) |
|
||
|
||
**当时记为「残留缺口 K」、随后被自己推翻**:`navigation` 与 `site-config` 在 seed 跑完后仍无授予,我判成「seed 覆盖缺口」。**该判断是错的**——`prisma/seed.ts:241-242` 的注释与 `src/lib/seed-permissions.test.ts:18-19,50` 的 `SUPER_ADMIN_ONLY_MODELS` 门禁证明这是**刻意的站点级配置独占**(仅 `super_admin` 可维护)。K 已在 §10.5 就地撤销,教训归属 `docs/lessons-learned.md` §5.32(本仓早已立过「按缺推断机制不存在」的规则,本轮我自己重犯)。
|
||
|
||
**H compose 挂载漂移 —— 已消除**。先 `diff` 确认服务器与仓内版本**只差那一行挂载**(不整文件覆盖未知定制),备份 `docker-compose.server.yml.bak.20261008_174943` 后同步,`docker-compose up -d` 重建。现取 `docker inspect` Mounts = `./uploads -> /app/public/uploads` ✓(旧值 `/app/uploads`)。**未做**:真实上传一次以证明落盘持久(需后台凭据,留作人工验证)。
|
||
|
||
**I `cmd_rollback` 不重建容器 —— 已修**(`scripts/deploy.sh`):回滚在恢复 `dist/` + 重载 nginx 之后,追加 `docker-compose build && up -d` 并轮询 `127.0.0.1:3000` 就绪,失败即 `exit 1`;随后走**已升级为资源级**的 `verify_remote`。`bash -n` 通过。
|
||
|
||
**J PR —— 见 §10.7**。**C 之外的 `deploy` 未再触发**:本轮所有生产变更均由 `deploy.sh` + 上述受控步骤完成,未跑 CI。
|
||
|
||
### 10.7 J PR —— 已创建 **#29**(`qa/seal-2026-09-28` → `dev`)
|
||
|
||
凭据来源:本机 `credential.helper=osxkeychain` 存有 `git.f.novalon.cn` 条目,`GET /api/v1/user` 现取 **HTTP 200**(login `zhangxiang`)⇒ 先前「本环境无 Gitea token、PR 不可执行」的判断**是错的**,已就地更正(密钥全程未回显,body 经文件传递而非 shell 拼接)。
|
||
|
||
| 项 | 值 |
|
||
|---|---|
|
||
| 链接 | `https://git.f.novalon.cn/novalon/novalon-website/pulls/29` |
|
||
| base / head | `dev` ← `qa/seal-2026-09-28`(API 回读确认) |
|
||
| 状态 | `open`、**`mergeable: true`**、`changed_files: 555` |
|
||
| 范围 | `origin/dev..HEAD` = **15 笔**(dev tip 是 `040951c`;含代码封版点 `a366bd1`/`6bb7c55`/`a0328a6`) |
|
||
| 描述 | `.pr-seal-2026-10-08.md` 全文 + 前置说明(生产已按 `a0328a6` 发布,本 PR 补治理痕迹) |
|
||
| 门禁 | `bash scripts/check-pr-checklist.sh .pr-seal-2026-10-08.md` **EXIT=0** |
|
||
|
||
**未合并,且刻意不合并**:`origin/main` 落后 46 笔(main tip `7df2dde`),而 `Jenkinsfile:407-429` 在 `branch 'main'` 上挂有「🚀 部署到生产环境」阶段 ⇒ 任何把这条链推上 `main` 的动作都会触发**无人值守的二次发布**。合并本 PR(→dev)不触发该阶段,但仍应由人决定;dev→main 另开 PR。
|
||
|
||
**证据目录**:`docs/acceptance/2026-10-08-release/` —— `build.txt`、`deploy.txt`(含步骤 1.5 与资源断言)、`type-check.txt`、`lint.txt`、`seed-rehearsal.txt`(副本演练)、`seed-diff.mjs` / `seed-diff.txt`(逐表差异,可复跑)、以及本节的线上核验读数(Playwright 三页 `TOTAL_FAILED_GETS=0`)。
|
||
|
||
### 10.8 第二次发布(2026-10-08 18:0x,`npm run build && ./scripts/deploy.sh deploy`)
|
||
|
||
**目的**:① 让线上产物对应已提交的树;② **端到端验证 §10.3 的发布链修复**(第一次部署时镜像是手工补的,修复本身还没在真实部署里跑过)。
|
||
|
||
| 检查 | 结果 |
|
||
|---|---|
|
||
| 构建 + 步骤 1.5 | `CHAIN_EXIT=0`;本地生成镜像 `dist/_next/static` 存在,新 BUILD_ID `HCvsEIztksM1GCWBJBrRP` |
|
||
| **资源级断言(新门禁首次实战)** | `verify_remote` 取样 6 件(5 个 `/_next/static/chunks/*.js` + `/favicon.ico`)**全 200** ⇒ 破站路径已被脚本自身堵住,不再依赖人工复核 |
|
||
| 产物同源 | 线上首页引用的 chunk 逐个回查本地 `dist/_next/static/**` ⇒ **同源命中**(chunk 名未变属预期:本轮只改文档,客户端代码无变化;BUILD_ID 已变证明是新构建) |
|
||
| 容器 | 重建后就绪轮询通过;Playwright 三页 `stylesheets=2`、品牌红命中、`4xx/5xx GET=0`、`console errors=0`,`TOTAL_FAILED_GETS=0` |
|
||
| 回滚锚点 | 本次部署前脚本自动产出新的 `dist_backup_*`(保留最近 3 份),DB 侧另有 `prod.db.bak.20261008_174734-preseed` |
|
||
|
||
证据:`docs/acceptance/2026-10-08-release/deploy-2.txt`(含步骤 1.5 与六项资源断言的原始输出)、`probe.mjs`(线上体检脚本,可复跑)、`build.txt`/`deploy.txt`/`seed-*`/`type-check.txt`/`lint.txt`。
|
||
|
||
**K 项已撤销**(见 §10.5 与 §10.6 的就地更正):`navigation`/`site-config` 无授予是 `prisma/seed.ts:241-242` 明示、`src/lib/seed-permissions.test.ts:18-19,50` 门禁钉住的**刻意站点级独占**,不是缺口。我上一笔据「矩阵里没有」就下结论,重犯了本仓 `docs/lessons-learned.md` §5.32 已立过的规则。
|
||
|
||
### 10.9 治理闭环:#29 已合并进 `dev`,#30 开向 `main`(2026-10-08 18:21)
|
||
|
||
| 项 | 值 |
|
||
|---|---|
|
||
| **#29** | `qa/seal-2026-09-28` → `dev`,**已合并**(`merged_at 2026-10-08T18:21:42+08:00`)。合并方式取 **fast-forward-only**(`allow_fast_forward_only_merge = true` 现取)而非仓库默认的 `rebase`:`origin/dev` 是 `HEAD` 的严格祖先 ⇒ FF 后 **15 笔 sha 逐字不变**,`origin/dev` tip = `104ec7d`。理由:本仓 AUTH-D1 已记过 rebase 造成「同标题异 hash」的拓扑分叉之痛(`f543e47` vs `origin/dev` 的 30↔31 假分叉),FF 既保线性又保 sha 可引用 |
|
||
| **#30** | `dev` → `main`,**open / `mergeable: true`**,46 笔,`main`(tip `7df2dde`) 是 `dev` 的严格祖先 ⇒ 同样可 FF。描述里显式写了「**合并即触发 CI 生产部署**」与三条 CI 侧已知风险(`check:motion` 23 处判红、视觉层依赖 CI 环境字体/DPR、变异与全站 axe 的成本) |
|
||
| 为什么 #30 不由我合 | `Jenkinsfile:407-429` 的「🚀 部署到生产环境」带 `when { branch 'main' }` ⇒ 点合 #30 = 授权一次无人值守线上发布。生产**已经**按 `a0328a6` 发布并验证两次(§10.1、§10.8),所以 #30 的价值只在治理同源,不在交付;触发二次发布不该由代理决定 |
|
||
| 凭据路径 | `credential.helper=osxkeychain`(Xcode 系统级 gitconfig 提供)→ `git credential fill` → Gitea API `POST /pulls`、`POST /pulls/{n}/merge`。PR body 一律经文件传递,避免 shell 把反引号当命令替换(本轮就因此丢过一次 `dev` 字面量) |
|
||
|
||
---
|
||
|
||
## §11 2026-10-17 · 对标语法批(Bain / Porsche Consulting)UI·UE·UX 重构
|
||
|
||
分支 `worktree-ui-grammar-two-axis`,基线 `da9a5cb6`。范围按决策四取 **tracer-bullet 一批**:
|
||
首页(`home-content-v16`)+ 一条承载详情页(`/solutions/[id]`)端到端,其余模板待验收后再套。
|
||
决策与实测判据全文见 [ADR-0008](adr/0008-benchmark-grammar-takeover.md)。
|
||
|
||
### 11.1 本轮新增的仪器(每台都配"能失败"的证据)
|
||
|
||
| 仪器 | 判据 | 自证 / 负对照 | 现读 |
|
||
|---|---|---|---|
|
||
| `scripts/check-visual-grammar.mjs`(`check:grammar`) | R1–R11 把对标语法钉成机器判据;每条报分母,分母 0 = 未能度量(EXIT=2,不与判红共用 EXIT=1) | `check:grammar:selftest`:R1–R9 喂已知违规必须全判红;R10 棘轮「28 不判红 / 29 判红」;R11「未声明引用判红 / 已声明不误报」 | 11/11 成立,EXIT=0 |
|
||
| `scripts/check-accents.mjs`(`check:accents`) | 营销面不得出现 `accent-*` 类彩色编码;豁免**按文件名**登记,命中归零亦判红 | `check:accents:selftest` 三情景**各测一维**(违规 / 豁免腐化 / 全绿)——第一版把互斥前提塞进同一份夹具,导致腐化那一维永远测不到,EXIT=1 自证失败 | 扫 251 源文件,命中 31 处全在 3 条豁免内,EXIT=0 |
|
||
| `scripts/dead-modules.mjs`(`check:dead`) | 从真实入口做 import 闭包判可达性 | 修四轮才可信(动态 import 边、多根、根级 `app/layout.tsx` 入口正则、绝对/相对路径不一致);不可度量时 EXIT=2 | dead 0(17 个已删) |
|
||
| R11 僵尸令牌守卫 | tailwind 映射的 `var(--*)` 必须在 `globals.css` 有声明 | **负对照已执行**:把 `--shadow-brand`/`--shadow-glow` 映射塞回 tailwind ⇒ EXIT=1、2 条判红;还原 ⇒ 11/11 成立。读数与脚本存 `docs/acceptance/2026-10-17-ia-e2e/` | 引用 144 个变量,悬空 0 |
|
||
|
||
`check:visual`(= grammar 自证+实跑、accents 自证+实跑,自证先跑)已并入 `test:all`。
|
||
|
||
### 11.2 本轮真实踩到并修掉的缺陷(管理归零)
|
||
|
||
| # | 缺陷 | 根因 | 为什么门禁没拦住 |
|
||
|---|---|---|---|
|
||
| D-1 | **`npm run lint` 的 EXIT=1 被管道吞成 0** | `npm run lint \| tail -6` 取的是 `tail` 的退出码(本仓 memory 已立过「管道吞退出码」,仍复犯) | 拦住了 —— 规则本身报了 2 error,是我没读它的退出码 |
|
||
| D-2 | 源码注释被当**文字节点渲染到页面上**(`solution-detail-content-v3.tsx` 两处 `/* …` 写在 JSX 子节点位) | 上一笔为修「注释占三元分支根位导致 build 失败」而把注释挪进 children,却没包 `{/* … */}` | **合法 JSX**:`type-check` EXIT=0、1747 例单测全绿、`npm run build` EXIT=0。唯一静态防线是 `react/jsx-no-comment-textnodes`,即 D-1 那 2 个 error |
|
||
| D-3 | 已退役的彩色阴影令牌在 tailwind 仍留映射 ⇒ `shadow-brand` 类静默展开成空值 | 「删了值但没删引用」;R5 看令牌层、R7 看业务代码消费,两条都绿 | 判据两侧都不看 tailwind↔CSS 这条缝 ⇒ 新增 R11 接管 |
|
||
| D-4 | `checkGrammar` 的 `results` 累加器挂 module 层,第二次调用往同一数组追加,`.find("R10")` 取到第一次读数 | 仪器只在被复用时才坏;主流程只调一次所以毫无症状 | 自证写成第二次调用才暴露 ⇒ 把累加器收进函数作用域 |
|
||
| D-5 | 我自己新写的「首页段序」断言用 `boundingBox().y` 排序 | 那是**视口相对**值,`scrollIntoViewIfNeeded` 后各段都落在同一带区(实测 -0.5 / -151.8) | 改用文档坐标 `getBoundingClientRect().top + scrollY`,并实测三段读数 2684 / 3242 / 3995,确认不是恒等 |
|
||
|
||
D-2 的回归守卫:`solution-detail-content-v3.test.tsx` 新增断言,且**先断言被污染的两段 DOM 真的渲染了**才断言"文字里没有 `/*`";该断言已用变异验证敏感性(把注释改回裸文本 ⇒ 仅这一条转红、其余三条仍绿,EXIT=1)。
|
||
|
||
### 11.3 E2E 与 IA 的连带改写
|
||
|
||
一级导航改双轴(行业 / 能力 / 洞察 / 关于我们)后,**7 个 spec 文件里的旧锚点必须随 IA 一起改**,
|
||
否则"绿"只代表还在测上一版信息架构。逐条按实测 DOM 重写(探针与读数存
|
||
`docs/acceptance/2026-10-17-ia-e2e/probe-*.mjs`,共 7 份):
|
||
|
||
| spec | 原锚点 | 现锚点 | 语义是否守住 |
|
||
|---|---|---|---|
|
||
| `nav-dropdown.spec.ts` | `button:has-text("产品")` / `("解决方案")` | 三轴各自触发器 + 新增一级 IA 契约断言(按钮文本恰为 `['行业','能力','洞察']` 且无「产品」) | 守住并加强:多了「产品若回到一级即判红」的反向守卫 |
|
||
| `p6-missing-paths.spec.ts` | 产品下拉 → 查看全部产品 | 能力下拉 → 产品矩阵总览 `/products` | 判据升级为「降级后仍可到达」 |
|
||
| `uj-11-home-conversion.spec.ts` | `hero-primary-cta`/`trust-section`/`narrative-section`/`cases-co-creation-cta` | `hero-cta`/`home-ledger*`/`metrics-basis-note`/`results-slot-*`/`home-cta-button` | 口径类断言改为「存在且非空」,不锁措辞(口径 target→verified 时会误红) |
|
||
| `p2-functional-e2e.spec.ts` | 同上旧锚点 + 旧五项导航文案 | v16 锚点;`导航链接可点击` 改为**按导航自己声明的目的地去走**(直链优先,未展开的下拉先 hover) | 桌面一级只剩 1 个 `<a>`、其余是 `button[aria-expanded]` ⇒ 旧写法在 idx=1 稳定读不到元素 |
|
||
| `p5-edge-cases.spec.ts:129` | `narrative-section a[href="/products"]` | `card-products a[href="/products"]`(页脚,不依赖 hover) | 守住 N-27「不许静默跳过」纪律 |
|
||
| `user-journey.spec.ts:216` | `button:has-text("解决方案")` + 查看全部解决方案 | `("行业")` + 查看全部行业 | 同轴改名 |
|
||
|
||
复跑:三文件 × 4 project **80 passed / 0 failed**;`p2` × chromium + chromium-mobile **96 passed**(含 D-5 修正后)。
|
||
|
||
### 11.4 新登记的待拍 / 待授权(本批一律未执行)
|
||
|
||
| 编号 | 项 | 为什么不由代理自决 |
|
||
|---|---|---|
|
||
| DEC-N1 | **彩色编码第二条通道**:`hero-themes.ts` 11 个主题里 7 个用非品牌 `accentColor`(erp `#1e3a5f`、crm `#1e40af`、bi `#0c4a6e`、cms `#14532d`、sds `#78350f`、oa `#4c1d95`、novavis `#0f3d3e`),以内联样式进产品·方案·服务详情页 hero 徽章 | 去掉逐产品色相 = 取消产品线视觉身份,是**设计裁定**;且属"套其余模板",决策四明确推到验收之后。`check:accents` 的口径已就地写清「仅类名通道」,防止被读成"营销面已无彩色编码" |
|
||
| DEC-N2 | `StaggerReveal` 默认 `staggerDelay = 0.15` 与 ADR-0004 决策三「stagger 30–60ms」不符 | 改库默认值 = 全站动效重排 + 基线重采;本批只在首页与账本显式传 0.04–0.06 |
|
||
| DEC-N3 | `check:motion` 现存 **8 条违反**(6 条写死贝塞尔不在令牌层、`--transition-gentle = 1000ms` 超 700ms 入场上限、1 条 CSS 裸时长字面量) | **全部是基线 `da9a5cb6` 就有的红**(`git show` 核过 `--transition-gentle: 1000ms` 与 `transition: opacity 0.6s` 两处),非本轮引入;该闸不在 `test:all` 内 |
|
||
| DEC-N4 | `CaseStudiesSection` / `detail-trust-section` **没有**授权与 basis 门槛(只有新成果槽有) | 应同闸;改的是既有转化页文案可见性,需与业务确认口径后再动 |
|
||
| AUTH-VISUAL | 视觉基线重采(radius / 阴影 / hover / CTA 全变)+ `--radius-cta: 12px` 负对照 | 写基线需单独授权;负对照若 N=0 则只读复跑的绿灯作废 |
|
||
| AUTH-NAV | CMS `navigation/default` 行改写 | 写库是共享状态动作;现行由代码 fail-closed 供数,不改库也能上线 |
|
||
|
||
### 11.5 终局验证轮(2026-10-17 续):三条 prod 目标读数 + 一个真缺陷 + 一次自伤
|
||
|
||
`test:e2e:prod`(harness 起 `node dist/standalone/server.js`,非 `next start`)首跑
|
||
**94 passed / 25 failed / 25 skipped**。25 条红逐条归因后**只剩 1 类是真事故**:
|
||
|
||
| 红因类 | 条数 | 定性 | 处置 |
|
||
|---|---|---|---|
|
||
| 旧导航标签硬编码(`a:has-text("服务")`、抽屉里 `("产品")`/`("解决方案")`) | 6 | 本批 IA 变更的连带,**测试口径落后于 IA** | 已重写(见下) |
|
||
| `/news` 筛选计数 2≠1 | 8 | **冻结的 ISR 落盘产物**:`dist/standalone/dist/server/app/news.html` 里含 `uj03-test-news-*`,而 `prisma/dev.db` 实测 0 条 `uj%` 行;响应头 `x-nextjs-cache: HIT`、`s-maxage=3600` | 装配层已修(UJ-03 teardown 删行后补 revalidate);**产品层缺口另记 DEC-N5** |
|
||
| `check:axe` 未能度量 | — | `EXIT=2`,路由清单 `/tmp/axe-routes.xml` 不存在(须先跑 `check:axe:routes`)——**不是判红,是没测** | 按序补跑 |
|
||
|
||
#### 真缺陷:一级导航降级把 `/products` 变成了**移动端孤儿路径**(已修)
|
||
|
||
- 现象:守卫断言 `[data-testid="mobile-tab-bar"] a[href="/products"]` 稳定读不到元素。
|
||
- 实测:底部 TabBar 的 hrefs 只有 `['/', '/solutions', '/services', '/insights', '/contact']`,
|
||
而移动抽屉原本**只渲染 `config.mainNav` 这一层**(`header.tsx:222-246`)⇒
|
||
「产品」退出一级后,手机上**没有任何导航路径**能到 `/products`(只剩页脚)。
|
||
桌面端靠 hover mega 面板仍可达,所以这是**只有移动端会中**的 IA 完成度缺口。
|
||
- 修法:抽屉为带 `dropdownKey` 的轴渲染其 mega 组(常驻展开,不做手风琴 ——
|
||
抽屉本身 `overflow-y-auto` 可滚,少一个交互态就少一处 a11y 契约要维护)。
|
||
复测:抽屉链接 **26 条,含 `/products` 1 条,二级项 21 个**;
|
||
`UJ-01/02/08/10` × chromium + chromium-mobile ⇒ **14 passed / 0 failed**。
|
||
- 记一笔正面价值:**这条红是判据抓对了,不是测试写坏了**。
|
||
「降级后仍可到达」这个断言的全部意义就在于此;若当时把它调成"找不到就跳过",
|
||
`/products` 会在手机上静默消失。
|
||
|
||
#### 本轮的自伤(必须记,否则下一轮还会做)
|
||
|
||
为了"清掉那份冻结的 ISR 产物",我对构建输出目录做了 `rm -rf`(含 `(marketing)/news` 子树),
|
||
结果连**已编译的页面模块** `dist/standalone/dist/server/app/(marketing)/news/page.js` 一起删了:
|
||
|
||
- 直接症状:standalone 服务打 `Error: Cannot find module '…/(marketing)/news/page.js'` ×6,
|
||
`UJ-01 Mobile` / `UJ-03` 因页面 500 而红。
|
||
- 更糟的是**验证被自己的破坏污染**:我当时跑「产物里 uj03 命中数 = 0」得到 0,
|
||
读起来像"缓存已干净",实际是**页面根本渲染失败**(500 的 HTML 里当然不含那行)。
|
||
`npm run build` 重建后 `news.html` 里 uj03 又出现 2 次,才暴露 DB 里真有 2 条残留行
|
||
——那是 UJ-03 因我破坏的产物而**中途失败、teardown 没跑完**留下的。
|
||
- 三条纪律:① 重置 ISR 只能靠 **重新构建** 或调用 revalidate,不许手删 `dist/**`;
|
||
② 任何"命中 0"式的清除验证必须同时断言**页面是健康的**(正对照:状态码 200 且关键锚点在),
|
||
否则"仪器坏了"与"问题没了"共用同一个 0;③ 破坏性清理若让用例中途失败,
|
||
要回头查它留下了什么**半成品数据**,而不是只修红的那条断言。
|
||
- 善后:自造的 2 条 `uj03-test-news-*` 已按 id 删除(连带 AuditLog 与 ContentZone.items 引用),
|
||
`news` 已发布行回到 seed 的 2 条;随后 `npm run build`(EXIT=0)重建产物。
|
||
|
||
#### 新登记
|
||
|
||
| 编号 | 项 | 说明 |
|
||
|---|---|---|
|
||
| DEC-N5 | **后台发布/删除不触发缓存失效**:`DELETE /api/admin/items`(`route.ts:282-311`)与 workflow 发布路由都不调 `revalidatePath`;全仓除 `e2e/user-journey.spec.ts` 外**没有任何生产代码调用 `/api/cms/revalidate`**,而 8 个页面注释都写着「CMS 发布/更新时通过 /api/cms/revalidate 主动刷新」 | 实测后果:最长 1 小时(`s-maxage=3600`)前台上仍是已删/旧内容。修法是把 `modelCode → paths` 的映射从 `api/cms/revalidate/route.ts` 里**提成可导入的函数**(同 §5.30「安全抽象必须可导入」),再在发布/更新/删除三处调用。属生产内容行为变更,本批不擅改 |
|
||
| DEC-N6 | `e2e/**/*.ts` 不在 `tsconfig` 的 include 内 ⇒ `npm run type-check` 抓不到 e2e 里的类型/重复声明错误 | 本轮实例:teardown 补丁里第二个 `const revalidateSecret` 与既有声明重名,type-check 全程 EXIT=0,只有 `npx playwright test --list` 才报 `Identifier 'revalidateSecret' has already been declared`。口径:**改 e2e 后必须至少跑一次 `--list`**(收集期解析)才算"能加载" |
|
||
|
||
### 11.6 终局验证补跑读数(2026-10-17,装配后的 standalone 产物)
|
||
|
||
| 门禁 | 读数 | 口径 |
|
||
|---|---|---|
|
||
| `test:visual:all --update-snapshots=none`(只读) | **104 failed / 21 passed**,五 project 均匀分布(21/21/20/21/21),**0 例 element-not-found、0 例超时** | 与首跑 `109/16` 的差值全部归因到那 5 条 `founder-quote-section` 死选择器(区块按裁定删除 ⇒ 区域截图永不可能命中),已改写为**反向守卫**并经变异验证。剩下的 104 条**都是像素不符**,即本批语法改动(radius 0–4 / 去彩色阴影 / CTA 直角 / hover 不抬升 / 暖色板)的预期外溢 ⇒ **AUTH-VISUAL 的重采量就是这 104 张**,不是"基线全坏" |
|
||
| `check:axe:routes` → `check:axe` | 清单 **35 条**;`PASSED=true`、`bgMismatch=0`、`contrastNodes=0`、`violationNodes=0`、`extraRuleNodes=0`、`extraRuleCoveragePairs=105`、`non2xxResponses=1`(= 期望内的 `/_not-found`)、`unexpectedStatus=0` ⇒ **EXIT=0** | 首跑是 `EXIT=2`「未能度量」(清单不存在,须先跑 routes),第二次 `EXIT=1` 抓到两类真问题(见下) |
|
||
| `test:e2e:prod` | 修完 6 条 IA 连带红 + ISR 装配后,`UJ-01/02/03/08/10` × chromium + chromium-mobile ⇒ **14 passed / 0 failed** | GA4 那 16 例在本 worktree **仍 skipped**:worktree 没有 `.env.production`,而 `NEXT_PUBLIC_GA_MEASUREMENT_ID` 是 **build 期烘焙**进客户端产物的 ⇒ 「prod 目标下 GA4 才真断言」这条口径在缺该文件的树上不成立,须记为**未取证**而不是通过 |
|
||
|
||
#### 修掉的两个闸自身缺陷
|
||
|
||
1. **`axe-node-count.mjs` 的底色哨兵把令牌值抄成字面量**(`EXPECTED_BG.dark = 'rgb(10, 14, 20)'`),
|
||
而暗色底早在 P1 暖色迁移(本分支基线 `da9a5cb6` 之前)就变成 `20 18 16`
|
||
⇒ 哨兵**恒红**,实测 `bgMismatch=36`。
|
||
归因用 `git diff da9a5cb6..HEAD -- src/app/globals.css` 核过:本批**没有**任何
|
||
`color-bg-primary` 改动 ⇒ 不是本轮引入。
|
||
修法不是把字面量改成新值(那只是再抄一遍抄本),而是**改从令牌自己取值**:
|
||
读 `--color-bg-primary-rgb` 三元组拼期望色。
|
||
**负对照已做**(`docs/acceptance/2026-10-17-ia-e2e/probe-bg-negative.mjs`):
|
||
把 `dist/standalone/dist/static` 临时移走起服务 ⇒
|
||
`expected=""`、`actual="rgba(0, 0, 0, 0)"` ⇒ 哨兵判红(EXIT=0 表示"负对照成立");
|
||
装配完好时 `expected="rgb(20, 18, 16)"` = `actual` ⇒ 判绿。
|
||
⇒ 这次改造**没有把闸调瞎**(§5.34 的同类风险)。
|
||
2. **改哨兵时漏改一处 `pageBg` 引用** ⇒ `check:axe` 以
|
||
`FATAL: 扫描中断(uncaughtException):pageBg is not defined` 崩掉。
|
||
这条值得记:闸崩溃与判红在退出码上是两回事(本闸 EXIT=1 判红 / EXIT=2 未能度量 /
|
||
FATAL 走 uncaughtException),**没有静默把崩当成通过**;
|
||
同时 `scripts/**.mjs` 不在 `tsconfig` 覆盖内,只有真跑才暴露(同 §5.43)。
|
||
|
||
#### ISR 冻结产物的最终处置
|
||
|
||
`uj03-test-news-*` 的 URL 会顺着「已发布 → revalidate 落盘 → 删除但没人再刷」这条链
|
||
被冻进产物,再被 BFS 收进路由清单,最后表现为 404。本轮闭环做法:
|
||
删自造行(含 `AuditLog.targetId` 与 `ContentZone.items` 的 JSON 引用)→
|
||
`npm run build` 重建(`news.html` 里 `uj03` 命中 **0**)→ 重跑 routes + axe。
|
||
纪律仍然成立:**重置 ISR 只能靠重建或 revalidate,不许手删 `dist/**`**(§5.42)。
|
||
|
||
**证据文件的口径提醒(引用前必读)**:`check:axe` 的输出路径是写死的
|
||
`docs/acceptance/2026-09-21-axe/axe-evidence.json`,所以本轮跑闸把那份**历史证据**
|
||
刷成了本轮读数(`0157b1c9` 里 409 行 diff 就是它)。它仍在原目录、仍可复跑取证,
|
||
但引用时要按「2026-10-17 本轮」读,不要当成 2026-09-21 那一轮的原件 ——
|
||
该轮原件的结论在 `docs/acceptance/2026-09-21-gates/` 与 §8/§9 里可回溯。
|
||
⇒ 这是一条**仪器设计缺陷**:证据文件名应当带运行时间戳或按轮次分目录,
|
||
否则每跑一次就在覆盖一次历史。登记为待办(改输出路径属独立小改动,本批不夹带)。
|
||
|
||
### 11.7 Lighthouse(装配后的 standalone 产物,`npm run lighthouse`)
|
||
|
||
**EXIT=0**,断言全过:11 URL × 3 跑 = 33 份报告。逐 URL 取三轮里的最好一轮读数
|
||
(`lighthouse-reports/`、`.lighthouseci/lhr-*.json` 可复算):
|
||
|
||
| URL | perf | a11y | best-practices | SEO | LCP |
|
||
|---|---|---|---|---|---|
|
||
| `/` | 99 | 100 | 100 | 100 | 902ms |
|
||
| `/about` | 99 | 100 | 100 | 100 | 976ms |
|
||
| `/about/brand` | 99 | 100 | 100 | 100 | 933ms |
|
||
| `/cases` | 99 | 100 | 100 | 100 | 996ms |
|
||
| `/contact` | 98 | 100 | 100 | 100 | 1101ms |
|
||
| **`/insights`**(本批新增覆盖) | 99 | 100 | 100 | 100 | 974ms |
|
||
| `/news` | 99 | 100 | 100 | 100 | 976ms |
|
||
| `/products` | 99 | 100 | 100 | 100 | 896ms |
|
||
| `/products/erp-upgrade` | 99 | 100 | 100 | 100 | 896ms |
|
||
| `/services` | 99 | 100 | 100 | 100 | 895ms |
|
||
| **`/solutions/manufacturing`**(本批 tracer-bullet 承载页,新增覆盖) | 99 | 100 | 100 | 100 | 895ms |
|
||
|
||
口径说明:
|
||
- 这是**在装配好的产物上**测的(`dist/standalone` 含 `dist/static` + `public`)——
|
||
§5.34 那类"全站 CSS 404 而 Lighthouse 仍 exit 0 且 perf 99-100"的假绿已被前置排除;
|
||
同轮 `check:axe` 的 `bgMismatch=0` 是另一侧证据(两条独立仪器指向同一事实)。
|
||
- 两条新覆盖的 URL 都进来了:`/insights` 是新的一级轴,`/solutions/manufacturing`
|
||
是本批的 tracer-bullet 详情页。**加进断言集而不测**是没意义的,所以先跑再登记。
|
||
- 阈值口径未动:`performance ≥ 0.9`、`accessibility/best-practices/seo ≥ 0.9`、
|
||
`LCP ≤ 3000ms`(`config/test/lighthouserc.json`),本轮实测最低 perf 98(/contact)、
|
||
最大 LCP 1101ms(/contact),余量分别 8 点与 1899ms。
|
||
|
||
---
|
||
|
||
## §12 2026-10-17 · §11.4 待拍批的落地轮(DEC-N1…N6 + AUTH-VISUAL)
|
||
|
||
用户裁定「需要决策就采用推荐方案」,本批把 §11.4/§11.5 登记的每一条按推荐项执行到位。
|
||
分支仍是 `worktree-ui-grammar-two-axis`,起点 `0ae765af`。
|
||
|
||
### 12.1 DEC-N5 · 后台发布/更新/删除真正让前台 ISR 失效(`f3e66f7d`)
|
||
|
||
**根因不是算错,是没有调用方**:`modelCode → paths` 的推导长在 `/api/cms/revalidate` 的路由体里,
|
||
所以它只能被外部 HTTP 调用触发。8 个页面注释那句「CMS 发布/更新时通过 `/api/cms/revalidate`
|
||
主动刷新」在没有任何生产调用方的日子里是假的 —— `s-maxage=3600` 下最长 1 小时前台仍端出
|
||
已删或过期内容,且没有任何门禁会红。
|
||
|
||
| 处置 | 内容 |
|
||
|---|---|
|
||
| 提纯 | 新增 `src/lib/cms/revalidation.ts`:`pathsForModel` / `tagsForModel` / `planRevalidation` 是**不碰 `next/cache` 的纯函数**,副作用收在 `applyRevalidation`(严格,供路由用)与 `revalidateContent`(尽力而为,供变更链用)。依据 §5.30「安全抽象必须可导入」 |
|
||
| 接线 | `items` 的 POST/PUT/DELETE、`workflow` 的 submit/approve/reject/archive、`zones` 的写与删,全部走同一份推导。判据按 `status`(草稿不进前台读取路径);**slug 变更时旧地址一并刷** |
|
||
| 时序 | 失效放在数据与审计**都落库之后**:刷缓存失败不该把一次成功的写入连带变成 500(那比旧快照更糟 —— 操作者以为没保存,其实已改) |
|
||
| 不静默 | `revalidateContent` 逐条 try,失败以 `[revalidation-failed]` 打日志并在 `failed` 字段回报;`applyRevalidation` 仍冒泡,保持 `/api/cms/revalidate` 的 500 语义 |
|
||
|
||
**证据**:`revalidation.test.ts` 18 例(纯映射对账真实 `CONTENT_TYPE_CONFIGS`,不抄字面路径)+
|
||
`cache-invalidation.test.ts` 7 例(断言的是「调用点存在」本身,正是当初缺的东西)。
|
||
定向 16 套件 **193 passed / EXIT=0**;
|
||
**负对照**:把 workflow 的调用点替换成注释 ⇒ `MUTANT_EXIT=1`、4 例转红(approve + submit/reject/archive),
|
||
还原后 `EXIT=0` 且文件逐字节复原。lint 定向 0 error。
|
||
|
||
### 12.2 DEC-N2 · 台账声明被证伪:`staggerDelay` 默认值从来不是 0.15
|
||
|
||
ADR-0008 §87-1 与 §11.4 写的是「`StaggerReveal` 默认 `staggerDelay = 0.15`,与 ADR-0004 决策三
|
||
「子元素 stagger 30–60ms」不符」。实测三条把它推翻:
|
||
|
||
1. `src/components/ui/scroll-reveal.tsx:113` 现行默认是 **`0.05`(= 50ms,落在 30–60ms 内)**,且工作树干净(不是我改的)。
|
||
2. `git log -S'staggerDelay = 0.15' -- src/components/ui/scroll-reveal.tsx` **无任何提交** —— 那串字面量在该文件历史里没存在过。
|
||
3. 全站 18 个显式传参只有 `staggerDelay={0.05}`(16 处)与 `{0.06}`(2 处),没有任何 0.15。
|
||
|
||
⇒ **DEC-N2 无需执行**,它和 §11.6 那条「axe 哨兵抄字面量早已过期」是同一类缺陷:
|
||
**台账里的数是从前一轮的叙述里抄来的,而不是从当场的仪器里取的**。
|
||
ADR-0008 §87-1 的同一句话需要一并更正(该文件本轮由 accent 子任务独占改写,故在此登记而非并发改)。
|
||
|
||
### 12.3 DEC-N3 · `check:motion` 的 8 条基线红归零,判据从「令牌声明」移到「消费点」(DEC-N3,提交见 `git log`)
|
||
|
||
先量再判,没有直接把红线挪低:
|
||
|
||
| 子项 | 读数与处置 |
|
||
|---|---|
|
||
| 6 处写死 cubic-bezier | 全部收进既有令牌 `--ease-ink` `[0.22,1,0.36,1]`(`template.tsx`、`page-transition.tsx`、`brand-visuals.tsx`),各处注释标 `CONTEXT.md:77` 出处;两曲线原本都落在 280ms 入场档,没有不可替代的物理理由 |
|
||
| `opacity 0.6s` 裸时长 | 改 `var(--transition-slower)`(globals.css:1486) |
|
||
| `--transition-gentle = 1000ms` | **实测在 `src/` 零消费**(仅 `tailwind.config.js:220` 的 `duration-gentle` 映射,无一处使用)⇒ 入场/循环/其他 = 0/0/0。原「令牌声明一律 ≤700ms」是把 CONTEXT.md:82 的**入场**红线读成了对调色板的禁令;现口径改为**消费点判红**:非 infinite 的 `transition/animation` 声明(含经 `var()` 解析出的时长)>700ms 必红,`infinite` 循环环境动效维持既有豁免 |
|
||
|
||
**仪器自证(负对照,真树注入 → 还原)**:塞回 `[0.16,1,0.3,1]` + `opacity 900ms` 裸字面量 +
|
||
`opacity var(--transition-gentle)`(非循环消费点)⇒ `npm run check:motion` **EXIT=1**,
|
||
4 条红分别命中 `easing-palette`×1、`css-transition-token`×1、`entrance-cap`×2;
|
||
还原后 **EXIT=0**、违规 0。⇒ 改口径没有把闸调瞎:超上限档位一旦接入非循环声明就判红。
|
||
|
||
读数:`check:motion` EXIT=0(0 违反)、`check:motion:test` EXIT=0(21/21)、`tsc --noEmit` EXIT=0。
|
||
|
||
### 12.4 DEC-N5 的连带教训:`next build` 的 TypeScript 阶段比 jest 严
|
||
|
||
新增的 `cache-invalidation.test.ts` 在 jest 里 25 例全绿,却把 `npm run build` 打成
|
||
`error TS2554: Expected 2 arguments, but got 1` —— 原因是测试夹具 `req(url, body)` 的 `body`
|
||
写成必填,而 `DELETE`/`PUT` 的调用不带 body。**jest 里少传一个参数只会让 `json()` 抛错、
|
||
又被路由的 catch 吞成 500 之外的路径**,所以测试毫无症状。已把 `body` 改可选并留下注释。
|
||
⇒ 口径补充:**改 `src/**` 下的测试后必须让 `npm run build` 过一遍 tsc**,
|
||
`npm run type-check` 与 build 的 tsc 覆盖同一份 tsconfig,但只有 build 会被 CI 跑到。
|
||
|
||
### 12.5 DEC-N4 · 授权与 basis 门槛下沉成共用闸(`2e009942`)
|
||
|
||
判据原先只有新成果槽有:`CaseStudiesSection` 与 `detail-trust-section` 里的案例主张不过闸,
|
||
于是「同一类证据走两套标准」。这轮把判据(授权 + ≥1 个 `basis === 'verified'` + 禁词扫描)
|
||
下沉成 `src/lib/constants/case-publish-gate.ts`,`results-slot` 的 `casePublishBlockers` 改为委托它
|
||
⇒ **三处消费同一实现,禁词/口径真源仍只有 `metrics-basis.ts` 一份**(不造第二套真源)。
|
||
|
||
| 项 | 读数 |
|
||
|---|---|
|
||
| 门槛下会被隐藏的既有条目 | **0 条** —— seeds(products×6 / services×4 / standalone×1)的 `caseStudies` 全是空数组,solutions seed 无该字段,CMS `dev.db` 11 条内容的 `caseStudies` 长度全为 0 ⇒ 线上转化页无可见变化,本条是**前瞻性 fail-closed 加固**而非内容清洗 |
|
||
| 转红的既有断言 | 2 处旧测试写的是「未授权案例照常渲染」,按测试夹具补 `authorized + basis:'verified'` 处理并新增负例(线上传言与测试数据不混用) |
|
||
| 仪器自证 | 把闸改恒真(`return []`)⇒ **EXIT=1、20 例转红**(gate 本体、results-slot 原有用例、两区块负例、solution-detail 消费页都在红因里);还原后 EXIT=0 ⇒ 证明确实共用一道闸 |
|
||
| `dataProofs` 为何不套硬闸 | 它已在 `weakestBasis` + `MetricsBasisNote` 契约下且自述目标口径,硬清会误伤全站已标注数字(理由写进代码注释) |
|
||
|
||
⚠ **残留(登记而非隐瞒)**:CMS `content-types` 的 `caseStudies` schema 还没有 `authorized/basis` 两个字段。
|
||
后台现在无法为案例授权,闸只挡住「无字段 ⇒ 不可发布」这一侧;业务要真出案例须先扩 schema。
|
||
|
||
### 12.6 本轮的合并验证读数(提交前)
|
||
|
||
`tsc --noEmit` EXIT=0;全量 jest **145 套件 / 1795 例 EXIT=0**(较 §11 的 141/1747 增加 4 套件 48 例);
|
||
`check:visual`(grammar + accents 各自 selftest 先跑)EXIT=0;`check:dead` EXIT=0(dead 0);
|
||
`check:motion` EXIT=0;`npm run build` EXIT=0(`postbuild` 已装配 `dist/static` + `public`)。
|
||
|
||
### 12.7 DEC-N1 · accent 第二条通道钉成判据 B,并当场抓到一条真漂移
|
||
|
||
裁定:**保留** 7 个产品线色相(承担产品线视觉身份,实测 hero 徽章占视口 **0.538%**、色相仅以 **6.3% alpha** 底纹存在、
|
||
1600×846 hero 视口**冷色像素普查 = 0**),但把这条通道收进 `check:accents` 的判据 B:
|
||
①真源 `hero-themes.ts` 的 `accentColor/accentBg`、②可达营销代码里 `style={{…}}` 的色彩属性
|
||
(含 `--badge-accent` 与内联引用 `--color-accent-*` 令牌的更隐蔽形态)、③营销页就地组装 `accentColor`(绕开真源的第二份色值)。
|
||
豁免按 **文件 + 色值** 登记且色值归一化成 `#rrggbb`(否则换个 `rgba()` 写法就绕过);
|
||
登记了却命中 0 ⇒ 判红(与判据 A 同一条防腐化纪律);棘轮 `MAX_NON_BRAND_HUES = 7`,存量恰在上限 ⇒ 第 8 个色相即判红。
|
||
|
||
| 证据 | 读数 |
|
||
|---|---|
|
||
| 仪器自证 | `check:accents:selftest` **11 情景 EXIT=0**,每情景只喂一维并断言另一维违规数为 0 |
|
||
| 自证里的两处不自洽(原稿从未跑成) | ①把「另一维的豁免腐化」当串维证据 ⇒ B 夹具天然不带 A 的 3 个豁免文件 ⇒ A 必报 stale 3 ⇒ 自证永远红。腐化不是串维证据(它只是"该维没喂料"的必然产物),**违规数才是**;②4 情景的棘轮期望与 `分母 0` 情景的 stale(写 9、实取 7)按实测改正 |
|
||
| 当场战果(真漂移) | `erp-upgrade-v3/page.tsx` 的 `deriveTheme()` 在营销页里抄了一整份 theme(含 `accentColor: '#1e3a5f'` 与两段渐变)绕开真源 ⇒ 判据 B 判红。改为 `getHeroTheme(heroThemeId ‖ 'erp')` 只覆盖动态字段 `badge` |
|
||
| 改后渲染是否变的对拍 | 与真源逐字段对拍 `gradientFrom/gradientTo/gradientAngle/accentColor/accentBg/texture/layout` **全等**;并用库内实值确认 `erp` 行的 `heroThemeId` 就是 `'erp'` ⇒ 解析到同一份 theme,渲染不变(不是"应该一样",是查过) |
|
||
| 复跑 | `check:accents` EXIT=0、`check:visual` EXIT=0、`tsc` EXIT=0、`jest --testPathPatterns products` 4 套件 48 例 EXIT=0 |
|
||
|
||
⚠ 口径边界(写在闸的成功输出行里):本闸只覆盖**代码面两条入路**;CMS 内容里 authored 的色值(富文本/图表数据)不在其内。
|
||
|
||
### 12.8 DEC-N6 · e2e 进类型口径 + 两处工程卫生,以及我自己造成的两次破坏
|
||
|
||
`e2e/tsconfig.json` + `npm run type-check:e2e` 并入 `test:all`;负对照读数:注入重复 `const revalidateSecret` 时
|
||
`type-check` EXIT=0(0 条 e2e 诊断)而 `type-check:e2e` **EXIT=2(TS2451×2)**,还原 EXIT=0 ⇒ 补口真的敏感。
|
||
既有 e2e 类型错误 **25 条**:19 条按行为等价修掉(`viewportSize` 可空、`.at(-1)`、`?? 0`、可选链、正则捕获组落局部变量、
|
||
touch-targets 数组参数改对象参数、删掉既非法又等于默认值的 `locator.screenshot({fullPage:false})` 等);
|
||
**6 条登记为残留并用 `@ts-expect-error` 标注**:5 处 `use.reducedMotion`(fixture 白名单证明运行时被忽略,
|
||
而正确写法 `contextOptions` 会真的改截图 ⇒ 与本轮基线重采相撞)、1 处 `expect.toHaveScreenshot.timeout`(类型没这个键但运行时确实读它)。
|
||
|
||
`.husky/pre-commit` 索引模式 100644→**100755**(`git ls-files -s` 为准)。⚠ 但 `core.hooksPath` 是**指向主检出的绝对路径**,
|
||
本机主检出那份工作树文件仍是 644 ⇒ 本仓每次提交照旧打 `hook was ignored`;克隆/检出该提交后才是 755。
|
||
axe 证据默认落 `docs/acceptance/<运行日>-axe/axe-evidence.json`,旧路径保留为 latest 副本(Jenkinsfile:399 与文档引用不断),
|
||
判定与三档退出码未动,新增 `check:axe:selftest`(临时目录真写一遍,9 项全 ✓)与 `--print-paths`。
|
||
|
||
**我自报两次破坏(管理归零,写在这里而不是只写在提交信息里)**:
|
||
|
||
1. **在别人还在写它的文件时就 `git add`** ⇒ 提交冻结的是中间态:`1c0ce5f4` 的信息声称「重复键已由 node 回读校验」,
|
||
而 `git show HEAD:package.json` 实取重复键 **2 处**、且 `test:all` 整条不见 —— 由后续 `0e17327e` 补正。
|
||
更狠的一环是我用来去重的那条命令:`grep -n 'type-check:e2e' package.json | tail -1` 取到的行号
|
||
命中的是**含该子串的 `test:all` 整行**,`sed -i "<行号>d"` 于是把全仓门禁入口删了。
|
||
⇒ 纪律:**按子串取行号再删行**属于危险动作(子串会出现在别的行里);改 JSON 要走解析器而不是行号。
|
||
2. **校验仪器本身是坏的**:那条 node 回读用正则 `^ "key":`(两空格缩进)数重复键,
|
||
而重复键在 `scripts` 对象里(四空格)⇒ 报 `dups=[]`,对目标那一维根本不敏感。
|
||
现已换成 `scripts/check-package-keys.mjs`:按**父路径 + 键名**分组计数,退出码 0/1/2 三档,
|
||
自带 `--selftest`(正对照 + 「同层重复必抓」+「异父同名不误报」三条各测一维),
|
||
并在真 `package.json` 上做了活体负对照:注入重复的 `"lint"` 键 ⇒ **NEGATIVE=1(`scripts` 里的 "lint")**,还原 ⇒ REAL=0。
|
||
|
||
另记一次同类自伤:`npx jest "src/app/(marketing)/products"` 里 `(` 与 `[` 是**正则元字符**,
|
||
jest 把它当 testPathPattern 解析 ⇒ "No tests found" 被我读成"测试失败"(EXIT=1 同码)。
|
||
改用 `--testPathPatterns products` 后 4 套件 48 例 EXIT=0。这与 §5.42「命中 0 必须配页面健康的正对照」是同一族:
|
||
**空结果与失败共用一个退出码时,仪器必须先自证能取到非空样本**。
|
||
|
||
### 12.9 GA4 首次真断言(§11.6 那条「未取证」就此闭合)
|
||
|
||
§5 的口径表早写明:默认 E2E 打 dev server,而 `NEXT_PUBLIC_GA_MEASUREMENT_ID` 只存在于 `.env.production`,
|
||
dev 下 `GoogleAnalytics.tsx` 提前 return null ⇒ 那 16 个 `@critical` 是 **skipped 而不是 passed**。
|
||
上一轮在 worktree 里连"skipped 也算取证"都做不到:worktree 没有 `.env.production`,而 `NEXT_PUBLIC_*` 是 **build 期烘焙**。
|
||
|
||
本轮把主检出的 `.env.production` 供进 worktree(该文件由 `.gitignore:81` 忽略,不入库),重跑 `npm run build` 后:
|
||
|
||
| 证据 | 读数 |
|
||
|---|---|
|
||
| 用例结果 | `ga4-event-tracking.spec.ts` × 4 project ⇒ **16 passed / 0 failed / 0 skipped**(16.3s) |
|
||
| 独立性正对照 | `grep -o 'G-[A-Z0-9]\{6,\}' dist/standalone/dist/static/chunks/*.js` 命中 `G-LGTLCR15KM`(两处 chunk)⇒ GA id 真烘进了客户端产物;不是"没 skip 所以算过" |
|
||
| 反面样本仍在盘上 | 上一轮 `e2e/allure-results/*.json` 里同一条是 `status: skipped` + `构建未注入 GA 脚本(NEXT_PUBLIC_GA_MEASUREMENT_ID 为空)` |
|
||
|
||
⇒ 「GA4 覆盖已验证」这条口径现在才成立,且引用时必须连「在装配产物上 + `E2E_TARGET=production`」一起引。
|
||
|
||
### 12.10 AUTH-VISUAL · 基线重采 113 张,`--radius-cta` 负对照成立
|
||
|
||
按 `--update-snapshots`(裸旗标取 `changed`)重采,并按 project 分 5 笔提交:**23 / 23 / 23 / 21 / 23 = 113 张**。
|
||
|
||
| 判据 | 读数 |
|
||
|---|---|
|
||
| 重采后可复现 | `--update-snapshots=none` 只读复跑(终版代码,含 DEC-N1 的页面改动)⇒ **125 passed / 0 failed / EXIT=0**,0 张被重写 |
|
||
| **基线确实对该维敏感**(AUTH-VISUAL 明确要求的负对照) | `--radius-cta: 0px` 改 `12px` ⇒ 同 project **15 failed / 10 passed、EXIT=1**;还原后 `git diff` 为空、该项目 **25 passed** ⇒ 只读绿灯不是空壳 |
|
||
| 防空白/防塌版的实物核验 | 抽样读尺寸与像素分布:home 桌面 1280×6449(近黑 14.53%、唯一色 1382)、home 移动 1170×23586(18.53%、3076)、承载详情页 webkit 2548×17536(10.87%、1642)⇒ 内容在场 |
|
||
|
||
**两条如实挂账,不抹平**:
|
||
|
||
1. **113 ≠ 预测的 104**。§11.6 给的是 21/21/20/21/21 = 104 failed,本轮四个桌面/平板 project 各 +2。
|
||
**逐名对账我没做**:差值可能来自 §11.6 之后落地的 DEC-N3(动效时长/缓动改写影响 hover 与过渡态裁图)
|
||
与 N-15 选择器修复后的新增命中 —— 这是推断不是读数,已列入 PR 未验证项,下一轮按 `--list` 逐名对账。
|
||
2. **逐张人工读图追认只做了抽样**,全量 113 张需决策人分批追认(PR 未验证项④)。
|
||
|
||
另记一条仪器口径教训:我筛"可疑空白图"用的判据是**字节数 < 20KB**,结果把 `button-*`
|
||
(82×44 的按钮裁图,天然 ~1KB)报成可疑件。⇒ 空白/塌版要看**尺寸与像素分布**(宽高、唯一色数、
|
||
近黑/近白占比),字节数只在"同尺寸同类"之间可比。
|
||
|
||
|
||
|
||
### 12.11 AUTH-VISUAL 的逐名对账闭合:113 / 12 / 5 孤儿,并把「聚合数经不起追问」这一类修掉
|
||
|
||
§12.10 挂的账(113 vs 预测 104 的 +9 无法归因)根因不在本轮,而在**上一轮只留了聚合数没留名单**。
|
||
本轮补两件事:
|
||
|
||
1. **逐名清单仪器** `scripts/visual-manifest.mjs`:把 Playwright 文本输出转成 `{project, at, title, status}` 清单,
|
||
退出码 0 全通过 / 1 有 failed / **2 未能度量(解析不到任何用例行,不与"全绿"共用 0)**。
|
||
自证与负对照都做了:
|
||
- 终版只读日志 ⇒ `total=125 passed=125 failed=0`,EXIT=0;
|
||
- `--radius-cta=12px` 那次 ⇒ `total=25 passed=10 failed=15`,EXIT=1(判红名单全是含 CTA/徽章的整页与主题图:
|
||
`首页 /`、`/about`、`/contact`、`/products`、`/products/erp`、`/products/erp-upgrade`、`/solutions`、
|
||
`/solutions/manufacturing`、`/services`、`/services/software`、`/news`、`/methodology`、`/team`、浅色主题、深色主题);
|
||
- 空日志 ⇒ **EXIT=2**(仪器坏的时候仍然会失败,而不是报通过)。
|
||
两份清单入库:`docs/acceptance/2026-10-17-final/visual-manifest-final.json`、`visual-manifest-radius12px.json`。
|
||
2. **用磁盘清单做差集取具名结果**(我第一版拿中文用例名去匹配 slug 文件名,键型不匹配 ⇒ 得出"125 张都没重写"的假结论,
|
||
是仪器错配不是发现;改成按文件名做差集后才对):
|
||
|
||
| 集合 | 数 | 说明 |
|
||
|---|---|---|
|
||
| 本轮重采 | **113** | 按 project 23/23/23/21/23 分 5 笔提交 |
|
||
| 未重写(真的与终版一致) | **12** | `input-default/focused` × 4 个桌面类 project(8)+ mobile 的 `button-default/hover/focus`(3)+ mobile 的 `header-navigation`(1) |
|
||
| 孤儿参照 | **5** | `founder-quote-section-*` × 5 project —— 该区块按 ADR-0008 决策一已删除,`visual-regression.spec.ts:180` 早改成 `toHaveCount(0)` 反向守卫,参照留在盘上等于给下一轮留骗人的东西 ⇒ **已 `git rm`** |
|
||
| 对账恒等式 | 125 = 113 + 12 | `--list` 实取 `Total: 125 tests in 1 file`;删孤儿后每 project 恰好 **25** 张,与用例数逐 project 相等(另有 `manual-acceptance/` 2 张非断言参照) |
|
||
|
||
⇒ **§11.6 那个 104 至今没有名单可查**,所以 +9 仍不能从证据归因(只能说:113/12/5 这三个数现在自洽且可复算)。
|
||
从本轮起每轮都留逐名清单,这类"聚合数对不上只能靠推断"的情形不会再出现。
|
||
|
||
### 12.12 两条原判「需你授权」的项:DEC-N4 的 schema 落地(可做,已做)与 AUTH-NAV(前提核查后判定为已达成)
|
||
|
||
**a) DEC-N4 的功能性前置已闭合(纯代码 + 本地 seed,非生产库动作)**
|
||
我上一轮把「扩 schema」当成需要授权的库动作,判错了:`ContentItem.data` 是 JSON 列,**没有表迁移**。
|
||
真正的门槛在 `prisma/seed.ts:364` —— `ContentModel.fields` 由 `content-types.ts` 生成,
|
||
而后台能不能填 `authorized/basis` 取决于那份声明(`loadDeclaredFields()` 读它)。
|
||
没有声明,闸就永远把所有案例拦在门外:**表现为"防呆生效",实际是业务用不上**。
|
||
|
||
| 动作 | 读数 |
|
||
|---|---|
|
||
| 三处 `caseStudies`(product / service / standalone-product)补 `authorized(boolean)` + `basis`(复用 `metricBasisField` 的选项表,只覆盖标签语境,不造第二份真源) | 新增 `src/lib/cms/case-field-contract.test.ts` 4 例 EXIT=0,全量 jest **146 套件 / 1799 例 EXIT=0** |
|
||
| 契约守卫的自证 | 摘掉 `authorized` 或摘掉 `verified` 选项 ⇒ 契约报问题(用例内断言,仪器坏时仍然会失败);站点计数写死为三处 ⇒ 新增带案例的内容类型忘记带字段会当场判红 |
|
||
| `npm run db:seed` 传播到库 | SEED=0;三行 `ContentModel.fields` 均含 `authorized` + `成果口径`;`ContentItem` 行数 **38 → 38 未变**(先 `cp` 出备份再跑,不盲跑重建) |
|
||
|
||
**b) AUTH-NAV:核查后判定「已达成」,不是待办**
|
||
台账说「CMS `navigation/default` 行改写」。实查:dev.db 里那行 `mainNav` 已经是
|
||
`行业 / 能力 / 洞察 / 关于我们`(无「产品」一级),且 `length(data)` 在我这次 seed 前后**逐字节相等(2778)**
|
||
⇒ 不是我本轮改的,也说明它早已随决策二的代码真源反转对齐。
|
||
`nav-dropdown.spec.ts` + `p6-missing-paths.spec.ts` × chromium/chromium-mobile ⇒ **26 passed / EXIT=0**,
|
||
这是在「该行被采纳」的前提下跑的,即 fail-closed 的契约门确实放行了一行符合 IA 的数据。
|
||
⇒ **AUTH-NAV 无需写库,判定关闭**;生产侧同名行是否同形,属部署期核对项(需要 SSH 只读,随发布一起做)。
|
||
|
||
**c) 我自报一次同类仪器错配(§5.45 的同族,第三次)**
|
||
上一条消息我说过「dev.db 里根本没有 navigation 行」——那句话的证据是
|
||
`sqlite3 … "select code, substr(data,…) from ContentItem where modelCode='navigation';" 2>/dev/null`,
|
||
而 `ContentItem` **没有 `code` 列**,sqlite3 报 `Parse error: no such column: code` 被 `2>/dev/null` 吞掉,
|
||
空 stdout 被我读成"没有这行"。⇒ 与 §5.44(`sed` 按行号删错行)、§5.45(正则只扫顶层)三条同判:
|
||
**查询工具的报错也是证据,不能丢;空结果必须同时证明"这次查询本身成功了"**。
|
||
本条结论已改用 `select count(*) …`(不含未知列)与逐字节长度对账重取。
|
||
|
||
### 12.13 终版复验(§12.12 之后重跑)与一条**有读数的**间歇红归因
|
||
|
||
schema 落地后不能拿"之前绿过"当终版读数,故整链重跑(`docs/acceptance/2026-10-17-final/run-post-schema-lane.sh`):
|
||
|
||
| 门禁 | 终版读数 |
|
||
|---|---|
|
||
| `npm run build` | EXIT=0 |
|
||
| `check:axe:routes` → `check:axe` | EXIT=0 / **EXIT=0**(`bgMismatch=0`、`violationNodes=0`、`unexpectedStatus=0`) |
|
||
| 视觉只读复跑 + 逐名清单 | EXIT=0;`visual-manifest-post-schema.json` ⇒ **total=125 passed=125 failed=0** |
|
||
| GA4 × 4 project | EXIT=0(16 passed / 0 skipped) |
|
||
| `npm run test:all` | **首跑 EXIT=1**,同条件复跑 **EXIT=0(59 passed / 25 skipped)**;Lighthouse 见车道尾 |
|
||
|
||
**那条 EXIT=1 不能记成"已知 flake"就翻篇**,本轮的处理是把归因做成读数:
|
||
|
||
1. 红因面:两条红都在 `p6-missing-paths.spec.ts` 的 **firefox** 单一 project(`@smoke` 首页→产品列表 / 列表→详情),
|
||
其余 project 全过;同一时刻 `check:coverage`、`check:a11y`、`check:visual`、`test:integration:real`(23 例)均已绿。
|
||
2. 排除数据面:怀疑过是我 `db:seed` 把 dev.db 内容 upsert 回 seed 值 ⇒ 逐模型对账
|
||
`product 6 / solution 6 / service 4 / standalone-product 1 / news 2` **与 seed 前备份完全一致**,
|
||
且 `product` 的 slug 集合用 `cmp` 比过为**未变**。
|
||
3. 排除代码面:单跑 `p6-missing-paths --project=firefox` ⇒ **9 passed / EXIT=0**;
|
||
全量 `test:e2e:fast` 同条件复跑 ⇒ **59 passed / EXIT=0**。
|
||
4. 机理:`playwright.config.ts:12-15` 是 `fullyParallel: true` + `retries: CI ? 2 : 0` + `workers: CI ? 1 : undefined`
|
||
⇒ **本地全速并行且零重试**,firefox 在大页面上的墙钟抖动就露在这里;CI 侧有 `retries=2 + workers=1` 兜住。
|
||
这与 `README.md` 早已记的「唯一红为 firefox 并发墙钟」是同一类,本轮第一次给它配上可复算的三把读数。
|
||
|
||
⇒ **不通过放宽断言或加 retry 来"修"**(那是把判据调瞎);如需本地稳定复现绿,编排上加 `--workers=1`,
|
||
并把这一条留给 CI 口径。登记为口径事实而非缺陷关闭。
|
||
|
||
---
|
||
|
||
## §13 治理闭环(2026-10-17):#33 以 fast-forward-only 合入 dev,dev→main 不由代理执行
|
||
|
||
| 项 | 读数 |
|
||
|---|---|
|
||
| **#33** | `worktree-ui-grammar-two-axis` → `dev`,**state=closed、merged_at 2026-10-17T09:27:55+08:00**。合并方式取 **fast-forward-only**:`origin/dev` 原 tip `8026d917` 是 HEAD 的严格祖先(`git merge-base --is-ancestor` EXIT=0),47 笔 sha **逐字不变**、`origin/dev` 现 = `6d46dbe8`。理由同 §10.9:本仓记过 rebase 造成「同标题异 hash」拓扑分叉之痛,FF 既保线性又保 sha 可引用。分支**未删**(`do_not_delete_branch=true`);删分支属独立动作 |
|
||
| **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」与「跑过全量」必须在文档里区分开,否则下一次还会有人把前者当后者勾上。
|
||
|
||
### 14.1 纯净对照跑完:A/B 层定性翻转(我上一条的对照结论被自己的新读数推翻)
|
||
|
||
上一节的"混杂披露"补成了纯净对照:给基线树 `cov-base` @ `da9a5cb6` 配它**自己的** `.env` + `prisma generate`
|
||
+ `npm run db:seed`(38 条内容条目),再跑同样 8 个 spec × chromium。
|
||
|
||
| 对照 | 代码 / 数据 | 结果 |
|
||
|---|---|---|
|
||
| 第一次(混杂) | 旧代码 `da9a5cb6` + **本批的新 dev.db** | 163 passed / **7 failed**(全在导航类锚点:`mobile.spec.ts:45/61`、`p2:99/132`、`user-journey:56/200`、`website-acceptance:139`) |
|
||
| 纯净对照 | 旧代码 `da9a5cb6` + **旧代码自己 seed 的数据** | 162 passed / **8 failed**,且 8 条**全是** `mobile-accessibility.spec.ts:41` 的 axe-core 扫描(8 个 URL × 1.0m) |
|
||
| 本批 | `0da1fa42` + 本批数据 | 1032 passed / **36 failed** / 44 skipped(4 project 全量) |
|
||
|
||
⇒ **定性翻转**(这才是这节真正的产出):
|
||
|
||
1. **那 7 条导航类红不是基线既有红**,而是"旧代码遇到新数据"的错配产物 —— 它们在纯净基线上是绿的,
|
||
在本批上红 ⇒ **本批引入的 spec 未重锚**(§11 把一级导航改成 行业/能力/洞察/关于我们,
|
||
当时只重锚了 `nav-dropdown`/`p6-missing-paths`/`uj-11`/`p2`/`p5`/`user-journey:216` 六处,
|
||
`mobile.spec.ts`、`p2-functional-e2e.spec.ts:99/132`、`user-journey.spec.ts:56/200`、`website-acceptance.spec.ts:139` 被漏掉)。
|
||
2. **`mobile-accessibility.spec.ts:41` 的 axe 扫描 8 条是既有红**(纯净基线同样红)⇒ 不属本批,但也在 dev 上红。
|
||
3. 其余在本批红、在纯净基线**不红**的,全部落入"本批引入":`p1-brand-visual-audit.spec.ts:579`
|
||
(证言/案例区不可见 ⇒ 与 DEC-N4 门槛的作用面重合,必须重测,不接受"应该无关")、
|
||
`p4-performance-a11y.spec.ts:338/396`(ARIA 与焦点可见)、
|
||
`mobile-accessibility.spec.ts:76` 与 `mobile-performance.spec.ts:287`(触摸目标 AA 2.5.8 ≥24px 硬门禁)、
|
||
`user-journey.spec.ts:562/773/854`(UJ-03/06/07 `@admin`,失败仅 ~170ms ⇒ 疑登录/权限,含 DEC-N5 的 admin 路由改动可能)。
|
||
|
||
⇒ 另记一条仪器事实:**同一份旧代码,配不同数据,红项集合完全不同**。
|
||
所以「基线也有红」这句话必须以「基线代码 + 基线数据」的成对状态来证,否则会把**自己引入的回归读成既有状态**
|
||
——我上一条正是这样读反了,方向还是保守的那一侧(把新红当成旧红),这类错误比反向更难被发现。
|
||
|
||
**下一步(本批不做,作为修复 PR 的验收条件,已在 §14 待办里)**:
|
||
按 (1)(3) 两组逐条修根因 —— 漏锚的 spec 按 §11.3 同一手法以实测 DOM 重锚;
|
||
`p1:579`、`p4:338/396`、触摸目标两条与 `@admin` 三条必须先复现再定性(产品缺陷还是测试口径),
|
||
不允许用放宽断言或加 retry 换绿。(2) 的 axe 既有红另案。
|
||
|
||
### 14.2 逐条修完后:36 → 4 → 终跑,并把「测试自己的竞态」与「产品缺陷」分开处理
|
||
|
||
按 §14.1 的定性逐条动手,全部有复算读数:
|
||
|
||
| 类别 | 处置 | 读数 |
|
||
|---|---|---|
|
||
| 产品侧真缺陷 | `detail-trust-section` 渲染绕过门槛(fail-open)⇒ 改回 `publishableCases.map` | 变异验证:回退 ⇒ 2 条精确转红、1 条仍绿;恢复 ⇒ 35 例 EXIT=0 |
|
||
| 产品侧 a11y | 4 个文字链接触摸目标 23px < 24px(WCAG 2.5.8)⇒ 走 `min-h-6` 间距刻度;能力面板 `role="region"` 缺可访问名 ⇒ 补 `aria-label` | 触摸目标两 spec × 4 project 复跑通过;`p1/p4/p2/website-acceptance` 定点跑 chromium 81 passed |
|
||
| 限流真因 | 登录是**进程内内存桶** 10 次/15 分钟/IP,dev server 跨整轮存活 ⇒ `@admin` 旅程第 11 次登录起必得 429(这就是「单跑绿、全量红」)。额度改为可按环境覆盖,**默认仍 10**(生产姿态一字未动),只在 e2e harness 抬到 500 | `route.test.ts` 双向用例:未设 ⇒ 10;设 3 ⇒ 第 4 次判限流。9 例 EXIT=0 |
|
||
| 测试锚点过期 | `mobile.spec:45`、`website-acceptance:139` 按真源 `navigation.ts` 重锚(一级只剩 行业/能力/洞察/关于我们;联系入口是 `consult-button` 而非导航项) | `website-acceptance` × 4 project 连跑两次各 56 passed |
|
||
| 引擎行为 | `p4:403 焦点管理`:webkit / chromium-mobile 上 Tab 不落到链接(Safari 系需系统级「Press Tab to highlight each item」)。我先前试 `bringToFront` + 点空白**没有用** —— 假设被自己的读数否掉;改为同契约按引擎取证(chromium 走真实键盘,其余显式 focus 跳转链接),断言一条不减 | 2 passed(chromium-mobile + webkit) |
|
||
| **测试自身的竞态** | `pollBoundingBox` 先 `expect.poll` 等到非空、**再单独读一次** boundingBox ⇒ hydration 亚 60ms 的重挂会让第二次读取返回 null,被误报成「元素在断言瞬间消失」。改成在同一次读取里既判非空又产出值 | 探针 `docs/acceptance/2026-10-17-final/probe-logo.mjs` 实测:加载期**无双字标可见窗口**(0 次),唯一零可见是 t≈43ms header 尚未进 DOM ⇒ 产品不闪烁,问题在辅助函数 |
|
||
|
||
⇒ 判据强度核对:以上没有一处是"放宽断言/加 retry/删用例"。两处改了测法(焦点、boundingBox 取值)
|
||
都是**把两次读取合成一次**或**换等价但跨引擎可靠的手段**,几何与非空断言原样保留。
|
||
|
||
终跑(4 project 全量功能 E2E)读数随本节的收尾笔登记。
|
||
|
||
### 14.3 修完之后:干净全量跑的红项集合每轮不同 ⇒ 登记为**残差超时抖动**,不洗成通过
|
||
|
||
三次**干净**全量功能 E2E(4 project、`--workers=4`、跑时不并发任何重命令):
|
||
|
||
| 轮 | 结果 | 红项集合 |
|
||
|---|---|---|
|
||
| `final5` | 1067 passed / **1 failed** / 44 skipped (15.1m) | `nav-keyboard.spec.ts:56`(键盘) |
|
||
| `final6` | 1065 passed / **3 failed** / 44 skipped (13.6m) | `p2-functional-e2e:136`(chromium-mobile + firefox)、`uj-08:54`(firefox)、`user-journey:419 UJ-10`(firefox)——**与上一轮不重合** |
|
||
| 另加一次被我自己污染的跑 | 1062 / 6 failed | 我在跑的同时并发了两次 tsc,负载是我的错,读数不作数 |
|
||
|
||
**逐条核对**:这些红项全部是 18–25s 的超时类,且**隔离复跑各自绿** ——
|
||
`p2:136 Logo点击返回首页`(firefox + chromium-mobile)隔离 **2 passed**、
|
||
`nav-keyboard` 修复后隔离 **12 passed / 加载下 68 passed / 变异回界 1 时判红**、
|
||
`website-acceptance` × 4 project 连跑两次各 **56 passed**。⇒ 定性为**并行墙钟抖动**
|
||
(firefox 与 chromium-mobile 是慢引擎,4 workers 下首个冷导航最吃 CPU),不是逻辑缺陷。
|
||
|
||
**为什么"能过"不等于"已过"**:本地默认 `retries: CI ? 2 : 0` 且 `workers: CI ? 1 : undefined`
|
||
(`playwright.config.ts:12-15`)⇒ CI 侧有两次重试 + 单 worker 兜这类抖动;本地全并行没有。
|
||
口径定为:**不以"隔离能绿"为由关掉断言**,也**不把这类残差写成"全量通过"**。
|
||
`PR-DESCRIPTION.md` 里 `npm run test` 一项因此**继续保持未勾选**,
|
||
写清「已把 36 → 1~3,残差为并行墙钟、CI 口径覆盖,本地要稳定绿请 `--workers=1`」。
|
||
|
||
真正修掉的(不是掩盖):`detail-trust-section` 的 fail-open、4 个触摸目标 23px、
|
||
`role="region"` 缺名、登录限流在测试下的结构性 429、两条过期导航锚点、
|
||
webkit/mobile 的 Tab 引擎差异取证法、`pollBoundingBox` 的二次读取竞态、
|
||
`nav-keyboard` 押死 Tab 次数(改为有界键盘行走,界内到不了即失败,变异回界 1 次立刻判红)。
|
||
|
||
### 14.4 数据层自伤(跨 worktree 的绝对 DATABASE_URL)与两处「真根因」的修复
|
||
|
||
**a) 事故与它污染了多少读数**
|
||
为做基线对照,我把本 worktree 的 `.env` 拷进另一棵 worktree(`cov-base`)。而
|
||
`DATABASE_URL="file:/…/ui-grammar-two-axis/prisma/dev.db"` 是**绝对路径** ⇒ 那棵**旧代码**的树跑
|
||
`npm run db:seed` 时,顺着绝对路径把**我这棵树**的 dev.db 整库覆盖成旧 IA(7 项导航)数据。
|
||
后果链:①服务端每请求打「CMS 导航配置不合格,已退回代码真源」;②**§14.3 的残差读数全部作废**
|
||
(它们跑在被污染的数据上);③我据此一度判「AUTH-NAV 需重开」——判断的起点是自造脏数据。
|
||
主检出的库与它自己的旧代码是自洽的(旧 IA ↔ 旧代码),**没有伤到另一条在途会话**。
|
||
|
||
**b) 修法:把事故变成机器防线**
|
||
`src/lib/seed-target.ts` 的纯函数 `checkSeedTarget(url, repoRoot, allowExternal)`:
|
||
目标库不在本树内 ⇒ **写之前**中止;非 `file:` 协议同样要求显式放行;
|
||
生产容器 seed(`file:/app/data/prod.db` 在仓库根之外)按显式 `SEED_ALLOW_EXTERNAL_DB=1` 走。
|
||
`prisma/seed.ts` 在 `main()` 最先处调用并打印实际目标库。
|
||
8 例判据 + **活体负对照**:`DATABASE_URL=file:/tmp/outside-sandbox.db` 跑 seed ⇒ EXIT=1,
|
||
且 `/tmp/outside-sandbox.db` 未被创建。数据已重新 seed 修复,回退日志从「每次」变 **0 次**。
|
||
⚠ 自伤一笔:该守卫的测试最初放在 `prisma/` 下,`jest roots=['src']` 根本不收集(读数
|
||
`Pattern: prisma/seed-target - 0 matches`)——**一个不被跑的守卫比没有守卫更危险**,已搬进 `src/lib`。
|
||
|
||
**c) 两处「真根因」(不记成墙钟抖动)**
|
||
1. **联系表单限流与登录同族**:`/api/contact` 也是 5 次/小时/IP 的进程内桶 ⇒ 全量跑里多次提交必然 429。
|
||
抽出 `src/lib/rate-limit-config.ts` 的 `readRateLimitMax`(未设⇒默认;非法⇒默认**且 warn**;合法⇒取整),
|
||
login/contact 都改用它;**默认值 10/5 均未动**,只在 e2e harness 抬到 500/200。
|
||
2. **`website-acceptance`「导航菜单功能正常」点击错位**:日志实取 `navigated to "/"`
|
||
⇒ 点击落在了 logo 上。缺 `expectHydrated(nav)`(相邻用例早有、这条漏了)+ 选择器
|
||
`a[href^="/"]` 把 logo 也算进来。两处都修,**连跑 5/5 绿**(4.7s,此前 15s 超时)。
|
||
同时 `uj-08` 的 helper 命中的是工具行那条 `/services`(不是面板入口),且面板正播 280ms 动画
|
||
⇒ `not stable` 重试到 15s;改语义锚点「查看全部能力」+ 等 320ms 并断言其 href。
|
||
|
||
### 14.5 收口:全量功能 E2E **1068 passed / 0 failed / 44 skipped(EXIT=0)**
|
||
|
||
§14.3 曾把 1~3 条超时记为「并行墙钟残差」,并说 CI 的 retries 兜住。**那个解释是错的**——
|
||
继续按「能复现就查根因」推进后发现,它们各自有真因,修完即 **0**:
|
||
|
||
| 曾记为"残差"的项 | 真因 | 修法 |
|
||
|---|---|---|
|
||
| `website-acceptance` 导航菜单功能正常(firefox/webkit 15s) | 日志实取 `navigated to "/"` ⇒ 点击命中了 logo;缺 `expectHydrated` + 选择器把 logo 算进菜单 | 补 hydration 前置 + 选择器排除 `href="/"`;**连跑 5/5 绿**(4.7s) |
|
||
| `p2:136` Logo点击返回首页(webkit 17.7s) | 同一根因:可见 ≠ 可交互,hydration 窗口内的 click 被丢弃 | 补 `expectHydrated`;**4 project × 3 轮 12/12 绿** |
|
||
| `p2:431` 表单必填验证 / 多次提交类 | `/api/contact` 5 次/小时/IP 的**进程内**桶,全量跑里必然 429 | 额度可按环境覆盖(默认 5 不动),e2e harness 抬到 200;`readRateLimitMax` 3 例判据 |
|
||
| `@admin` 三条(UJ-03/06/07) | 登录 10 次/15 分钟/IP,同族 | 同上(默认 10 不动,harness 500) |
|
||
| `uj-08`(firefox 隔离也红) | helper hover 命中工具行的 `/services` 链接,且面板正播 280ms 动画 ⇒ `not stable` 到 15s | 语义锚点「查看全部能力」+ 等 320ms + 断言其 href |
|
||
|
||
⇒ 口径修正(这条比数字重要):**「隔离能绿 + 集合每轮不同」不足以判为墙钟抖动**。
|
||
这次每一个都被"把报错读到具体那一行"推翻了。以后遇到同类,先做两件事:
|
||
①读完整报错(是 goto 超时还是 expect 失败、naviaged to 哪里);②找同文件里**已经修过同类**的用例,
|
||
把它的前置(如 `expectHydrated`)当成约定补上。
|
||
|
||
**最终读数**:`npm run test:functional`(4 project,默认 workers)⇒
|
||
**1068 passed / 0 failed / 44 skipped,EXIT=0,13.1m**。
|
||
§14.3 的残差表就此作废,仅作为"我一度把真 bug 当抖动"的留痕。
|
||
|
||
### 14.6 内容漂移会让视觉基线失效——这次不是样式,是 seed 恢复了 /contact 的两段文案
|
||
|
||
终版产物门禁(BUILD 0 / axe 0 / Lighthouse 0)之后,视觉只读复跑 **6 failed**:
|
||
`/contact` 全页 ×5 project + `input` 1 张。逐项核对不是样式回归:
|
||
|
||
| 证据 | 读数 |
|
||
|---|---|
|
||
| 重新 seed 前后的 `contact-page` 行 | 从 785 → 792 字节,差异 2 个键:`heroDescription`("快速响应…" → "回复您的咨询…")与 `commitmentItems[0]`("快速响应您的咨询" → "回复您的咨询") |
|
||
| 基线是哪份内容上采的 | 02:18 那次重采跑在**被污染的旧内容**上(旧库),而 21:28 的重新 seed 恢复了 seed 版本 ⇒ 图文高度/换行变化,全页截图必红 |
|
||
|
||
处置:重采这 6 张(AUTH-VISUAL 的授权范围),再只读复验;并把这条口径写死:
|
||
**视觉基线与"seed 内容"耦合** —— 重跑 `db:seed` 或改 CMS 文案后,内容型基线会失效,
|
||
必须按"内容变更 ⇒ 重采 + 只读复验"处理,不能把它读成样式回归。反过来,
|
||
将来若看到只有 `/contact`、`/news` 这类内容页整页红而组件裁图全绿,先查数据而不是查 CSS。
|