novalon-website/CONTEXT.md

Novalon Website - 领域术语表

核心实体

设计 DNA (Design DNA)

基于 Accenture + Bain + Porsche Consulting 三家顶级咨询公司设计体系分析后，整合出的 Novalon 三维设计基因：

• 维度一：Design System（设计系统）：可量化令牌（颜色、排版、间距、布局、形状、阴影、动效、组件）
• 维度二：Design Style（设计风格）：定性感知（氛围、视觉语言、构图、图像、交互感、品牌语气）
• 维度三：Visual Effects（视觉效果）：特殊渲染（滚动动效、微交互、视差、SVG 动画等）

决策状态：✅ 2026-06-28 确认

咨询专业风（Consulting Professional）

Novalon 网站的主体视觉骨架。核心特征：

• 墨色为主、留白克制、强对比排版
• 数据驱动、答案优先的内容策略
• 模块化网格布局、工业化组件系统
• 参考对象：Accenture（系统化）+ Bain（品牌清晰度）

决策状态：✅ 2026-06-28 确认（作为主体骨架）

水墨文化基因（Ink Cultural DNA） [已移除]

已通过 ADR-0006 决定移除。网站设计风格纯化为纯咨询专业风，不再使用任何水墨装饰元素。Logo 中的书法「睿」字保留（属品牌标识，非装饰性元素）。

决策状态：❌ 2026-07-10 移除（ADR-0006）

朱砂点睛

品牌红 #C41E3A 的使用原则——仅作点缀，不作为主色调。核心约束：

• 面积占比 ≤ 10%
• 使用场景：Hero 关键词、CTA 按钮、关键数字、模块标签、链接强调、下划线
• 用法向 Bain 看齐：精准、克制、有记忆点

品牌红贯穿规则（每页必有品牌红）： 每页至少 3 处品牌红触达点，确保品牌识别一致性：

1. Hero 区域：1 个 badge 标签或 1 个关键词高亮（二选一，不叠加）
2. CTA 区域：主按钮使用 brand 色
3. Section 标签：Eyebrow 下划线装饰（4px 品牌红短线）
4. 数据高亮：关键数字（≤2 个/页）
5. 链接交互：hover 态、导航激活态、表单聚焦态统一使用品牌红

品牌红禁止使用场景：

• 禁止作为段落文字颜色
• 禁止大面积背景（badge 背景除外）
• 禁止与辅助色（蓝/青/琥珀/紫）在同一卡片内同时出现

决策状态：✅ 已确认（2026-06-28 重申约束，2026-06-29 补充贯穿规则）

品牌色令牌的语义拆分（2026-09-04 新增 · 暗黑模式修复）

品牌红必须区分「文字」与「底色」两种用法，二者不能共用同一个 CSS 变量：

utility	变量	浅色	深色	适用
text-brand-ink	--color-brand-ink-rgb	#C41E3A	#F87171	品牌色文字：eyebrow、指标数字、标签、链接 hover
bg-brand / border-brand	--color-brand-rgb	#C41E3A	#C41E3A（不翻转）	按钮底色、边框、图标填充
bg-brand-bg	--color-brand-bg	#FEF2F4	#2A1418	品牌浅底块（与 --color-error-bg 同口径翻转）
--badge-accent-text	--badge-accent（组件注入）	accentColor 原色	color-mix(accent 45%, white)	DetailHero 徽章：accentColor 直用作深底文字不可读（#1e3a5f 深底 1.65:1），经 CSS 变量间接引用后按主题自动适配

依据（WCAG 相对亮度实测，非估算）：

• 红底白字按钮 #C41E3A × #F8FAFC = 5.58:1；若把按钮底整体换成 #E04A68 会掉到 3.75:1 → 所以绝不能整体提亮 --color-brand
• 深色下品牌文字取 #F87171：于 #0A0E14 / #0F1419 / #151B23 分别 6.99 / 6.69 / 6.26，全达 AA； 且它已是深色主题 --color-error-text 的既有值，不引入新色值

例外 —— 以下场景保持 bg-white + text-brand（不用 brand-ink），因为它们是恒定品牌红/深色 区块上的白底反转元素，白底在两主题下都不翻转：CTA 区块白底主按钮、品牌红指标块上的白底角标、 Switch / Slider 的白底圆钮。

决策状态：✅ 2026-09-04 全站审计后确认（深色对比度违规 683 → 0）； ✅ 2026-09-04 生产构建终验（33 路由 × 双主题 P1=0 / P3=0，剩余 P2 全为 GA 外网噪音）

动效设计四原则 (Motion Design Principles)

基于 Porsche Consulting "用动效象征变革"理念，统一全站动效语言：

1. Purposeful（有目的）：每个动效必须服务于内容传达，不做纯装饰动效
2. Fast（快节奏）：入场 180–280ms（--transition-fast … --transition-normal），hover 150ms，反馈 100ms
3. Natural（自然）：统一使用 ease-ink [0.22, 1, 0.36, 1] 作为默认缓动曲线
4. Layered（分层）：子元素入场 stagger 30-60ms，Section 间 stagger 100-150ms

动效禁止事项：

• 禁止连续循环动画（pulse-soft 除外，仅用于骨架屏）
• 禁止超过 700ms 的入场动效
• 禁止使用弹性缓动（spring）做内容入场（仅用于按钮按压反馈）

