Commit Graph
10 Commits
Author SHA1 Message Date
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