# 支付宝后端 - 任务计划

> 所属智能体: backend-dev
> 状态: pending
> 创建: 2026-04-14

## 目标

实现支付宝当面付（扫码支付）的完整后端功能，包括配置层、控制器、模型和路由。

## 详细步骤

- [ ] 1. 新建 `setting/payment_alipay.go`：配置变量 + IsAlipayConfigured() + OnAlipayConfigChanged
- [ ] 2. 修改 `model/option.go`：InitOptionMap + updateOptionMap + triggerAlipayReset
- [ ] 3. 新建 `model/topup_alipay.go`：RechargeAlipay 函数（事务+行锁+幂等）
- [ ] 4. 新建 `controller/topup_alipay.go`：客户端缓存 + 5 个 HTTP 处理函数
- [ ] 5. 修改 `controller/topup.go`：GetTopUpInfo 添加支付宝支付方式
- [ ] 6. 修改 `model/topup.go`：ManualCompleteTopUp 添加 "alipay"
- [ ] 7. 修改 `router/api-router.go`：注册 4 个路由
- [ ] 8. `go build` 编译验证

## 涉及文件

- `setting/payment_alipay.go` — 新建：支付宝配置
- `setting/payment_wechat.go` — 参考：微信支付配置模式
- `controller/topup_alipay.go` — 新建：支付宝控制器
- `controller/topup_wechat.go` — 参考：微信支付控制器
- `model/topup_alipay.go` — 新建：支付宝充值模型
- `model/topup_wechat.go` — 参考：微信充值模型
- `model/option.go` — 修改：注册配置 key
- `model/topup.go` — 修改：添加 alipay 支付方式
- `controller/topup.go` — 修改：GetTopUpInfo
- `router/api-router.go` — 修改：注册路由

## 关键技术点

- gopay alipay 子包：`github.com/go-pay/gopay/alipay`
- TradePrecreate API：当面付预下单
- 金额单位：元（字符串 "7.00"），不是微信的分
- 回调验签：alipay.VerifySign(alipayPublicKey, notifyReq)
- 回调响应：纯文本 "success"
- 订单号前缀：ali（区分微信的 wx）

## 依赖

- 无外部依赖，go-pay 已在项目中