Commit Graph
13 Commits
Author SHA1 Message Date
zhangxiang f6e750c318 docs(runbook): 修正 build/up 串链位置——注释不能落在 && 之后(否则是 shell 语法错) 2026-10-20 08:23:49 +08:00
zhangxiang 702c732d27 fix(contact): 去掉 useSearchParams 让 /contact 可完整预渲染;补发布后 ISR 预热脚本
冷首访白屏的第二个真因:/contact 用 useSearchParams() 读 ?success,客户端组件里
这会让整页在预渲染时退化成 Suspense fallback(首访只看到「加载中…」,限速下 ~6s 才出内容)。
该参数只用于一次性成功提示 ⇒ 改为挂载后从 window.location 读并 replaceState 清理。

- /contact 冷首访 h1 可见:6.0s → 1.5s;HTML 73KB 含正文(此前只有外壳)。
- 新增 scripts/ops/warm-routes.mjs:按 sitemap 预热并断言全 200、第二遍 <1500ms 或 HIT;
  本轮线上第二遍:非 200 = 0、>1500ms = 0。
- 全站冷首访复测:/ 827ms、/about 1652ms、/contact 1511ms、/products 917ms、
  /services/software 922ms、/insights 1532ms。
- runbook:加发布前磁盘检查(≥2G)与「构建失败必须中止」;加 §4.0 预热步骤。
- 事故记录:第三次重建时服务器磁盘 99%,COPY 报 ENOSPC 而 up -d 仍执行(旧镜像被当已发布);
  清理旧备份 1.8G + docker image prune 1.075G 后回到 81%,重建 015b6d75 成功。
