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

This commit is contained in:
renzhiyuan 2026-08-27 16:19:09 +08:00
parent dd117b3da5
commit 3e4ebaf34d
1 changed files with 205 additions and 0 deletions

View File

@ -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})
})
}