决策状态：✅ 2026-06-29 确认

服务编号+色条编码（Service Number + Color Bar）

服务模块的区分方式，取代纯颜色编码：

• 主要区分：大号数字编号（01、02、03...）
• 辅助区分：卡片左侧 4px 细色条
• 不整卡上色，保持专业感的同时提供快速识别

决策状态：✅ 2026-06-28 确认

墨韵流光 [已移除]

已通过 ADR-0006 移除。原包含旋转渐变边框和鼠标跟随光晕两个子机制，不再使用。

决策状态：❌ 2026-07-10 移除（ADR-0006）

HSI 架构 (Hub-Spoke-Independent)

Novalon 网站的信息架构模型，参考 IHG 洲际酒店集团官网模式设计。三层结构：

• Hub（枢纽）：/products 产品目录作为统一入口，内部分为"企业套装区"和"专业产品区"
• Spoke（辐条）：/solutions 解决方案作为行业场景入口，每个方案页面以"推荐套装组合 + 服务包"为核心叙事
• Independent（独立）：独立产品（安全/行业特种/硬件）在 Products 的专业产品区内拥有独立展示路径，不强制绑定特定解决方案

决策状态：✅ 2026-05-26 确认，见 ADR-0002

四层叙事模型 (Four-Layer Narrative)

所有详情页（产品/方案/服务/独立产品）统一采用的分层内容架构：

• Layer 1 Hero（情感入口）：大视觉 + 标题 + 一句话价值主张 + 状态标签。支持色调+背景+布局的有限变化
• Layer 2 价值理性支撑：按页面类型差异化——产品页展示功能模块与优势，方案页展示痛点→架构→组合，服务页展示挑战→成果→流程
• Layer 3 信任证明：案例故事、数据佐证、认证资质、客户评价。当前状态：全新层，现有页面完全缺失
• Layer 4 CTA 转化：主行动 + 次行动 + 交叉推荐（方案↔产品↔服务双向链接）

决策状态：✅ 2026-05-26 确认

Hero 变化策略 (Hero Variation Strategy)

详情页 Hero 区域的视觉差异化策略。在保持"水墨雅致"统一品牌的前提下，允许三类变化：

• 色调变化：不同产品/方案/服务使用不同的主色调或渐变方向
• 背景纹理：ERP 用几何网格、BI 用数据流线条、安全产品用盾牌纹样等语义化背景图案
• 布局微调：文字位置、元素排列可有小幅差异（左对齐/居中/右对齐等）

约束：Header / Footer / Breadcrumb / 设计令牌全站不变，仅 Hero 区内变化

决策状态：✅ 2026-05-26 确认（选型 C：色调+背景+布局）

企业套装 (Enterprise Suite)

Novalon 的 6 个核心产品，互为互补关系，常以组合形式出现在解决方案中：

• ERP 睿新管理系统、CRM 客户管理、BI 数据平台、CMS 内容平台、SDS 供应链决策、OA 协同办公

目标客群高度重叠（中大型企业），客户可能同时购买多个套装产品。

专业产品 (Standalone Products)

自成体系、不一定依赖企业套装的独立产品线：

• 安全产品（堡垒机/漏扫/零信任等）
• 行业特种软件
• 硬件产品

当前状态：近期有规划，需在本次重构中预留完整的模板体系

特效组件 (Effects)

该目录已不存在（口径核对 2026-09-23）：src/components/effects/ 在提交 37296b5（2026-05-10「三轮视觉改造与页面过渡动画」）中被整体删除 25 个文件，git ls-tree -r HEAD 与该目录的 ls 均为空。本节原文（"24 个视觉特效组件……大部分未被首页使用，属于技术债务"）是重构前的现状盘点，只作历史保留，不得再当作可寻址的目录引用。动效能力现在的落点是 src/components/ui/（scroll-reveal.tsx、animated-counter.tsx、brand-visuals.tsx）与 src/components/sections/（hero-particle-field.tsx + 其引擎）。

Design Tokens

.impeccable.md 中定义的设计令牌系统，包含颜色、排版、间距、卡片系统、Section 背景交替规则。当前状态：文档已定义，代码中 globals.css 有对应 CSS 变量，但组件层未完全落地。

关键决策

