diff --git a/README.md b/README.md index ffcf15c..9bbd3db 100644 --- a/README.md +++ b/README.md @@ -31,13 +31,14 @@ - [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`),但**视觉回归在封版树上实测 94 passed / 31 failed**(20 张缺参照 + 11 张已过时参照,属 AUTH-D3 追认范围,已逐条归因,非像素级产品缺陷),生产目标 E2E 实测 **91 passed / 1 failed**(唯一红为 firefox 并发墙钟)。**计数一律不在此复制**:以 `npm run test:coverage`、`cd e2e && npx playwright test --list`、`docs/acceptance/2026-09-30-seal/final-verdict.md` §1 表为现取入口 +- [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] **官网产品模块定位(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)+ 关于页资质「建设中」如实空态,零编造 - [x] **生产部署上线(2026-08-20)**:`deploy.sh deploy`(本地 dist → 远端容器重建)+ 生产库 seed(page-copy/methodology 数据)完成;生产目录 Drizzle 残留源码归档清理;站点全路由 200、生产库 Prisma 结构 - [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`(§8 为现行判定),封版判定书与全部原始门禁输出见 `docs/acceptance/2026-09-30-seal/`。**判定 = 封版通过(含例外清单)**:例外均为「待业务口径」(4 条互斥 SLA、erp-upgrade 无 basis 数字)或「待授权的测试装配追认」(视觉基线、写库 E2E、全量变异),非代码质量问题 +- [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 当前树」,本轮内作废了自己一条「运行期漂移」错判) - [ ] **信任证据补齐·阶段 1/2(待内测/试点客户素材)**:如实披露「共创中/内测中/已交付」三档 + 经授权客户(脱敏);有交付成果后经授权公示可量化结果(零编造原则)——口径字段与 admin 录入口已就绪,待真实数据把 `basis` 从 `target` 升级为 `verified` ## 技术栈 diff --git a/docs/acceptance/qa-tracker.md b/docs/acceptance/qa-tracker.md index 6ad593a..3e3d815 100644 --- a/docs/acceptance/qa-tracker.md +++ b/docs/acceptance/qa-tracker.md @@ -372,3 +372,18 @@ S-3(about/contact/erp-upgrade 无 revalidate + revalidateTag no-op,涉渲染 | F | 推送本轮基线与文档 | 待批 | 未推集合现取 `git log --oneline origin/qa/seal-2026-09-28..HEAD`(起点是 `6ff19d1` 视觉基线入库);快进推送即可,但含 **17MB 新增参照二进制**,一旦推入即长驻远端历史,须知情后批 | | G | 移动档 +30/+21px 归因 | **已完成(本轮内,且推翻了自己的初判)** | 用 `row-diff.cjs` 定位发散行 y=7440 → `/products/erp` 的 `benefits` 段;根因是 `a366bd1` 的 Q-6 count-up 动画修复(旧参照冻结了动画中间帧)。取证法与教训见 9.4 | | — | AUTH-D2(重 seed)/ D4(写库 E2E 11 例)/ D9(Sentry 投递)/ D10(全量变异)/ D11(证据目录口径) | 状态不变 | 见 §2.3 | + +### 9.6 文档同步与本树一手复测(收尾轮末笔) + +**一手复测**(此前只在 PR 描述里沿用他轮读数,不符合「门禁命令实际执行过」条):`npm run type-check` **EXIT=0**;`npm run lint` **EXIT=0 / 0 error / 104 warning**。日志 `/tmp/tc-1008.txt`、`/tmp/lint-1008.txt`(临时件,不入库)。 + +**四处文档同步**(视觉层转绿后原叙述即成假事实): + +| 文件 | 更正 | +|---|---| +| `docs/development/quality-gates.md` §6.2 | **文档与代码矛盾**:原文写「`--update-snapshots` 不带值时 Playwright 取 `missing`」——实为 **`changed`**(`program.js:202` 的 `preset`),`missing` 是**完全不带旗标**时的缺省(`common/index.js:584`)。已改写两种触发条件的差异,并把读数更新为「封版树 94/31(历史)→ 2026-10-08 基线闭合后 125/0」,附「例数 ≠ 张数」与「归因须对采集树 vs 当前树」两条口径 | +| `docs/testing.md` 视觉节 | 参照计数 107 → **132**(5 project 各 **26** + `manual-acceptance/` 2);原「用例数 − 参照数 = 覆盖空洞」的算式已不成立,改为**三个 shot 归组来源**(按钮一例三张、输入框一例两张、L3 两例零张);N-15 覆盖空洞标注为已闭合并写明现在的语义锚点 | +| `README.md` 进度区 | 撤下「视觉回归在封版树上实测 94/31」的现行口径(改为历史 + 125/0 现况);例外清单里的「视觉基线」移出待授权项;新增 2026-10-08 轮次条目(agentic 选型 + `nav-keyboard` + AUTH-D3 闭合 + §5.33 教训);台账指针 §8 → **§9** | +| `AGENTS.md`(**被 `.gitignore:316` 排除,仅本机**) | 视觉回归行的 21 失败/104 通过/94-31 系列读数标注作废并指向 §9;lint 行补 2026-10-08 一手复测 104;`-u` 模式描述同 `quality-gates.md` 更正 | + +**PR 描述**:新建 `.pr-seal-2026-10-08.md`(覆盖 `a0328a6..HEAD` 全链,含 §8/§9 两轮),`bash scripts/check-pr-checklist.sh .pr-seal-2026-10-08.md` ⇒ **EXIT=0 通过**。按用户裁定与 `.pr-seal-2026-09-*.md` 同列**保持未跟踪**,需要时直接粘进 Gitea 表单;上一份 `.pr-seal-2026-09-30.md` 的叙述已停在 seal 轮,**不得再用于建 PR**。 diff --git a/docs/development/quality-gates.md b/docs/development/quality-gates.md index 65347e8..d106c0f 100644 --- a/docs/development/quality-gates.md +++ b/docs/development/quality-gates.md @@ -160,7 +160,7 @@ Closes #123 1. **`test:e2e:prod` 默认集合会写真库**:它的 grep 是 `@smoke|@critical|@journey`,**不排除** `e2e/cms-workflow.spec.ts`(`@critical`)与 `e2e/user-journey.spec.ts`(`@journey`),二者对 `/api/admin/items|media` 发真实写请求 ⇒ "prod" 不等于"只读安全"。要拿写库-free 凭据必须自己加: `--grep-invert 'cms-workflow\.spec\.ts|user-journey\.spec\.ts'`(`--grep-invert` 匹配的是含**文件路径**的 title path,先 `--list` 自证排除生效再实跑)。封版树实测:排除后 **92 例 → 91 passed / 1 failed**,`prisma/dev.db` 的 inode/size/mtime 跑前后完全一致。唯一红是 `[firefox] uj-09:124` 的并发墙钟(隔离与 4-project 复跑均绿),已登记 `docs/acceptance/qa-tracker.md` §2.4。 -2. **视觉比对必须显式关写入**:`--update-snapshots` 不带值时 Playwright 取 `missing`,会**静默创建**缺失参照。只读比对写 `--update-snapshots=none`,并先确认 `:3000` 无残留服务(`reuseExistingServer` 在 dev 目标下为 true,会静默复用旧构建)。封版树实测 **94 passed / 31 failed = 20 缺参照 + 11 已过时参照**,逐条归因见 `docs/acceptance/2026-09-30-seal/final-verdict.md` §2.2。 +2. **视觉比对必须显式关写入**:**不带 `--update-snapshots` 旗标**时 Playwright 取 `missing`(`node_modules/playwright/lib/common/index.js:584`),会**静默创建**缺失参照;而**裸 `--update-snapshots`(带旗标不带值)取 `changed`**(`node_modules/playwright/lib/program.js:202` 的 `preset: "changed"`),只写「缺失 / 比对不符」两种,**不会重写通过的参照**——所以「覆盖了多少张」可以直接当作「判红多少张」。只读比对必须显式写 `--update-snapshots=none`,并先确认 `:3000` 无残留服务(`reuseExistingServer` 在 dev 目标下为 true,会静默复用旧构建)。**读数口径**:`--update-snapshots=none` 在封版树(2026-09-30)实测 **94 passed / 31 failed**(20 例缺参照 + 11 例已过时,归因见 `docs/acceptance/2026-09-30-seal/final-verdict.md` §2.2);AUTH-D3 于 **2026-10-08 闭合**(写入 38 张 = 25 新 + 13 覆盖;**38 是文件数、31 是用例数**,一例可多 shot),随后独立只读复跑 **125 passed / 0 failed / EXIT=0**,取证见 `docs/acceptance/2026-10-08-baselines/`。**判红归因的参照系是「基线采集树 vs 当前树」**(`git log -1 -- <参照路径>` 现取采集树),「本轮相对上一轮零源码改动」只支撑绿灯平移、不支撑参照同源——详见 `docs/lessons-learned.md` §5.33。 3. **安全头不必打线上**:`scripts/utils/check-security-headers.ts:28-35` 支持 `--url`,因此可以对着本分支产物跑(`--url http://localhost:3100/` ⇒ 实测 7 PASS / 1 WARN / 0 FAIL,WARN 是 HSTS,由 nginx/CDN 边缘注入,http 目标本就不下发)。只有 `test:all` 的默认值指向 `https://novalon.cn`,那条在分支产物上结构上不可能全绿,两者不可混用。 ### 7. 一键门禁 `npm run test:all` diff --git a/docs/testing.md b/docs/testing.md index 06592cd..fe895a8 100644 --- a/docs/testing.md +++ b/docs/testing.md @@ -187,7 +187,9 @@ npx playwright test --grep @security # 浏览器侧的安全头用例(e **测试文件**: `e2e/visual-regression.spec.ts`(L1 全页 15 页 × 5 project + L2 组件状态 + L3 主题 = `--list` 实测 **25 例/project × 5 project = 125 例**) -> ⚠ 三个口径别混:`VISUAL_TEST_PAGES` 的**页面数** 15、每 project 的**用例数** 25、磁盘上的**参照 PNG 数** 107(5 个 project 目录各 21 张 + 目录外 `manual-acceptance/` 2 张)。用例数 − 参照数 ≠ 0 的那部分是**覆盖空洞**而非「多余用例」——`/products/erp-upgrade` 与 `/about/brand` 在两页于 5 个 project 下均无参照,另有卡片/输入框两例死在选择器上(`[class*="card"]` 零匹配、`input[type="text"]` 的 `.first()` 命中按设计隐藏的反垃圾蜜罐)。定性见 [docs/acceptance/2026-09-23-gates/final-verdict.md](acceptance/2026-09-23-gates/final-verdict.md) N-15 与 A-9。**`@visual` 标签不存在**(`e2e/*.spec.ts` 内零命中),视觉层只按 project / spec 文件选取。 +> ⚠ 三个口径别混:`VISUAL_TEST_PAGES` 的**页面数** 15、每 project 的**用例数** 25、每 project 磁盘上的**参照 PNG 数** **26**(全仓 `git ls-files e2e/visual-snapshots` 现取 **132 张** = 5 个 project 目录各 26 + 目录外 `manual-acceptance/` 2)。**例数 ≠ 张数**,三个来源:`按钮组件` 一例三张(`button-default/hover/focus`)、`表单输入框` 一例两张(`input-default/focused`)、L3 两例(H1 字体、品牌主色)**断言 computed style 不出图**。⇒ 写盘时「覆盖了多少张」不能直接读成「判红多少例」,须按 shot 归组对账(2026-10-08 实例:38 张 = 31 例)。 +> +> **历史覆盖空洞已闭合(2026-10-08)**:`/products/erp-upgrade` 与 `/about/brand` 曾在 5 个 project 下全无参照,卡片/输入框两例曾死在选择器上(`[class*="card"]` 零匹配、`input[type="text"]` 的 `.first()` 命中按设计隐藏的反垃圾蜜罐)——即 N-15 / A-9。现况:选择器已由 N-15(b) 改为语义锚点(card 走 `[data-testid^="bento-product-card-"]` + `role="listitem"` 钉住;input 走 `form input:visible` 并把蜜罐的存在/隐藏**单独断言成契约**),缺的 25 张参照已补齐并追认,只读复跑 **125 passed / 0 failed / EXIT=0**。取证与逐张读图:`docs/acceptance/2026-10-08-baselines/attribution.md`;判红归因的参照系教训:`docs/lessons-learned.md` §5.33。**`@visual` 标签不存在**(`e2e/*.spec.ts` 内零命中),视觉层只按 project / spec 文件选取。 **Project**: `visual-chromium-desktop` / `-tablet` / `-mobile` / `visual-firefox-desktop` / `visual-webkit-desktop`,全部 `reducedMotion: 'reduce'`