开发 → 测试 契约

开发交付物给测试

1. 提测达标（硬性要求）

详见 04-gates/submission-gate.md

核心要求：

• 代码已合并到测试分支
• CI 流水线绿灯
• 冒烟测试通过
• 提测申请单完整
• 测试环境可访问
• 接口文档已更新

2. 提测申请单

• 模板：submission 模板
• 必须包含：版本号、变更清单、影响范围、自测结果、环境信息
• 缺项即退回

3. Bug 修复

Bug 级别	响应时限	修复时限
P0（阻塞）	2h 内确认	当天修复
P1（严重）	4h 内确认	1 工作日内
P2（一般）	1 工作日内	2 工作日内
P3（轻微）	2 工作日内	版本前

修复后必须：

• 在 Issue/MR 中标注修复 commit
• @ 对应测试人员回归
• 说明修复影响范围（可能引入的回归风险）

测试回传给开发

交付物	时机	格式
冒烟测试结果	提测当天	Markdown / Issue 评论
Bug 报告	发现即提	Bug 模板
接口契约评审意见	设计阶段	Markdown
测试用例邀请评审	用例完成后	会议邀请 + 文档
测试执行报告	每日/每轮	Markdown

接口契约规范

由于企业环境禁用 Swagger，使用标准化 Markdown 接口文档：

• 模板：api-contracts 模板
• 存放位置：代码仓库内 docs/api/ 目录
• 变更管理：随代码 diff，MR 中体现
• 同步要求：接口变更必须同步更新文档，文档与代码不一致即为提测不达标

环境责任

责任	归属方
测试环境搭建	开发
测试环境部署代码	开发 / CI
测试环境稳定性保障	开发
测试数据准备	测试（开发提供脚本）
测试环境清理	测试

违约处理

场景	处理方式
未达标强行提测	直接退回，记录"提测失败"
Bug 响应超时	升级至开发经理
接口文档与实际不一致	直接退回，要求先对齐
连续 2 次提测失败	开发经理介入，流程复盘