Files
zyt/admin/PAYMENT_DEPLOYMENT_CHECKLIST.md
T
2026-03-11 14:33:49 +08:00

193 lines
5.3 KiB
Markdown

# 支付功能部署检查清单
## 开发环境检查
- [ ] 代码已提交到版本控制系统
- [ ] 所有文件已创建:
- [ ] `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`
## 团队培训
- [ ] 开发人员已了解支付流程
- [ ] 测试人员已了解测试方法
- [ ] 运维人员已了解部署步骤
- [ ] 支持人员已了解常见问题
## 应急预案
- [ ] 已准备支付失败处理方案
- [ ] 已准备回调失败处理方案
- [ ] 已准备数据恢复方案
- [ ] 已准备回滚方案
## 上线前最终检查
- [ ] 所有检查项已完成
- [ ] 所有测试已通过
- [ ] 所有文档已准备
- [ ] 所有人员已培训
- [ ] 应急预案已准备
- [ ] 获得上线批准
## 上线后监控
- [ ] 监控支付成功率
- [ ] 监控回调处理
- [ ] 监控错误日志
- [ ] 监控用户反馈
- [ ] 准备应急响应
## 常见问题排查
### 支付宝相关
- [ ] 签名验证失败 → 检查密钥和参数排序
- [ ] 回调未收到 → 检查回调地址和防火墙
- [ ] 金额不匹配 → 检查金额计算
- [ ] 订单不存在 → 检查订单号
### 微信支付相关
- [ ] 签名验证失败 → 检查密钥和参数排序
- [ ] 回调未收到 → 检查回调地址和防火墙
- [ ] 金额不匹配 → 检查金额转换(分)
- [ ] 订单不存在 → 检查订单号
### 通用问题
- [ ] 支付接口超时 → 检查网络连接
- [ ] 数据库错误 → 检查数据库连接
- [ ] 权限错误 → 检查用户权限
- [ ] 配置错误 → 检查环境变量
## 签字确认
- [ ] 开发负责人:_________________ 日期:_______
- [ ] 测试负责人:_________________ 日期:_______
- [ ] 运维负责人:_________________ 日期:_______
- [ ] 项目经理:_________________ 日期:_______