feat(billing): 微信支付配置进 DB —— admin 控制面保存即热生效
用户定的形态:配置存数据库、密钥文件放服务器磁盘(库里只存路径)。 env 降级为兜底(DB 优先 → env → 隐藏,与 tokens_per_credit 同一约定)。 - payment 包重构:Config(6 字段)+ Manager(RWMutex 热重载,学 prompt 控制面 改完即生效不重启);未启用原因人话化(未配置/缺哪些字段/初始化失败具体错)。 - APIv3 密钥入库前 AES-GCM 加密(shared/secrets,与模型 API Key 同一把 SUNDYNIX_SECRET_KEY);GET 只回 has_apiv3_key 不回显;PUT 留空=沿用旧密钥 (只写不回显语义,同模型 Key)。 - admin GET/PUT /admin/payment/wechat;业务路径全部改经 Manager.Current() 取快照(BillingPacks/下单/查单/回调)。 - admin 计费页「微信支付配置」卡片:状态徽章(已启用/未启用+原因)+六字段 +保存并热生效。 live:无配置→「未配置」;存假配置→热重载报「私钥加载失败:decode err」; 去掉 appid→「配置不全,缺: appid」;密钥留空沿用(has_apiv3_key 保持 true); psql 复核库内密文 enc:1: 前缀、不含明文子串。go/tsc/41 vitest 全绿。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Blizzard
@@ -0,0 +1,112 @@
|
||||
package payment
|
||||
|
||||
import (
|
||||
"context"
|
||||
"errors"
|
||||
"log"
|
||||
"os"
|
||||
"strings"
|
||||
"sync"
|
||||
)
|
||||
|
||||
// Config 微信支付渠道配置。来源两级：DB 设置（admin 控制面，热生效）优先，env 兜底
|
||||
// ——与 TokensPerCredit 的「DB 优先 → env → 默认」同一约定。
|
||||
// APIv3Key 在库里是 AES-GCM 密文（与模型 API Key 同一把 SUNDYNIX_SECRET_KEY），
|
||||
// 这里拿到的是解密后的明文；PrivateKeyPath 只是服务器磁盘路径，私钥文件本身不进库。
|
||||
type Config struct {
|
||||
MchID string `json:"mchid"`
|
||||
CertSerial string `json:"cert_serial"`
|
||||
PrivateKeyPath string `json:"private_key_path"`
|
||||
APIv3Key string `json:"apiv3_key"`
|
||||
AppID string `json:"appid"`
|
||||
NotifyURL string `json:"notify_url"`
|
||||
}
|
||||
|
||||
// Empty 完全未配置（一个字段都没填）。
|
||||
func (c Config) Empty() bool {
|
||||
return c.MchID == "" && c.CertSerial == "" && c.PrivateKeyPath == "" &&
|
||||
c.APIv3Key == "" && c.AppID == "" && c.NotifyURL == ""
|
||||
}
|
||||
|
||||
// missing 返回缺失字段名（配置不全时给 admin 一句能看懂的原因）。
|
||||
func (c Config) missing() []string {
|
||||
var out []string
|
||||
for _, f := range []struct{ k, v string }{
|
||||
{"mchid", c.MchID}, {"cert_serial", c.CertSerial}, {"private_key_path", c.PrivateKeyPath},
|
||||
{"apiv3_key", c.APIv3Key}, {"appid", c.AppID}, {"notify_url", c.NotifyURL},
|
||||
} {
|
||||
if strings.TrimSpace(f.v) == "" {
|
||||
out = append(out, f.k)
|
||||
}
|
||||
}
|
||||
return out
|
||||
}
|
||||
|
||||
// ConfigFromEnv 从环境变量读配置（DB 未配置时的兜底，兼容 P5.2 的纯 env 用法）。
|
||||
func ConfigFromEnv() Config {
|
||||
return Config{
|
||||
MchID: os.Getenv("WECHAT_MCHID"),
|
||||
CertSerial: os.Getenv("WECHAT_MCH_CERT_SERIAL"),
|
||||
PrivateKeyPath: os.Getenv("WECHAT_MCH_PRIVATE_KEY"),
|
||||
APIv3Key: os.Getenv("WECHAT_APIV3_KEY"),
|
||||
AppID: os.Getenv("WECHAT_APPID"),
|
||||
NotifyURL: os.Getenv("WECHAT_NOTIFY_URL"),
|
||||
}
|
||||
}
|
||||
|
||||
// Manager 持有当前微信渠道实例，支持 admin 改配置后热重载（学 prompt 控制面：改完即生效，
|
||||
// 不重启 gateway）。所有业务路径经 Current() 取用——nil 即渠道隐藏。
|
||||
type Manager struct {
|
||||
mu sync.RWMutex
|
||||
w *Wechat
|
||||
reason string // 未启用原因（给 admin 状态面看）
|
||||
}
|
||||
|
||||
func NewManager() *Manager {
|
||||
return &Manager{reason: "未配置"}
|
||||
}
|
||||
|
||||
// Reload 按给定配置重建渠道实例。失败只降级为隐藏并记录原因，绝不 panic/拖垮服务。
|
||||
func (m *Manager) Reload(ctx context.Context, c Config) error {
|
||||
w, reason, err := build(ctx, c)
|
||||
m.mu.Lock()
|
||||
m.w = w
|
||||
m.reason = reason
|
||||
m.mu.Unlock()
|
||||
if w != nil {
|
||||
log.Printf("[payment] 微信支付 Native 渠道已启用 (mchid=%s)", c.MchID)
|
||||
} else if !c.Empty() {
|
||||
log.Printf("[payment] 微信支付渠道未启用: %s", reason)
|
||||
}
|
||||
return err
|
||||
}
|
||||
|
||||
// Current 当前渠道实例；nil = 未配置/配置失败（渠道隐藏）。
|
||||
func (m *Manager) Current() *Wechat {
|
||||
m.mu.RLock()
|
||||
defer m.mu.RUnlock()
|
||||
return m.w
|
||||
}
|
||||
|
||||
// Status 给 admin 状态面：是否启用 + 未启用原因。
|
||||
func (m *Manager) Status() (bool, string) {
|
||||
m.mu.RLock()
|
||||
defer m.mu.RUnlock()
|
||||
return m.w != nil, m.reason
|
||||
}
|
||||
|
||||
// build 装配渠道实例；返回 (实例, 未启用原因, 错误)。配置为空不算错。
|
||||
func build(ctx context.Context, c Config) (*Wechat, string, error) {
|
||||
if c.Empty() {
|
||||
return nil, "未配置", nil
|
||||
}
|
||||
if miss := c.missing(); len(miss) > 0 {
|
||||
reason := "配置不全，缺: " + strings.Join(miss, ", ")
|
||||
return nil, reason, errors.New(reason)
|
||||
}
|
||||
w, err := New(ctx, c)
|
||||
if err != nil {
|
||||
return nil, "初始化失败: " + err.Error(), err
|
||||
}
|
||||
return w, "", nil
|
||||
}
|
||||
@@ -7,9 +7,7 @@ import (
|
||||
"context"
|
||||
"errors"
|
||||
"fmt"
|
||||
"log"
|
||||
"net/http"
|
||||
"os"
|
||||
|
||||
"github.com/wechatpay-apiv3/wechatpay-go/core"
|
||||
"github.com/wechatpay-apiv3/wechatpay-go/core/auth/verifiers"
|
||||
@@ -21,16 +19,7 @@ import (
|
||||
"github.com/wechatpay-apiv3/wechatpay-go/utils"
|
||||
)
|
||||
|
||||
// Wechat 微信支付 Native（扫码）适配器。凭据一律 env 注入：
|
||||
//
|
||||
// WECHAT_MCHID 商户号
|
||||
// WECHAT_MCH_CERT_SERIAL 商户 API 证书序列号
|
||||
// WECHAT_MCH_PRIVATE_KEY 商户 API 私钥文件路径（apiclient_key.pem）
|
||||
// WECHAT_APIV3_KEY APIv3 密钥（32 字节）
|
||||
// WECHAT_APPID 关联的公众号/小程序/APP 的 appid
|
||||
// WECHAT_NOTIFY_URL 支付回调地址（须公网 https，如 https://api.example.com/api/v1/billing/callback/wechat）
|
||||
//
|
||||
// 任一缺失 → NewWechatFromEnv 返回 nil，渠道自动隐藏（半配置状态不许把下单路由搞出 5xx）。
|
||||
// Wechat 微信支付 Native（扫码）适配器。配置来源见 Config（DB 优先、env 兜底，由 Manager 装配）。
|
||||
// 本地开发收不到公网回调没关系：前端轮询的 GET /billing/orders/:id 会主动查单确认，
|
||||
// 回调只是生产环境更快的到账通道，两条路都汇入同一个幂等入账闸。
|
||||
type Wechat struct {
|
||||
@@ -42,36 +31,20 @@ type Wechat struct {
|
||||
svc native.NativeApiService
|
||||
}
|
||||
|
||||
// NewWechatFromEnv 依据环境变量装配微信渠道；未配置（或配置不全/私钥读不了）返回 nil。
|
||||
func NewWechatFromEnv(ctx context.Context) *Wechat {
|
||||
mchID := os.Getenv("WECHAT_MCHID")
|
||||
serial := os.Getenv("WECHAT_MCH_CERT_SERIAL")
|
||||
keyPath := os.Getenv("WECHAT_MCH_PRIVATE_KEY")
|
||||
apiv3 := os.Getenv("WECHAT_APIV3_KEY")
|
||||
appID := os.Getenv("WECHAT_APPID")
|
||||
notifyURL := os.Getenv("WECHAT_NOTIFY_URL")
|
||||
if mchID == "" && serial == "" && keyPath == "" && apiv3 == "" {
|
||||
return nil // 完全未配置：静默（大多数开发环境）
|
||||
}
|
||||
if mchID == "" || serial == "" || keyPath == "" || apiv3 == "" || appID == "" || notifyURL == "" {
|
||||
log.Printf("[payment] 微信支付配置不全（MCHID/CERT_SERIAL/PRIVATE_KEY/APIV3_KEY/APPID/NOTIFY_URL 缺一不可），渠道保持隐藏")
|
||||
return nil
|
||||
}
|
||||
priv, err := utils.LoadPrivateKeyWithPath(keyPath)
|
||||
// New 按完整配置装配微信渠道（私钥从磁盘路径加载；调用方保证字段齐全）。
|
||||
func New(ctx context.Context, c Config) (*Wechat, error) {
|
||||
priv, err := utils.LoadPrivateKeyWithPath(c.PrivateKeyPath)
|
||||
if err != nil {
|
||||
log.Printf("[payment] 微信商户私钥加载失败(%s)，渠道保持隐藏: %v", keyPath, err)
|
||||
return nil
|
||||
return nil, fmt.Errorf("商户私钥加载失败(%s): %w", c.PrivateKeyPath, err)
|
||||
}
|
||||
client, err := core.NewClient(ctx, option.WithWechatPayAutoAuthCipher(mchID, serial, priv, apiv3))
|
||||
client, err := core.NewClient(ctx, option.WithWechatPayAutoAuthCipher(c.MchID, c.CertSerial, priv, c.APIv3Key))
|
||||
if err != nil {
|
||||
log.Printf("[payment] 微信支付客户端初始化失败，渠道保持隐藏: %v", err)
|
||||
return nil
|
||||
return nil, fmt.Errorf("客户端初始化失败: %w", err)
|
||||
}
|
||||
log.Printf("[payment] 微信支付 Native 渠道已启用 (mchid=%s)", mchID)
|
||||
return &Wechat{
|
||||
mchID: mchID, appID: appID, notifyURL: notifyURL, apiv3Key: apiv3,
|
||||
mchID: c.MchID, appID: c.AppID, notifyURL: c.NotifyURL, apiv3Key: c.APIv3Key,
|
||||
client: client, svc: native.NativeApiService{Client: client},
|
||||
}
|
||||
}, nil
|
||||
}
|
||||
|
||||
// CreatePay Native 下单：返回 code_url（前端渲染成二维码）。金额取订单锁定值。
|
||||
|
||||
Reference in New Issue
Block a user