术语	含义	决策状态
信息架构	HSI 混合模型（Hub-Spoke-Independent），非纯层级也非纯平级	✅ 2026-05-26 确认
视觉策略	统一品牌"水墨雅致"为底，Hero 区域支持色调+背景+布局变化	✅ 2026-05-26 确认
叙事结构	四层模型（Hero → 价值支撑 → 信任证明 → CTA），全类型页面统一	✅ 2026-05-26 确认
实施范围	全量落地：6产品 + 4方案 + 4服务全部重构，独立产品预留空模板	✅ 2026-05-26 确认
重构范围	保持 Next.js App Router 架构不变，不更换技术栈	✅ 已确认（ADR-0001）
特效取舍	逐个评估 24 个特效组件，决定保留/改造/删除	✅ 已确认
首页 Hero 视觉方向	先用原型对比再决定（排版驱动 vs 墨韵背景 vs 中间路线）	✅ 已确认
web-design-engineer 定位	仅用于 Hero 原型验证，不用于全站重构	✅ 已确认
运营状态	未正式上线，重构风险可控	✅ 已确认
产品分类对齐	代码中 enterprise/growth/specialized 三分类与 CONTEXT.md 矛盾；统一为"企业套装区"（6核心产品）+ "专业产品区"（独立产品），删除 growth 分类	✅ 2026-06-07 确认
解决方案 L3 信任层	需补上 SolutionTrustSection，但初创阶段案例数据不足，标记为 TODO；空数据时显示"更多案例即将发布"而非空白	✅ 2026-06-07 确认（TODO）
独立产品组件统一	独立产品从 V1 组件迁移到 V2/V3 组件体系，通过 hero-themes 差异化（深色调、技术纹理、参数化布局）体现"硬核"风格，不维护独立设计系统；V1 组件迁移完成后删除	✅ 2026-06-07 确认
方案列表页组合叙事	解决方案卡片需展示"推荐组合"（如制造业=ERP+BI+SDS），让用户一眼看出方案=产品组合，体现 IHG Spoke→Hub 连接	✅ 2026-06-07 确认
Hero 视觉方向修正	当前深色渐变风格偏离"水墨雅致"品牌定位，需转向浅色/宣纸色底、深色文字、品牌色点缀；通过 web-design-engineer skill 做原型验证后再落地	✅ 2026-06-07 确认
导航体现 HSI 层级	Products（Hub）视觉权重最高，Solutions（Spoke）次之，Services 最轻；Products 下拉菜单需展示套装区/专业产品区分区	✅ 2026-06-07 确认
方案页删除服务方式区域	Solutions 列表页"服务方式"区域职责越界（属 Services 层），应删除；替换为方案→服务的轻量关联推荐链接	✅ 2026-06-07 确认
L3 信任层内容策略	初创阶段无真实案例/数据/资质，L3 暂不渲染；组件结构预留，数据就绪后启用。三档策略：有案例→正常展示；有意向→"正在服务中"标签；无数据→不显示 L3。阶段 0（2026-08-20）已落地：信任策略从「结果证据」转向「可验证的过程+能力+治理证据」——首页「共创计划」板块（共创进行中/产品内测中/成果授权公开三档如实状态 + 招募 CTA）、关于页资质区如实「建设中」空态	✅ 2026-06-07 确认 / 阶段 0 完成 2026-08-20
首页共创计划板块	成立 <1 年无真实案例时，以主动板块替代被动标签：page-copy 字段 earlyAccessTitle/earlyAccessCtaLabel/earlyAccessStatus 驱动首页「首批客户共创计划」板块，如实呈现共创/内测/授权公开状态并引导转化（成为共创客户 → /contact）。零编造：不虚构客户/数据/资质	✅ 2026-08-20 确认
数字口径 basis 结构强制	「每个数字带口径」从个别页自觉升级为结构约束：走共享数字样式渲染的指标（metrics/outcomes/dataProofs）必须声明 basis: target|team-history|verified，渲染端按 basis 自动附角注，缺失/非法保守回落到最弱的 target（「目标口径，非既成结果」）。CMS 侧 basis 为 select 字段，真实出路由业务在 admin 录入；metrics-basis.test.ts 机械校验 seed 全量条目显式声明、禁止条目无据自称 verified，并拦截「源自真实客户案例/经过实战验证」式虚构佐证文案。注意：字段定义改动需重跑 seed 同步 ContentModel.fields 后 admin 才出现该输入项；渲染端已对未同步数据兜底为 target	✅ 2026-09-20 确认（critique P0 收尾）
组件版本统一	独立产品迁移后删除 detail/（V1），将 detail-v2/ 重命名为 detail/，组件文件名去掉版本后缀（如 DetailHeroV3 → DetailHero）	✅ 2026-06-07 确认（待 Phase 0 执行）
设计定位	纯咨询专业风（Accenture + Bain + Porsche 三位一体），水墨元素已移除	✅ 2026-07-10 更新（ADR-0006）
设计 DNA 框架	三维度模型：Design System + Design Style + Visual Effects，基于 Accenture+Bain+Porsche 整合	✅ 2026-06-28 确认
服务区分方式	服务编号+色条编码（数字为主，4px 色条为辅），不整卡上色	✅ 2026-06-28 确认
叙事风格分层	首页/Solutions/Services 用咨询风，Products 用产品风为主+咨询风为辅；统一设计令牌，仅内容组织不同	✅ 2026-06-28 确认
重构实施路径	Phase 0 对齐清理 → Phase 1 首页与核心模板升级 → Phase 2 动效与体验打磨	✅ 2026-06-28 确认
品牌人格	复合人格：主色调是"专业可靠的老专家"，叠加"年轻有为的新锐"的活力，打底是"严谨精密的工程师"气质	✅ 2026-06-29 确认
品牌完成度自评	40/100。原因：只是换了配色和样式（骨架有了），但品牌灵魂、视觉资产、内容深度都严重不足	✅ 2026-06-29 确认
核心问题诊断	品牌定位无误，执行需跟上。通过 ADR-0006 移除水墨元素后，纯化咨询专业风	✅ 2026-07-10 更新（ADR-0006）
品牌提升优先级	前三件事：A)重做首页Hero > B)建立完整品牌视觉系统 > E)品牌故事页面（Q12）	✅ 2026-06-29 确认
设计DNA深化方案	Accenture骨架 + Bain血肉 + Porsche点睛，三阶段落地（地基→品牌→个性）	✅ 2026-06-29 确认（ADR-0004）
颜色策略	编号为主，色条为辅（保持当前方案）	✅ 2026-06-29 确认
内容策略	强借鉴Bain答案优先——首页首屏直接给出核心价值主张 + 量化成果	✅ 2026-06-29 确认
初创文案真实性	公司成立于 2026-01-15，成立不足一年；全站静态文案不再使用「12 年深耕 / 500+ 企业 / 8+ 年核心团队经验 / 大厂背景 / 头部咨询 / 全球顶尖伙伴 / 虚构客户案例 / 未取得资质认证」等无法验证的表述，统一改为「2026 年成立 / 首批客户共创 / 专业核心团队 / 结果导向」；产品种子与 ERP 升级专题页同步清理虚构案例/认证，并已重新执行 npm run db:seed	✅ 2026-08 确认
生产部署模式	2026-08 切换为混合渲染：next.config.mjs 使用 output: 'standalone'，Dockerfile.prod + docker-compose.server.yml 启动 Next.js 容器，Nginx 托管静态资源并代理 /api/*、/admin/*、ISR 回源；生产 SQLite 位于 data/prod.db，通过 DATABASE_URL=file:/app/data/prod.db 与 PRISMA_QUERY_ENGINE_LIBRARY 运行	✅ 2026-08 确认
动效强度	体验级全场景动效叙事（Porsche Consulting水准，但克制不炫技）	✅ 2026-06-29 确认
排版方向	Accenture信息密度 + Bain标题对比 + Porsche图文节奏的融合方案	✅ 2026-06-29 确认
品牌故事页品牌名	使用与 footer Logo 完全相同的青柳隶书 SVG path（BrandCalligraphyName），不加载 4.4MB 的 AoyagiReisho 字体文件，兼顾品牌一致性与性能	✅ 2026-08-18 确认
风格主词	Swiss Modernism 2.0（骨架）+ Bento Box Grid（信息组织）+ Hero-Centric & Conversion-Optimized（首屏转化）+ Trust & Authority & Social Proof（信任层）+ Motion-Driven（差异化记忆点）+ Accessible & Ethical（底线）	✅ 2026-08-18 确认
官网产品模块定位	IHG/字节式品牌矩阵：官网品牌宣传为主，产品矩阵页保留为聚合入口（每产品一句话定位+指标证据+外链独立站）；成熟产品 externalUrl 外链独立站（NovaVis → novavis.p.novalon.cn 已实践），未成熟产品官网详情页占位，独立站上线后切换外链。参照案例（已核实）：IHG 品牌组合页 / 字节跳动 bytedance.com/products / 腾讯 tencent.com/business.html（模式 B：品牌+品牌矩阵聚合页）；对照金蝶/用友（模式 C：产品为主，官网承载详情与转化）	✅ 2026-08-19 确认
品牌主口号	智连未来 · 成长伙伴 —— 您的数字化转型同行者（整句全站统一采用）。品牌叙事内核（定位声明 / 承诺 / L0 价值主张 / L1 三支柱 / 语气语调）见 docs/brand-narrative-core.md，作为全站文案统一唯一锚点	✅ 2026-08-19 确认
品牌叙事 CMS 化	品牌叙事内核全部下沉到 CMS site-config 模型（slogan / valueProposition / positioningStatement / brandPromise / toneOfVoice / pillars），后台可编辑；代码侧 COMPANY_INFO 与 BRAND_NARRATIVE（src/lib/constants/company.ts）作为未配置 CMS 时的兜底唯一真源，layout.tsx 读取后经 SiteConfigProvider 注入全站	✅ 2026-08-19 确认
结构性文案 CMS 化	新增 page-copy 内容模型承载各业务页面章节标题/眉标/描述/CTA/空状态，覆盖首页 + 服务/方案/产品/案例/新闻列表页，seed 写入 6 条（home/services/solutions/products/cases/news）。实现为「CMS 优先 + 硬编码兜底」：CMS 未配置时回退 TRUST_SIGNALS/EARLY_ACCESS/NARRATIVE_ACTS 等常量，保证任何情况不白屏。数据层新增 getPageCopy(pageCode) / getHomePageCopy()，各 page.tsx 读取后以 pageCopy props 传入组件。详情页小节标题、页面内嵌业务常量（服务流程/合作模式/产品组合）、Header/Footer 等 UI 外壳按 UI 职责保留代码。数据实体（服务/产品/方案/案例/新闻/指标/Hero）仍由 data-server 从 Prisma 读取	✅ 2026-08-19 确认
首页对标埃森哲重构（scene#16）	视觉基调：局部深色 Hero（推荐项）——保持浅色咨询风为底，仅 Hero 升级为全出血深色画布（近黑底 bg-ink + 白色 Logo /logo-white.svg + 品牌红 #C41E3A 单电压 ≤10%），制造埃森哲式戏剧感；实施范围：Phase A+B 全量——①内容支柱补齐：新增 Insights 行业洞察（2×2 gap-px 卡片网格 + 方法论/观点/共创类型标签）、FounderQuote 创始人观点（深红区块 + 白色点阵 + 大引言）、News 新闻动态（最近 3 条 + 查看全部）三个对标埃森哲思想领导力支柱的区块；②Hero 深色化；③CTA 签名符号：全站 Button 组件 rounded-md → rounded-full（Pill 胶囊化）+ ArrowRight 签名箭头。零编造内容原则：公司 2026-01-15 成立，Insights 兜底 4 条均为可验证方法论内容（不虚构研究报告/人名），FounderQuote 署名兜底「Novalon 创始团队」不虚构具体人名。实现：home-content-v15.tsx 替换 v14（9 区块顺序 Hero→Trust→Narrative→Insights→Services→FounderQuote→Cases→News→CTA），CMS 优先 + FALLBACK_INSIGHTS/NEWS 常量兜底；seed page-copy 新增 insights*/founderQuote*/news* 字段（upsert 幂等）。验证：tsc 0 errors / eslint 0 errors / Jest 128 套件 1621 通过 / Playwright 视觉回归 22 passed（macOS 11 限制下用 Chromium 117 兼容配置生成快照）	✅ 2026-08-31 确认（署名口径已被 2026-09-21 行修订）
FounderQuote 兜底署名改回法定主体名（修订上行）	上行的「Novalon 创始团队」与 p1-brand-visual-audit.spec.ts:30 的 FORBIDDEN_TEXT=/novalon/i 冲突，且对外可见文案的署名应是法定主体「四川睿新致远科技有限公司」的简称而非英文品牌名。裁定：改文案不改测试——FALLBACK_FOUNDER_QUOTE.name（home-content-v15.tsx:115）与 prisma/seed.ts:961 同步为「睿新致远创始团队」，单测 home-content-v15.test.tsx:181 随动。DB 侧 page-copy/home 的 founderQuoteName 实测为空，页面走兜底分支，无需授权写库；curl localhost:3000/ 复核渲染值为「睿新致远创始团队」且 0 处 "Novalon 创始团队"。零编造原则不变：仍不虚构具体人名	✅ 2026-09-21 确认（验收 §7-4 / 放行条件② 留痕）
装饰大字对比度口径	装饰性大字号文字（序号、客户名首字占位）不享有对比度豁免：axe-core 4.11.4 的 color-contrast 只看 DOM 可见文字颜色，aria-hidden / role="none" / CSS opacity 均不豁免（变体矩阵实测，仅 SVG <text>、CSS mask、::before 等非文本编码可绕）。全站统一用大字档令牌 text-text-hint（#7C8CA5 / 深色 #94A3B8，对各级卡片底色 ≥3:1，满足 WCAG 1.4.3 大字 AA），不再用 text-text-muted/10 之类低 alpha 淡化；口径由 scripts/utils/check-color-contrast.ts 的「大号装饰文本 × 各级卡片底色」契约组固化	✅ 2026-09-21 确认（验收 A-12 清零）
触摸目标口径	硬门禁 = WCAG 2.2 AA SC 2.5.8 ≥24×24px（含 Spacing/Equivalent/Inline 例外，正文内联链接按 display:inline 排除）；SC 2.5.5 的 44×44px 属 AAA，在 e2e/touch-targets.ts 中只作为建议清单打印、不使构建失败。此前测试把 44px 标为 AA 是标准档位错用	✅ 2026-09-21 确认
GA4 SPA pageview 标题时序	Next.js App Router 的 <title> 在路由 commit 之后 2–5 帧才写入（生产实测 chromium-mobile 第 2 帧、桌面 chromium 第 3–5 帧），因此 GoogleAnalytics.tsx 必须带帧预算（MAX_TITLE_SETTLE_FRAMES = 10）轮询等待标题变化后再 gtag('config')；超预算兜底发送（不丢计数），新导航前补发未送出的上一条 pageview（不送上一页标题）	✅ 2026-09-21 确认（验收 A-17）
iPhone SE 复核口径（放行条件⑥）	375×667 @2x + colorScheme 强制深/浅 × 同意条 pending/dismissed × 首页/新闻详情/新闻列表/联系页 = 16 组，证据（32 图 + measurements.json + 探针脚本）落在 docs/acceptance/2026-09-21-iphone-se/。实测：16/16 scrollWidth == clientWidth == 375（无横向溢出）、footerBottomGap = 64（验收 R-1 记录为 192–226 的双安全区空带）、滚到底后 footerBottomVsViewport = -128 一致；同意条在 pending 态以 bannerTop=461 覆盖页脚——这是 fixed bottom-16 浮层的设计行为，可关闭后消失。边界：这是浏览器仿真，不等同真机走查，真机确认仍需人工	✅ 2026-09-22 确认（验收 §8-⑥）
-[var(--color-*)]/<alpha> 死样式族的收口边界	编译产物实测：src 下 22 处 / 17 个唯一类在 CSS 中 0 产出（Tailwind v3 不能对纯 hex 变量套 alpha，见 tailwind.config.js:12-15）。按渲染证据分级后只修 2 处「活组件 + 仅 hover」：NewsDetailClient.tsx:49 → hover:bg-brand-soft、service-card.tsx:33 → hover:border-brand/20（hover 不入基线，零像素影响，已确认三条规则在编译 CSS 中产出）。注意点亮后的合成底色须重算对比度：hover:bg-brand/20 在浅色主题下使 text-brand-ink 降到 4.18:1（破 AA 4.5:1），且 axe 忽略 :hover、check:contrast 只断言令牌配对，两道门禁均测不到，故取 12% 的 brand-soft（浅色 4.80:1 / 深色 6.60:1）。不做：/privacy、/terms 首屏 via-[var(--color-brand)]/80 一旦被"点亮"会在已审批基线里画出半透明暗坑，属设计判断；3 处需先在 globals.css + config 补 --color-bg-section-rgb / --color-brand-bg-rgb 通道；其余 14 处位于无任何路由渲染的 barrel-only 死代码。是否扩 check-brand-text-token.ts 到全族由用户定范围	⏳ 2026-09-22 待裁定（残留项，不属验收 §8 六条放行条件）
英文 wordmark 的受控口径（续上上行 §7-4）	全仓唯一的字面 NOVALON 位于 public/logo.svg:72、public/logo-white.svg:72、public/logo-calligraphy.svg:72 的 <text> 元素，且各自行前注释 <!-- NOVALON - 英文 --> 自述为设计意图，三处 <text> 实测内容恰为 NOVALON（letter-spacing="4"，仅 fill 随底色不同：#0A0E14 / #FFFFFF）。提交 8d3bd72 另把书法人名统一到 header/footer/品牌页（新增 BrandCalligraphyName，改 public/logo.svg）。裁定：wordmark 属图形资产内的受控内容，不是文案回归；对外可见文本署名一律「睿新致远」（:195），src 下其余 novalon 串为技术上下文（novalon.cn 域名、novalon_admin_token 等存储键、PBKDF2 盐、管理端 Novalon CMS 界面）。据此把 e2e/p1-brand-visual-audit.spec.ts 从"零断言"改为三条真不变量：①两张 logo 资产经 page.request.get 取回后，每个 <text> 内容须恰为 NOVALON（改名、夹带或漏字即失败）；②header/footer/首页的可见文本、alt、title、hover 后文本零 novalon（技术上下文除外）；③凡"遍历后无命中即通过"的用例补 expect(checked/hovered/withAlt).toBeGreaterThan(0)，避免选择器失配伪装成绿灯。因 wordmark 以 <img> 加载、不成 DOM 文本，:173-177 的首页 Hero 豁免分支在生产 HTML 上当前不触发（改为内联 SVG 时会生效）——保留但不依赖。放行条件② 的「修订 CONTEXT.md 或测试」两条路径此处同时满足	✅ 2026-09-22 确认（验收 §7-4 / 放行条件②）
边界页（404 / 根错误兜底）的可测口径	⑤ 的扫描分母从 sitemap.xml（29 条）扩为 sitemap ∪ 预渲染产物 ∪ 站内链接 BFS = 35 条后，首轮即 passed=false（docs/acceptance/2026-09-21-axe/axe-evidence.json，双引擎双主题共 8 条 bad rows）：/_not-found 的 h1「404」用 text-brand-ink + opacity-20 ⇒ 有效 alpha 20%，color-contrast 必破；/_global-error 因项目无 global-error.tsx，由 Next 内置文档壳顶替 root layout ⇒ <html id="__next_error__"> 无 lang，且本站主题是 html[data-theme='dark'] 属性驱动（globals.css:396 明示非 .dark class），内置壳读不到令牌，深色落到浏览器默认 rgb(10,10,10)。裁定：边界页属全站范围，不豁免——404 与根错误页是每个访客都可能落到的页面，且是唯一的"无 CMS 数据兜底路径"。修复：404 标题改 text-brand-ink/80（120px 属大号文本，AA 需 3:1；沿用 §5.22 /products/erp-upgrade 水印数字的同一口径与同一档位），新增 src/app/global-error.tsx 自带 <html lang="zh-CN"> + <title>（错误边界是 Client Component，不支持 metadata 导出）+ 与 globals.css 同值的 OS 主题内联样式（CSP style-src 'self' 'unsafe-inline' 允许）。约束：①可见文本一律不得用 opacity-* 暗化，装饰性大字用可编译的主题令牌 + /80 档；②新增 app/ 顶层边界文件须自带文档壳与主题样式，且本版本 Next 的 global-error props 是 retry（node_modules/next/dist/docs/01-app/03-api-reference/03-file-conventions/error.md），不是旧 API 的 reset；③任何"全站 = 0"型门禁的分母必须是三源并集清单，sitemap.xml 只覆盖"希望被收录的页"，单独使用即为口径错误。配套回归：src/app/global-error.test.tsx（3 例：lang、retry 接线、digest 展示）	✅ 2026-09-22 修复并复扫通过：chain5/chain6 最终树 34 路由 × chromium/firefox × 深/浅 的 contrastNodes / violationNodes / themeMismatch / bgMismatch 全为 0、rows=136、passed=true（docs/acceptance/2026-09-21-axe/axe-evidence.json，详见 §5.24 与 docs/acceptance/2026-09-21-gates/final-tree-results.md ⑤）
refresh token 的轮换/吊销：本轮有意延后（需 schema 变更 = 需授权动作）	src/app/api/auth/refresh/route.ts 只验签名即用旧 payload 重签，意味着失窃的 refresh token 在到期前可无限换取 access token。闭合它需要 jti / tokenVersion 一类的服务端状态，即 Prisma schema 迁移——按 AGENTS.md §5.1「破坏性/共享状态动作须单独取得授权」，DB 迁移不在常规变更里夹带，故本轮明确延后并留痕（源码注释同处 :33-34 已写明 backlog）。已随车交付的缓解（不需迁移）：①按 payload.userId 实查 User，账号不存在或 status === 0 一律 401，堵住「被禁用/删除账号仍能在 7 天有效期内换新令牌」（B-7）；②角色不按令牌里的旧 claim 沿用，而是走 permissions 层的同源查询 UserRole 关联表后重签，无关联角色的历史账号回落到与 login 同源的 User.role 标量，避免降权后仍持旧角色。边界：这两条只保证「账号状态实时」，不构成令牌吊销——已签发且账号仍启用的旧 refresh token 依旧可用到过期	✅ 2026-09-23 确认（延后为有意决策，非遗漏；轮换/吊销待授权迁移）
CMS 写入侧字段校验的边界（承接「数字口径 basis 结构强制」行）	出路由 src/lib/cms/validate-content-data.ts 承载，挂在 POST /api/admin/items（:132）与 PATCH（:215）上，只执行 ContentModel.fields 已声明的约束：options 即视为枚举（select/dropdown 与带 options 的 text 在 content-types.ts 同义）、min/max/pattern；违规返回 validationError('内容字段校验未通过', { fields }) 并附每条 path。刻意保持宽松的两处：未声明的键一律放行、未填的键不判必填，以免改变既有载荷形态（seed 与页面组件依赖宽松结构）；loadDeclaredFields 在模型缺失或 fields 不可解析时回落 []，即fail-open（无声明 = 无约束），因此「后台有校验」不等于「值一定合法」，新增约束的正解是补 ContentModel.fields 而非在路由里加特例。basis 的强制仍在那一行的口径里：渲染端 metrics-basis-note.tsx:11 缺省回落 target，metrics-basis.test.ts 机械校验 seed 全量条目显式声明并禁止无据自称 verified；字段定义改动须重跑 seed 同步 ContentModel.fields 后 admin 才出现输入项	✅ 2026-09-23 确认（写入侧只判已声明约束 + fail-open 为有意取舍）
边界页（/_not-found / /_global-error）不带站点 Header/Footer	这是结构结果而非疏漏，本轮核实并固化为口径：src/app/not-found.tsx 位于 app/ 根、不在 (marketing) 路由组内，而 Header/Footer 只挂在 (marketing)/layout.tsx:14,22，故 404 页由 root layout 提供公共外壳（主题内联脚本、GA、CookieConsent、MobileTabBar）但无导航与页脚；NotFoundContent 自带恢复动线（返回首页 CTA + history.back() + 产品/方案/关于/联系四枚入口）。src/app/global-error.tsx 更彻底：按 Next 契约它自带 <html lang="zh-CN"> + <title> + 与 globals.css 同值的 OS 主题内联样式并顶替 root layout（node_modules/next/dist/docs/01-app/03-api-reference/03-file-conventions/error.md:163,165 明写"必须自带文档壳、不含全局样式、data-theme 到不了它"），因此两页都不能指望复用 Header/Footer 或品牌红规则；错误边界是 Client Component，metadata 导出无效，标题只能用 React <title>。约束：新增 app/ 顶层边界文件须自带文档壳与主题样式，且本版本 props 是 retry 不是 reset；给这两页补导航/页脚需先决定是否把 root layout 变成可复用外壳，属设计判断而非机械改动	✅ 2026-09-23 确认（口径固化，配套回归 src/app/global-error.test.tsx）
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，其修复标注在同一行）

