package routes import ( "github.com/gofiber/fiber/v2" "github.com/break/junhong_cmp_fiber/internal/handler/admin" "github.com/break/junhong_cmp_fiber/internal/model/dto" "github.com/break/junhong_cmp_fiber/pkg/constants" "github.com/break/junhong_cmp_fiber/pkg/errors" "github.com/break/junhong_cmp_fiber/pkg/middleware" "github.com/break/junhong_cmp_fiber/pkg/openapi" ) func registerShopRoutes(router fiber.Router, handler *admin.ShopHandler, doc *openapi.Generator, basePath string) { shops := router.Group("/shops") groupPath := basePath + "/shops" Register(shops, doc, groupPath, "GET", "", coreShopManagement(handler.List), RouteSpec{ Summary: "店铺列表", Description: constants.ShopManagementAccessDescription + constants.ShopListPaginationDescription, Tags: []string{"店铺管理"}, Input: new(dto.ShopListRequest), Output: new(dto.ShopPageResult), Auth: true, }) Register(shops, doc, groupPath, "POST", "", coreShopManagement(handler.Create), RouteSpec{ Summary: "创建店铺", Description: constants.ShopManagementAccessDescription, Tags: []string{"店铺管理"}, Input: new(dto.CreateShopRequest), Output: new(dto.ShopResponse), Auth: true, }) Register(shops, doc, groupPath, "GET", "/business-owner-candidates", coreShopManagement(handler.BusinessOwnerCandidates), RouteSpec{ Summary: "查询店铺业务员候选", Description: "仅超级管理员和平台账号可查询;只返回当前启用、未删除的平台账号最小摘要。", Tags: []string{"店铺管理"}, Input: new(dto.ShopBusinessOwnerCandidateRequest), Output: new(dto.ShopBusinessOwnerCandidatePageResult), Auth: true, }) Register(shops, doc, groupPath, "PUT", "/:id", coreShopManagement(handler.Update), RouteSpec{ Summary: "更新店铺", Description: constants.ShopManagementAccessDescription, Tags: []string{"店铺管理"}, Input: new(dto.UpdateShopParams), Output: new(dto.ShopResponse), Auth: true, }) Register(shops, doc, groupPath, "PUT", "/:id/credit-limit", handler.UpdateCreditLimit, RouteSpec{ Summary: "调整既有店铺实际信用额度", Description: "后端不校验按钮权限;shop:credit-limit:manage 仅供前端控制按钮显示。", Tags: []string{"代理商资金管理"}, Input: new(dto.UpdateShopCreditLimitParams), Output: new(dto.ShopCreditLimitResponse), Auth: true, }) Register(shops, doc, groupPath, "DELETE", "/:id", coreShopManagement(handler.Delete), RouteSpec{ Summary: "删除店铺", Description: constants.ShopManagementAccessDescription, Tags: []string{"店铺管理"}, Input: new(dto.IDReq), Output: nil, Auth: true, }) Register(shops, doc, groupPath, "GET", "/cascade", coreShopManagement(handler.Cascade), RouteSpec{ Summary: "店铺联级查询", Description: constants.ShopManagementAccessDescription, Tags: []string{"店铺管理"}, Input: new(dto.ShopCascadeRequest), Output: new([]dto.ShopCascadeItem), Auth: true, }) } func registerShopDetailRoute(router fiber.Router, handler *admin.ShopHandler, doc *openapi.Generator, basePath string) { shops := router.Group("/shops") groupPath := basePath + "/shops" Register(shops, doc, groupPath, "GET", "/:id", coreShopManagement(handler.Detail), RouteSpec{ Summary: "查询店铺详情", Description: constants.ShopManagementAccessDescription + " 返回与店铺列表一致的业务员归属摘要。", Tags: []string{"店铺管理"}, Input: new(dto.IDReq), Output: new(dto.ShopResponse), Auth: true, }) } func coreShopManagement(handler fiber.Handler) fiber.Handler { return func(c *fiber.Ctx) error { if middleware.GetUserTypeFromContext(c.UserContext()) == constants.UserTypeEnterprise { return errors.New(errors.CodeForbidden, constants.ShopManagementForbiddenMessage) } return handler(c) } } func registerShopRoleRoutes(router fiber.Router, handler *admin.ShopRoleHandler, doc *openapi.Generator, basePath string) { shops := router.Group("/shops") groupPath := basePath + "/shops" Register(shops, doc, groupPath, "POST", "/:shop_id/roles", handler.AssignShopRoles, RouteSpec{ Summary: "分配店铺默认角色", Tags: []string{"店铺管理"}, Input: new(dto.AssignShopRolesRequest), Output: new(dto.ShopRolesResponse), Auth: true, }) Register(shops, doc, groupPath, "GET", "/:shop_id/roles", handler.GetShopRoles, RouteSpec{ Summary: "查询店铺默认角色", Tags: []string{"店铺管理"}, Input: new(dto.GetShopRolesRequest), Output: new(dto.ShopRolesResponse), Auth: true, }) Register(shops, doc, groupPath, "DELETE", "/:shop_id/roles/:role_id", handler.DeleteShopRole, RouteSpec{ Summary: "删除店铺默认角色", Tags: []string{"店铺管理"}, Input: new(dto.DeleteShopRoleRequest), Output: nil, Auth: true, }) } func registerShopCommissionRoutes(router fiber.Router, handler *admin.ShopCommissionHandler, doc *openapi.Generator, basePath string) { shops := router.Group("/shops") groupPath := basePath + "/shops" Register(shops, doc, groupPath, "GET", "/fund-summary", agentFundManagement(handler.ListFundSummary), RouteSpec{ Summary: "代理商资金概况", Description: "按当前店铺数据范围分页返回主钱包、佣金及信用资金事实;现金可用、总可用和欠款均由服务端计算,读取不代表具有调额权限。", Tags: []string{"代理商资金管理"}, Input: new(dto.ShopFundSummaryListReq), Output: new(dto.ShopFundSummaryPageResult), Auth: true, }) Register(shops, doc, groupPath, "GET", "/:shop_id/withdrawal-requests", handler.ListWithdrawalRequests, RouteSpec{ Summary: "代理商提现记录", Tags: []string{"代理商资金管理"}, Input: new(dto.ShopWithdrawalRequestListReq), Output: new(dto.ShopWithdrawalRequestPageResult), Auth: true, }) Register(shops, doc, groupPath, "GET", "/:shop_id/commission-records", handler.ListCommissionRecords, RouteSpec{ Summary: "代理商佣金明细", Tags: []string{"代理商资金管理"}, Input: new(dto.ShopCommissionRecordListReq), Output: new(dto.ShopCommissionRecordPageResult), Auth: true, }) Register(shops, doc, groupPath, "GET", "/:shop_id/main-wallet/transactions", handler.ListMainWalletTransactions, RouteSpec{ Summary: "代理商预充值钱包流水", Tags: []string{"代理商资金管理"}, Input: new(dto.MainWalletTransactionListRequest), Output: new(dto.MainWalletTransactionListResponse), Auth: true, }) Register(shops, doc, groupPath, "GET", "/:shop_id/commission-stats", handler.GetCommissionStats, RouteSpec{ Summary: "代理商佣金统计", Tags: []string{"代理商资金管理"}, Input: new(dto.CommissionStatsRequest), Output: new(dto.CommissionStatsResponse), Auth: true, }) Register(shops, doc, groupPath, "GET", "/:shop_id/commission-daily-stats", handler.GetCommissionDailyStats, RouteSpec{ Summary: "代理商每日佣金统计", Tags: []string{"代理商资金管理"}, Input: new(dto.DailyCommissionStatsRequest), Output: []dto.DailyCommissionStatsResponse{}, Auth: true, }) Register(shops, doc, groupPath, "POST", "/:shop_id/withdrawal-requests", handler.CreateWithdrawal, RouteSpec{ Summary: "发起提现申请", Tags: []string{"代理商资金管理"}, Input: new(dto.CreateMyWithdrawalReq), Output: new(dto.CreateMyWithdrawalResp), Auth: true, }) commissionRecords := router.Group("/commission-records") crPath := basePath + "/commission-records" Register(commissionRecords, doc, crPath, "POST", "/:id/resolve", handler.ResolveCommissionRecord, RouteSpec{ Summary: "修正待审佣金记录", Tags: []string{"代理商资金管理"}, Input: new(dto.CommissionRecordResolveRequest), Auth: true, }) } func agentFundManagement(handler fiber.Handler) fiber.Handler { return func(c *fiber.Ctx) error { if middleware.GetUserTypeFromContext(c.UserContext()) == constants.UserTypeEnterprise { return errors.New(errors.CodeForbidden, constants.AgentFundManagementForbiddenMessage) } return handler(c) } }