添加文件: server_tb_LinkedMall/internal/router/router.go

server_tb_LinkedMall/internal/router/router.go

@@ -0,0 +1,205 @@
+package router
+
+import (
+	"github.com/gofiber/fiber/v2"
+
+	"server_tb_LinkedMall/internal/middleware"
+	"server_tb_LinkedMall/internal/service"
+)
+
+// SetupRouter 注册所有路由
+func SetupRouter(app *fiber.App, svc *service.LinkedMallService) {
+	// 全局中间件
+	app.Use(middleware.RequestID())
+	app.Use(middleware.CORS())
+
+	// 健康检查
+	app.Get("/health", func(c *fiber.Ctx) error {
+		return c.JSON(fiber.Map{"status": "ok"})
+	})
+
+	// API v1 路由组
+	api := app.Group("/api/v1", middleware.StandardResponse())
+
+	// ============================================================
+	// 采购方店铺相关
+	// ============================================================
+
+	// 接口 1: ListPurchaserShops - 分页获取采购方店铺列表
+	api.Get("/purchaser-shops", func(c *fiber.Ctx) error {
+		// TODO: 实现参数绑定和调用
+		return c.JSON(fiber.Map{"message": "ListPurchaserShops - 待实现"})
+	})
+
+	// 接口 2: GetPurchaserShop - 获取单个采购店铺详情
+	api.Get("/purchaser-shops/:shopId", func(c *fiber.Ctx) error {
+		// TODO: 实现参数绑定和调用
+		return c.JSON(fiber.Map{"message": "GetPurchaserShop - 待实现"})
+	})
+
+	// ============================================================
+	// 选品池商品相关
+	// ============================================================
+
+	// 接口 3: ListSelectionProducts - 分页查询选品池商品列表
+	api.Get("/selection-products", func(c *fiber.Ctx) error {
+		// TODO: 实现参数绑定和调用
+		return c.JSON(fiber.Map{"message": "ListSelectionProducts - 待实现"})
+	})
+
+	// 接口 4: GetSelectionProduct - 查询选品池商品详情
+	api.Get("/selection-products/:productId", func(c *fiber.Ctx) error {
+		// TODO: 实现参数绑定和调用
+		return c.JSON(fiber.Map{"message": "GetSelectionProduct - 待实现"})
+	})
+
+	// 接口 5: GetSelectionProductSaleInfo - 查询选品池商品销售信息
+	api.Get("/selection-products/:productId/sale-info", func(c *fiber.Ctx) error {
+		// TODO: 实现参数绑定和调用
+		return c.JSON(fiber.Map{"message": "GetSelectionProductSaleInfo - 待实现"})
+	})
+
+	// 接口 6: ListSelectionProductSaleInfos - 批量查询商品销售信息
+	api.Post("/selection-products:batch-sale-info", func(c *fiber.Ctx) error {
+		// TODO: 实现参数绑定和调用
+		return c.JSON(fiber.Map{"message": "ListSelectionProductSaleInfos - 待实现"})
+	})
+
+	// 接口 7: ListSelectionSkuSaleInfos - 批量SKU销售信息
+	api.Post("/selection-skus:batch-sale-info", func(c *fiber.Ctx) error {
+		// TODO: 实现参数绑定和调用
+		return c.JSON(fiber.Map{"message": "ListSelectionSkuSaleInfos - 待实现"})
+	})
+
+	// 接口 8: ListCategories - 查询类目列表
+	api.Get("/categories", func(c *fiber.Ctx) error {
+		// TODO: 实现参数绑定和调用
+		return c.JSON(fiber.Map{"message": "ListCategories - 待实现"})
+	})
+
+	// 接口 9: SearchProducts - 搜索选品池商品
+	api.Post("/selection-products:search", func(c *fiber.Ctx) error {
+		// TODO: 实现参数绑定和调用
+		return c.JSON(fiber.Map{"message": "SearchProducts - 待实现"})
+	})
+
+	// 接口 10: SelectionGroupAddProduct - 选品池商品入库
+	api.Post("/selection-group/products:add", func(c *fiber.Ctx) error {
+		// TODO: 实现参数绑定和调用
+		return c.JSON(fiber.Map{"message": "SelectionGroupAddProduct - 待实现"})
+	})
+
+	// 接口 11: SelectionGroupRemoveProduct - 选品池商品出库
+	api.Post("/selection-group/products:remove", func(c *fiber.Ctx) error {
+		// TODO: 实现参数绑定和调用
+		return c.JSON(fiber.Map{"message": "SelectionGroupRemoveProduct - 待实现"})
+	})
+
+	// ============================================================
+	// 采购单相关
+	// ============================================================
+
+	// 接口 12: RenderPurchaseOrder - 采购单渲染（下单预校验）
+	api.Post("/purchase-orders:render", func(c *fiber.Ctx) error {
+		// TODO: 实现参数绑定和调用
+		return c.JSON(fiber.Map{"message": "RenderPurchaseOrder - 待实现"})
+	})
+
+	// 接口 13: SplitPurchaseOrder - 采购单渲染并拆单
+	api.Post("/purchase-orders:split-render", func(c *fiber.Ctx) error {
+		// TODO: 实现参数绑定和调用
+		return c.JSON(fiber.Map{"message": "SplitPurchaseOrder - 待实现"})
+	})
+
+	// 接口 14: CreatePurchaseOrder - 创建采购单【异步】
+	api.Post("/purchase-orders", func(c *fiber.Ctx) error {
+		// TODO: 实现参数绑定和调用
+		return c.JSON(fiber.Map{"message": "CreatePurchaseOrder - 待实现"})
+	})
+
+	// 接口 15: GetPurchaseOrderStatus - 获取采购单状态
+	api.Get("/purchase-orders/:purchaseOrderId/status", func(c *fiber.Ctx) error {
+		// TODO: 实现参数绑定和调用
+		return c.JSON(fiber.Map{"message": "GetPurchaseOrderStatus - 待实现"})
+	})
+
+	// ============================================================
+	// 订单相关
+	// ============================================================
+
+	// 接口 16: GetOrder - 获取订单详情
+	api.Get("/orders/:orderId", func(c *fiber.Ctx) error {
+		// TODO: 实现参数绑定和调用
+		return c.JSON(fiber.Map{"message": "GetOrder - 待实现"})
+	})
+
+	// 接口 17: QueryOrders - 查询订单列表
+	api.Get("/orders", func(c *fiber.Ctx) error {
+		// TODO: 实现参数绑定和调用
+		return c.JSON(fiber.Map{"message": "QueryOrders - 待实现"})
+	})
+
+	// 接口 18: ListLogisticsOrders - 查询订单物流信息
+	api.Get("/orders/:orderId/logistics", func(c *fiber.Ctx) error {
+		// TODO: 实现参数绑定和调用
+		return c.JSON(fiber.Map{"message": "ListLogisticsOrders - 待实现"})
+	})
+
+	// 接口 19: ConfirmDisburse - 确认收货
+	api.Post("/orders/:orderId:confirm-disburse", func(c *fiber.Ctx) error {
+		// TODO: 实现参数绑定和调用
+		return c.JSON(fiber.Map{"message": "ConfirmDisburse - 待实现"})
+	})
+
+	// ============================================================
+	// 售后相关
+	// ============================================================
+
+	// 接口 20: RenderRefundOrder - 售后渲染预校验
+	api.Post("/refund-orders:render", func(c *fiber.Ctx) error {
+		// TODO: 实现参数绑定和调用
+		return c.JSON(fiber.Map{"message": "RenderRefundOrder - 待实现"})
+	})
+
+	// 接口 21: CreateRefundOrder - 创建售后单
+	api.Post("/refund-orders", func(c *fiber.Ctx) error {
+		// TODO: 实现参数绑定和调用
+		return c.JSON(fiber.Map{"message": "CreateRefundOrder - 待实现"})
+	})
+
+	// 接口 22: CancelRefundOrder - 取消售后单
+	api.Post("/refund-orders/:refundOrderId:cancel", func(c *fiber.Ctx) error {
+		// TODO: 实现参数绑定和调用
+		return c.JSON(fiber.Map{"message": "CancelRefundOrder - 待实现"})
+	})
+
+	// 接口 23: GetRefundOrder - 获取售后单详情
+	api.Get("/refund-orders/:refundOrderId", func(c *fiber.Ctx) error {
+		// TODO: 实现参数绑定和调用
+		return c.JSON(fiber.Map{"message": "GetRefundOrder - 待实现"})
+	})
+
+	// 接口 24: CreateGoodsShippingNotice - 回填退货物流运单
+	api.Post("/refund-orders/:refundOrderId:fill-logistics", func(c *fiber.Ctx) error {
+		// TODO: 实现参数绑定和调用
+		return c.JSON(fiber.Map{"message": "CreateGoodsShippingNotice - 待实现"})
+	})
+
+	// ============================================================
+	// 区域编码
+	// ============================================================
+
+	// 接口 25: QueryChildDivisionCode - 查询子区域编码
+	api.Get("/divisions:children", func(c *fiber.Ctx) error {
+		// TODO: 实现参数绑定和调用
+		return c.JSON(fiber.Map{"message": "QueryChildDivisionCode - 待实现"})
+	})
+
+	// ============================================================
+	// 回调通知（供LinkedMall回调）
+	// ============================================================
+	api.Post("/callback", func(c *fiber.Ctx) error {
+		// TODO: 实现回调处理逻辑
+		return c.JSON(fiber.Map{"success": true})
+	})
+}