feat: swag.

controllers/login.go

@@ -29,7 +29,16 @@ type AuthResponse struct {
 	User  models.User `json:"user"`
 }
 
-// Register 用户注册
+// @Summary 用户注册
+// @Description 注册新用户，返回JWT Token
+// @Tags 认证
+// @Accept json
+// @Produce json
+// @Param request body SwagRegisterRequest true "注册信息"
+// @Success 201 {object} SwagAPIResponse "注册成功"
+// @Failure 400 {object} SwagAPIResponse "请求参数错误"
+// @Failure 409 {object} SwagAPIResponse "用户名已存在"
+// @Router /register [post]
 func Register(c *gin.Context) {
 	var req RegisterRequest
 	if err := c.ShouldBindJSON(&req); err != nil {
@@ -73,7 +82,17 @@ func Register(c *gin.Context) {
 	})
 }
 
-// Login 用户登录
+// @Summary 用户登录
+// @Description 用户名密码登录，返回JWT Token和用户信息
+// @Tags 认证
+// @Accept json
+// @Produce json
+// @Param request body SwagLoginRequest true "登录信息"
+// @Success 200 {object} SwagAPIResponse "登录成功"
+// @Failure 400 {object} SwagAPIResponse "请求参数错误"
+// @Failure 401 {object} SwagAPIResponse "用户名或密码错误"
+// @Failure 403 {object} SwagAPIResponse "用户已禁用"
+// @Router /login [post]
 func Login(c *gin.Context) {
 	var req LoginRequest
 	if err := c.ShouldBindJSON(&req); err != nil {