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
This commit is contained in:
1 parent
bcd32b3784
commit
6c9900ffed
4 files changed
+22
-4
No files matched your search
@@ -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`
|
||||
|
||||
Reference in new issue
Block a user