refactor(payment): 渠道抽象成 Channel 接口 —— 接新渠道=加 adapter 不动骨架

PAYMENT_DESIGN §3 承诺的 internal/payment/channel.go 适配器接口此前不存在,微信硬编码在
manager/handler 里。补齐抽象:

- channel.go:Channel 接口(Name/CreatePay/QueryOrder/VerifyCallback)+ 统一 PayIntent/PayResult
  + 渠道名常量。入参用基本类型不吃 *store.PaymentOrder,payment 包不反依赖 store。
- Wechat 实现 Channel(编译期断言 var _ Channel);QueryResult 归一为 PayResult;CreatePay 返回 PayIntent。
- Manager 从「持一个 *Wechat」改为渠道注册表:Get(name)/Available()/Status(name)/ReloadWechat;
  按渠道名持有已装配实例,热重载不变。
- 回调路由收敛 /billing/callback/wechat → /billing/callback/:channel 按名路由(旧 notify URL 仍匹配);
  查单/掉单补偿据 order.Channel 路由,不再写死微信。下单支持可选 channel(缺省 wechat)。
- 支付宝/Stripe 现在真·只差一个 adapter+注册。唯一未泛化:回调 ack 应答格式(现微信态,注释标明)。
- payment 包首个测试:Manager 注册表 4 用例(空/注册摘除/空配置/配置不全)。build/vet/test/lint 全绿。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Blizzard
2026-07-18 13:56:24 +08:00
parent 86e79d76ac
commit 3a4e1d53a5
10 changed files with 261 additions and 80 deletions
+51 -20
View File
@@ -5,6 +5,7 @@ import (
"errors"
"log"
"os"
"sort"
"strings"
"sync"
)
@@ -63,25 +64,42 @@ func ConfigFromEnv() Config {
}
}
// Manager 持有当前微信渠道实例,支持 admin 改配置后热重载(学 prompt 控制面:改完即生效,
// 不重启 gateway)。所有业务路径经 Current() 取用——nil 即渠道隐藏。
// Manager 是充值渠道注册表:按渠道名持有已装配的 Channel 实例,支持 admin 改配置后热重载
// (学 prompt 控制面:改完即生效,不重启 gateway)。业务路径经 Get(name) 按订单渠道取用——
// 取到 nil 即该渠道未启用/隐藏。接新渠道(支付宝/Stripe= 加一个 ReloadXxx + 各自 Channel 实现。
type Manager struct {
mu sync.RWMutex
w *Wechat
reason string // 未启用原因(给 admin 状态面看)
mu sync.RWMutex
channels map[string]Channel // 渠道名 → 实例(仅含已成功装配的)
reasons map[string]string // 渠道名 → 未启用原因(给 admin 状态面看,含未启用的
}
func NewManager() *Manager {
return &Manager{reason: "未配置"}
return &Manager{
channels: map[string]Channel{},
reasons: map[string]string{ChannelWechat: "未配置"},
}
}
// Reload 按给定配置重建渠道实例。失败只降级为隐藏并记原因,绝不 panic/拖垮服务
func (m *Manager) Reload(ctx context.Context, c Config) error {
w, reason, err := build(ctx, c)
// register 装配结果登记:成功则入表、失败则从表移除并记原因(内部用,调用方持有意图日志)
func (m *Manager) register(name string, ch Channel, reason string) {
m.mu.Lock()
m.w = w
m.reason = reason
m.mu.Unlock()
defer m.mu.Unlock()
if ch != nil {
m.channels[name] = ch
} else {
delete(m.channels, name)
}
m.reasons[name] = reason
}
// ReloadWechat 按给定配置重建微信渠道。失败只降级为隐藏并记录原因,绝不 panic/拖垮服务。
func (m *Manager) ReloadWechat(ctx context.Context, c Config) error {
w, reason, err := buildWechat(ctx, c)
var ch Channel
if w != nil {
ch = w
}
m.register(ChannelWechat, ch, reason)
if w != nil {
log.Printf("[payment] 微信支付 Native 渠道已启用 (mchid=%s)", c.MchID)
} else if !c.Empty() {
@@ -90,22 +108,35 @@ func (m *Manager) Reload(ctx context.Context, c Config) error {
return err
}
// Current 当前渠道实例;nil = 未配置/配置失败(渠道隐藏)。
func (m *Manager) Current() *Wechat {
// Get 按渠道名取实例;nil = 未配置/配置失败(渠道隐藏)。
func (m *Manager) Get(name string) Channel {
m.mu.RLock()
defer m.mu.RUnlock()
return m.w
return m.channels[name]
}
// Status 给 admin 状态面:是否启用 + 未启用原因
func (m *Manager) Status() (bool, string) {
// Available 返回已启用的渠道名(供前端展示可选渠道)
func (m *Manager) Available() []string {
m.mu.RLock()
defer m.mu.RUnlock()
return m.w != nil, m.reason
out := make([]string, 0, len(m.channels))
for name := range m.channels {
out = append(out, name)
}
sort.Strings(out)
return out
}
// build 装配渠道实例;返回 (实例, 未启用原因, 错误)。配置为空不算错
func build(ctx context.Context, c Config) (*Wechat, string, error) {
// Status 给 admin 状态面:某渠道是否启用 + 未启用原因
func (m *Manager) Status(name string) (bool, string) {
m.mu.RLock()
defer m.mu.RUnlock()
_, ok := m.channels[name]
return ok, m.reasons[name]
}
// buildWechat 装配微信渠道实例;返回 (实例, 未启用原因, 错误)。配置为空不算错。
func buildWechat(ctx context.Context, c Config) (*Wechat, string, error) {
if c.Empty() {
return nil, "未配置", nil
}