Deploy files from GitHub repository

controllers/user_controller.go

@@ -28,15 +28,15 @@ func NewUserController(accountService services.AccountService) UserController {
 }
 
 // ListUsers godoc
-// @Summary      List All Users
-// @Description  Retrieve a paginated list of users with optional role filter
-// @Tags         Admin Users
+// @Summary      List All Users with Pagination
+// @Description  Retrieve a paginated list of all users with optional role filter. Supports pagination parameters (page, limit) and can filter by user role.
+// @Tags         Super Admin Users Management
 // @Accept       json
 // @Produce      json
 // @Security     BearerAuth
-// @Param        page      query     int     false  "Page number"                        default(1)
-// @Param        limit     query     int     false  "Number of items per page (max 50)"  default(10)
-// @Param        role      query     string  false  "Filter by role: user, admin, super_admin"
+// @Param        page      query     int     false  "Page number for pagination. Minimum value is 1. Default is 1."
+// @Param        limit     query     int     false  "Number of items per page. Minimum 1, Maximum 50. Default is 10."
+// @Param        role      query     string  false  "Filter users by role. Allowed values: user, admin, super_admin. Leave empty for no filter."
 // @Success      200  {object}  dto.SuccessResponse[[]dto.UserResponse]
 // @Failure      400  {object}  dto.ErrorResponse
 // @Failure      401  {object}  dto.ErrorResponse
@@ -118,7 +118,7 @@ func (c *userController) ListUsers(ctx *gin.Context) {
 // CreateUser godoc
 // @Summary      Create Single User
 // @Description  Create a new user account by providing user details
-// @Tags         Admin Users
+// @Tags         Super Admin Users Management
 // @Accept       json
 // @Produce      json
 // @Security     BearerAuth
@@ -159,7 +159,7 @@ func (c *userController) CreateUser(ctx *gin.Context) {
 // BulkCreateUsers godoc
 // @Summary      Bulk Create Users
 // @Description  Create multiple user accounts at once
-// @Tags         Admin Users
+// @Tags         Super Admin Users Management
 // @Accept       json
 // @Produce      json
 // @Security     BearerAuth
@@ -184,7 +184,7 @@ func (c *userController) BulkCreateUsers(ctx *gin.Context) {
 // GetUserById godoc
 // @Summary      Edit User
 // @Description  Update user information by ID
-// @Tags         Admin Users
+// @Tags         Super Admin Users Management
 // @Accept       json
 // @Produce      json
 // @Security     BearerAuth
@@ -245,7 +245,7 @@ func (c *userController) UpdateUser(ctx *gin.Context) {
 // DeleteUser godoc
 // @Summary      Delete User
 // @Description  Delete a user account by ID
-// @Tags         Admin Users
+// @Tags         Super Admin Users Management
 // @Accept       json
 // @Produce      json
 // @Security     BearerAuth