门禁断言的有效性口径（chain6/chain7 新增）

验收期间发现 config/test/lighthouserc.json 有 3 条 warn 级断言（autocomplete-valid / presentation-role-conflict / svg-img-alt）在 Lighthouse 里根本没有对应审计项：把 chain6 全部 21 份报告的 audits 键取并集（175 个 id）比对 62 个非 categories: 断言键，只有这 3 条缺席；@lhci/cli@0.15.1 用的是它自带的 lighthouse@12.6.1（不是顶层的 13.4.1），其 core/audits/accessibility/ 64 个审计文件里没有这三个。它们每轮稳定打印 "…" is not a known audit. found: 0，因为是 warn 级永不判红 —— 于是"57 项 a11y 断言全过"里混进了 3 项什么都没测的条目。

约束（今后一律适用）：

1. 门禁里的每一条断言必须映射到真实存在的测量项。删除或新增断言都要留下"这项由谁兜底"的说明；warn 级、恒 0、无对照的断言按"假绿"处理，不得当作覆盖。
2. 拆门之前先证明覆盖还在别处。用与 ⑤ 门禁同款的 runOnly: {type:'tag', values:['wcag2a','wcag2aa','wcag21a','wcag21aa']} 做正/负对照（docs/acceptance/2026-09-21-axe/probe-axe-rule-coverage.mjs，每条规则各造一个必然违规的最小节点）：autocomplete-valid、svg-img-alt 确在 axe 通道内（各抓到 1 node）；但 presentation-role-conflict 属 best-practice tag，axe 门禁的 tag 集合根本不跑它。因此处理不是"删了事"，而是删死断言 + 在 axe-contrast-evidence.mjs（现 scripts/accessibility/axe-node-count.mjs）增加第二次 runOnly: {type:'rules', values:EXTRA_RULES} 运行。
3. 规则级通道也要断言分母：每页 extraRulesChecked === EXTRA_RULES.length（计 extraRulePagesUnderCovered）+ 违规节点 0。axe 对未知 rule id 会抛错，这一条同时防"将来某条规则被 axe 改名后静默消失"——与本节第 1 条是同一种病。
4. 异常快的绿灯必须自证。chain6 type-check 只花 2s，用注入 const probe: number = "not a number" 的正对照确认 tsc 能报错（冷缓存 11.1s）、删除后 2.9s 干净，成因是 tsconfig.compilerOptions.incremental=true 命中 .tsbuildinfo ⇒ 门禁有效。"很快/很慢"只是怀疑的起点，能造正对照就不要靠推断背书（与记忆「绿灯≠达标」同源）。
5. 文档里的数字要被复算，否则就从证据退化成传说：该口径本身成立，但它的示范当时写歪了——原文称「AGENTS.md §5 记的 lint『实测 105 条 warning』在 chain4/chain6 实测均为 106，已按实测改文并注明分布（56 no-console／25／12／10／其余 3 条零散）」，而 2026-09-23 本树复跑 npm run lint 实为 105 problems / 0 errors / EXIT=0、no-console 55 条，且"改文"落在未被 git 跟踪的 AGENTS.md 上（验收 N-16：由 next dev 再生，随时可丢）。裁定：warning 计数按轮次漂移，不作为常量引用；权威分布记录位改到 docs/development/quality-gates.md §1，并在其后附可复制的复算命令（含分项管道）。本条教训从"文档数字落后于实测"升级为"文档数字被写进了不可审的载体"。

