user

type CreateUserReq struct {
	Name     string            `json:"name" validate:"required,min=2,max=100" doc:"User's full name" example:"testUserName"`
	Email    string            `json:"email" validate:"required,email" doc:"User's email address" example:"testEmail"`
	Age      *int              `json:"age,omitempty" validate:"omitempty,min=13,max=120" doc:"User's age (optional)" example:"30"`
	Role     string            `json:"role" validate:"oneof=admin user guest" doc:"User role" example:"user"`
	Active   bool              `json:"active" doc:"Whether the user account is active" example:"true"`
	Metadata map[string]string `json:"metadata,omitempty" doc:"Additional user metadata"`
}

type DeleteUserReq struct {
	ID    int  `param:"id" validate:"required,min=1" doc:"User ID to delete" example:"123"`
	Force bool `query:"force" doc:"Force deletion even if user has associated data" example:"false"`
}

type GetUserReq struct {
	ID int `param:"id" validate:"required,min=1" doc:"User ID" example:"123"`
}

type ListResponse struct {
	Users []Response `json:"users" doc:"List of users for the current page"`
	Total int        `json:"total" doc:"Total number of users matching the filter" example:"150"`
	Page  int        `json:"page" doc:"Current page number" example:"1"`
	Pages int        `json:"pages" doc:"Total number of pages" example:"8"`
}

type ListUsersReq struct {
	Page     int      `query:"page" validate:"omitempty,min=1" doc:"Page number (1-based)" example:"1"`
	PageSize int      `query:"page_size" validate:"omitempty,min=1,max=100" doc:"Number of users per page" example:"20"`
	Search   string   `query:"search" doc:"Search term for name or email" example:"john"`
	Roles    []string `query:"roles" doc:"Filter by user roles (repeat query param: roles=user&roles=admin)" example:"user,admin"`
	Active   *bool    `query:"active" doc:"Filter by active status" example:"true"`
}

type Module struct {
	// contains filtered or unexported fields
}

type Response struct {
	ID        int               `json:"id" doc:"Unique user identifier" example:"123"`
	Name      string            `json:"name" doc:"User's full name" example:"testUserName"`
	Email     string            `json:"email" doc:"User's email address" example:"testEmail"`
	Age       *int              `json:"age,omitempty" doc:"User's age" example:"30"`
	Role      string            `json:"role" doc:"User role" example:"user"`
	Active    bool              `json:"active" doc:"Whether the user account is active" example:"true"`
	CreatedAt time.Time         `json:"created_at" doc:"Account creation timestamp" example:"2023-01-15T10:30:00Z"`
	UpdatedAt time.Time         `json:"updated_at" doc:"Last update timestamp" example:"2023-01-15T14:45:00Z"`
	Metadata  map[string]string `json:"metadata,omitempty" doc:"Additional user metadata"`
}

type UpdateUserReq struct {
	ID     int    `param:"id" validate:"required,min=1" doc:"User ID" example:"123"`
	Name   string `json:"name,omitempty" validate:"omitempty,min=2,max=100" doc:"User's full name" example:"testUserName"`
	Email  string `json:"email,omitempty" validate:"omitempty,email" doc:"User's email address" example:"testEmail"`
	Age    *int   `json:"age,omitempty" validate:"omitempty,min=13,max=120" doc:"User's age" example:"30"`
	Role   string `json:"role,omitempty" validate:"omitempty,oneof=admin user guest" doc:"User role" example:"user"`
	Active *bool  `json:"active,omitempty" doc:"Whether the user account is active" example:"true"`
}