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)
	adminH := handler.NewAdminHandler(db)
	shopH := handler.NewShopHandler(db)
	errorReportH := handler.NewErrorReportHandler(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)
		public.GET("/release", publicH.GetRelease)
		public.POST("/errors", errorReportH.Submit)
		public.POST("/register", authH.Register)
	}

	// 需要 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.PUT("/:id/remark", inventoryH.UpdateRemark)
			inventory.POST("/checks", inventoryH.CreateCheck)
			inventory.GET("/checks/:id", inventoryH.GetCheck)
			inventory.PUT("/checks/:id/complete", inventoryH.CompleteCheck)
		}

		// 用户管理（仅管理员）
		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)
			finance.POST("/records",               financeH.Create)
			finance.PUT("/records/:id/close",      financeH.Close)
			finance.PUT("/records/close-by-ref",   financeH.CloseByRef)
			finance.GET("/summary",                financeH.Summary)
		}

		// 酒行信息
		shop := api.Group("/shop")
		{
			shop.GET("/info", shopH.GetInfo)
			shop.PUT("/info", middleware.AdminOnly(), shopH.UpdateInfo)
			shop.POST("/logo", middleware.AdminOnly(), shopH.UploadLogo)
		}

		// 编号规则
		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("/product-codes",  importH.ImportProductCodes)
			imp.POST("/stock-in",       importH.ImportStockIn)
			imp.POST("/stock-out",      importH.ImportStockOut)
			imp.POST("/inventory",      importH.ImportInventory)
		}

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

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

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

		// 超级管理员专属
		superAdmin := api.Group("/admin")
		superAdmin.Use(middleware.SuperAdminOnly())
		{
			superAdmin.POST("/clear-data", adminH.ClearData)
			superAdmin.GET("/errors", errorReportH.List)
		}
	}
}