4.4 KiB
4.4 KiB
前后端联调评审流程
1. 概述
本流程确保前后端联调质量，防止设计断链和接口不匹配问题。
2. 适用范围
- 所有前后端集成开发
- 新功能开发联调
- Bug 修复联调
- 性能优化联调
3. 评审角色
| 角色 | 职责 |
|---|---|
| 后端负责人 | API 设计评审，数据模型验证 |
| 前端负责人 | UI/UX 验证，接口对接验证 |
| 测试工程师 | 联调测试计划，测试用例验证 |
| 技术负责人 | 架构一致性评审，最终决策 |
4. 评审时机
- Sprint 开发初期：API 接口评审
- Sprint 中期：联调问题评审
- Sprint 结束前：上线前评审
5. 评审内容
5.1 API 接口评审
- 接口路径符合 RESTful 规范
- 请求/响应格式一致
- 错误码定义完整
- 分页、排序、筛选参数统一
- 权限控制明确
5.2 数据模型评审
- 前后端数据结构一致
- 字段命名统一（camelCase/snake_case）
- 数据类型匹配
- 可选字段/必填字段明确
- 枚举值定义一致
5.3 业务逻辑评审
- 前后端业务逻辑一致
- 边界条件处理一致
- 异常场景处理覆盖
- 用户交互流程验证
5.4 性能评审
- 接口响应时间满足要求
- 数据库查询优化
- 前端渲染性能优化
- 并发处理机制验证
5.5 安全评审
- 认证授权机制完善
- 敏感数据传输加密
- 输入验证防注入
- XSS/CSRF 防护
6. 评审流程
6.1 API 接口评审（Sprint 开始）
输入：
- API 设计文档（Swagger/OpenAPI）
- 数据模型定义
- 权限设计文档
输出：
- API 接口评审报告
- 接口变更记录
步骤：
- 后端负责人提交 API 设计文档
- 前端负责人审查接口与前端需求的匹配度
- 技术负责人审查架构一致性
- 评审会议讨论并记录问题
- 后端负责人更新接口文档
6.2 联调问题评审（Sprint 中期）
输入：
- 联调中发现的问题列表
- 问题复现步骤
- 问题影响分析
输出：
- 问题解决方案
- 优先级排序
- 解决时间表
步骤：
- 前后端负责人汇总联调问题
- 评审会议讨论解决方案
- 技术负责人评估解决方案可行性
- 确定解决优先级和时间表
6.3 上线前评审（Sprint 结束）
输入：
- 联调测试报告
- 性能测试报告
- 安全测试报告
- 代码审查报告
输出：
- 上线决策（通过/不通过/条件通过）
- 上线风险清单
- 回滚方案
步骤：
- 测试工程师提交测试报告
- 评审会议审查测试结果
- 技术负责人评估上线风险
- 团队决策是否上线
7. 评审文档
7.1 API 接口评审报告模板
# API 接口评审报告
**评审日期**: YYYY-MM-DD
**评审人员**: ...
## 评审结果
- 通过/不通过/条件通过
## 问题列表
| ID | 问题 | 严重程度 | 负责人 | 解决方案 | 状态 |
|----|------|---------|--------|---------|------|
7.2 联调测试报告模板
# 联调测试报告
**测试日期**: YYYY-MM-DD
**测试人员**: ...
## 测试结果
- 测试用例数: X
- 通过: Y
- 失败: Z
- 通过率: N%
## 失败用例列表
| 用例ID | 问题描述 | 严重程度 | 负责人 | 状态 |
|--------|---------|---------|--------|------|
8. 问题分级
| 级别 | 描述 | 处理时限 |
|---|---|---|
| P0 | 阻塞问题，无法联调 | 立即修复（4h内） |
| P1 | 严重问题，影响核心功能 | 当天修复 |
| P2 | 一般问题，影响用户体验 | 本周修复 |
| P3 | 优化建议，不影响功能 | 下个 Sprint 处理 |
9. 评审准则
通过标准
- 所有 P0、P1 问题已解决
- 联调测试通过率 ≥ 95%
- 性能指标满足要求
- 安全测试通过
不通过标准
- 存在未解决的 P0 问题
- 联调测试通过率 < 80%
- 存在安全漏洞
条件通过标准
- P0 问题已解决，存在少量 P2 问题
- 联调测试通过率 ≥ 90%
- 性能基本达标
- 无严重安全问题
10. 持续改进
- 每个 Sprint 后进行评审流程复盘
- 收集团队反馈，优化评审流程
- 定期更新评审检查清单