2026-10-20 08:23:34 +08:00
zhangxiang d0090cea56 fix(motion): reduce 偏好下 hydration 不匹配(React #418)且元素停在 opacity:0
线上 /about 白屏排查(§16):30 条路由 + 6 种环境里唯一可复现的缺陷是
webkit/chromium + prefers-reduced-motion:reduce ⇒ pageerror #418,main 内 14 个元素
opacity 恒 0(正常环境只有 3 个首屏以下的滚动入场项)。

根因:useReducedMotion 用 window.matchMedia 作 useState 初值 ⇒ SSR false、客户端首帧 true;
scroll-reveal / template / page-transition 又用它决定 initial/variants/甚至早返回不同树结构,
与 SSR HTML 不一致;且 reduce 时 whileInView 被清空 ⇒ 元素停在 initial 的 opacity:0。

修法(结构恒定,减少动效改用「时长 0」表达):
- hook 首帧恒 false,挂载后 effect 同步真实偏好;
- ScrollReveal/StaggerReveal 的 initial/whileInView/variants 不再按 reduce 清空;
- template.tsx 与 StaggerChildren 去掉早返回裸结构,改空 variants。

回归守卫 e2e/reduced-motion-hydration.spec.ts(/about 与 /):断言 reduce 自证生效、
无 hydration 错误、h1 与末段标题 opacity=1。变异验证:hook 改回 matchMedia 初值 ⇒ 2 红,恢复 ⇒ 2 绿。

另:runbook 明确禁止对 dist/_next/static 用 --delete(回访者旧 HTML 会引用上一代 chunk);
本轮已从备份 --ignore-existing 合并回旧代 101 个文件。复算:tsc/type-check:e2e 0、
jest 35 套件 462 例 0、check:visual 0、check:motion 0、视觉 chromium-desktop 25/25。
2026-10-20 08:00:20 +08:00
zhangxiang 524c1b6575 docs(release): 生产发布记录 §15 + runbook 更正「合 main 不会触发部署」
实测更正:Jenkins 任务 novalon-website-ci-cd 的 config.xml 是 <triggers/>(空)、builds 只有 permalinks
(从未构建)、匿名 POST /job/…/build 返 403、Gitea webhook 打不进去 ⇒「合 main 自动部署」当前不成立。
runbook §3 补「设计路径(需管理员加 GenericTrigger)」与「手动路径(本轮实际执行)」两节。

发布记录(§15):本地重建 → 服务器 dist/public 备份 → rsync 增量(3011 文件 / 2432 传输 /
线上 3.4MB,speedup 44)→ 镜像重建 c2c955d3 → 容器 healthy → 10 个页面全 200 →
线上 HTML 出现新标记(成果槽空态 / results-slot / 预约咨询 / 四轴导航)→ 服务端回退日志 0、error 0 →
停容器迁移(source=cms / issues=0,回传后 chown 1001:1001)→ 迁移后库读数:导航四轴 + 三模型门槛字段 ✓、
内容 38 行未变、案例 0 条 → 线上全页截图人工确认。回滚锚点三项已登记。
2026-10-20 07:49:56 +08:00
zhangxiang cee21e178a docs(ops): 生产侧核对与发布 runbook;新增最小迁移脚本 sync-cms-schema(默认 dry-run)
只读核对生产库(scp 副本、本地 node:sqlite 查询,未写生产):
- navigation 行仍是旧 7 项 IA(panels products,solutions,services)⇒ 新代码每请求退回代码真源;
- 三处 caseStudies 的 ContentModel.fields 缺 authorized/basis ⇒ 后台填不出门槛字段;
- 生产案例条目 **0 条** ⇒ 只发代码不会隐藏任何内容(dataProofs 按裁定不套硬闸)。

新增 scripts/ops/sync-cms-schema.ts:只补 3 个模型的两个子字段 + 把 navigation 行改写为
由 NAVIGATION_V2/MEGA_DROPDOWN_DATA 派生的形状;默认 dry-run,--apply 才写,
写前用真实 resolveNavigation 验收派生形状、写后强制复查(不通过即退出码 1)。
在生产库副本上预演通过:source=cms / issues=0;逐行 diff 证明只动了
3 个 ContentModel 行 + 1 个 ContentItem 行(navigation),其余 37 行内容与 13 个模型逐字节不变。

docs/development/deploy-runbook.md 写清:备份与停容器顺序、**服务器 Node v20 无 node:sqlite
⇒ 迁移必须本机跑再回传**、不推荐用 db:seed(会重写所有覆盖行且需 SEED_ALLOW_EXTERNAL_DB=1)、
发布后四项只读核对、三条回滚路径,以及"合 main = 无人值守线上发布,须决策人显式发起"。
2026-10-20 07:40:37 +08:00
zhangxiang 11afb2cc9f docs(sync): 按 AGENTS.md §6 把本轮五条裁定与三台新闸写回四份文档
- CLAUDE.md:新增 type-check:e2e 与 check:package-keys 两条命令及其存在理由。
- CONTEXT.md 关键决策表:追加 5 行(缓存失效单一真源 / 产品线色相受控例外 /
  动效时长按用途在消费点判 / 案例发布门槛 / e2e 与 scripts 的静态口径)。
- README.md:把「本批遗留待拍/待授权」整句换成 §12 轮的实际处置,含
  DEC-N2 被证伪一事;test:all 的描述由「原文七段」改为现取十段。
- quality-gates.md:新增「§12 轮新增/改写的门禁」表,每行都带自证或负对照读数,
  并写明仍未并入 test:all 的两项与 axe 的 :3100 编排口径。
- package.json:check:package-keys 入 test:all(十段),键唯一性由守卫自证 EXIT=0。
2026-10-17 08:19:10 +08:00
zhangxiang f23500ff07 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。
2026-10-17 01:08:45 +08:00
zhangxiang 6c9900ffed docs(qa): 视觉转绿后的四处文档同步,并更正 quality-gates 的 -u 模式假事实
- quality-gates.md §6.2:原文称裸 --update-snapshots 取 missing,实为 changed
  (program.js:202 preset);missing 是完全不带旗标时的缺省(common/index.js:584)。
  两种触发条件差异改写,读数补 125/0 与「例数 ≠ 张数」「归因须对采集树 vs 当前树」口径
- docs/testing.md:参照计数 107→132(每 project 21→26),原「用例数−参照数=覆盖空洞」
  算式已不成立,改为三个 shot 归组来源;N-15 空洞标注已闭合
- README.md:撤下「视觉 94/31」现行口径(改历史 + 125/0),例外清单移出视觉基线,
  新增 2026-10-08 轮次条目,台账指针 §8→§9
- qa-tracker 新增 §9.6:本树一手复测 type-check EXIT=0 / lint 0 error 104 warning
  (此前 PR 引用沿用他轮读数,不满足「命令实际执行过」条)+ 四处同步清单 +
  PR 描述 .pr-seal-2026-10-08.md 过门禁 EXIT=0
2026-10-08 17:18:06 +08:00
zhangxiang 1b8ffd5486 docs(seal): 2026-09-30 封版验收判定与证据入库 + 台账假事实更正
代码封版点仍是 a0328a6;本提交只含验收证据与文档,用于把台账
§0 的「未达可判验收通过(唯一阻断 AUTH-D1)」改判为「封版通过
(含例外清单)」。

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

更正 4 处文档假事实:DEC-N21b(/admin 实有服务端 gating,入口是
src/proxy.ts 而非 middleware.ts)、视觉基线「85 张未提交」(实测
107 张全在库)、「无需重跑 db:seed」(seed 改过 modelCode 而
permissions 精确匹配)、lint 105→104。
2026-09-30 23:41:22 +08:00
zhangxiang a0328a623f chore(qa): 验收台账与证据入库 + 构建/部署配置同步
- docs/acceptance/qa-tracker.md:跨周期缺陷单一真源台账(§7=第五轮)。
- 周期 1/2 + iPhone SE/axe 验收证据目录、ACCEPTANCE_REVIEW 快照入库。
- 同步 README/CONTEXT/CLAUDE/DESIGN/testing/deployment/lessons-learned 口径;
  next.config/Dockerfile/nginx/Jenkinsfile/docker-compose/sentry/prisma 对齐
  standalone 产物装配与部署形态。
2026-09-28 10:48:09 +08:00
zhangxiang 03ed066c6c chore(repo): 移植 PR-First 提交流程门禁(脚本 + Gitea PR 模板)
对齐 novavis AGENTS.md §27,逐项按本仓实测改写,不照抄不存在的命令:
- scripts/check-pr-checklist.sh:三种模式(模板结构 / 单 PR 文件 / --pr-dir 扫描)
  与退出码 0/1/2 保持同源;模板根改为按脚本自身位置解析并保留 AGENT_PROJECT_DIR
  覆写;修上游 --pr-dir 的参数解析缺陷(for arg in "$@" 内 shift 不消费值,
  目录会被再当成 PR 文件),改 while+shift
- .gitea/PULL_REQUEST_TEMPLATE.md:30 项 checklist 全部换成本仓真实门禁命令
  (type-check / lint / test:unit / test:coverage 阈值 / Playwright / visual /
  check:contrast / check:headings / lighthouse / test:security:headers),并补
  CMS 字段-需重跑 seed 声明、:3000 旧预览不作数、暗黑 token、动效 180–280ms、
  品牌红触达、数字 basis 口径等本仓专有约束
- 文档同源:docs/development/quality-gates.md 新增「提交与 PR 流程」权威副本
  (AGENTS.md 被 .gitignore 排除,不可依赖)、CLAUDE.md 补 Submission Flow 节

门禁自检:脚本 bash -n 通过;11 个用例覆盖三模式 + 缺节/缺文件/子项不足/非 PR
文件/未知选項/--quiet 等负路径,均带正控制以防「匹配零的假绿」。
2026-09-20 11:50:58 +08:00
张翔 498bb3a3c8 refactor: reorganize project structure and improve code quality
- Move CI/CD configs to config/ci/ directory
- Reorganize scripts into categorized directories (deployment, monitoring, testing, utils)
- Consolidate documentation into docs/ directory with proper structure
- Update linting and testing configurations
- Remove obsolete test reports and performance summaries
- Add new documentation for code quality tools and contact form security
- Improve project organization and maintainability
- Fix lint-staged config to only lint JS/TS files
- Disable react/react-in-jsx-scope rule for Next.js compatibility
- Ignore scripts and test config directories in ESLint
2026-03-24 13:38:58 +08:00
张翔 c06ac08510 docs: add quality gates documentation 2026-03-24 13:32:01 +08:00