hyb-oa/docs/ops/测试策略.md

Testing Strategy

Coverage Gate Policy

为保障核心系统迭代质量，目前系统配备了渐进式的覆盖率门禁（Coverage Gate）。

• 阈值标准： 核心关键模块代码行覆盖率要求 >= 70% 才能算作合格。关键模块目前指代：

  • src/services/featureFlags
  • src/services/verification
  • src/services/integrations/dispatcher.js
  • src/services/integrations/outbox.js
  • src/services/integrations/erp.js
  • src/utils/workflow.js

• 阻断策略：

  1. 在**Pull Request (PR)**中，覆盖率达不到门禁要求时系统将挂出 Warn 告警，但不会中断构建进度（即不强制干预协作交付）。
  2. 在main 分支中，低于上述覆盖率标准将抛出致命错误并标记部署失败（Error/Fail Block）。此外，全量域仅采取柔性报告并不强制失败。

CI Integration

流水线集成了 Vitest npm run test:coverage 与 node 自定义的 scripts/coverage_gate.js 保障上述策略。执行结果会自动附着于 Actions Job Summary。 机房脚本将自动解析 coverage-summary.json 从而提取对应业务模块的 lines.pct 并在 GITHUB_REF_NAME 为依据判定通过。

R66 小团队试点门禁

R66 面向 10 人以下团队试点，放行重点是主路径可用、备用模块不干扰、发布可回滚。

建议上线前执行：

bash scripts/qa/run-release-gate.sh r66-trialrun

该模式串联：

• static：部署契约、server prisma:validate、client typecheck/build。
• server-regression-all：后端全量业务回归。
• smoke-local：本地网页 smoke，覆盖登录、Portal、导航和企业微信入口基础 UI。

若本机数据库、Playwright 或公网 smoke 账号条件不足，必须在 deploy/trialrun/checklist.md 的 R66 小团队试点收敛检查中记录不可执行原因和手工替代步骤。