# 前后端联调评审流程

## 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 接口评审报告
- 接口变更记录

**步骤**：
1. 后端负责人提交 API 设计文档
2. 前端负责人审查接口与前端需求的匹配度
3. 技术负责人审查架构一致性
4. 评审会议讨论并记录问题
5. 后端负责人更新接口文档

### 6.2 联调问题评审（Sprint 中期）

**输入**：
- 联调中发现的问题列表
- 问题复现步骤
- 问题影响分析

**输出**：
- 问题解决方案
- 优先级排序
- 解决时间表

**步骤**：
1. 前后端负责人汇总联调问题
2. 评审会议讨论解决方案
3. 技术负责人评估解决方案可行性
4. 确定解决优先级和时间表

### 6.3 上线前评审（Sprint 结束）

**输入**：
- 联调测试报告
- 性能测试报告
- 安全测试报告
- 代码审查报告

**输出**：
- 上线决策（通过/不通过/条件通过）
- 上线风险清单
- 回滚方案

**步骤**：
1. 测试工程师提交测试报告
2. 评审会议审查测试结果
3. 技术负责人评估上线风险
4. 团队决策是否上线

## 7. 评审文档

### 7.1 API 接口评审报告模板

```markdown
# API 接口评审报告

**评审日期**: YYYY-MM-DD
**评审人员**: ...

## 评审结果
- 通过/不通过/条件通过

## 问题列表
| ID | 问题 | 严重程度 | 负责人 | 解决方案 | 状态 |
|----|------|---------|--------|---------|------|
```

### 7.2 联调测试报告模板

```markdown
# 联调测试报告

**测试日期**: 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 后进行评审流程复盘
- 收集团队反馈，优化评审流程
- 定期更新评审检查清单

## 11. 相关文档

- [前后端联调检查清单](../checklists/FRONTEND_BACKEND_CHECKLIST.md)
- [代码审查标准](../code-review/CODE_REVIEW_STANDARD.md)
- [生产环境检查清单](../team/PRODUCTION_CHECKLIST.md)
