新增完整换货生命周期管理:后台发起 → 客户端填收货信息 → 后台发货 → 确认完成(含可选全量迁移) → 旧资产转新再销售 后台接口(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 旧表改名
126 lines
4.7 KiB
Go
126 lines
4.7 KiB
Go
package routes
|
||
|
||
import (
|
||
"github.com/gofiber/fiber/v2"
|
||
|
||
"github.com/break/junhong_cmp_fiber/internal/bootstrap"
|
||
"github.com/break/junhong_cmp_fiber/pkg/openapi"
|
||
)
|
||
|
||
// RegisterAdminRoutes 注册管理后台相关路由
|
||
func RegisterAdminRoutes(router fiber.Router, handlers *bootstrap.Handlers, middlewares *bootstrap.Middlewares, doc *openapi.Generator, basePath string) {
|
||
// 认证路由已迁移到 /api/auth,参见 RegisterAuthRoutes
|
||
authGroup := router.Group("", middlewares.AdminAuth)
|
||
|
||
if handlers.Account != nil {
|
||
registerAccountRoutes(authGroup, handlers.Account, doc, basePath)
|
||
}
|
||
if handlers.Role != nil {
|
||
registerRoleRoutes(authGroup, handlers.Role, doc, basePath)
|
||
}
|
||
if handlers.Permission != nil {
|
||
registerPermissionRoutes(authGroup, handlers.Permission, doc, basePath)
|
||
}
|
||
if handlers.Shop != nil {
|
||
registerShopRoutes(authGroup, handlers.Shop, doc, basePath)
|
||
}
|
||
if handlers.ShopRole != nil {
|
||
registerShopRoleRoutes(authGroup, handlers.ShopRole, doc, basePath)
|
||
}
|
||
|
||
if handlers.ShopCommission != nil {
|
||
registerShopCommissionRoutes(authGroup, handlers.ShopCommission, doc, basePath)
|
||
}
|
||
if handlers.CommissionWithdrawal != nil {
|
||
registerCommissionWithdrawalRoutes(authGroup, handlers.CommissionWithdrawal, doc, basePath)
|
||
}
|
||
if handlers.CommissionWithdrawalSetting != nil {
|
||
registerCommissionWithdrawalSettingRoutes(authGroup, handlers.CommissionWithdrawalSetting, doc, basePath)
|
||
}
|
||
if handlers.Enterprise != nil {
|
||
registerEnterpriseRoutes(authGroup, handlers.Enterprise, doc, basePath)
|
||
}
|
||
if handlers.EnterpriseCard != nil {
|
||
registerEnterpriseCardRoutes(authGroup, handlers.EnterpriseCard, doc, basePath)
|
||
}
|
||
if handlers.EnterpriseDevice != nil {
|
||
registerEnterpriseDeviceRoutes(authGroup, handlers.EnterpriseDevice, doc, basePath)
|
||
}
|
||
if handlers.Authorization != nil {
|
||
registerAuthorizationRoutes(authGroup, handlers.Authorization, doc, basePath)
|
||
}
|
||
|
||
if handlers.MyCommission != nil {
|
||
registerMyCommissionRoutes(authGroup, handlers.MyCommission, doc, basePath)
|
||
}
|
||
if handlers.IotCard != nil {
|
||
registerIotCardRoutes(authGroup, handlers.IotCard, handlers.IotCardImport, doc, basePath)
|
||
}
|
||
if handlers.Device != nil {
|
||
registerDeviceRoutes(authGroup, handlers.Device, handlers.DeviceImport, doc, basePath)
|
||
}
|
||
if handlers.AssetLifecycle != nil {
|
||
registerAssetLifecycleRoutes(authGroup, handlers.AssetLifecycle, doc, basePath)
|
||
}
|
||
if handlers.AssetAllocationRecord != nil {
|
||
registerAssetAllocationRecordRoutes(authGroup, handlers.AssetAllocationRecord, doc, basePath)
|
||
}
|
||
if handlers.Storage != nil {
|
||
registerStorageRoutes(authGroup, handlers.Storage, doc, basePath)
|
||
}
|
||
if handlers.Carrier != nil {
|
||
registerCarrierRoutes(authGroup, handlers.Carrier, doc, basePath)
|
||
}
|
||
if handlers.PackageSeries != nil {
|
||
registerPackageSeriesRoutes(authGroup, handlers.PackageSeries, doc, basePath)
|
||
}
|
||
if handlers.Package != nil {
|
||
registerPackageRoutes(authGroup, handlers.Package, doc, basePath)
|
||
}
|
||
if handlers.PackageUsage != nil {
|
||
registerPackageUsageRoutes(authGroup, handlers.PackageUsage, doc, basePath)
|
||
}
|
||
if handlers.ShopPackageBatchAllocation != nil {
|
||
registerShopPackageBatchAllocationRoutes(authGroup, handlers.ShopPackageBatchAllocation, doc, basePath)
|
||
}
|
||
if handlers.ShopPackageBatchPricing != nil {
|
||
registerShopPackageBatchPricingRoutes(authGroup, handlers.ShopPackageBatchPricing, doc, basePath)
|
||
}
|
||
if handlers.ShopSeriesGrant != nil {
|
||
registerShopSeriesGrantRoutes(authGroup, handlers.ShopSeriesGrant, doc, basePath)
|
||
}
|
||
if handlers.AdminOrder != nil {
|
||
registerAdminOrderRoutes(authGroup, handlers.AdminOrder, doc, basePath)
|
||
}
|
||
if handlers.AdminExchange != nil {
|
||
registerAdminExchangeRoutes(authGroup, handlers.AdminExchange, doc, basePath)
|
||
}
|
||
if handlers.PollingConfig != nil {
|
||
registerPollingConfigRoutes(authGroup, handlers.PollingConfig, doc, basePath)
|
||
}
|
||
if handlers.PollingConcurrency != nil {
|
||
registerPollingConcurrencyRoutes(authGroup, handlers.PollingConcurrency, doc, basePath)
|
||
}
|
||
if handlers.PollingMonitoring != nil {
|
||
registerPollingMonitoringRoutes(authGroup, handlers.PollingMonitoring, doc, basePath)
|
||
}
|
||
if handlers.PollingAlert != nil {
|
||
registerPollingAlertRoutes(authGroup, handlers.PollingAlert, doc, basePath)
|
||
}
|
||
if handlers.PollingCleanup != nil {
|
||
registerPollingCleanupRoutes(authGroup, handlers.PollingCleanup, doc, basePath)
|
||
}
|
||
if handlers.PollingManualTrigger != nil {
|
||
registerPollingManualTriggerRoutes(authGroup, handlers.PollingManualTrigger, doc, basePath)
|
||
}
|
||
if handlers.Asset != nil {
|
||
registerAssetRoutes(authGroup, handlers.Asset, handlers.AssetWallet, doc, basePath)
|
||
}
|
||
if handlers.WechatConfig != nil {
|
||
registerWechatConfigRoutes(authGroup, handlers.WechatConfig, doc, basePath)
|
||
}
|
||
if handlers.AgentRecharge != nil {
|
||
registerAgentRechargeRoutes(authGroup, handlers.AgentRecharge, doc, basePath)
|
||
}
|
||
}
|