工作流验收门禁规则

适用于跨角色流程（派单、审批、整改、维保）的端到端验收与发布门禁。

规则文件内容

请复制以下内容，保存为 .cursor/rules/workflow-acceptance-gates.mdc：

---
description: 工作流验收标准、阶段门禁、回退路径与发布准入规则
globs: tests/e2e/**, src/modules/workflow/**, docs/acceptance/**
---

# 工作流验收门禁业务规则

## 1. 核心原则
- **流程闭环可验收**：每个流程必须跑通“创建-执行-完成-归档”。
- **角色权限可验证**：不同角色操作边界必须可测试。
- **门禁结果可发布**：未通过门禁不允许进入生产。

## 2. 验收阶段定义
- `G1`：功能通路（主流程）
- `G2`：异常分支（回退、重试、拒绝）
- `G3`：权限与审计
- `G4`：性能与并发基线

## 3. 验收用例规则
- 每个流程至少 1 条主流程验收用例。
- 每个关键节点至少 1 条异常分支用例。
- 每个关键角色至少 1 条权限拒绝用例。

```ts
interface AcceptanceGateResult {
  gateCode: 'G1' | 'G2' | 'G3' | 'G4';
  passed: boolean;
  blockerCount: number;
  warningCount: number;
}

4. 发布门禁规则

• G1/G2/G3 任一失败：阻断发布。
• G4 未达标：允许灰度但需限流与观察窗口。
• 所有 blocker 必须绑定缺陷单号。

5. 数据与环境规则

• 验收环境需接近生产配置。
• 测试数据必须可重复构造、可清理。
• 第三方依赖建议使用沙箱或稳定桩服务。

6. 审计与留痕规则

• 每次验收需生成报告并归档。
• 报告必须包含版本号、提交号、执行人。
• 门禁豁免必须有审批记录与到期时间。

7. 回归联动规则

• 关键缺陷修复后必须触发相关流程全链路回归。
• 同类流程可复用验收模板，减少重复建设。
• 版本发布前需重跑最近 30 天高频失败场景。

8. 数据模型约束

• acceptance_plans 必须包含：plan_id, workflow_code, version, owner_id, status
• acceptance_cases 必须包含：plan_id, gate_code, case_id, priority, expected_result
• acceptance_runs 必须包含：run_id, plan_id, gate_code, result, blocker_count, executed_at

9. 实施注意事项

• 建议验收结果接入 CI 状态检查。
• 可视化展示 blocker 趋势，支持版本决策。
• 流程验收模板建议按行业场景沉淀。

## 适用场景

- 工单与派单流程验收
- 审批与整改流程发布
- 多角色业务系统上线门禁

## scripts 可执行校验版本（P3）

- **脚本路径**：`yihuohao/proven/dev-assets/cursor-skills/scripts/check-workflow-gates.cjs`
- **输入文件**：`gates` 数组 JSON（`G1~G4` 的通过状态与 blocker 数）

```bash
node yihuohao/proven/dev-assets/cursor-skills/scripts/check-workflow-gates.cjs ./acceptance-run.json

• 校验结果：G1/G2/G3 失败或存在 blocker 时返回退出码 2。