来源：docs/acceptance/2026-09-21-gates/final-tree-results.md ④ 与「Lighthouse 的 3 条死断言」小节、docs/lessons-learned.md §5.25。

页面类型与四层映射

套装产品详情页 (/products/[id])

层	内容要点
L1 Hero	产品名 + 分类 + 状态 + 定位语 + 有限视觉变化（如深蓝调性）
L2 价值	核心功能模块 + 产品优势 + 技术规格 + 适用场景
L3 信任	适用行业案例 + 痛点→产品如何解决的故事
L4 CTA	预约体验 + 下载资料 + "使用此产品的客户也关注了 XX 方案"

解决方案详情页 (/solutions/[id])

层	内容要点
L1 Hero	行业名 + 方案标题 + 副标题 + 行业氛围视觉
L2 价值	行业痛点 → 方案架构图 → 推荐套装组合（核心差异点）
L3 信任	同行业标杆客户案例 + 实施效果数据
L4 CTA	预约演示 + 下载白皮书 + 相关产品深度卡片

服务详情页 (/services/[id])

层	内容要点
L1 Hero	服务名 + 定位语 + 服务范围标签
L2 价值	挑战→成果 KPI + 服务流程可视化 + 团队/方法论
L3 信任	服务案例 + 客户评价 + SLA 承诺
L4 CTA	咨询服务 + 相关方案推荐

