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:
@@ -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: "密码已过期",
|
||||
|
||||
Reference in New Issue
Block a user