jiu/backend/internal/router/router.go

package router

import (
	"github.com/gin-gonic/gin"
	"gorm.io/gorm"

	"github.com/wangjia/jiu/backend/internal/handler"
	"github.com/wangjia/jiu/backend/internal/middleware"
	"github.com/wangjia/jiu/backend/internal/service"
)

func Setup(r *gin.Engine, db *gorm.DB) {
	// 服务层
	authSvc := service.NewAuthService(db)
	licenseSvc := service.NewLicenseService(db)
	stockSvc := service.NewStockService(db)

	// 处理器
	authH := handler.NewAuthHandler(authSvc)
	licenseH := handler.NewLicenseHandler(licenseSvc)
	productH := handler.NewProductHandler(db)
	warehouseH := handler.NewWarehouseHandler(db)
	partnerH := handler.NewPartnerHandler(db)
	stockInH := handler.NewStockInHandler(db, stockSvc)
	stockOutH := handler.NewStockOutHandler(db, stockSvc)
	inventoryH := handler.NewInventoryHandler(db)
	importH := handler.NewImportHandler(db)
	userH := handler.NewUserHandler(db)
	productOptH := handler.NewProductOptionHandler(db)
	productImageH := handler.NewProductImageHandler(db)
	financeH := handler.NewFinanceHandler(db)
	numberRuleH := handler.NewNumberRuleHandler(db)
	publicH := handler.NewPublicHandler(db)

	// 健康检查（无需认证，用于前端连通性探测）
	r.GET("/health", func(c *gin.Context) {
		c.JSON(200, gin.H{"status": "ok"})
	})

	// 版本信息（无需认证，用于客户端更新检查）
	r.GET("/version", handler.GetVersion)

	v1 := r.Group("/api/v1")

	// 公开路由（无需登录）
	auth := v1.Group("/auth")
	{
		auth.POST("/login", authH.Login)
		auth.POST("/refresh", authH.Refresh)
	}

	// 商品公开详情（无需登录）
	public := v1.Group("/public")
	{
		public.GET("/products/:public_id", publicH.GetProduct)
	}

	// 需要 JWT 的路由（ReadOnly 中间件：只读用户不可执行写操作）
	api := v1.Group("")
	api.Use(middleware.JWT(), middleware.ReadOnly())
	{
		// 许可证
		license := api.Group("/license")
		{
			license.GET("/info", licenseH.Info)
			license.POST("/activate", licenseH.Activate)
			license.GET("/verify", licenseH.Verify)
			license.POST("/deactivate", licenseH.Deactivate)
		}

		// 商品
		products := api.Group("/products")
		{
			products.GET("", productH.List)
			products.POST("", productH.Create)
			products.POST("/find-or-create", productH.FindOrCreate)
			products.GET("/:id/detail", productH.Detail)
			products.GET("/:id/qrcode", productH.QRCode)
			products.PUT("/:id", productH.Update)
			products.DELETE("/:id", productH.Delete)
			products.POST("/:id/images", productImageH.Upload)
			products.DELETE("/:id/images/:image_id", productImageH.Delete)
		}

		// 仓库
		warehouses := api.Group("/warehouses")
		{
			warehouses.GET("", warehouseH.List)
			warehouses.POST("", warehouseH.Create)
			warehouses.PUT("/:id", warehouseH.Update)
			warehouses.DELETE("/:id", warehouseH.Delete)
		}

		// 往来单位
		partners := api.Group("/partners")
		{
			partners.GET("", partnerH.List)
			partners.POST("", partnerH.Create)
			partners.PUT("/:id", partnerH.Update)
			partners.DELETE("/:id", partnerH.Delete)
		}

		// 入库
		stockIn := api.Group("/stock-in")
		{
			stockIn.GET("/orders", stockInH.List)
			stockIn.GET("/orders/:id", stockInH.Get)
			stockIn.POST("/orders", stockInH.Create)
			stockIn.PUT("/orders/:id", stockInH.Update)
			stockIn.DELETE("/orders/:id", stockInH.Delete)
			stockIn.PUT("/orders/:id/submit", stockInH.Submit)
			stockIn.PUT("/orders/:id/approve", stockInH.Approve)
			stockIn.PUT("/orders/:id/reject", stockInH.Reject)
		}

		// 出库
		stockOut := api.Group("/stock-out")
		{
			stockOut.GET("/orders", stockOutH.List)
			stockOut.GET("/orders/:id", stockOutH.Get)
			stockOut.POST("/orders", stockOutH.Create)
			stockOut.PUT("/orders/:id", stockOutH.Update)
			stockOut.DELETE("/orders/:id", stockOutH.Delete)
			stockOut.PUT("/orders/:id/submit", stockOutH.Submit)
			stockOut.PUT("/orders/:id/approve", stockOutH.Approve)
			stockOut.PUT("/orders/:id/reject", stockOutH.Reject)
		}

		// 库存
		inventory := api.Group("/inventory")
		{
			inventory.GET("", inventoryH.List)
			inventory.GET("/logs", inventoryH.Logs)
			inventory.GET("/products", inventoryH.Products)
			inventory.POST("/checks", inventoryH.CreateCheck)
			inventory.GET("/checks/:id", inventoryH.GetCheck)
		}

		// 用户管理（仅管理员）
		users := api.Group("/users")
		users.Use(middleware.AdminOnly())
		{
			users.GET("", userH.List)
			users.POST("", userH.Create)
			users.PUT("/:id", userH.Update)
			users.PUT("/:id/reset-password", userH.ResetPassword)
		}

		// 财务
		finance := api.Group("/finance")
		{
			finance.GET("/records", financeH.ListRecords)
		}

		// 编号规则
		numberRules := api.Group("/number-rules")
		{
			numberRules.GET("", numberRuleH.List)
			numberRules.PUT("/:id", numberRuleH.Update)
		}

		// 导入
		imp := api.Group("/import")
		{
			imp.POST("/products",       importH.ImportProducts)
			imp.POST("/partners",       importH.ImportPartners)
			imp.POST("/product-names",  importH.ImportProductNames)
			imp.POST("/product-series", importH.ImportProductSeries)
			imp.POST("/product-specs",  importH.ImportProductSpecs)
			imp.POST("/stock-in",       importH.ImportStockIn)
			imp.POST("/stock-out",      importH.ImportStockOut)
		}

		// 基础数据选项（名称/系列/规格）
		opts := api.Group("/product-options")
		{
			opts.GET("/names", productOptH.ListNames)
			opts.POST("/names", productOptH.CreateName)
			opts.DELETE("/names/:id", productOptH.DeleteName)

			opts.GET("/series", productOptH.ListSeries)
			opts.POST("/series", productOptH.CreateSeries)
			opts.DELETE("/series/:id", productOptH.DeleteSeries)

			opts.GET("/specs", productOptH.ListSpecs)
			opts.POST("/specs", productOptH.CreateSpec)
			opts.DELETE("/specs/:id", productOptH.DeleteSpec)
		}
	}
}