邹方成
6ee627139c
Some checks failed
Build docker and publish / linux (1.24.5) (push) Failing after 40s
feat(pay): 添加支付API基础结构 feat(miniapp): 创建支付测试小程序页面与配置 feat(wechatpay): 配置微信支付参数与证书 fix(guild): 修复成员列表查询条件 docs: 更新代码规范文档与需求文档 style: 统一前后端枚举显示与注释格式 refactor(admin): 重构用户奖励发放接口参数处理 test(title): 添加称号效果参数验证测试
2.7 KiB
2.7 KiB
剩余完善项
- 积分恢复比例与幂等：部分/全额退款的积分恢复算法与重复保护
- 通知事件持久化与去重：payment_notify_events 入库、processed 标记、重复回调忽略
- 退款列表与详情接口：基于 payment_refunds 的查询/分页/导出
- 对账入口与差异列表：账单导入、生成 payment_bill_diff、差异查询与导出
- 管理端详情字段完善：展示 transaction_id/refund_no/channel/支付方式、累计已退款与可退余额
- 前端金额展示统一为元（两位小数），保留分用于接口与导出
- 唯一索引与安全校验：核查并补齐关键唯一约束与条件更新
后端改造
- 积分恢复
- 算法：恢复积分 = (订单积分抵扣分 × 退款分 ÷ 实付分) ÷ 100；累计不超过订单抵扣积分
- 幂等：按订单维度累计已恢复积分对比目标；全额退款一次性恢复剩余积分
- 通知事件
- 入库 payment_notify_events(notify_id,event_type,raw,processed=false)；处理成功后置 processed=true；重复 notify_id 直接 ACK
- 退款查询
- GET /api/admin/pay/refunds：分页筛选（order_no/status/date/range）
- GET /api/admin/pay/refunds/:refund_no：详情（refund_no/amount/status/success_time/reason/raw）
- 对账能力
- POST /api/admin/pay/bills/import：上传/拉取账单入库 payment_bills
- GET /api/admin/pay/bills/diffs：查询差异 payment_bill_diff（缺失/金额不符/多余）
- 订单详情聚合
- 交易：最近一笔 payment_transactions（transaction_id/success_time/amount）
- 退款：payment_refunds 汇总（refund_no/amount/status/success_time/reason），计算累计已退与可退余额
前端改造
- 金额格式化工具：统一元展示（两位小数），表格列与详情区全部使用
- 详情页新增字段：transaction_id/refund_no/channel/支付方式；累计已退/可退余额（元）
- 退款记录表：元展示；状态中文映射
- 对账入口页面：账单导入按钮、差异列表表格、导出
幂等与安全
- 幂等键：order_no/out_trade_no/notify_id/refund_no/transaction_id
- 唯一索引：核查 payment_* 与 orders.order_no；接口层条件更新与金额校验
- 日志与告警：验签失败、金额不一致、退款异常、对账差异
测试与验收
- 单元：分↔积分换算、比例恢复、幂等重复、接口参数校验
- 集成：预下单→通知→主动退款→详情一致；对账导入与差异生成
- 前后端构建与联调通过；数据与展示口径一致
执行顺序
- 后端：积分恢复与幂等、通知事件入库与去重
- 后端：退款查询接口、对账入库与差异接口
- 前端：金额格式化、详情字段与退款/对账页面
- 测试与联调：全链路验证并修正细节