# 支付功能部署检查清单

## 开发环境检查

- [ ] 代码已提交到版本控制系统
- [ ] 所有文件已创建：
  - [ ] `server/config/pay.php`
  - [ ] `server/app/adminapi/controller/order/AlipayNotifyController.php`
  - [ ] `server/app/adminapi/controller/order/WechatNotifyController.php`
  - [ ] `server/app/adminapi/logic/order/OrderLogic.php` (已更新)
  - [ ] `server/app/common/model/Order.php` (已更新)
  - [ ] `admin/order.sql` (已更新)
- [ ] 代码通过语法检查
- [ ] 代码通过代码审查

## 测试环境检查

### 数据库
- [ ] 执行数据库迁移脚本
- [ ] 验证 `trade_no` 字段已添加到 `la_order` 表
- [ ] 验证表结构正确

### 环境配置
- [ ] 配置 `.env` 文件中的支付宝参数
- [ ] 配置 `.env` 文件中的微信支付参数
- [ ] 验证配置文件 `server/config/pay.php` 可以正确读取环境变量

### 支付宝集成
- [ ] 获取支付宝沙箱账号
- [ ] 配置支付宝沙箱网关地址
- [ ] 配置支付宝回调地址
- [ ] 测试支付宝支付流程
- [ ] 验证支付宝回调处理正确
- [ ] 验证订单状态更新正确

### 微信支付集成
- [ ] 获取微信支付测试账号
- [ ] 配置微信支付测试参数
- [ ] 配置微信支付回调地址
- [ ] 测试微信支付流程
- [ ] 验证微信支付回调处理正确
- [ ] 验证订单状态更新正确

### 功能测试
- [ ] 测试正常支付流程
- [ ] 测试补单支付流程
- [ ] 测试支付宝支付
- [ ] 测试微信支付
- [ ] 测试支付失败处理
- [ ] 测试重复支付防护
- [ ] 测试金额验证
- [ ] 测试签名验证

### 前端测试
- [ ] 支付对话框显示正确
- [ ] 支付方式选择正确
- [ ] 补单支付订单号输入正确
- [ ] 支付完成后订单列表刷新正确
- [ ] 错误提示显示正确

### 后端测试
- [ ] 支付接口返回正确的支付URL/数据
- [ ] 回调处理正确验证签名
- [ ] 回调处理正确验证金额
- [ ] 回调处理正确更新订单状态
- [ ] 异常处理正确

### 安全测试
- [ ] 验证签名验证不能被绕过
- [ ] 验证金额验证不能被绕过
- [ ] 验证订单状态检查正确
- [ ] 验证权限控制正确
- [ ] 验证日志记录正确

## 生产环境准备

### 支付宝生产配置
- [ ] 获取支付宝生产账号
- [ ] 获取支付宝生产密钥
- [ ] 配置支付宝生产网关地址
- [ ] 配置支付宝生产回调地址
- [ ] 在支付宝后台配置回调地址

### 微信支付生产配置
- [ ] 获取微信支付生产账号
- [ ] 获取微信支付生产密钥
- [ ] 配置微信支付生产参数
- [ ] 配置微信支付生产回调地址
- [ ] 在微信后台配置回调地址

### 生产环境部署
- [ ] 更新生产环境的 `.env` 文件
- [ ] 执行生产环境数据库迁移
- [ ] 部署代码到生产环境
- [ ] 验证生产环境配置正确
- [ ] 验证生产环境数据库正确

### 生产环境测试
- [ ] 测试生产环境支付宝支付
- [ ] 测试生产环境微信支付
- [ ] 测试生产环境回调处理
- [ ] 验证生产环境订单状态更新
- [ ] 验证生产环境日志记录

## 监控和维护

### 日志监控
- [ ] 配置支付相关日志
- [ ] 设置日志告警
- [ ] 定期检查日志

### 性能监控
- [ ] 监控支付接口响应时间
- [ ] 监控回调处理时间
- [ ] 监控数据库查询性能

### 错误监控
- [ ] 监控支付失败率
- [ ] 监控回调失败率
- [ ] 监控异常错误

### 定期维护
- [ ] 定期检查支付配置
- [ ] 定期更新密钥
- [ ] 定期清理日志
- [ ] 定期备份数据库

## 文档检查

- [ ] 已阅读 `PAYMENT_QUICK_START.md`
- [ ] 已阅读 `PAYMENT_GATEWAY_INTEGRATION.md`
- [ ] 已阅读 `PAYMENT_IMPLEMENTATION_SUMMARY.md`
- [ ] 已阅读 `PAYMENT_API_ENDPOINTS.md`
- [ ] 已阅读 `PAYMENT_MIGRATION.md`

## 团队培训

- [ ] 开发人员已了解支付流程
- [ ] 测试人员已了解测试方法
- [ ] 运维人员已了解部署步骤
- [ ] 支持人员已了解常见问题

## 应急预案

- [ ] 已准备支付失败处理方案
- [ ] 已准备回调失败处理方案
- [ ] 已准备数据恢复方案
- [ ] 已准备回滚方案

## 上线前最终检查

- [ ] 所有检查项已完成
- [ ] 所有测试已通过
- [ ] 所有文档已准备
- [ ] 所有人员已培训
- [ ] 应急预案已准备
- [ ] 获得上线批准

## 上线后监控

- [ ] 监控支付成功率
- [ ] 监控回调处理
- [ ] 监控错误日志
- [ ] 监控用户反馈
- [ ] 准备应急响应

## 常见问题排查

### 支付宝相关
- [ ] 签名验证失败 → 检查密钥和参数排序
- [ ] 回调未收到 → 检查回调地址和防火墙
- [ ] 金额不匹配 → 检查金额计算
- [ ] 订单不存在 → 检查订单号

### 微信支付相关
- [ ] 签名验证失败 → 检查密钥和参数排序
- [ ] 回调未收到 → 检查回调地址和防火墙
- [ ] 金额不匹配 → 检查金额转换（分）
- [ ] 订单不存在 → 检查订单号

### 通用问题
- [ ] 支付接口超时 → 检查网络连接
- [ ] 数据库错误 → 检查数据库连接
- [ ] 权限错误 → 检查用户权限
- [ ] 配置错误 → 检查环境变量

## 签字确认

- [ ] 开发负责人：_________________ 日期：_______
- [ ] 测试负责人：_________________ 日期：_______
- [ ] 运维负责人：_________________ 日期：_______
- [ ] 项目经理：_________________ 日期：_______