feat(req): 部署门禁制度 — PDV 验收任务 + Deploy Gate 1-3
在 /req deploy 流程中增加部署后 E2E 验收(Post-Deploy Verification)门禁: - 新增 verification linkRole 和【验收】任务命名规范 - Deploy Gate 1 健康检查 / Gate 2 PDV 任务完成 / Gate 3 证据完整 - PDV Playwright spec 模板(页面可达、菜单可见、API 连通) - 同步更新 req-workflow、dev-test、e2e-testing 相关文档 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
@@ -15,6 +15,7 @@ description: 软件测试技能。用于单元测试、集成测试、E2E测试
|
||||
| `android-testing.md` | Android 测试 (JUnit + Espresso + Compose) |
|
||||
| `e2e-testing.md` | E2E Playwright:API Mock 冒烟测试(无后端)+ 全链路集成测试 |
|
||||
| `templates/go-integration-test.md` | Go 集成测试模板(多步骤 API 流程、中间件验证、租户隔离) |
|
||||
| `templates/pdv-smoke-spec.md` | PDV 部署后验收 Playwright 模板(页面可达、菜单可见、API 连通) |
|
||||
|
||||
---
|
||||
|
||||
@@ -50,6 +51,7 @@ description: 软件测试技能。用于单元测试、集成测试、E2E测试
|
||||
| E2E (Mock 冒烟) | `npm run test:e2e:smoke-mock` | `e2e-testing.md` §API Mock |
|
||||
| E2E (全链路) | `npm run test:e2e` | `e2e-testing.md` §全链路 |
|
||||
| E2E (Coolbuy PaaS) | `make e2e` | `e2e-testing.md` §Coolbuy |
|
||||
| E2E (部署后验收 PDV) | `E2E_BASE_URL=<url> npx playwright test e2e/pdv/` | §PDV |
|
||||
|
||||
---
|
||||
|
||||
@@ -145,6 +147,60 @@ ai-proj task append-doc --id <taskId> --content "# 测试报告
|
||||
|
||||
---
|
||||
|
||||
## 部署后 E2E 验收 (PDV — Post-Deploy Verification)
|
||||
|
||||
部署后验收是独立于 TG4 的 E2E 冒烟模式,在 `/req deploy` 健康检查通过后执行。
|
||||
|
||||
### PDV vs TG4 区别
|
||||
|
||||
| 维度 | TG4 (开发阶段 E2E 冒烟) | PDV (部署后验收) |
|
||||
|------|------------------------|-----------------|
|
||||
| **触发时机** | `/req test` Gate 4 | `/req deploy` 步骤 6 |
|
||||
| **环境** | 本地开发环境,API Mock | 真实部署环境 (staging/prod) |
|
||||
| **目的** | 验证前端逻辑、UI 渲染 | 验证功能入口可达、基本可用 |
|
||||
| **API** | `page.route()` 拦截 | 真实后端 API |
|
||||
| **范围** | 回归冒烟 | 仅新功能可达性 |
|
||||
|
||||
### PDV 检查项
|
||||
|
||||
| 检查项 | 说明 | 示例 |
|
||||
|--------|------|------|
|
||||
| **页面可达** | 需求涉及的前端页面返回 200 | `/okr/my`, `/okr/team` |
|
||||
| **菜单可见** | 新增菜单项在侧栏中出现 | OKR 菜单对目标用户角色可见 |
|
||||
| **基础渲染** | 页面无白屏/JS 报错 | 页面有预期的标题/组件 |
|
||||
| **API 连通** | 关键 API 带 token 调用返回正常 | `GET /api/v1/okr/objectives` 返回 200 |
|
||||
|
||||
### PDV 不做什么
|
||||
|
||||
- 不做完整回归测试(那是 TG4 的事)
|
||||
- 不测试复杂业务流程(如多步骤表单提交)
|
||||
- 不替代手动验收
|
||||
- 只做「功能入口可达 + 基本可用」的冒烟验证
|
||||
|
||||
### PDV 执行方式
|
||||
|
||||
```bash
|
||||
E2E_BASE_URL=<部署环境URL> npx playwright test e2e/pdv/ --project=chromium
|
||||
```
|
||||
|
||||
### PDV Spec 生成规则
|
||||
|
||||
AI 根据需求变更范围动态生成 Playwright spec,模板见 `templates/pdv-smoke-spec.md`。生成流程:
|
||||
|
||||
1. 从需求关联任务提取前端变更范围(页面路由、菜单项、API 端点)
|
||||
2. 登录测试账号(使用 storageState 或手动登录)
|
||||
3. 验证新增菜单项可见(检查 `.ant-menu` 包含目标文本)
|
||||
4. 导航到新页面,验证非白屏(title 不含 error/500/404)
|
||||
5. 调用关键 API,验证返回状态码 < 500
|
||||
6. 每步截图保存为证据
|
||||
|
||||
### PDV 结果判定
|
||||
|
||||
- **全部 PASS** → 继续推进到 released
|
||||
- **任一 FAIL** → 阻断推进,在部署文档记录失败项,通知修复
|
||||
|
||||
---
|
||||
|
||||
## TG2 集成测试检测
|
||||
|
||||
### 模板映射
|
||||
|
||||
Reference in New Issue
Block a user