user-system/docs/processes/FRONTEND_BACKEND_REVIEW.md

前后端联调评审流程

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 接口评审报告模板

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

11. 相关文档

• 前后端联调检查清单
• 代码审查标准
• 生产环境检查清单