feat: 实现客户端换货系统(client-exchange-system)

新增完整换货生命周期管理:后台发起 → 客户端填收货信息 → 后台发货 → 确认完成(含可选全量迁移) → 旧资产转新再销售

后台接口(7个):
- POST /api/admin/exchanges(发起换货)
- GET /api/admin/exchanges(换货列表)
- GET /api/admin/exchanges/:id(换货详情)
- POST /api/admin/exchanges/:id/ship(发货)
- POST /api/admin/exchanges/:id/complete(确认完成+可选迁移)
- POST /api/admin/exchanges/:id/cancel(取消)
- POST /api/admin/exchanges/:id/renew(旧资产转新)

客户端接口(2个):
- GET /api/c/v1/exchange/pending(查询换货通知)
- POST /api/c/v1/exchange/:id/shipping-info(填写收货信息)

核心能力:
- ExchangeOrder 模型与状态机(1待填写→2待发货→3已发货→4已完成,1/2可取消→5)
- 全量迁移事务(11张表:钱包、套餐、标签、客户绑定等)
- 旧资产转新(generation+1、状态重置、新钱包、历史隔离)
- 旧 CardReplacementRecord 表改名为 legacy,is_replaced 过滤改为查新表
- 数据库迁移:000085 新建 tb_exchange_order,000086 旧表改名
This commit is contained in:
2026-03-19 13:26:54 +08:00
parent df76e33105
commit e78f5794b9
41 changed files with 5242 additions and 10 deletions

View File

@@ -149,6 +149,17 @@ const (
CodePhoneAlreadyBound = 1184 // 手机号已被其他客户绑定
CodeAlreadyBoundPhone = 1185 // 当前客户已绑定手机号,不可重复绑定
CodeOldPhoneMismatch = 1186 // 旧手机号与当前绑定不匹配
CodeNeedRealname = 1187 // 该套餐需实名认证后购买
CodeOpenIDNotFound = 1188 // 未找到微信授权信息,请先完成授权
// 换货相关错误 (1200-1209)
CodeExchangeOrderNotFound = 1200 // 换货单不存在
CodeExchangeInProgress = 1201 // 存在进行中的换货单
CodeExchangeStatusInvalid = 1202 // 换货单状态不允许此操作
CodeExchangeAssetTypeMismatch = 1203 // 换货资产类型必须一致
CodeExchangeNewAssetNotInStock = 1204 // 新资产非在库状态
CodeExchangeAssetNotExchanged = 1205 // 资产未处于已换货状态,不允许转新
CodeExchangeMigrationFailed = 1206 // 数据迁移失败
// 服务端错误 (2000-2999) -> 5xx HTTP 状态码
CodeInternalError = 2001 // 内部服务器错误
@@ -274,6 +285,15 @@ var allErrorCodes = []int{
CodePhoneAlreadyBound,
CodeAlreadyBoundPhone,
CodeOldPhoneMismatch,
CodeNeedRealname,
CodeOpenIDNotFound,
CodeExchangeOrderNotFound,
CodeExchangeInProgress,
CodeExchangeStatusInvalid,
CodeExchangeAssetTypeMismatch,
CodeExchangeNewAssetNotInStock,
CodeExchangeAssetNotExchanged,
CodeExchangeMigrationFailed,
CodeInternalError,
CodeDatabaseError,
CodeRedisError,
@@ -396,6 +416,15 @@ var errorMessages = map[int]string{
CodePhoneAlreadyBound: "手机号已被其他客户绑定",
CodeAlreadyBoundPhone: "当前客户已绑定手机号,不可重复绑定",
CodeOldPhoneMismatch: "旧手机号与当前绑定不匹配",
CodeNeedRealname: "该套餐需实名认证后购买",
CodeOpenIDNotFound: "未找到微信授权信息,请先完成授权",
CodeExchangeOrderNotFound: "换货单不存在或无权限",
CodeExchangeInProgress: "该资产存在进行中的换货单",
CodeExchangeStatusInvalid: "换货单当前状态不允许此操作",
CodeExchangeAssetTypeMismatch: "换货资产类型必须一致(卡换卡/设备换设备)",
CodeExchangeNewAssetNotInStock: "新资产非在库状态,不可用于换货",
CodeExchangeAssetNotExchanged: "资产当前状态不允许转新",
CodeExchangeMigrationFailed: "换货数据迁移失败",
CodeInvalidCredentials: "用户名或密码错误",
CodeAccountLocked: "账号已锁定",
CodePasswordExpired: "密码已过期",