新增完整换货生命周期管理:后台发起 → 客户端填收货信息 → 后台发货 → 确认完成(含可选全量迁移) → 旧资产转新再销售 后台接口(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 旧表改名
63 lines
3.8 KiB
Go
63 lines
3.8 KiB
Go
package openapi
|
||
|
||
import (
|
||
"github.com/break/junhong_cmp_fiber/internal/bootstrap"
|
||
"github.com/break/junhong_cmp_fiber/internal/handler/admin"
|
||
"github.com/break/junhong_cmp_fiber/internal/handler/app"
|
||
authHandler "github.com/break/junhong_cmp_fiber/internal/handler/auth"
|
||
"github.com/break/junhong_cmp_fiber/internal/handler/callback"
|
||
)
|
||
|
||
// BuildDocHandlers 构造文档生成用的 handlers(所有依赖传 nil)
|
||
func BuildDocHandlers() *bootstrap.Handlers {
|
||
return &bootstrap.Handlers{
|
||
Auth: authHandler.NewHandler(nil, nil),
|
||
Account: admin.NewAccountHandler(nil),
|
||
Role: admin.NewRoleHandler(nil, nil),
|
||
Permission: admin.NewPermissionHandler(nil),
|
||
PersonalCustomer: app.NewPersonalCustomerHandler(nil, nil),
|
||
ClientAsset: app.NewClientAssetHandler(nil, nil, nil, nil, nil, nil, nil, nil, nil),
|
||
ClientWallet: app.NewClientWalletHandler(nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil),
|
||
ClientOrder: app.NewClientOrderHandler(nil, nil, nil, nil, nil, nil, nil, nil),
|
||
ClientExchange: app.NewClientExchangeHandler(nil),
|
||
ClientRealname: app.NewClientRealnameHandler(nil, nil, nil, nil, nil, nil, nil),
|
||
ClientDevice: app.NewClientDeviceHandler(nil, nil, nil, nil, nil, nil, nil),
|
||
Shop: admin.NewShopHandler(nil),
|
||
ShopRole: admin.NewShopRoleHandler(nil),
|
||
ShopCommission: admin.NewShopCommissionHandler(nil),
|
||
CommissionWithdrawal: admin.NewCommissionWithdrawalHandler(nil),
|
||
CommissionWithdrawalSetting: admin.NewCommissionWithdrawalSettingHandler(nil),
|
||
Enterprise: admin.NewEnterpriseHandler(nil),
|
||
EnterpriseCard: admin.NewEnterpriseCardHandler(nil),
|
||
EnterpriseDevice: admin.NewEnterpriseDeviceHandler(nil),
|
||
Authorization: admin.NewAuthorizationHandler(nil),
|
||
MyCommission: admin.NewMyCommissionHandler(nil),
|
||
IotCard: admin.NewIotCardHandler(nil),
|
||
IotCardImport: admin.NewIotCardImportHandler(nil),
|
||
Device: admin.NewDeviceHandler(nil),
|
||
DeviceImport: admin.NewDeviceImportHandler(nil),
|
||
AssetAllocationRecord: admin.NewAssetAllocationRecordHandler(nil),
|
||
Storage: admin.NewStorageHandler(nil),
|
||
Carrier: admin.NewCarrierHandler(nil),
|
||
PackageSeries: admin.NewPackageSeriesHandler(nil),
|
||
Package: admin.NewPackageHandler(nil),
|
||
PackageUsage: admin.NewPackageUsageHandler(nil),
|
||
ShopPackageBatchAllocation: admin.NewShopPackageBatchAllocationHandler(nil),
|
||
ShopPackageBatchPricing: admin.NewShopPackageBatchPricingHandler(nil),
|
||
ShopSeriesGrant: admin.NewShopSeriesGrantHandler(nil),
|
||
AdminOrder: admin.NewOrderHandler(nil, nil),
|
||
AdminExchange: admin.NewExchangeHandler(nil, nil),
|
||
PaymentCallback: callback.NewPaymentHandler(nil, nil, nil, nil),
|
||
PollingConfig: admin.NewPollingConfigHandler(nil),
|
||
PollingConcurrency: admin.NewPollingConcurrencyHandler(nil),
|
||
PollingMonitoring: admin.NewPollingMonitoringHandler(nil),
|
||
PollingAlert: admin.NewPollingAlertHandler(nil),
|
||
PollingCleanup: admin.NewPollingCleanupHandler(nil),
|
||
PollingManualTrigger: admin.NewPollingManualTriggerHandler(nil),
|
||
Asset: admin.NewAssetHandler(nil, nil, nil),
|
||
AssetWallet: admin.NewAssetWalletHandler(nil),
|
||
WechatConfig: admin.NewWechatConfigHandler(nil),
|
||
AgentRecharge: admin.NewAgentRechargeHandler(nil),
|
||
}
|
||
}
|