仓库自包含化：Docker/CI/文档/规范入库，路由分组拆分

internal/api/routes_swagger.go

@@ -0,0 +1,19 @@
+package api
+
+import (
+	"os"
+
+	"github.com/gin-gonic/gin"
+	swaggerFiles "github.com/swaggo/files"
+	ginSwagger "github.com/swaggo/gin-swagger"
+)
+
+// registerSwagger 挂载 swagger UI 与 spec(/swagger/index.html)。
+// 默认关闭,环境变量 SWAGGER=1 时开启——面板管理接口结构不宜默认对外,
+// 生产按需临时打开;spec 由 `go tool swag init` 生成进 docs/ 包。
+func registerSwagger(r *gin.Engine) {
+	if os.Getenv("SWAGGER") != "1" {
+		return
+	}
+	r.GET("/swagger/*any", ginSwagger.WrapHandler(swaggerFiles.Handler))
+}