docs(grammar): 落 ADR-0008 并改掉说谎的那一方,含四条经验教训与台账 §11

对标实测证伪了 ADR-0004 的两条视觉判据,所以本笔的主体是**改文档**:
判据错在文档里,而不是错在代码里,不一起改就是文档变成说谎的那一方。

新增 `docs/adr/0008-benchmark-grammar-takeover.md`(取证方法、实测对照表、
四项裁定、已知偏差 6 条、验证契约):
- Bain 走 archive.org 快照 2026-08-31(1600×846)绕开 Cloudflare,
  Porsche 取 live 国际站 + 中国站导航,逐元素 `getComputedStyle`。
- **被证伪 ①**(决策四)「关键数字 = 超大字号 + 品牌色」:
  Bain 成果数字实测 **40px / 字重 500 / 纯黑**;
  本仓 `--font-size-5xl: 2.25rem` 在桌面根字号 18px 下 = 40.5px ⇒ 现档正好命中,零新增令牌。
- **被证伪 ②**(决策一)「4px 色条为辅」:两家**都不用颜色给内容分类**,
  饱和红用作"面"的次数为 **0**(Bain #CC0000 出现 65 次全是字与线,
  Porsche 红出现 4 次全是按钮)。
  ADR-0004 决策一、决策四两处就地加 ⚠️ 修订块并指向 ADR-0008。
  ADR 不重写历史,但必须让读者不会把已废判据当现状。

`DESIGN.md`:front-matter 的 `rounded:` 改成 0–4px 记档 + 新增 `cta: "0px"`;
`components.cta-*/badge-pill/card-bain/input-field` 的 `rounded` 从
  `{rounded.full}` 改 `{rounded.cta}` 或 `{rounded.md}`,
padding 按实测 `14px 28px`;Elevation 段删掉「hover 升至 card-shadow-hover + translateY(-4px)」;
数据条段把「font-black + 品牌红」改为「text-5xl / 500 / text-ink」并注明是被实测推翻的那条;
Navigation 段写入双轴与「真源是代码、CMS 行须满足 IA 契约才采纳」。

`CONTEXT.md` 关键决策表 +9 行:对标双轴导航 / 导航真源=代码 / 视觉语法记档 /
僵尸令牌 / 彩色编码适用面 / 成果槽 ResultsSlot / 替代信号槽 / 承诺单一真源 /
「注释写在 JSX children 位 = 页面文字」。

`docs/development/quality-gates.md`:
- §1 的 lint warning **权威计数就地更新**:本树 `EXIT=0 / 0 error / 81 warning`,
  分项相加必须等于总数(55+12+8+4+1+1 = 81 ✓),
  并给出与 2026-09-23 那 104 条的逐项对账(`no-explicit-any` 25→4 等,净 −23 ✓)。
  归因**已实证到文件**而不是只看方向一致:逐个 `git show da9a5cb6:<被删文件>` 数出
  33 处 `any` 命中(v15.test 12 / NewsDetailClient.test 8 / v15 4 / …),
  并说明命中数 ≠ 告警数的差额来源,附可复算命令。
- §5.1 `check:motion` 现状 23 处 → **8 处 / 4 文件**,
  并写明残留 8 处全部经 `git show` 自证为基线 `da9a5cb6` 既有红、非本轮引入。
- 新增 §5.2 记录 `check:visual`(R1–R11 每条的分母口径与两条闸的**适用边界**),
  §7 的 `test:all` 组成改为八段并注明自证先跑。
- 另记一条:这条计数一度被读成 0 error,是因为管道吞掉了 EXIT=1(见 §5.38)。

`docs/lessons-learned.md` 四条(§5.38–§5.41)+ 更新记录 4 行:
管道吞退出码复犯 / 合法 JSX 的注释渲染成页面文字而三道门禁全绿 /
仪器只在被复用时才坏(module 层累加器 + 互斥前提塞进同一份夹具)/
僵尸令牌(删了值没删引用,R5 与 R7 各看一侧所以两条都绿)。

`docs/acceptance/qa-tracker.md` §11:四台仪器表(每台的可失败证据)、
本轮 5 条缺陷与根因、6 个 spec 的重锚对照表、
新登记 4 条待拍(DEC-N1 彩色编码第二通道 / N2 stagger 默认值 /
N3 motion 残留 8 处 / N4 既有案例区无门槛)+ 2 条待授权(AUTH-VISUAL / AUTH-NAV)。

`config/test/lighthouserc.json`:URL 集补 `/insights`(新的一级轴)与
`/solutions/manufacturing`(本批 tracer-bullet 承载页)——
不补就是新页没有任何 Lighthouse 覆盖。

`README.md`:加本批进度条目,并把「check:motion 仍 23 处」的旧数改为指向
quality-gates §5.1 的现取口径。

探针 7 份入库 `docs/acceptance/2026-10-17-ia-e2e/`(导航结构 / 面板链接 /
首页 testid 与文案 / 段序文档坐标 / 页脚入口),是本批所有 E2E 断言的取证来源。

本笔纯文档 + 配置,不改运行时代码;同树已跑过的验证仍成立:
`npm run test:all` EXIT=0、`type-check` EXIT=0、`lint` EXIT=0(0/81)、
`test:unit` 141 套件 / 1747 例、`check:visual` 11/11 + accents 成立、`build` EXIT=0。
This commit is contained in:
zhangxiang committed 2026-10-17 01:08:45 +08:00
1 parent ec543ff242
commit f23500ff07
18 files changed
+522 -29

No files matched your search

