补齐 HTTP 层：实现用户模块、路由与中间件接线、COS 上传及优雅启动

- 新增用户与上传错误码文件及 Recovery 中间件
- 修复 router.go 导入与中间件链，注册用户路由并补 handler 错误码导入
- 补充用户状态常量与 UserGetByWechatOpenID 查询，修订刷新令牌 dto
- 移除 upload 包 OTel 调用，新增 FileUploadCos 上传封装
- 实现 UserService 微信登录/刷新令牌/我的信息/改资料/上传头像
- 裁剪 main.go 配置段并移除 OTel 桥接，补启动与优雅退出
- 新增 configs 示例配置、global 配置结构及 go.mod 依赖

internal/routers/api/v1/user.go

@@ -0,0 +1,119 @@
+// Package v1 提供 /api/v1 版本的 HTTP handler，负责请求绑定、鉴权透传与统一响应，
+// 业务逻辑与归属校验均在 internal/service 层完成。
+package v1
+
+import (
+	"net/http"
+
+	"git.lzcwy.cn/zhengchiliu/zt-online-game-backend/global"
+	"git.lzcwy.cn/zhengchiliu/zt-online-game-backend/internal/dto"
+	"git.lzcwy.cn/zhengchiliu/zt-online-game-backend/internal/middleware"
+	"git.lzcwy.cn/zhengchiliu/zt-online-game-backend/internal/service"
+	"git.lzcwy.cn/zhengchiliu/zt-online-game-backend/pkg/app"
+	"git.lzcwy.cn/zhengchiliu/zt-online-game-backend/pkg/errcode"
+	"github.com/gin-gonic/gin"
+)
+
+// UserHandler 用户相关接口。
+type UserHandler struct {
+	svc *service.UserService
+}
+
+// NewUserHandler 创建用户 handler。
+func NewUserHandler() *UserHandler {
+	return &UserHandler{svc: service.NewUserService()}
+}
+
+// WxLogin 微信登录（公开）。
+func (h *UserHandler) WxLogin(c *gin.Context) {
+	response := app.NewResponse(c)
+	var request dto.UserWxLoginRequest
+	if err := c.ShouldBindJSON(&request); err != nil {
+		response.ToErrorResponse(errcode.InvalidParams.WithDetails(err.Error()))
+		return
+	}
+	out, e := h.svc.WxLogin(c.Request.Context(), &request)
+	if e != nil {
+		response.ToErrorResponse(e)
+		return
+	}
+	response.ToResponse(out)
+}
+
+// RefreshToken 刷新访问令牌（公开）。
+func (h *UserHandler) RefreshToken(c *gin.Context) {
+	response := app.NewResponse(c)
+	var request dto.UserRefreshTokenRequest
+	if err := c.ShouldBindJSON(&request); err != nil {
+		response.ToErrorResponse(errcode.InvalidParams.WithDetails(err.Error()))
+		return
+	}
+	out, e := h.svc.RefreshToken(c.Request.Context(), &request)
+	if e != nil {
+		response.ToErrorResponse(e)
+		return
+	}
+	response.ToResponse(out)
+}
+
+// InfoGetBySelf 获取当前用户信息。
+func (h *UserHandler) InfoGetBySelf(c *gin.Context) {
+	response := app.NewResponse(c)
+	userID, ok := middleware.GetUserID(c.Request.Context())
+	if !ok {
+		response.ToErrorResponse(errcode.Unauthorized)
+		return
+	}
+	out, e := h.svc.InfoGetBySelf(c.Request.Context(), userID)
+	if e != nil {
+		response.ToErrorResponse(e)
+		return
+	}
+	response.ToResponse(out)
+}
+
+// ProfileUpdate 修改当前用户资料。
+func (h *UserHandler) ProfileUpdate(c *gin.Context) {
+	response := app.NewResponse(c)
+	userID, ok := middleware.GetUserID(c.Request.Context())
+	if !ok {
+		response.ToErrorResponse(errcode.Unauthorized)
+		return
+	}
+	var request dto.UserProfileUpdateBySelfRequest
+	if err := c.ShouldBindJSON(&request); err != nil {
+		response.ToErrorResponse(errcode.InvalidParams.WithDetails(err.Error()))
+		return
+	}
+	out, e := h.svc.ProfileUpdate(c.Request.Context(), userID, &request)
+	if e != nil {
+		response.ToErrorResponse(e)
+		return
+	}
+	response.ToResponse(out)
+}
+
+// AvatarUpload 上传用户头像（multipart，字段名 file）。
+func (h *UserHandler) AvatarUpload(c *gin.Context) {
+	response := app.NewResponse(c)
+	userID, ok := middleware.GetUserID(c.Request.Context())
+	if !ok {
+		response.ToErrorResponse(errcode.Unauthorized)
+		return
+	}
+	// 解析 multipart 前限制请求体大小（MaxSizeMB + 1MB 的 multipart 边界开销），
+	// 防止超大 body 在 FormFile 解析时耗尽内存/磁盘。
+	maxBytes := int64(global.UploadSetting.MaxSizeMB)*1024*1024 + 1024*1024
+	c.Request.Body = http.MaxBytesReader(c.Writer, c.Request.Body, maxBytes)
+	fileHeader, err := c.FormFile("file")
+	if err != nil {
+		response.ToErrorResponse(errcode.UploadFileEmpty.WithDetails(err.Error()))
+		return
+	}
+	out, e := h.svc.AvatarUpload(c.Request.Context(), userID, fileHeader)
+	if e != nil {
+		response.ToErrorResponse(e)
+		return
+	}
+	response.ToResponse(out)
+}

internal/routers/router.go

@@ -0,0 +1,49 @@
+package routers
+
+import (
+	"net/http"
+
+	"git.lzcwy.cn/zhengchiliu/zt-online-game-backend/internal/middleware"
+	v1 "git.lzcwy.cn/zhengchiliu/zt-online-game-backend/internal/routers/api/v1"
+	"github.com/gin-gonic/gin"
+)
+
+// NewRouter 构建 gin 引擎：注册中间件链与 /api/v1 路由。
+func NewRouter() *gin.Engine {
+	r := gin.New()
+
+	// 中间件链：Recovery -> RequestID -> Slog -> CORS
+	r.Use(
+		middleware.Recovery(),
+		middleware.RequestID(),
+		middleware.GinSlogMiddleware(),
+		middleware.CORS(),
+	)
+
+	// 健康检查
+	r.GET("/ping", func(c *gin.Context) {
+		c.JSON(http.StatusOK, gin.H{"message": "pong"})
+	})
+
+	// handler 实例
+	userHandler := v1.NewUserHandler()
+
+	apiV1 := r.Group("/api/v1")
+
+	// ===== 公开路由（无需登录） =====
+	{
+		apiV1.POST("/user/wxlogin", userHandler.WxLogin)
+		apiV1.POST("/user/refresh-token", userHandler.RefreshToken)
+	}
+
+	// ===== 鉴权路由（需登录） =====
+	auth := apiV1.Group("")
+	auth.Use(middleware.JWTAuth())
+	{
+		auth.GET("/user/info", userHandler.InfoGetBySelf)
+		auth.PUT("/user/profile", userHandler.ProfileUpdate)
+		auth.POST("/user/avatar/upload", userHandler.AvatarUpload)
+	}
+
+	return r
+}