junhong_cmp_fiber/openspec/specs/asset-recharge-adaptation/spec.md

MODIFIED Requirements

Requirement: 资产充值关联支付配置

系统 SHALL 在创建资产充值订单时记录当前生效的支付配置 ID，用于回调处理时加载正确的配置验签。

Scenario: 创建充值订单时记录支付配置 ID

• WHEN 个人客户创建资产充值订单（IoT 卡钱包或设备钱包充值）

POST /api/h5/wallets/recharge
Authorization: Bearer {token}
Content-Type: application/json

请求体（现有接口，字段不变）

{
  "resource_type": "iot_card",
  "resource_id": 101,
  "amount": 10000,
  "payment_method": "wechat"
}

字段	类型	必填	说明
resource_type	string	✅	资源类型：iot_card / device
resource_id	uint	✅	资源 ID（卡 ID 或设备 ID）
amount	int64	✅	充值金额（分），范围 10010000000（1 元10 万元）
payment_method	string	✅	支付方式：wechat / alipay（支付宝保留但本次不改造）

• THEN 系统查询当前生效的微信参数配置
• THEN 将 payment_config_id 写入充值记录

成功响应 200 OK（新增 payment_config_id 字段）

{
  "code": 0,
  "data": {
    "id": 1,
    "recharge_no": "CRCH20260316100000654321",
    "user_id": 100,
    "wallet_id": 50,
    "amount": 10000,
    "payment_method": "wechat",
    "payment_config_id": 1,
    "status": 1,
    "status_text": "待支付",
    "created_at": "2026-03-16T10:00:00+08:00",
    "updated_at": "2026-03-16T10:00:00+08:00"
  },
  "msg": "success",
  "timestamp": "2026-03-16T10:00:00+08:00"
}

Scenario: 无生效配置时拒绝第三方充值

• WHEN 个人客户创建充值订单（wechat/alipay），但当前无生效的微信参数配置
• THEN 系统返回错误

{
  "code": 1175,
  "data": null,
  "msg": "暂无可用的第三方支付渠道",
  "timestamp": "2026-03-16T10:00:00+08:00"
}

---

Requirement: 资产充值表结构变更

tb_asset_recharge_record 新增字段：

字段	类型	必填	说明
payment_config_id	bigint	❌	创建充值订单时使用的微信参数配置 ID（支付宝支付时为 NULL）

---

Requirement: 资产充值回调按配置验签

• WHEN 收到支付回调（微信或富友），订单号前缀为 CRCH
• THEN 系统查询 tb_asset_recharge_record，通过 payment_config_id 加载对应配置
• THEN 使用该配置的凭证验签
• THEN 验签通过后调用 rechargeService.HandlePaymentCallback()

注意：当前代码中 callback/payment.go 使用废弃的 RechargeOrderPrefix = "RCH" 进行前缀匹配，需修复为 AssetRechargeOrderPrefix = "CRCH"。

---

Requirement: 常量重命名（Card → Asset）

pkg/constants/wallet.go 中以下常量从 Card 前缀重命名为 Asset 前缀：

旧名称	新名称
CardWalletResourceTypeIotCard	AssetWalletResourceTypeIotCard
CardWalletResourceTypeDevice	AssetWalletResourceTypeDevice
CardWalletStatusNormal	AssetWalletStatusNormal
CardWalletStatusFrozen	AssetWalletStatusFrozen
CardWalletStatusClosed	AssetWalletStatusClosed
CardTransactionTypeRecharge	AssetTransactionTypeRecharge
CardTransactionTypeDeduct	AssetTransactionTypeDeduct
CardTransactionTypeRefund	AssetTransactionTypeRefund
CardRechargeOrderPrefix	AssetRechargeOrderPrefix
CardRechargeMinAmount	AssetRechargeMinAmount
CardRechargeMaxAmount	AssetRechargeMaxAmount

旧 Card* 常量保留为废弃别名，添加 Deprecated 注释。段落标题 卡钱包常量 → 资产钱包常量。