init: 后端框架脚手架 (Go + Gin + GORM + MySQL)

- 项目目录结构：backend/ deploy/ schema/ migrations/ - 数据库 Schema：所有建表 SQL，含 hotel_id 多租户隔离 - Go 后端：config、model、handler、service、middleware、router - 认证：账号密码登录 + JWT（Access + Refresh Token） - 许可证：HMAC-SHA256 激活码生成 + 设备绑定验证 - 业务模块：商品、仓库、往来单位、入库、出库、库存、盘点 - 库存事务：入库/出库审核时原子更新库存 + 流水记录 - 数据导入：Excel/CSV 批量导入商品、往来单位 - Docker Compose：本地 MySQL + Adminer Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-04 01:24:53 +08:00
commit 0e42f0e417
39 changed files with 2989 additions and 0 deletions
@@ -0,0 +1,115 @@
+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)
+
+	v1 := r.Group("/api/v1")
+
+	// 公开路由（无需登录）
+	auth := v1.Group("/auth")
+	{
+		auth.POST("/login", authH.Login)
+		auth.POST("/refresh", authH.Refresh)
+	}
+
+	// 需要 JWT 的路由
+	api := v1.Group("")
+	api.Use(middleware.JWT())
+	{
+		// 许可证
+		license := api.Group("/license")
+		{
+			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.PUT("/:id", productH.Update)
+			products.DELETE("/:id", productH.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/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/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.POST("/checks", inventoryH.CreateCheck)
+			inventory.GET("/checks/:id", inventoryH.GetCheck)
+		}
+
+		// 导入
+		imp := api.Group("/import")
+		{
+			imp.POST("/products", importH.ImportProducts)
+			imp.POST("/partners", importH.ImportPartners)
+		}
+	}
+}