+9
View File
@@ -206,6 +206,15 @@ Novalon 的 6 个核心产品,互为互补关系,常以组合形式出现在
| lint warning 的处置口径:**0 error 判门禁,warning 不判红也不清零** | 现行裁定:`npm run lint` 通过标准是 **0 error**;warning 属**已知存量**并只登记分布、不阻塞合入(数量口径的**版本库内权威记录位**是 `docs/development/quality-gates.md` §1:2026-09-23 **第二周期**最终树复跑 `npm run lint` ⇒ **104 problems / 0 errors / EXIT=0**,分项 55 `no-console` + 25 `no-explicit-any` + **11** `set-state-in-effect` + 10 `no-img-element` + 各 1 `no-sync-scripts`/`no-html-link-for-pages`/死抑制(同日第一周期为 105,差值唯一来自后台编辑器"挂载期消费守卫"那个效果被删)。⚠ 不要再指向 `AGENTS.md` §5——该文件被 `.gitignore` 有意排除、由 `next dev` 再生,不可审也不可回滚,见验收 N-16)。分级由 `eslint.config.mjs` 声明而非随手 `--fix`:`@typescript-eslint/no-explicit-any`(`:52`)、`no-console`(`:54`,`allow: ['warn','error']`)、`react-hooks/set-state-in-effect`(`:61`)为 `warn`;`react/no-unescaped-entities`、`eqeqeq`、`prefer-const` 等是 `error`。按路径降档只有三处 override(`e2e/**/*.ts` 关 `no-console`、`**/*.test.{ts,tsx}` 与 `**/__tests__/**` 关 `no-explicit-any`、`tests/performance/*.js`),**`prisma/seed.ts` 不在其中**——它的进度日志是"有意容忍的 warning",不是配置豁免。**禁止的处置方式**:为凑绿把规则调成 `off`、加行内 `eslint-disable` 而不写理由、把 `Unused eslint-disable directive`(死抑制)当噪声忽略——死抑制本身按 §「门禁断言的有效性口径」第 1 条归入"什么都没测"。需要静音时须附来源注释 | ✅ 2026-09-23 确认(warning 存量制,error 零容忍)|
| `duration-300` → 动效令牌 与 死样式收口:**本轮为 in flight,不得当作已完成** | 两条已知残留:①`duration-300` 一类 Tailwind 预设时长绕过 `--transition-fast/normal/slow`(`globals.css:255-258` 的 180/280/450/700ms)且 300ms 超出动效四原则「入场 180–280ms」的档位;②`-[var(--color-*)]/<alpha>` 静默不产出 CSS 的家族(见上方 §5.20 与「死样式族的收口边界」行)。**2026-09-23 文档同步时不写结论**:另一执行体正在同一批 `src/**/*.tsx` 上作业(写入瞬间 `src` 下 `duration-300` 命中 13 处、死样式族命中 8 处,均在实时变动中),任何计数此刻都不可引用。**约束(替换时才成立)**:动效时长走令牌、点亮死样式属设计判断、hover 合成底色须重算对比度(axe 与 `check:contrast` 都测不到 `:hover`)。复算命令:`grep -rn "duration-300" src` 与 `grep -rno "\-\[var(--color-[a-z-]*)\]/[0-9]*" src` | ⏳ in flight(2026-09-23 观察:他人正在编辑相关文件;未落地,不作为已确认决策引用)|
| E2E 目标与 skipped 口径 / `check:axe*` 的落地状态(2026-09-23) | ①**口径**:`npm run test`(含 `test:all` 里的 `test:e2e:fast`)的 webServer 是 `npm run dev`(`e2e/playwright.config.ts:130`),GA4 的 4 个 `@critical` 用例 × 4 project = **16 个 skipped**(`.env.production` 独占 GA ID → dev 下不注入 gtag → 用例内 `test.skip`);产物口径只有 `npm run test:e2e:prod`(CI 在 `Jenkinsfile`「🌐 E2E 测试」仅 main 分支执行,且须先 build)。裁定:**引用 GA4/生产头覆盖必须指名 prod 目标**,"全绿"不等于"全断言"。②**静态 a11y 门禁已成型**:`check:a11y` = `check:contrast` + `check:headings` + `check:brand-token`,并已并入 `test:all`。③**已闭合(2026-09-23 同日落地)**:`package.json` 的 `check:axe` / `check:axe:routes` 指向的 `scripts/accessibility/{axe-node-count,crawl-routes}.mjs` 现已存在(由 `docs/acceptance/2026-09-21-axe/` 的一次性 harness 平移而来,最终树 34 路由 × 4 组合 `passed=true`,证据 JSON 仍留原目录),判定改为退出码(0 通过 / 1 判红 / 2 清单缺失或 0 条),并由 `Jenkinsfile`「♿♿ 全站 axe 节点计数」阶段(仅 main,服务用 `node dist/standalone/server.js`,按记录 PID 收服)自动执行 —— axe 节点计数自此**是**自动化门禁;引用其结果时须同时给出 `axe-evidence.json` 的 `routeCount` 与分母断言,只报 `passed=true` 不报分母即为口径错误。④文档同步另纠正三处:`npm run preview` 实为 `next start -p 3000`(非 `npx serve`,standalone 下会打警告)、渲染模式措辞由「静态导出」改「standalone 混合渲染」、`docs/testing.md` 的 dev 指示器机制改回 `e2e/fixtures.ts` 的真实实现 | ✅ 2026-09-23 确认(③已于同日落地为常驻门禁,④为该轮文档纠正;③的漂移记录见 `docs/lessons-learned.md` §5.26,其修复标注在同一行)|
| **对标双轴导航**(行业 × 能力 + 洞察) | 一级导航 `NAVIGATION_V2` 恰为 **行业 `/solutions` · 能力 `/services` · 洞察 `/insights` · 关于我们 `/about`**;「产品」**退出一级**,入口降为能力面板里的「产品矩阵总览 → `/products`」(`all-products`)。术语映射:行业 = 旧「解决方案」轴(路由不变)、能力 = 旧「服务」轴(**只做改名,不新增 `/capabilities`** —— 新增会与 `/services` 构成两个规范源)。判据:`e2e/nav-dropdown.spec.ts` 断言触发器文本恰为三轴且「产品」不得回到一级 | ✅ 2026-10-17(ADR-0008 决策二)|
| **导航真源 = 代码,不是 DB 行** | 反转原「CMS 行覆盖代码」的优先级:`resolveNavigation(cmsData)` 只有当 CMS `navigation` 行满足 **IA 契约**(`industries` / `capabilities` / `insights` 三个 mega key 齐备)时才采纳,否则 **fail closed** 回代码常量。契约检查要三维齐备而非只看自洽 —— 实测复现过「一条**自洽的旧行**」让页脚各列静默变空。`injectStandaloneProducts` 按 **group id** 匹配而非 key | ✅ 2026-10-17(`src/lib/navigation-resolution.ts`)|
| **视觉语法记档**(借语法不借色相) | 对标实测形状语法:`--radius-xs/sm = 0`、`md/lg = 2px`、`xl/2xl/3xl = 4px`、新增 `--radius-cta = 0`;**`--radius-full` 必须保持 9999px**(承载 avatar/switch/slider/radio/progress/scroll-area 的功能性真圆,归零即方角化后台所有旋钮);彩色阴影 `--shadow-brand/-brand-hover/-glow` 退役;`.bain-card:hover` 只改 hairline 不抬升。色相保留自有 `#C41E3A` 朱砂与朱砂条 | ✅ 2026-10-17(ADR-0008 决策一,`npm run check:grammar` R1–R11 强制)|
| **僵尸令牌**(tailwind 映射悬空) | 定义:CSS 声明已退役而 `tailwind.config.js` 仍映射该 `var(--*)` ⇒ 类名照生成、运行时静默展开成空值,不报错不判红。与「令牌孪生」同族:**删了值但没删引用**。守卫 = `check:grammar` R11(外部所有者变量按名豁免,且**豁免腐化亦判红**)| ✅ 2026-10-17(`docs/lessons-learned.md` §5.41)|
| **彩色编码的适用面**(accent 降级 ≠ 删除) | `--color-accent-*` 7 枚仅供 (i) 图表/序列、(ii) 后台工具 UI 的分类色标;**营销面禁用**(`check:accents` 判红)。这是 ADR-0004 决策一「色条为辅」的实测修订:两家对标**都不用颜色给内容分类**,而本仓 7 枚令牌实际只换来一处 `accent-blue`。⚠ 该闸口径**仅类名通道**;`hero-themes.ts` 的 `accentColor` 内联样式通道未被覆盖(实测 11 主题里 7 个非品牌色相仍在详情页 hero),待设计裁定(qa-tracker §11.4 DEC-N1)| ✅ 2026-10-17(ADR-0008 决策一修订段)|
| **成果槽 / ResultsSlot**(可判别空态) | 首页与详情页 L3「客户成果」位的统一承载。状态是**可判别联合**(`ready` / `co-creation` / `authorized-pending`)而非「有没有数据」的布尔,验收时能区分「没有案例」与「案例被门槛拦下」。反伪造不变量 `casePublishBlockers()`:`verified === true` + 证言有作者 + ≥1 个 `basis === 'verified'` 的指标 + 不命中禁词,四者齐备才判可发布;不齐则降级为 `results-slot-blocked` 占位并 `console.error`,**不在渲染期 throw** | ✅ 2026-10-17(`src/components/sections/results-slot.tsx`)|
| **替代信号槽 / L3SignalsSlot** | 真实案例/认证需客户授权才能公开,在那之前 L3 不得整段消失(信任真空)。四条替代信号全部指向站内**真实路由**(方法论 / 团队 / 发展历程 / 联系),零编造;服务承诺卡在业务确认前显示「待业务确认」且不可点击 | ✅ 2026-10-17(`src/components/detail/l3-signals-slot.tsx`)|
| **承诺单一真源**(commitments) | 一个 `about` 只留一条承诺,散落的 SLA 文案改由 `src/lib/constants/commitments.ts` 派生。历史上存在四条互斥 SLA(`<4小时` / `7×24` / `48小时` / `工作日 2 小时`)+ 一条形似项;现仅保留有授权口径的「工作日 2 小时内回复您的咨询」(basis = target),其余退役 | ✅ 2026-10-17(`src/lib/constants/commitments.ts`)|
| **`/* */` 写在 JSX children 位 = 页面文字** | 合法 JSX,`type-check` / 1747 例单测 / `npm run build` 全绿也不会拦,唯一静态防线是 ESLint `react/jsx-no-comment-textnodes`(error)。⇒ 注释要么进 `{/* */}`,要么移到 JSX 之外;新增此类守卫必须配**敏感性证明**(先断言被污染那段 DOM 真渲染了,再变异确认只有这一条转红)| ✅ 2026-10-17(`docs/lessons-learned.md` §5.39)|
#### 门禁断言的有效性口径(chain6/chain7 新增)
+75 -25
View File
@@ -54,12 +54,14 @@ typography:
fontWeight: 400
letterSpacing: "0.2em"
rounded:
xs: "3px"
sm: "6px"
md: "8px"
lg: "12px"
xl: "18px"
2xl: "24px"
xs: "0px"
sm: "0px"
md: "2px"
lg: "2px"
xl: "4px"
2xl: "4px"
3xl: "4px"
cta: "0px"
full: "9999px"
spacing:
xs: "4px"
@@ -75,22 +77,25 @@ spacing:
components:
cta-primary:
backgroundColor: "{colors.cinnabar}"
textColor: "{colors.paper}"
rounded: "{rounded.full}"
padding: "16px 40px"
textColor: "#FFFFFF"
rounded: "{rounded.cta}"
padding: "14px 28px"
cta-primary-hover:
backgroundColor: "{colors.cinnabar-deep}"
cta-secondary:
backgroundColor: "{colors.paper}"
textColor: "{colors.ink}"
rounded: "{rounded.full}"
padding: "16px 40px"
border: "1px {colors.border-rule}"
rounded: "{rounded.cta}"
padding: "14px 28px"
cta-dark:
textColor: "#F8FAFC"
rounded: "{rounded.full}"
padding: "16px 40px"
rounded: "{rounded.cta}"
padding: "14px 28px"
card-bain:
backgroundColor: "{colors.paper}"
rounded: "{rounded.lg}"
rounded: "{rounded.md}"
border: "1px hairline → hover {colors.border-rule}(不抬升、不加阴影)"
padding: "24px"
input-field:
backgroundColor: "{colors.paper}"
@@ -99,7 +104,7 @@ components:
badge-pill:
backgroundColor: "{colors.cinnabar-blush}"
textColor: "{colors.cinnabar}"
rounded: "{rounded.full}"
rounded: "{rounded.cta}"
---
# Design System: Novalon Website
@@ -188,7 +193,12 @@ Novalon 的界面是一份可以逐条审计的经营宣言。它模仿顶级咨
## Elevation & Depth
分层靠「几乎看不见的边框 + 真实柔和的阴影」完成:`--color-border-primary` 被刻意软化到 #EEF2F7,卡片默认 `--shadow-sm`/card-shadow 贴地,hover 升至 `--card-shadow-hover` 并 translateY(-4px)。阴影全部从墨色 rgba(10,14,20,α) 取用,不用纯黑。
分层靠「几乎看不见的边框 + 真实柔和的阴影」完成:`--color-border-primary` 被刻意软化,卡片默认 `--shadow-sm`/card-shadow 贴地。
**hover 不再抬升**(2026-10-17 起,见 [ADR-0008](docs/adr/0008-benchmark-grammar-takeover.md)):
`--card-shadow-hover` 已退役,`.bain-card:hover` 只做「边框转 `border-rule` + 底色转 `bg-secondary`」,
`translateY(-4px)` 一并删除 —— 对标实测两家 hover 只改 hairline,没有位移与阴影增长。
存量 `hover:-translate-y` 28 处 / 19 文件由 `check:grammar` 的 R10 递减棘轮登记,只降不升。
阴影全部从**暖墨色** rgba(20,18,16,α) 取用(原 rgba(10,14,20,α) 冷 slate 与暖纸底不同族,16 处已统一),不用纯黑。
### Shadow Vocabulary
- **xs–xl 层级带** (`0 1px 1px α0.03` → `0 24px 56px α0.1`): 微边界 → 卡片 → 下拉 → 模态 → 全屏浮层。
@@ -200,29 +210,69 @@ Novalon 的界面是一份可以逐条审计的经营宣言。它模仿顶级咨
## Shapes
柔边体系:徽章/焦点元素 3px、按钮/输入 6px、卡片/弹窗 8px、大卡 12px(`--card-border-radius`)、英雄卡 18px、全屏弹窗 24px;CTA 与 badge 一律全圆角 pill。特色几何:区块顶/底 0.5–2px 朱砂条带、`corner-frame` L 形角框(16px 红色直角)、`clip-slant` 斜切(Accenture 遗产,仅装饰带使用)。卡片在 1px 淡边框与阴影之间只声明一次 elevation(边框为 hairline 级)。
**直角体系(2026-10-17 起,见 [ADR-0008](docs/adr/0008-benchmark-grammar-takeover.md))**:
`--radius-xs/sm = 0px`、`--radius-md/lg = 2px`(卡片)、`--radius-xl/2xl/3xl = 4px`、
`--radius-cta = 0px`(CTA 与 badge 专用)。**CTA 不再是 pill** —— 对标实测
Bain 与 Porsche Consulting 抽样元素 `border-radius` 全部为 0,`rounded-full` 是本仓自造语法。
⚠ **`--radius-full` 保持 9999px,不可归零**:它承载的是**功能性的圆**
(`avatar` `switch` `slider` `radio-group` `progress` `scroll-area` 骨架屏 pulse 点)。
把它一并归零会把后台与所有 Radix 表面的旋钮、滑块、头像全部方角化。
由 `check:grammar` 的 R2 正向守卫 + R9 双向判据守住这条线。
装饰性圆形(如套件组合图的中心节点)改用 `rounded-cta` 方角牌。
特色几何:区块顶/底 0.5–2px 朱砂条带、`corner-frame` L 形角框(16px 红色直角)、
`clip-slant` 斜切(Accenture 遗产,仅装饰带使用)。卡片在 1px 淡边框与阴影之间只声明一次
elevation(边框为 hairline 级)。
## Components
### Buttons(CTAButton,全站行动召唤)
- **Shape:** 全圆角 pill(rounded-full),内置 ArrowRight 箭头签名,hover 位移 translate-x。
- **Primary:** 朱砂填充 + 白字(16px 40px),hover 转 Cinnabar Deep;**Secondary:** 墨色 20% 描边透明底;**Dark:** 深色区块专用浅描边;**Inline:** 透明小箭头文字链,用于卡内「了解更多」。
- 交互 Button(ui/button.tsx)另带 6 档 size 与 ripple,触控下限 44×44px。
- **Shape:** `rounded-cta`(0px,两轨一致);四档共用 `px-7 py-3.5 text-sm font-medium`。
**箭头只在 `inline` 轨**,实心/描边轨不内置 ArrowRight —— 对标实测两家按钮无图标签名。
- **Primary:** 朱砂填充 + 白字,hover 转 `bg-brand-hover`;
**Secondary:** 静止边框 `border-border-rule`(#8A8377,对卡底实测 3.75:1,不是 `ink/20`),
hover 转 `border-border-dark`;**Dark:** 深色区块专用浅描边;**Inline:** 透明小箭头文字链。
- 过渡统一 `transition-colors duration-hover`(150ms)—— 只有颜色变化,
因此不写 `transition-all`(那会把阴影/位移一起接进来)。
- 交互 Button(`ui/button.tsx`)另带 6 档 size 与 ripple;其**文字档改直角、
`icon` 档保持 `rounded-full`**(圆形图标钮是功能形状,由 R9 双向判据保护)。
### Cards / Containers(bain-card)
- **Corner Style:** 12px 柔边;**Background:** Paper;**Border:** 1px hairline;**Shadow:** card-shadow → hover 抬升 4px + card-shadow-hover;内边距 24px(大 40px)。
- **Corner Style:** 2px(`--radius-md`);**Background:** Paper;**Border:** 1px hairline;
**hover:** 边框转 `border-rule` + 底色转 `bg-secondary`,
**不抬升、不加阴影**(对标实测两家 hover 只改 hairline;
`--card-shadow-hover` / `--shadow-brand*` 已退役)。内边距 24px(大 40px)。
### Inputs / Fields
- Paper 底、hairline 描边、6px 圆角、44px 高;focus 转 `border-brand/50`;标签常驻(placeholder 仅作示例);错误文案内联于字段下。
- Paper 底、hairline 描边、直角、44px 高;focus 转 `border-brand/50`;标签常驻
(placeholder 仅作示例);错误文案内联于字段下。
### Navigation
- 白色 sticky 头部,active 项朱砂下划线;桌面 hover 展开 mega dropdown(分组 + 描述 + 状态 badge);移动端汉堡 + 底部 tab bar 双轨(在办:收敛为一套);skip-link 常驻。
- 白色 sticky 头部,active 项朱砂下划线;桌面 hover 展开 mega dropdown(分组 + 描述 + 状态 badge);
移动端汉堡 + 底部 tab bar 双轨;skip-link 常驻。
- **一级导航是「行业 × 能力 + 洞察」双轴**(ADR-0008 决策二):
`行业` → `/solutions`、`能力` → `/services`、`洞察` → `/insights`(新),
`产品` **退出一级**,其入口降为能力 mega 内第二层的 `all-products → /products`。
- **真源是代码常量** `NAVIGATION_V2` / `MEGA_DROPDOWN_DATA`;CMS `navigation` 行只在满足
IA 契约(三个必需 mega key 齐备)时才覆盖代码,否则 fail closed 回代码
(`src/lib/navigation-resolution.ts`)。反转的动机:实测复现出「一条自洽的旧行」
会让页脚各列静默变空。
### 数据条(Stats Strip)
- 3 项为宜:数字用 display 级 font-black + `tabular-nums` + 品牌红,label 用小灰字。这是「答案先行」的结构件,但仅在数据不被本页其它区域重复时放置(首页成果带、信任页 Hero);hub 页 Hero 的数据条因与下方网格逐字重复已移除。
- 3 项为宜:数字用 **`text-5xl` / 字重 500 / `text-ink`(纯黑)** + `tabular-nums`,label 用小灰字。
⚠ 原写「font-black + 品牌红」已被实测推翻:Bain 成果数字是 **40px / 500 / 纯黑**,
且两家饱和红**从不用作面**(`text-5xl` = `2.25rem` 在桌面根字号 18px 下正好 40.5px,零新增令牌)。
这是「答案先行」的结构件,但仅在数据不被本页其它区域重复时放置(首页成果带、信任页 Hero);
hub 页 Hero 的数据条因与下方网格逐字重复已移除。
- 每个数字必须带 `basis`(`target | team-history | verified`),量化项与定性项分列,
不拿定性句冒充数字。
### Badge / 状态签
- Pill,12% 软底或 blush 底 + 品牌/编码色文字 + 20% 同色描边;「内测中 / 敬请期待」等诚实状态以此呈现。
- **直角**(`--badge-radius: var(--radius-cta)`),12% 软底或 blush 底 + 品牌/编码色文字 + 20% 同色描边;
「内测中 / 敬请期待」等诚实状态以此呈现。
- ⚠ **状态签不再用 coding accent 上色**:`accent-*` 只可被图表/序列组件与后台工具 UI 的分类色标消费,
营销面出现即由 `npm run check:accents` 判红(ADR-0008 决策一修订)。
## Do's and Don'ts
+2 -1
View File
@@ -31,7 +31,7 @@
- [x] CMS 全覆盖:法律页、新闻、团队、案例、服务、方案、产品、独立产品、首页运营位(ContentZone)、RBAC/工作流/媒体/通知全部从 CMS 读取并启用 ISR(3600s)
- [x] CMS 管理后台:角色权限界面(`/admin/roles`)、内容模型 × 操作权限矩阵、super_admin 锁定
- [x] 全量测试体系:单元 **134 suites / 1697 例** / 功能 E2E **1080 例**(270 例 × chromium + chromium-mobile + firefox + webkit 四个 project)/ 视觉回归 **125 例**(25 例 × 桌面·平板·移动·firefox·webkit 五个 project)/ 用户旅程 UJ-01~UJ-11 / Lighthouse / k6 负载压力 / 安全扫描。**本条不声明「全部通过」**:单元与真库集成层在封版树 `a0328a6` 上全绿(`npm run test:coverage`、`npm run test:integration:real`);**视觉回归在 2026-10-08 补齐并逐张追认 38 张参照后,独立只读复跑 125 passed / 0 failed / EXIT=0**(AUTH-D3 就此闭合;此前封版树实测 94/31 = 20 例缺参照 + 11 例已过时,已逐条归因,非像素级产品缺陷);生产目标 E2E 实测 **91 passed / 1 failed**(唯一红为 firefox 并发墙钟);`check:motion` 仍 **23 处判红**(DEC-P2-motion 待裁定,未并入伞形门禁)。**计数一律不在此复制**:以 `npm run test:coverage`、`cd e2e && npx playwright test --list`、`docs/acceptance/2026-09-30-seal/final-verdict.md` §1 表与 `docs/acceptance/qa-tracker.md` §9 为现取入口
- [x] 全量测试体系:单元 **134 suites / 1697 例** / 功能 E2E **1080 例**(270 例 × chromium + chromium-mobile + firefox + webkit 四个 project)/ 视觉回归 **125 例**(25 例 × 桌面·平板·移动·firefox·webkit 五个 project)/ 用户旅程 UJ-01~UJ-11 / Lighthouse / k6 负载压力 / 安全扫描。**本条不声明「全部通过」**:单元与真库集成层在封版树 `a0328a6` 上全绿(`npm run test:coverage`、`npm run test:integration:real`);**视觉回归在 2026-10-08 补齐并逐张追认 38 张参照后,独立只读复跑 125 passed / 0 failed / EXIT=0**(AUTH-D3 就此闭合;此前封版树实测 94/31 = 20 例缺参照 + 11 例已过时,已逐条归因,非像素级产品缺陷);生产目标 E2E 实测 **91 passed / 1 failed**(唯一红为 firefox 并发墙钟);`check:motion` 判红数见 `docs/development/quality-gates.md` §5.1(2026-10-17 本树复测为 8 处,未并入伞形门禁)。**计数一律不在此复制**:以 `npm run test:coverage`、`cd e2e && npx playwright test --list`、`docs/acceptance/2026-09-30-seal/final-verdict.md` §1 表与 `docs/acceptance/qa-tracker.md` §9 为现取入口
- [x] **官网产品模块定位(IHG/字节式品牌矩阵,2026-08-19)**:官网品牌宣传为主,产品矩阵页为聚合入口;成熟产品 `externalUrl` 外链独立站(NovaVis → novavis.p.novalon.cn);未成熟产品详情页占位,独立站上线后切换外链
- [x] **结构性文案全站 CMS 化(2026-08-19)**:新增 `page-copy` 内容模型承载全部营销页面章节标题/眉标/描述/CTA/空状态(首页 + 服务/方案/产品/案例/新闻列表页),「CMS 优先 + 硬编码兜底」不白屏;seed 写入 6 条,本地 db:seed 已生效
- [x] **信任证据补齐·阶段 0(成立 <1 年策略,2026-08-20)**:信任策略从「结果证据」转向「可验证的过程 + 能力 + 治理证据」——首页「首批客户共创计划」板块(共创进行中/产品内测中/成果授权公开三档如实状态 + 招募 CTA)+ 关于页资质「建设中」如实空态,零编造
@@ -39,6 +39,7 @@
- [x] **数字口径结构强制(2026-09-20,critique P0 收尾)**:共享数字样式渲染的指标(`metrics`/`outcomes`/`dataProofs`)统一携带 `basis: target|team-history|verified`,渲染端自动附口径角注、未声明保守回落 `target`;CMS 新增 `basis` select 录入字段;删除产品详情页「每一项指标都源自真实客户案例」「经实际场景验证」等虚构佐证并补注角注;`metrics-basis.test.ts` 机械校验声明完整性并拦截虚构佐证禁词
- [x] **五轮系统性 QA 封版(2026-09-21…28 修复,2026-09-30 封版)**:Q-1…Q-10 / S-1…S-24 共 30 处缺陷修复入库(假登出清服务端令牌、登录 IP 限流、停用令牌 fail-closed 收口、workflow 状态+审计交互式 `$transaction` 原子化、编辑器 richtext 防换行静默损毁、`StaggerReveal` 吞网格类致详情页塌成单列、首页 CMS 数组逐条守卫、about/contact/erp-upgrade 补 ISR=3600 等),每处带判别性 RED→GREEN 测试。跨周期台账 `docs/acceptance/qa-tracker.md`(§9 为现行段落),封版判定书与全部原始门禁输出见 `docs/acceptance/2026-09-30-seal/`。**判定 = 封版通过(含例外清单)**:例外为「待业务口径」(4 条互斥 SLA、erp-upgrade 无 basis 数字)与「待授权项」(写库 E2E 11 例、全量变异、生产 `db:seed`、`check:motion` 23 处)——视觉基线追认已于 2026-10-08 闭合,见下条;均非代码质量问题
- [x] **作者侧 agentic 工具化 + 视觉基线闭合(2026-10-08)**:① 选型判定采用 Playwright 1.60 自带 Test Agents(planner/generator/healer,`.claude/agents/*.md` + `.mcp.json`,**未新增依赖、运行期零模型**),淘汰 `tester-army/e2e` 等的判据全表见 `docs/testing/agentic-test-authoring.md`;② 补主导航键盘契约 `e2e/nav-keyboard.spec.ts`(4 例 `@a11y`,dev 10/6、production 10/2、稳定性 24/24,并定性两条引擎/目标差异);③ **AUTH-D3 视觉基线闭合**:写入 38 张(25 新 + 13 覆盖,逐张读图追认)后独立只读复跑 **125/0 / EXIT=0**,取证 `docs/acceptance/2026-10-08-baselines/`;④ 台账 §9 + `docs/lessons-learned.md` §5.33(基线判红须对「采集树 vs 当前树」,本轮内作废了自己一条「运行期漂移」错判)
- [x] **对标语法批:Bain / Porsche Consulting 实测驱动的 UI·UE·UX 重构(2026-10-17,tracer-bullet 一批)**:对标取证不是二手描述——Bain 走 archive.org 快照 2026-08-31(1600×846)绕开 Cloudflare、Porsche 取 live 国际站,逐元素 `getComputedStyle` 抽样。实测**证伪了 ADR-0004 的两条视觉判据**(决策四「关键数字 = 超大字号 + 品牌色」:Bain 成果数字实为 40px / 字重 500 / 纯黑;决策一「4px 色条为辅」:两家都不用颜色给内容分类),已在同一笔里改文档。四项裁定与落地见 [ADR-0008](docs/adr/0008-benchmark-grammar-takeover.md):① **借语法不借色相** —— radius 收进 0–4px 记档 + 新增 `--radius-cta: 0`(CTA 由 pill 改直角)、彩色阴影 `--shadow-brand/-brand-hover/-glow` 退役、`.bain-card` hover 去抬升,**`--radius-full` 保持 9999px**(承载 avatar/switch/slider/radio/progress 的功能性真圆,一并归零即方角化后台所有旋钮);② **一级导航改行业 × 能力 + 洞察双轴**,「产品」退出一级(入口降为能力面板里的产品矩阵总览),且把导航真源**从 DB 行反转为代码**(CMS 行须满足 IA 契约才采纳,否则 fail closed —— 实测复现过「一条自洽的旧行」让页脚各列静默变空);③ **信任层走零编造透明路线**:`ResultsSlot` 可判别空态 + `casePublishBlockers()` 反伪造不变量 + L3 替代信号槽,承诺条款收进 `commitments.ts` 单一真源;④ **范围只到首页 + 一条承载详情页**,其余模板待验收。新增三台可失败仪器并常驻门禁:`check:grammar`(R1–R11,含 R2 正向守卫、R9 双向、R10 递减棘轮、R11 僵尸令牌守卫)、`check:accents`(营销面类名通道,豁免按名登记且**豁免腐化亦判红**)、`check:dead`(import 闭包可达性);`check:visual` 已并入 `test:all` 且**自证先跑**(自证失败即宣布绿灯作废)。证据与台账见 `docs/acceptance/qa-tracker.md` §11、探针 7 份存 `docs/acceptance/2026-10-17-ia-e2e/`;经验教训 `docs/lessons-learned.md` §5.38–§5.41(含「`npm run lint | tail` 吞掉 2 个 error」与「注释写在 JSX children 位会渲染成页面文字,而 type-check/1747 例单测/build 三道全绿」)。**本批遗留待拍/待授权**:视觉基线重采(AUTH-VISUAL)、CMS 导航行改写(AUTH-NAV)、彩色编码第二通道 `hero-themes.accentColor`(DEC-N1,`check:accents` 不覆盖它,口径已印在闸的输出行上)、`StaggerReveal` 默认 stagger 与文档不符(DEC-N2)、`check:motion` 残留 **8 处**(DEC-N3,较 2026-09-30 的 23 处减少,全部经 `git show` 自证为基线 `da9a5cb6` 既有红、非本轮引入)、既有 `CaseStudiesSection`/`detail-trust-section` 无授权门槛(DEC-N4)
- [ ] **信任证据补齐·阶段 1/2(待内测/试点客户素材)**:如实披露「共创中/内测中/已交付」三档 + 经授权客户(脱敏);有交付成果后经授权公示可量化结果(零编造原则)——口径字段与 admin 录入口已就绪,待真实数据把 `basis` 从 `target` 升级为 `verified`
## 技术栈
+2
View File
@@ -11,6 +11,8 @@
"http://localhost:3200/products",
"http://localhost:3200/cases",
"http://localhost:3200/news",
"http://localhost:3200/insights",
"http://localhost:3200/solutions/manufacturing",
"http://localhost:3200/contact",
"http://localhost:3200/products/erp-upgrade",
"http://localhost:3200/about/brand"
@@ -0,0 +1,14 @@
import { chromium } from 'playwright';
const b = await chromium.launch();
const p = await b.newPage({ viewport: { width: 1440, height: 900 } });
await p.goto('http://localhost:3210/', { waitUntil: 'domcontentloaded' });
await p.waitForTimeout(3000);
const inCard = await p.locator('[data-testid="card-products"] a[href="/products"]').count();
console.log('card-products 内 /products 链接数:', inCard);
if (inCard) console.log(' 文本:', (await p.locator('[data-testid="card-products"] a[href="/products"]').first().innerText()).trim());
console.log('home-cta-button 数:', await p.locator('[data-testid="home-cta-button"]').count(),
'href:', await p.locator('[data-testid="home-cta-button"]').first().getAttribute('href'));
console.log('l3 heading:', await p.locator('#l3-signals-heading').count());
console.log('方法论 link:', await p.locator('a[href="/methodology"]').count());
console.log('team link:', await p.locator('a[href="/team"]').count());
await b.close();
@@ -0,0 +1,15 @@
import { chromium } from 'playwright';
const b = await chromium.launch();
const p = await b.newPage({ viewport: { width: 1440, height: 900 } });
await p.goto('http://localhost:3210/', { waitUntil: 'domcontentloaded' });
await p.waitForTimeout(3000);
const ids = await p.evaluate(() =>
[...document.querySelectorAll('[data-testid]')].map(e => e.getAttribute('data-testid')));
console.log('TESTIDS:', JSON.stringify([...new Set(ids)]));
const cta = await p.locator('[data-testid="hero-primary-cta"]').count();
console.log('hero-primary-cta count:', cta);
const bodyText = await p.locator('body').innerText();
for (const k of ['共创', '数据来源', '口径', '暂无案例数据', '成为首批共创客户', '首批客户共创']) {
console.log(` 「${k}」出现 ${bodyText.split(k).length - 1} 次`);
}
await b.close();
@@ -0,0 +1,22 @@
import { chromium } from 'playwright';
const b = await chromium.launch();
// 桌面:取 CTA href、ledger signals 文案、basis note 文案
const p = await b.newPage({ viewport: { width: 1440, height: 900 } });
await p.goto('http://localhost:3210/', { waitUntil: 'domcontentloaded' });
await p.waitForTimeout(3000);
const cta = p.locator('[data-testid="hero-cta"]').first();
console.log('hero-cta count=', await p.locator('[data-testid="hero-cta"]').count(),
'href=', await cta.getAttribute('href'), 'text=', (await cta.innerText()).trim().replace(/\n/g,''));
console.log('ledger-signals:', (await p.locator('[data-testid="home-ledger-signals"]').innerText()).replace(/\n/g,' | ').slice(0,220));
console.log('basis-note:', await p.locator('[data-testid="metrics-basis-note"]').innerText());
console.log('l3 heading visible:', await p.locator('#l3-signals-heading').isVisible());
await p.close();
// 移动端:CTA 是否在首屏内 + 横向溢出
const m = await b.newPage({ viewport: { width: 390, height: 844 } });
await m.goto('http://localhost:3210/', { waitUntil: 'domcontentloaded' });
await m.waitForTimeout(3000);
const box = await m.locator('[data-testid="hero-cta"]').first().boundingBox();
console.log('mobile hero-cta box:', JSON.stringify(box), '在首屏内=', !!box && box.y >= 0 && box.y + box.height <= 844);
const of = await m.evaluate(() => ({ sw: document.documentElement.scrollWidth, cw: document.documentElement.clientWidth }));
console.log('mobile overflow:', JSON.stringify(of));
await b.close();
@@ -0,0 +1,16 @@
import { chromium } from 'playwright';
const b = await chromium.launch();
const p = await b.newPage({ viewport: { width: 1440, height: 900 } });
await p.goto('http://localhost:3210/', { waitUntil: 'domcontentloaded' });
await p.waitForSelector('nav[aria-label="主导航"]', { timeout: 15000 });
await p.waitForTimeout(2500);
const nav = p.locator('nav[aria-label="主导航"]');
const btn = nav.locator('button:has-text("能力")');
await btn.hover(); await p.waitForTimeout(700);
// 找到面板容器:按钮的父级里除按钮外的文本
const html = await nav.evaluate(n => n.outerHTML);
console.log('NAV HTML length', html.length);
const txt = await nav.innerText();
console.log('--- innerText after hovering 能力 ---');
console.log(txt.replace(/\n{2,}/g, '\n').slice(0, 900));
await b.close();
@@ -0,0 +1,11 @@
import { chromium } from 'playwright';
const b = await chromium.launch();
const p = await b.newPage({ viewport: { width: 1440, height: 900 } });
await p.goto('http://localhost:3210/', { waitUntil: 'domcontentloaded' });
await p.waitForTimeout(3000);
console.log('ledger:', (await p.locator('[data-testid="home-ledger"]').innerText()).replace(/\n+/g,' | ').slice(0, 400));
const metrics = await p.locator('[data-testid="ledger-metric"]').count();
console.log('ledger-metric count:', metrics);
console.log('results-slot:', (await p.locator('[data-testid="results-slot-placeholder"]').innerText()).replace(/\n+/g,' | ').slice(0, 260));
console.log('co-creation block:', await p.locator('[data-testid="results-slot-co-creation"]').count());
await b.close();
@@ -0,0 +1,20 @@
import { chromium } from 'playwright';
const b = await chromium.launch();
const p = await b.newPage({ viewport: { width: 1440, height: 900 } });
await p.goto('http://localhost:3210/', { waitUntil: 'domcontentloaded' });
await p.waitForSelector('nav[aria-label="主导航"]', { timeout: 15000 });
await p.waitForTimeout(2500);
const nav = p.locator('nav[aria-label="主导航"]');
console.log('BUTTONS:', await nav.locator('button').allTextContents());
console.log('LINKS:', await nav.locator('a').evaluateAll(a => a.map(x => x.getAttribute('href') + '|' + x.textContent.trim())));
// hover 能力,看面板
const cap = nav.locator('button:has-text("能力")');
console.log('cap count:', await cap.count());
if (await cap.count()) {
await cap.first().hover();
await p.waitForTimeout(600);
console.log('expanded:', await cap.first().getAttribute('aria-expanded'));
const panel = await p.locator('[id*="dropdown"], [role="menu"], [data-testid*="mega"]').allTextContents();
console.log('PANEL texts (first 300 chars):', panel.join(' /// ').slice(0, 300));
}
await b.close();
@@ -0,0 +1,12 @@
import { chromium } from 'playwright';
const b = await chromium.launch();
const p = await b.newPage({ viewport: { width: 1440, height: 900 } });
await p.goto('http://localhost:3210/', { waitUntil: 'domcontentloaded' });
await p.waitForTimeout(3000);
for (const id of ['hero-section','home-ledger','results-slot-placeholder','home-insights','home-industries','home-capabilities','home-cta']) {
const el = p.locator(`[data-testid="${id}"]`).first();
if (!(await el.count())) { console.log(id, 'MISSING'); continue; }
const y = await el.evaluate(e => e.getBoundingClientRect().top + window.scrollY);
console.log(id.padEnd(24), Math.round(y));
}
await b.close();
@@ -0,0 +1,20 @@
import { chromium } from 'playwright';
const b = await chromium.launch();
const p = await b.newPage({ viewport: { width: 1440, height: 900 } });
await p.goto('http://localhost:3210/', { waitUntil: 'domcontentloaded' });
await p.waitForSelector('nav[aria-label="主导航"]', { timeout: 15000 });
await p.waitForTimeout(2500);
const nav = p.locator('nav[aria-label="主导航"]');
for (const label of ['行业', '能力', '洞察']) {
const btn = nav.locator(`button:has-text("${label}")`);
await p.mouse.move(0, 0); await p.waitForTimeout(200);
await btn.hover(); await p.waitForTimeout(700);
const expanded = await btn.getAttribute('aria-expanded');
const controls = await btn.getAttribute('aria-controls');
const links = await p.locator('a').evaluateAll(a => a.map(x => x.getAttribute('href')).filter(h => h && (h.startsWith('/solutions') || h.startsWith('/services') || h.startsWith('/products') || h.startsWith('/insights') || h.startsWith('/news') || h.startsWith('/methodology'))));
const viewAll = await p.locator('a:has-text("查看全部")').evaluateAll(a => a.map(x => x.textContent.trim() + ' -> ' + x.getAttribute('href')));
console.log(`\n### ${label} expanded=${expanded} controls=${controls}`);
console.log(' 面板内相关链接:', [...new Set(links)].join(' '));
console.log(' 查看全部:', viewAll.join(' | '));
}
await b.close();
@@ -0,0 +1,10 @@
import { chromium } from 'playwright';
const b = await chromium.launch();
const p = await b.newPage({ viewport: { width: 1440, height: 900 } });
await p.goto('http://localhost:3210/', { waitUntil: 'domcontentloaded' });
await p.waitForTimeout(3000);
const links = await p.locator('a[href="/products"], a[href^="/products/"]').evaluateAll(a =>
a.map(x => ({ href: x.getAttribute('href'), text: x.textContent.trim().slice(0,24), visible: !!(x.offsetWidth || x.offsetHeight) })));
console.log(JSON.stringify(links, null, 0).slice(0, 900));
console.log('可见的 /products 链接数:', links.filter(l => l.href === '/products' && l.visible).length);
await b.close();
+59
View File
@@ -502,3 +502,62 @@ S-3(about/contact/erp-upgrade 无 revalidate + revalidateTag no-op,涉渲染
| **#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 供数,不改库也能上线 |
@@ -41,6 +41,12 @@ ADR-0003 确立了「咨询为骨,水墨为魂」的总体设计方向,但
#### 决策一:颜色策略 —— 编号为主,色条为辅
> ⚠️ **2026-10-17 实测修订(见 [ADR-0008](0008-benchmark-grammar-takeover.md))**:本决策的「色条为辅」
> 已被消费面实测推翻——7 个 coding accent 进令牌层后,真正跑起来的营销代码只消费了**一个蓝**
> 做装饰性图标砖与状态徽章,而 Bain / Porsche 两家实测**都没有用颜色给内容分类**。
> 现行规则:`--color-accent-*` 仅限图表/序列与后台工具 UI 的分类编码,**营销面一律禁用**,
> 由 `npm run check:accents` 判红。令牌保留不删。
**保持当前方案不变**,与 ADR-0003 一致:
- 服务线区分:大号数字编号(主要识别) + 卡片左侧 4px 细色条(辅助识别)
- 不整卡上色,保持专业感
@@ -105,6 +111,13 @@ ADR-0003 确立了「咨询为骨,水墨为魂」的总体设计方向,但
- 关键数字:超大字号 + 品牌色 + tabular-nums
- 标题/正文比例 ≥ 3:1,制造视觉张力
> ⚠️ **2026-10-17 实测修订(见 [ADR-0008](0008-benchmark-grammar-takeover.md))**:
> 「关键数字 = 超大字号 + **品牌色**」这一半是对标的误读。Bain 成果数字实测
> `getComputedStyle` = **40px / 字重 500 / 纯黑**;两家饱和红用作"面"的次数为 **0**
> (Bain `#CC0000` 出现 65 次全是字与线,Porsche 红出现 4 次全是按钮)。
> 现行做法:数字用既有 `text-5xl` 档(桌面根字号 18px 下 `2.25rem` = 40.5px,**零新增令牌**)、
> 字重 500、`text-ink`,tabular-nums 保留。品牌红回到点睛位(eyebrow 短线 / 实心 CTA / hover 边)。
- **图文组合和节奏**:Porsche 式电影感
- 分屏布局(左图右文 / 左文右图交替)
- 大图占比高(50-60% 视口宽度)
+101
View File
@@ -0,0 +1,101 @@
# ADR 0008: 对标语法接管视觉层与导航层(Bain / Porsche Consulting 实测)
## 状态
已接受。部分接管 ADR-0004(其决策一、决策四的视觉判据被实测证伪,见「被证伪的既有判据」)。
## 日期
2026-10-17
## 上下文
用户要求「调研、参考 Bain 咨询和保时捷咨询官网,优化、重构当前官网的 UI、UE、UX」。
本仓在 2026-06~07 已经走过一轮对标(ADR-0004、`docs/superpowers/specs/2026-06-29-phase2-bain-brand-clarity-design.md`、`2026-07-08-bain-differentiation-design.md`),首页文案已到 v15,结论式标题与 HeroStatsBand 都已落地。所以本轮的价值不在"再对一次标",而在**把对标从文案层下沉到语法层与结构层**——因为这次实测出来的数字证伪了 ADR-0004 的视觉判据。
取证方法(自己取,非二手描述):Bain 走 archive.org 快照 2026-08-31、1600×846 视口,绕开 Cloudflare;Porsche Consulting 取 live 国际站首页 + 中国站导航;对每个抽样元素跑 `getComputedStyle`。
| 维度 | Bain(快照 2026-08-31) | Porsche Consulting(live) | Novalon 修订前 |
|------|------------------------|---------------------------|---------------|
| `border-radius` | 抽样**全部 0px** | 抽样**无一非零** | 令牌 3/6/8/12/18/24/32/9999 |
| 字色集合 | 仅 `#000 #FFF #CC0000 #767676` | 仅 `#000 #FFF #B6B5BA` | 含 7 个 coding accent |
| 面色集合 | `#FFF` `#000` `#ECECEC` | `#FFF #000 #D6001D #F2F2F2` | 冷 slate 系 |
| 饱和红用作面 | **0 次**(`#CC0000` 出现 65 次,全为字/线) | 红出现 4 次,**全是按钮** | `bg-brand-section #8B1530` 满幅一段(FounderQuote) |
| 成果数字 | **40px / 字重 500 / 纯黑** | 同类克制 | 文档写「超大字号 + 品牌色」 |
| CTA | 白底 · 红字 · 1px `#D8D8D8` · radius 0 · pad 20/32 · 14px uppercase | 实心 `#D6001D` · 白字 · radius 0 · pad 13/24 · 16px | 实心朱砂 + `rounded-full` + `--shadow-brand` 光晕 + 涟漪 |
| hover | 只改 hairline→rule,**不抬升** | 靠图与留白 | `.bain-card` `translateY(-4px)` + 阴影增长 |
## 被证伪的既有判据
这两条不是口味分歧,是**对标读错了**,所以必须在同一笔里改文档,否则文档成了说谎的那一方:
1. **ADR-0004 决策四**「关键数字:超大字号 + 品牌色 + tabular-nums」——Bain 实测 40px / 字重 500 / 纯黑。本仓 `--font-size-5xl: 2.25rem` 在桌面根字号 18px 下 = 40.5px,即**现有档位正好命中对标值,零新增令牌**;要改的是"品牌色"这半句。
2. **ADR-0004 决策一**「编号为主 + 4px 色条为辅」——实测两家**都没有用颜色给内容分类**。本仓 7 个 accent 进令牌层后,真正跑起来的营销代码只消费了**一个蓝**(`accent-blue`)做装饰性图标砖与状态徽章:成本是全站语法被稀释,收益是一处蓝。
## 决策
四项,均由交付决策人在本轮 AskUserQuestion 中选定(推荐项全部采纳)。
### 决策一:借语法,不借色相
采纳对标的**形状语法**(radius 0–4px 记档、近乎单色、克制的数字排版、实心/描边两轨 CTA、hover 不抬升),保留 Novalon 自己的 `#C41E3A` 朱砂与朱砂条辅助图形。
落地为机器判据 `scripts/check-visual-grammar.mjs`(R1–R10,见下):
- radius 记档:`--radius-xs/sm = 0`、`md/lg = 2px`、`xl/2xl/3xl = 4px`,新增 `--radius-cta: 0px`
- **`--radius-full` 必须保持 9999px**(正向守卫):`rounded-full` 在本仓承载真圆——`avatar` `switch` `slider` `radio-group` `progress` `scroll-area` 骨架屏。把它一并归零会把后台与所有 Radix 表面的旋钮、滑块、头像全部方角化,这是"语法收口"最容易犯的自伤,所以单列一条并配负对照。
- 彩色阴影令牌 `--shadow-brand/-brand-hover/-glow` 退役;`.bain-card:hover` 改为 hairline→rule,去掉位移与阴影增长
- 7 个 `--color-accent-*` **降级不删除**(后台内容模型 type 色标是分类编码、图表也要用),营销面一律禁用,由 `scripts/check-accents.mjs` 强制:豁免**按文件名登记**,且名单里的文件命中数变 0 同样判红(防豁免名单腐化成"没人记得为什么在这"的永久豁免)
- ⚠ **该闸只覆盖 Tailwind 类名通道**,这句口径就写在它的成功输出行里,防止后来人把它读成"营销面已无任何彩色编码"。实测还有第二条通道:`src/lib/constants/hero-themes.ts` 的 `accentColor` 以内联样式进 DetailHero 徽章(`detail-hero.tsx:81-86` 的 backgroundColor / color / borderColor 与 `--badge-accent`),11 个主题里 **7 个用非品牌色相**(erp `#1e3a5f`、crm `#1e40af`、bi `#0c4a6e`、cms `#14532d`、sds `#78350f`、oa `#4c1d95`、novavis `#0f3d3e`),落在产品·方案·服务详情页的 hero 上。本批不收它的两个理由:(i) 那属于「把 tracer-bullet 的做法套到其余模板」,而决策四明确把模板批推到验收之后;(ii) 去掉逐产品色相等于取消产品线视觉身份,那是**设计裁定**而不是语法收口,不该由闸顺手替决策人拍板。已登记为独立待拍项(见「后果」§已知偏差 6)。
- `hover:-translate-y` 存量 28 处 / 19 文件登记为**递减棘轮**上限(R10):变多判红,变少不判红但把下调提示写进 note
### 决策二:一级导航改对标双轴
一级导航从「产品/解决方案/服务/案例/新闻/关于/联系」改为**行业 × 能力 + 洞察**,"产品"退出一级。
关键工程决定:把导航真源**从 DB 行反转为代码**。`src/lib/navigation-resolution.ts` 的 `resolveNavigation()` 只在 CMS 行满足 IA 契约(三个必需 mega key 齐备)时才采纳它,否则 fail closed 到代码常量。理由:本轮实测复现出「一条**自洽的旧行**」会让页脚各列静默变空——旧行本身没有格式错误,只是不符合新 IA,而原先的优先级是 DB 行覆盖代码。
同时把降级动作补齐:删掉一级"产品"会让 `/products` 成为孤儿,因此在二级 mega 里加入口 `all-products → /products` 并配守卫测试。
### 决策三:信任层走零编造透明路线
没有客户授权就没有案例可发。所以不做"占位假案例",而做**可判别空态 + 反伪造不变量**:
- `src/components/sections/results-slot.tsx` 用可判别 state(而非"有没有数据")承载;`casePublishBlockers()` 要求 `verified === true`、证言有作者、≥1 个 `basis === 'verified'` 的指标、且不命中禁词,四者齐备才判可发布
- L3 空数据时由替代信号槽兜底(方法论 / 团队 / 历程 / 承诺),四条都指向站内真实路由;服务承诺卡在业务确认前显示「待业务确认」占位且不可点击
- 承诺条款收进单一真源 `src/lib/constants/commitments.ts`,一个 `about` 只留一条承诺;实测互斥的四条 SLA(`<4小时` / `7×24` / `48小时` / `工作日 2 小时`)中只保留有授权口径的一条
### 决策四:范围 = tracer-bullet 一批
首页 8 段 + 一条承载详情页(`/solutions/[id]`)端到端做完,交付决策人看过再套其余模板。目的是避免在语法未验收前把全站 20+ 页面重写一遍。
## 理由
- 对标的价值在于**它已被验证的形状**,而形状可以脱离色相继承;色相是品牌资产,不该在对标时被换掉
- 语法层判据若只写在文档里,就有 `CONTEXT.md` 与 `globals.css` 各说一套、以及「文档比代码更新」那类问题(本轮真实踩过:`--transition-hover: 150ms` 只在 CSS、`tailwind.config.js` 只有 DEFAULT/normal/slow 三档)——所以要做成能失败的闸
- 反伪造成果槽必须是**可判别状态**而不是"数据为空时的分支",否则空态、加载态、被拦态三者共用一个渲染路径,验收时无法区分"没有案例"与"案例被门槛拦下"
## 后果
**得到的**:视觉语法、accent 消费面、导航真源、承诺真源各有了一条机器判据或单一真源;`npm run check:visual` 已并入 `test:all`。
**付出的**:全站视觉基线需要重新采集(radius/阴影/hover 都变了);一级导航变更后 `/products` 的转化路径变长,需要观察。
**已知偏差,本轮不修(各自登记为独立动作)**:
1. `StaggerReveal` 默认 `staggerDelay = 0.15` 与 ADR-0004 决策三「子元素 stagger 30–60ms」不符;改库默认值是全站动效重排 + 基线重采,需单独授权。本批只在首页与账本处显式传 0.04–0.06。
2. `check:motion` 现存 8 条违反(6 条写死贝塞尔不在令牌层、`--transition-gentle = 1000ms` 超 700ms 入场上限、1 条 CSS 裸时长字面量),**全部为本分支基线 da9a5cb6 就有的红**,非本轮引入。
3. `CaseStudiesSection` 与 `detail-trust-section` 仍**没有**授权/basis 门槛(只有新的成果槽有);应在彼处与 CMS 发布时同样设闸。
4. `ui/` 组件库里 53 个不可达原语是产品决定,本批不删。
5. `.husky/pre-commit` 在 git 里是 mode 100644,因此任何克隆里 lint-staged 都不会随提交执行——这是治理缺口,本批只报告不擅改。
6. **彩色编码的第二条通道未被本批的闸覆盖**:`hero-themes.ts` 的 7 个非品牌 `accentColor`
仍以内联样式渲染在产品·方案·服务详情页 hero 徽章上。需要决策人裁定"逐产品色相身份要不要保留";
若裁定保留,`check:accents` 的口径就永久是「类名通道」;若裁定去掉,属模板批的视觉改动 + 基线重采。
## 取证与验证
- 语法闸自证:`npm run check:grammar:selftest` 喂已知违规样本,R1–R9 必须全部判红,R10 棘轮必须「上限处不判红 / 上限+1 判红」;任一不成立即宣布"上面所有绿灯不作数"并 EXIT=1
- accent 闸自证:`npm run check:accents:selftest` 三个情景分别只测一维(违规 / 豁免腐化 / 全绿),因为把互斥前提写进同一份夹具会让其中一维永远测不到
- 注释渲染回归:`solution-detail-content-v3.test.tsx` 断言渲染文字里不含 `/*`,且先断言被污染的两段 DOM 确实渲染了(否则"找不到注释"可能只是"那段没出现");该断言已用变异验证过敏感性——把注释改回裸文本节点后仅这一条转红、其余三条仍绿
- 负对照(待授权执行):把 `--radius-cta` 设成 12px,确认 ≥1 张视觉基线转红;若 N=0,说明基线什么都没拍,只读复跑的绿灯作废
+48 -3
View File
@@ -23,7 +23,20 @@
**通过标准**: **0 error**。warning **不判红**——这是本项目的显式裁定(见 `CONTEXT.md`「lint warning 分级与门禁判定口径」);把 warning 清零不是门禁前置条件,但**不得**为凑绿而把它们调成 `off`。
**warning 数量口径(本文件为版本库内的权威记录位)**:2026-09-23 **第二周期**最终树实测 `npm run lint` ⇒ **EXIT=0,`✖ 104 problems (0 errors, 104 warnings)`**,分项相加 = 104:**55** `no-console` / **25** `@typescript-eslint/no-explicit-any` / **11** `react-hooks/set-state-in-effect` / **10** `@next/next/no-img-element` / 各 1 `@next/next/no-sync-scripts`、`@next/next/no-html-link-for-pages`、`Unused eslint-disable directive`(死抑制)。同日**第一周期**记录的 105 条与本树只差 1,且差值唯一归因为 `set-state-in-effect` **12→11**(后台编辑器的"挂载期消费守卫"那个效果被删)——**没有任何一项是本周期新增**。该计数**随树漂移**(上一轮 chain4/chain6 为 106/56),引用时必须同时给复算命令,不得当作常量:
**warning 数量口径(本文件为版本库内的权威记录位)**:
> **2026-10-17 本树复测(对标语法批,分支 `worktree-ui-grammar-two-axis`)**:`npm run lint` ⇒ **EXIT=0,`✖ 81 problems (0 errors, 81 warnings)`**。
> 分项相加必须 = 总数,口径自洽才算这条记录可信:**55** `no-console` / **12** `react-hooks/set-state-in-effect` / **8** `@next/next/no-img-element` /
> **4** `@typescript-eslint/no-explicit-any` / 各 1 `@next/next/no-sync-scripts`、`@next/next/no-html-link-for-pages`(55+12+8+4+1+1 = 81 ✓)。
> 与下行 2026-09-23 的 104 相差 **−23**,按规则逐项对账为:`no-explicit-any` **25→4(−21)**、`Unused eslint-disable directive` **1→0(−1)**、
> `@next/next/no-img-element` **10→8(−2)**、`set-state-in-effect` **11→12(+1)**、`no-console` **55→55(0)**(−21−1−2+1 = −23 ✓)。
> 归因**已实证到文件**(不是只看方向一致):`da9a5cb6` 时被删掉的文件里 `: any` / `as any` / `<any>` 命中数为
> `home-content-v15.test.tsx` 12、`NewsDetailClient.test.tsx` 8、`home-content-v15.tsx` 4、`insight-card.test.tsx` 3、
> `industry-grid.test.tsx` 2、`hero-particle-field.test.tsx` 2、`case-card.test.tsx` 2(合计 33 处命中 ⇒ 净减 21 条 warning,
> 差额是因为命中数 ≠ 告警数:泛型实参、注释里的 `any` 不产生该告警)。复算命令:
> `for f in $(git diff --diff-filter=D --name-only <base>..HEAD | grep -E '\.tsx?$'); do git show <base>:"$f" | grep -cE '(: any|as any|<any>)'; done`
> 另记一条本轮真实事故:这条计数一度被读成 0 error 是因为 `npm run lint | tail` 拿到的是 `tail` 的退出码,
> 而当时真实输出是 **2 error / EXIT=1**(`react/jsx-no-comment-textnodes` 两处)⇒ 见 `docs/lessons-learned.md` §5.38,
> **门禁命令必须重定向到文件后再读 `$?`**:
```bash
npm run lint # 看末行 ✖ N problems
@@ -142,7 +155,39 @@ Closes #123
**自证伪**:`npm run check:motion:test`(19 例,`scripts/utils/__tests__/check-motion-constraints.test.ts`)对每条规则做**双向**断言 —— 合规夹具判 0(防常红)+ 违规夹具判该规则红(防常绿),并含一条元测试:四条规则的触发集合必须恰好等于 `MOTION_RULES` 声明的全集(任一规则变得不可触发即红)。该测试跑在 `scripts/` 下,故需 `--roots` 显式指定(jest 默认 `roots` 是 `src`),不在 `test:unit` / `test:coverage` 的口径内。
**当前树状态(2026-09-30 实测)**:`npm run check:motion` → **EXIT=1,23 处违规 / 13 个文件**(R1 0、R2 1、R3 2、R4 20;分母 = 262 个源码文件 · 46 条 CSS 声明 · 290 个时长字面量 · 66 条贝塞尔字面量 · 6 个 `--transition-*` 令牌 · 6 个 `--ease-*` 令牌)。主体是 `[0.16, 1, 0.3, 1]`(17 处)与 `[0.25, 1, 0.5, 1]`(3 处)两条**未在令牌层声明**的曲线,另有 `--transition-gentle: 1000ms` 超上限、`globals.css:1457` 与 `src/lib/constants/design-system.ts:76` 的裸时长字面量。因此**本轮只登记独立脚本、不并入 `check:a11y`**(并入即把伞下门禁做成永久红);违规修完后把 `check:motion` 追加进 `package.json` 的 `check:a11y` 串即可,规则本身不得为转绿而放宽。
**当前树状态(2026-10-17 本树复测)**:`npm run check:motion` → **EXIT=1,8 处违规 / 4 个文件**(R1 token-band 0、R2 entrance-cap 1、R3 css-transition-token 1、R4 easing-palette 6;分母 = 252 个源码文件 · 46 条 CSS 声明 · 251 个时长字面量 · 51 条贝塞尔字面量 · 7 个 `--transition-*` 令牌 · 6 个 `--ease-*` 令牌)。较 2026-09-30 的 23 处减少,是因为本轮删掉了不可达模块与 `design-system.ts`(其裸时长字面量随文件消失)、并给 `--transition-hover` 补了档;**残留 8 处全部是基线 `da9a5cb6` 就有的红**(`git show da9a5cb6:src/app/globals.css` 里 `--transition-gentle: 1000ms` 与 `transition: opacity 0.6s` 两处可自证),非本轮引入:`[0.16, 1, 0.3, 1]`(`template.tsx` ×2、`brand-visuals.tsx` ×2)与 `[0.25, 1, 0.5, 1]`(`page-transition.tsx` ×2)四条未在令牌层声明的曲线 + `--transition-gentle: 1000ms` 超 700ms 入场上限 + `globals.css:1481` 的 `0.6s` 裸字面量。登记为 `docs/acceptance/qa-tracker.md` §11.4 DEC-N3。因此**本轮只登记独立脚本、不并入 `check:a11y`**(并入即把伞下门禁做成永久红);违规修完后把 `check:motion` 追加进 `package.json` 的 `check:a11y` 串即可,规则本身不得为转绿而放宽。
#### 5.2 视觉语法与彩色编码门禁 `npm run check:visual`(2026-10-17 新增,已并入 `test:all`)
出处:对标实测(Bain archive 快照 2026-08-31 + Porsche Consulting live,`getComputedStyle` 抽样)
与 [ADR-0008](../adr/0008-benchmark-grammar-takeover.md)。两条闸都是**先自证再判分**:
自证失败即宣布「上面所有绿灯不作数」并以 EXIT=1 结束,防止一台坏仪器给出连贯却无意义的绿灯。
| 脚本 | 判据 | 分母口径 | 退出码 |
|------|------|---------|--------|
| `scripts/check-visual-grammar.mjs` | R1 radius 记档 0–4px · R2 `--radius-full` 仍为真圆(**正向守卫**,防「一并归零」把 avatar/switch/slider/radio/progress/scroll-area 全方角化)· R3 `--radius-cta` 存在且为 0 · R4 CTA/badge 表面零 `rounded-full` · R5 彩色阴影令牌已退役 · R6 `.bain-card` hover 无位移抬升 · R7 业务代码零彩色阴影消费 · R8 组件级圆角令牌落进记档(补 R4 的令牌路径盲区)· R9 按钮尺寸档直角 + `icon` 档保持圆(**双向**)· R10 hover 抬升数 ≤ 登记上限(**递减棘轮**,变少不判红但把下调提示写进 note)· R11 tailwind 映射的 `var(--*)` 必须在 `globals.css` 有声明(**僵尸令牌守卫**) | 每条规则各报自己的分母;**分母为 0 = 判据没有目标 = 未能度量(EXIT=2),不算通过**。唯一例外是 R7:它的分母是「仍在消费彩色阴影的文件数」,0 表示已清零(成立) | 0 成立 / 1 判红 / 2 未能度量 |
| `scripts/check-accents.mjs` | 营销面(`src/**` 排除测试与 `_archive`)不得出现 `accent-*` 类彩色编码 | 扫描源文件数;命中数与命中文件数一并打印 | 0 成立 / 1 判红(含**豁免腐化**:按名登记的豁免文件命中变 0 亦判红)/ 2 未能度量 |
**两条闸各自的口径边界(必须读,否则会把它当成"视觉已达标")**:
1. `check:accents` **只覆盖 Tailwind 类名通道**。第二条彩色编码通道是
`src/lib/constants/hero-themes.ts` 的 `accentColor`,它以内联样式进
`src/components/detail/detail-hero.tsx:81-86`(`backgroundColor` / `color` / `borderColor` / `--badge-accent`)。
实测 11 个主题里 **7 个用非品牌色相**(erp `#1e3a5f`、crm `#1e40af`、bi `#0c4a6e`、cms `#14532d`、
sds `#78350f`、oa `#4c1d95`、novavis `#0f3d3e`),落在产品·方案·服务详情页 hero 徽章上。
该闸的成功输出行已把这层边界印在屏幕上,判据措辞与被验的那一维保持一致
(登记于 `docs/acceptance/qa-tracker.md` §11.4 DEC-N1,待设计裁定)。
2. R10 是**存量棘轮**不是"已合规":28 处 / 19 文件的 `hover:-translate-y` 仍在,
本批只保证它不再增长。全站清账属于模板批。
**自证的可失败性证据(本轮实测)**:
- `check:grammar:selftest` ⇒ R1–R9 对已知违规全部判红(9/9);R10 在 28 处不判红、29 处判红;R11 抓到未声明引用且不误报已声明引用。
- R11 的**负对照已在真树上执行**:把 `boxShadow.brand/'glow'` 两行映射塞回 `tailwind.config.js` ⇒ `EXIT=1`、报出 2 条悬空;还原 ⇒ 11/11 成立。探针与读数存 `docs/acceptance/2026-10-17-ia-e2e/`。
- `check:accents:selftest` ⇒ 三个情景**各测一维**(违规 / 豁免腐化 / 全绿)。写成一份夹具是不行的:「营销面有违规」与「三条豁免都有命中」互斥,塞进同一份数据会让腐化那一维永远为假。
**为什么自证必须先跑**:本轮真实踩到 `checkGrammar` 把 `results` 累加器挂在 module 层,
第二次调用往同一数组追加、`.find("R10")` 取到第一次读数 ⇒ 主流程只调一次所以毫无症状
(`docs/lessons-learned.md` §5.40)。
**已接地的动态 axe 门禁(2026-09-23)**:`check:axe` / `check:axe:routes` 的脚本已落到常驻位置 `scripts/accessibility/{axe-node-count,crawl-routes}.mjs`(原 `docs/acceptance/2026-09-21-axe/` 的一次性 harness 平移而来,证据 JSON 仍留原目录,最终树 34 路由 × 4 组合 `passed=true`)。判定从「打印 PASSED」升级为**退出码**:0 通过 / 1 判红(任一引擎×主题组合的 violation 节点 > 0、主题或底色不匹配、三条规则级规则的分母不闭合、扫描中断)/ 2 清单缺失或解析出 0 条。CI 接线在 `Jenkinsfile`「♿♿ 全站 axe 节点计数」阶段(仅 main,复用上一阶段的 `dist/standalone`,按 `node dist/standalone/server.js` 起服务,`set -e`、无 `|| echo`),因此它是**真实的自动化门禁**而非可选脚本;但它不在 `check:a11y` / `test:all` 伞下(那三条是零服务依赖的静态检查,axe 轮需要生产服务与两个浏览器引擎)。复跑口径与静态资源装配要求见 `docs/testing.md`「axe 全站节点计数门禁(验收 §8-⑤)」一节。
@@ -165,7 +210,7 @@ Closes #123
### 7. 一键门禁 `npm run test:all`
`type-check` → `lint` → `test:coverage` → **`test:integration:real`** → **`check:a11y`** → `test:e2e:fast` → `test:security:headers`(`package.json:48` 原文即此七段,勿凭记忆省略 `test:integration:real`)。注意最后一项 E2E 仍是 **dev 目标**(`@smoke|@critical`),GA4 的 16 个实例同样 skipped,故 `test:all` 绿之后仍需按 §6 补 `test:e2e:prod`。
`type-check` → `lint` → `test:coverage` → **`test:integration:real`** → **`check:a11y`** → **`check:visual`** → `test:e2e:fast` → `test:security:headers`(`package.json` 的 `test:all` 原文即此八段,勿凭记忆省略 `test:integration:real`。2026-10-17 新增 `check:visual` = `check:grammar:selftest` → `check:grammar` → `check:accents:selftest` → `check:accents`,**自证先跑**:自证失败的闸不许用它的绿灯出结论。见 §5.2)。注意最后一项 E2E 仍是 **dev 目标**(`@smoke|@critical`),GA4 的 16 个实例同样 skipped,故 `test:all` 绿之后仍需按 §6 补 `test:e2e:prod`。
## 提交与 PR 流程(PR-First)
+73
View File
@@ -617,6 +617,10 @@ git config --get-regexp -i "gitea|credential" 2>/dev/null # ← 空
| 2026-10-08 | 增加 §5.33(把「本轮零源码改动」误用成「参照与树同源」⇒ 将 `+30px` 判成运行期漂移;实际旧参照采集树是 `040951c`(09-22),当前树含 `a366bd1`(09-28 第五轮),根因是 Q-6 count-up 动画从 render 体迁入 `useEffect`,旧参照冻结了中间帧。附三条口径:归因须对「采集树 vs 当前树」、基线数量须标「例/张」、裸 `--update-snapshots` 实为 `changed` 模式不重写通过项) | `docs/acceptance/2026-10-08-baselines/{attribution.md,row-diff.cjs}`、`docs/acceptance/qa-tracker.md` §9.4 |
| 2026-10-08 | 增加 §5.34(`deploy.sh` 打印「🎉 部署成功」后线上实为破站:HTML 全 200 而首页引用的 CSS/JS/图标全 404。根因 = nginx web root 需要 `dist/_next/static/**`,而 `next build` 出 `dist/static/**`、`postbuild` 只补 standalone 形态,历史镜像被 `rsync --delete` 抹掉。三条规则:部署后验证须从页面实际引用的 URL 取样并做负对照;`--delete` 目标若被别的流程写入则本脚本须自行重新生成;改产物形态前先确认另一侧契约。附「用 nginx access.log 历史状态码区分我引入 vs 既有」与「`docker inspect` 看真实挂载而非读仓内 compose」两条取证法) | `docs/acceptance/qa-tracker.md` §10、`scripts/deploy.sh` 步骤 1.5 + 资源断言、`docs/deployment.md` §七 |
| 2026-10-08 | 增加 §5.35(把「命令报错」读成「查无此项」:`git config --get-regexp -i …` 因非法开关报错、被 `2>/dev/null` 吞掉,于是把「本环境无 Gitea token ⇒ PR 不可执行」写成连续两轮台账假事实;凭据其实在 Xcode 系统级 `credential.helper=osxkeychain` 里,API 现取 200,PR #29 已建成。三条规则:负命题探测禁止丢 stderr 且要看退出码、凭据发现要用 `git credential fill` / `--show-origin`、写进台账的「不可执行」是最高成本假事实且须附可复跑证伪命令) | `git config --show-origin --get-regexp credential`、`docs/acceptance/qa-tracker.md` §8.5 B / §9.5 B / §10.7 |
| 2026-10-17 | 增加 §5.38(`npm run lint \| tail` 把真实的 `LINT_EXIT=1 / 2 errors` 吞成 0;本仓 memory 已立过同条仍复犯 ⇒ 门禁命令一律重定向到文件再读退出码,`for s in …; do npm run $s \| tail` 形式会把一整批闸的退出码统一替换成 0)| `docs/acceptance/qa-tracker.md` §11.2 D-1 |
| 2026-10-17 | 增加 §5.39(注释写在 JSX children 位即成文字节点:type-check、1747 例单测、`npm run build` 三道全绿而页面上看得见 `/* … */`;唯一静态防线是 `react/jsx-no-comment-textnodes`。新增回归断言配「敏感性证明」——先断言被污染的两段 DOM 真渲染了,再用变异确认只有这一条转红)| `src/app/(marketing)/solutions/solution-detail-content-v3.test.tsx`、qa-tracker §11.2 D-2 |
| 2026-10-17 | 增加 §5.40(仪器只在被复用时才坏:`results` 累加器挂 module 层 ⇒ 第二次 `checkGrammar` 的 `.find("R10")` 取到第一份读数,棘轮负对照被读成不判红;同族第二例是自证夹具把「营销面违规」与「豁免全命中」两个互斥前提写进同一份数据,使腐化那一维永远测不到 ⇒ 拆成三个各测一维的情景,含一个全绿情景防恒红)| `scripts/check-visual-grammar.mjs`、`scripts/check-accents.mjs` |
| 2026-10-17 | 增加 §5.41(僵尸令牌:CSS 声明退役而 tailwind 映射未删 ⇒ 类照生成、`var()` 静默取空;R5/R7 各看一侧所以两条都绿。删映射并新增 R11 反向守卫(外部所有者按名豁免且豁免腐化亦判红),负对照实测 `EXIT=1 / 悬空 2 条` ⇒ 还原 11/11。附两条仪器纪律:豁免名单单一真源、先怀疑夹具再怀疑判据)| `tailwind.config.js`、`scripts/check-visual-grammar.mjs` R11、`docs/acceptance/2026-10-17-ia-e2e/` |
### 5.36 判据的适用对象没写进判据:diff 包围盒对全页截图必然假红
@@ -648,3 +652,72 @@ P1 色板迁移改了 `globals.css` 68 处 hex,第二批重跑基线却报 **1
它守版式与图形不走样;色板到位由 `check:token-twins`+`check:contrast` 分工担保。
另:104 张基线(≈138 MB)压在单个 commit 会被 Gitea 的 HTTP 413 拦下,按 project 拆成 5 个 commit
再逐笔 `git push origin ${sha}:refs/heads/<br>` 才推得动(详见 §5.35 同族的"命令报错不等于查无此项")。
### 5.38 管道吞退出码又复犯一次,而这次它吞掉的是「两个 error」
`npm run lint | tail -6` 之后 `echo $?` 读的是 `tail` 的退出码。本仓 memory 里
(`feedback-scratch-probe-pitfalls`)已明写过这条,仍在同一轮里踩中:真实输出是
**`83 problems (2 errors, 81 warnings)`、`LINT_EXIT=1`**,而我打印出来的是 `LINT=0`。
纪律:**门禁类命令一律重定向到文件再读退出码**,不许接管道。
```bash
npm run --silent lint > /tmp/lint.txt 2>&1; echo "EXIT=$?" # 对
npm run --silent lint | tail -6; echo "EXIT=$?" # 错:拿到的是 tail 的
```
同一条 `for s in a b c; do npm run --silent $s | tail -4; done` 形式尤其危险:
它把每个闸的退出码统一替换成 0,一整批"绿灯"里没有一个是真的。
### 5.39 合法 JSX 里的注释会渲染成页面文字:type-check、1747 例单测、build 三道全绿也拦不住
上一笔为了修「注释占了 ternary 分支根位导致 Turbopack 报 `Expected '</', got 'ident'`」,
把注释从分支根位挪进了 JSX children —— 但没包 `{/* … */}`,于是它变成**文字节点**:
```jsx
<div className="w-14 h-px bg-brand" />
/* 这段解释会在页面上被读者看见 */
<span className="text-xs …">Solutions</span>
```
`npm run type-check` EXIT=0、1747 例单测全绿、`npm run build` EXIT=0、视觉基线也不认得它。
唯一拦住它的是 ESLint 的 `react/jsx-no-comment-textnodes`(severity=error),
而它的 EXIT=1 恰好被 §5.38 那个管道吃掉。⇒ 三条教训合成一条:
**"编译通过 + 测试通过" 对"内容是否被正确渲染"这一维根本不敏感**;
新增守卫时断言要配**敏感性证明**——`solution-detail-content-v3.test.tsx` 里那条
`container.textContent` 不含 `/*` 的断言,先断言被污染的两段 DOM 确实渲染了
(`Solutions` / `推荐产品组合` / `+`),否则"找不到注释"可能只是"那段根本没出现";
再用变异验证(把注释改回裸文本 ⇒ 仅这条转红、其余三条仍绿)。
### 5.40 仪器只在被复用时才坏:module 层累加器让第二次读数是第一次的
`check-visual-grammar.mjs` 把 `const results = []` 和 `rule()` 放在 **module 作用域**,
`checkGrammar()` 只往里 push、不重置。主流程调一次 ⇒ 毫无症状。当我为了自证 R10 棘轮
而**第二次**调用 `checkGrammar` 时,`.find(x => x.id === "R10")` 命中的是数组里**第一份**读数
(喂的是 0 处抬升的坏样本),于是"上限+1 判红"这一维被读成不判红,自证 EXIT=1。
判据:任何"被喂样本"的函数**不得依赖调用间可变状态**。累加器收进函数作用域后复跑通过。
同族缺陷在本轮还有一次:自证夹具把「营销面有违规」和「三条豁免都有命中」两个**互斥前提**
写进同一份数据,导致"豁免腐化"那一维永远为假 —— 拆成三个各测一维的情景(含一个全绿情景,
防的是判据写错成恒红也会"抓到所有负例")。
### 5.41 僵尸令牌:删了 CSS 声明却没删 tailwind 映射,类名照生成、值静默为空
`--shadow-brand / --shadow-brand-hover / --shadow-glow` 三枚从 `globals.css` 退役后,
`tailwind.config.js` 里 `boxShadow.brand/'brand-hover'/glow` 三行映射**原样留着**。
后果不是报错:`shadow-brand` 这个类仍被生成,展开成 `box-shadow: var(--shadow-brand)`,
而该自定义属性无人声明 ⇒ 运行时取空、**静默什么都不画**。
`check:grammar` 的 R5(令牌已退役)和 R7(业务代码零消费)当时**都是绿的**——
因为它们各看一侧,谁都不看 tailwind↔CSS 这条缝。这与 §5.37 是同一族:
一个语义有多条表示通道时,守卫必须按定义逐通道对账。
处置:删掉三行映射,并新增 R11「tailwind 引用的 `var(--*)` 必须在 `globals.css` 有声明」,
外部所有者的变量(`--radix-accordion-content-height`)按名登记豁免、且**豁免腐化亦判红**
(登记了却没被引用 = 红)。R11 负对照已执行:把两枚退役映射塞回 tailwind ⇒
`EXIT=1 / 悬空 2 条`,还原 ⇒ 11/11 成立;实测引用 144 个变量、悬空 0。
写 R11 时自己踩了两个小坑,都值得记:
① 豁免名单写在规则里、夹具里再手抄一遍 ⇒ 改一处另一处悄悄失效(把名单提到 module 层共用);
② 夹具不带那条外部所有者引用 ⇒ 「豁免腐化」先判红,把"已声明不误报"这一维污染成假红,
差点被读成判据坏。**先怀疑夹具,再怀疑判据**。