独立产品详情页 (/products/[id] — 专业产品区)

层	内容要点	特殊之处
L1 Hero	产品名 + 类别标签 + 独立视觉调性	更"硬核"风格
L2 价值	功能特性 + 技术参数 + 对比优势	偏技术/参数导向
L3 信任	认证资质（等保/行业标准）+ 部署案例 + 性能数据	合规证明优先
L4 CTA	申请试用/演示 + 技术文档 + 可搭配套装推荐	不绑定特定方案

歧义已解决

• "重构"≠ 推倒重来：在现有 Next.js 架构内做系统性清理和提升，不更换技术栈
• "web-design-engineer"≠ 代码生成器：它是设计验证工具，产出原型 HTML，不是最终代码
• "克制动效"≠ 零动效：动效服务于信息传达（hover 反馈、scroll reveal、卡片交互），但不做装饰性粒子/水墨动画
• "参考 IHG"≠ 视觉模仿 IHG：借鉴的是 IHG 的信息架构思维（集团枢纽 + 品牌独立叙事），而非其视觉风格
• "产品独立"≠ 官网撤出产品：独立产品拥有独立子域名与独立叙事（NovaVis → novavis.p.novalon.cn 已实践，走 externalUrl 外链）；官网仍保留产品矩阵页作为聚合入口（每产品一句话定位+指标+外链），不承载深度详情
• "咨询专业风"≠ 丢弃水墨：水墨已从"整体风格"降级为"文化基因"，现通过 ADR-0006 完全移除。网站纯走 Accenture + Bain + Porsche 咨询专业风
• "设计 DNA 重构"≠ 从零开始：是对齐标准 + 清理债务 + 重点升级，而非推倒重来
• "Phase 0"≠ 没有产出：虽然是"脏活累活"，但通过组件减少、文件体积下降、测试覆盖率提升等可量化指标体现价值