Files
junhong_cmp_fiber/openspec/changes/client-api-data-model-fixes/specs/wallet-recharge/spec.md
huang ec86dbf463 feat: 客户端接口数据模型基础准备
- 新增资产状态、订单来源、操作人类型、实名链接类型常量
- 8个模型新增字段(asset_status/generation/source/retail_price等)
- 数据库迁移000082:7张表15+字段,含存量retail_price回填
- BUG-1修复:代理零售价渠道隔离,cost_price分配锁定
- BUG-2修复:一次性佣金仅客户端订单触发
- BUG-4修复:充值回调Store操作纳入事务
- 新增资产手动停用接口(PATCH /iot-cards/:id/deactivate、/devices/:id/deactivate)
- Carrier管理新增实名链接配置
- 后台订单generation写时快照
- BatchUpdatePricing支持retail_price调价目标
- 清理全部H5旧接口和个人客户旧登录方法
2026-03-19 10:56:50 +08:00

1.2 KiB

MODIFIED Requirements

Requirement: 充值支付回调处理

系统 SHALL 处理微信和支付宝的支付回调,验证签名,更新充值订单状态,增加钱包余额。

关键一致性修复:HandlePaymentCallback 内的 UpdateStatusWithOptimisticLockUpdatePaymentInfo MUST 使用同一个事务内 tx 执行。

Scenario: 回调处理中状态更新与支付信息更新同事务

  • WHEN 收到支付成功回调并进入 HandlePaymentCallback
  • THEN 系统 MUST 在同一事务 tx 内执行 UpdateStatusWithOptimisticLock
  • THEN 系统 MUST 在同一事务 tx 内执行 UpdatePaymentInfo

Scenario: 事务失败整体回滚

  • WHEN 回调处理中任一步骤失败
  • THEN 系统 MUST 回滚该事务,保证订单状态与支付信息不出现部分成功

Requirement: Store 方法签名支持事务参数

系统 MUST 调整充值相关 Store 方法签名,支持显式传入 *gorm.DB tx 参数,以保证事务边界可控。

Scenario: Service 传入事务句柄

  • WHEN Service 在事务上下文调用 Store 更新充值记录
  • THEN Store 方法 MUST 接收并使用传入的 tx 执行数据库操作