Full Restruct API and Services

Signed-off-by: Asai Neko <sugar@sne.moe>

api/user/list.go

@@ -8,6 +8,18 @@ import (
 	"github.com/gin-gonic/gin"
 )
 
+// List retrieves a paginated list of users from the search engine.
+// @Summary      List Users
+// @Description  Fetches a list of users with support for pagination via limit and offset.
+// @Tags         User
+// @Accept       json
+// @Produce      json
+// @Param        limit   query     string  false  "Maximum number of users to return (default 0)"
+// @Param        offset  query     string  true   "Number of users to skip"
+// @Success      200     {object}  service_user.UserListResult
+// @Failure      400     {string}  string  "Invalid Input (Format Error)"
+// @Failure      500     {string}  string  "Internal Server Error (Search Engine or Missing Offset)"
+// @Router       /user/list [get]
 func (self *UserHandler) List(c *gin.Context) {
 	type ListQuery struct {
 		Limit  *string `form:"limit"`