Refactor health check and user management endpoints for improved structure and clarity

- Replaced the existing health check endpoint with a new handler at `/admin/v1/health` to align with the updated API structure.
- Introduced a dedicated `health.go` file to encapsulate health check logic and response formatting.
- Updated Swagger documentation to reflect the new health check endpoint and its response structure.
- Refined user management routes to enhance clarity and maintainability, including changes to login, logout, and profile management endpoints.
- Ensured all user-related endpoints are now prefixed appropriately and documented in Swagger for better API usability.

internal/user/handler.go

@@ -63,8 +63,8 @@ func (h *Handler) RegisterRoutes(e *echo.Echo) {
 
 // Login handles user login
 // @Summary Login user
-// @Description Authenticate user with email/username and password
-// @Tags users
+// @Description Authenticate user with username and password
+// @Tags Authorization
 // @Accept json
 // @Produce json
 // @Param login body LoginForm true "Login credentials"
@@ -72,7 +72,7 @@ func (h *Handler) RegisterRoutes(e *echo.Echo) {
 // @Failure 400 {object} response.APIResponse
 // @Failure 401 {object} response.APIResponse
 // @Failure 500 {object} response.APIResponse
-// @Router /users/login [post]
+// @Router /login [post]
 func (h *Handler) Login(c echo.Context) error {
 	form, err := response.Parse[LoginForm](c)
 	if err != nil {
@@ -91,7 +91,7 @@ func (h *Handler) Login(c echo.Context) error {
 // RefreshToken handles token refresh
 // @Summary Refresh access token
 // @Description Refresh access token using refresh token
-// @Tags users
+// @Tags Authorization
 // @Accept json
 // @Produce json
 // @Param refresh body RefreshTokenForm true "Refresh token"
@@ -99,7 +99,7 @@ func (h *Handler) Login(c echo.Context) error {
 // @Failure 400 {object} response.APIResponse
 // @Failure 401 {object} response.APIResponse
 // @Failure 500 {object} response.APIResponse
-// @Router /users/refresh-token [post]
+// @Router /refresh-token [post]
 func (h *Handler) RefreshToken(c echo.Context) error {
 	form, err := response.Parse[RefreshTokenForm](c)
 	if err != nil {
@@ -117,14 +117,14 @@ func (h *Handler) RefreshToken(c echo.Context) error {
 // ResetPassword handles password reset request
 // @Summary Reset password
 // @Description Send password reset email to user
-// @Tags users
+// @Tags Authorization
 // @Accept json
 // @Produce json
 // @Param reset body ResetPasswordForm true "Password reset request"
 // @Success 200 {object} response.APIResponse
 // @Failure 400 {object} response.APIResponse
 // @Failure 500 {object} response.APIResponse
-// @Router /users/reset-password [post]
+// @Router /reset-password [post]
 func (h *Handler) ResetPassword(c echo.Context) error {
 	form, err := response.Parse[ResetPasswordForm](c)
 	if err != nil {
@@ -144,7 +144,7 @@ func (h *Handler) ResetPassword(c echo.Context) error {
 // GetProfile gets current user profile
 // @Summary Get user profile
 // @Description Get current user profile information
-// @Tags users
+// @Tags Users
 // @Accept json
 // @Produce json
 // @Security BearerAuth
@@ -152,7 +152,7 @@ func (h *Handler) ResetPassword(c echo.Context) error {
 // @Failure 401 {object} response.APIResponse
 // @Failure 404 {object} response.APIResponse
 // @Failure 500 {object} response.APIResponse
-// @Router /users/profile [get]
+// @Router /profile [get]
 func (h *Handler) GetProfile(c echo.Context) error {
 	// Extract user ID from JWT token context
 	userID, err := GetUserIDFromContext(c)
@@ -171,7 +171,7 @@ func (h *Handler) GetProfile(c echo.Context) error {
 // UpdateProfile updates current user profile
 // @Summary Update user profile
 // @Description Update current user profile information
-// @Tags users
+// @Tags Users
 // @Accept json
 // @Produce json
 // @Security BearerAuth
@@ -180,7 +180,7 @@ func (h *Handler) GetProfile(c echo.Context) error {
 // @Failure 400 {object} response.APIResponse
 // @Failure 401 {object} response.APIResponse
 // @Failure 500 {object} response.APIResponse
-// @Router /users/profile [put]
+// @Router /profile [put]
 func (h *Handler) UpdateProfile(c echo.Context) error {
 	// Extract user ID from JWT token context
 	userID, err := GetUserIDFromContext(c)
@@ -204,7 +204,7 @@ func (h *Handler) UpdateProfile(c echo.Context) error {
 // ChangePassword changes current user password
 // @Summary Change password
 // @Description Change current user password
-// @Tags users
+// @Tags Users
 // @Accept json
 // @Produce json
 // @Security BearerAuth
@@ -213,7 +213,7 @@ func (h *Handler) UpdateProfile(c echo.Context) error {
 // @Failure 400 {object} response.APIResponse
 // @Failure 401 {object} response.APIResponse
 // @Failure 500 {object} response.APIResponse
-// @Router /users/change-password [put]
+// @Router /change-password [put]
 func (h *Handler) ChangePassword(c echo.Context) error {
 	userID, err := GetUserIDFromContext(c)
 	if err != nil {
@@ -238,14 +238,14 @@ func (h *Handler) ChangePassword(c echo.Context) error {
 // Logout handles user logout
 // @Summary Logout user
 // @Description Logout current user and invalidate tokens
-// @Tags users
+// @Tags Users
 // @Accept json
 // @Produce json
 // @Security BearerAuth
 // @Success 200 {object} response.APIResponse
 // @Failure 401 {object} response.APIResponse
 // @Failure 500 {object} response.APIResponse
-// @Router /users/logout [post]
+// @Router /logout [delete]
 func (h *Handler) Logout(c echo.Context) error {
 	// Extract user ID and access token from context
 	userID, err := GetUserIDFromContext(c)
@@ -271,7 +271,7 @@ func (h *Handler) Logout(c echo.Context) error {
 // CreateUser creates a new user (admin only)
 // @Summary Create user
 // @Description Create a new user (admin only)
-// @Tags users
+// @Tags Users
 // @Accept json
 // @Produce json
 // @Security BearerAuth
@@ -281,7 +281,7 @@ func (h *Handler) Logout(c echo.Context) error {
 // @Failure 401 {object} response.APIResponse
 // @Failure 403 {object} response.APIResponse
 // @Failure 500 {object} response.APIResponse
-// @Router /users/admin [post]
+// @Router /users [post]
 func (h *Handler) CreateUser(c echo.Context) error {
 	// Get current user ID from JWT token
 	currentUserID, err := GetUserIDFromContext(c)
@@ -311,7 +311,7 @@ func (h *Handler) CreateUser(c echo.Context) error {
 // ListUsers lists users with search and filters (admin only)
 // @Summary List users
 // @Description List users with search and filters (admin only)
-// @Tags users
+// @Tags Users
 // @Accept json
 // @Produce json
 // @Security BearerAuth
@@ -328,7 +328,7 @@ func (h *Handler) CreateUser(c echo.Context) error {
 // @Failure 401 {object} response.APIResponse
 // @Failure 403 {object} response.APIResponse
 // @Failure 500 {object} response.APIResponse
-// @Router /users/admin [get]
+// @Router /users [get]
 func (h *Handler) ListUsers(c echo.Context) error {
 	var form ListUsersForm
 	if err := c.Bind(&form); err != nil {
@@ -352,7 +352,7 @@ func (h *Handler) ListUsers(c echo.Context) error {
 // GetUserByID gets a user by ID (admin only)
 // @Summary Get user by ID
 // @Description Get user details by ID (admin only)
-// @Tags users
+// @Tags Users
 // @Accept json
 // @Produce json
 // @Security BearerAuth
@@ -363,7 +363,7 @@ func (h *Handler) ListUsers(c echo.Context) error {
 // @Failure 403 {object} response.APIResponse
 // @Failure 404 {object} response.APIResponse
 // @Failure 500 {object} response.APIResponse
-// @Router /users/admin/{id} [get]
+// @Router /users/{id} [get]
 func (h *Handler) GetUserByID(c echo.Context) error {
 	idStr := c.Param("id")
 	userID, err := uuid.Parse(idStr)
@@ -382,7 +382,7 @@ func (h *Handler) GetUserByID(c echo.Context) error {
 // UpdateUser updates a user (admin only)
 // @Summary Update user
 // @Description Update user information (admin only)
-// @Tags users
+// @Tags Users
 // @Accept json
 // @Produce json
 // @Security BearerAuth
@@ -394,7 +394,7 @@ func (h *Handler) GetUserByID(c echo.Context) error {
 // @Failure 403 {object} response.APIResponse
 // @Failure 404 {object} response.APIResponse
 // @Failure 500 {object} response.APIResponse
-// @Router /users/admin/{id} [put]
+// @Router /users/{id} [put]
 func (h *Handler) UpdateUser(c echo.Context) error {
 	// Extract user ID from JWT token context
 	currentUserID, err := GetUserIDFromContext(c)
@@ -430,7 +430,7 @@ func (h *Handler) UpdateUser(c echo.Context) error {
 // DeleteUser deletes a user (admin only)
 // @Summary Delete user
 // @Description Delete a user (admin only)
-// @Tags users
+// @Tags Users
 // @Accept json
 // @Produce json
 // @Security BearerAuth
@@ -441,7 +441,7 @@ func (h *Handler) UpdateUser(c echo.Context) error {
 // @Failure 403 {object} response.APIResponse
 // @Failure 404 {object} response.APIResponse
 // @Failure 500 {object} response.APIResponse
-// @Router /users/admin/{id} [delete]
+// @Router /users/{id} [delete]
 func (h *Handler) DeleteUser(c echo.Context) error {
 	// Extract user ID from JWT token context
 	currentUserID, err := GetUserIDFromContext(c)
@@ -468,7 +468,7 @@ func (h *Handler) DeleteUser(c echo.Context) error {
 // UpdateUserStatus updates user status (admin only)
 // @Summary Update user status
 // @Description Update user account status (admin only)
-// @Tags users
+// @Tags Users
 // @Accept json
 // @Produce json
 // @Security BearerAuth
@@ -480,7 +480,7 @@ func (h *Handler) DeleteUser(c echo.Context) error {
 // @Failure 403 {object} response.APIResponse
 // @Failure 404 {object} response.APIResponse
 // @Failure 500 {object} response.APIResponse
-// @Router /users/admin/{id}/status [put]
+// @Router /users/{id}/status [put]
 func (h *Handler) UpdateUserStatus(c echo.Context) error {
 	currentUserID, err := GetUserIDFromContext(c)
 	if err != nil {
@@ -517,7 +517,7 @@ func (h *Handler) UpdateUserStatus(c echo.Context) error {
 // UpdateUserRole updates user role (admin only)
 // @Summary Update user role
 // @Description Update user role (admin only)
-// @Tags users
+// @Tags Users
 // @Accept json
 // @Produce json
 // @Security BearerAuth
@@ -529,7 +529,7 @@ func (h *Handler) UpdateUserStatus(c echo.Context) error {
 // @Failure 403 {object} response.APIResponse
 // @Failure 404 {object} response.APIResponse
 // @Failure 500 {object} response.APIResponse
-// @Router /users/admin/{id}/role [put]
+// @Router /users/{id}/role [put]
 func (h *Handler) UpdateUserRole(c echo.Context) error {
 	// Extract user ID from JWT token context
 	currentUserID, err := GetUserIDFromContext(c)
@@ -567,19 +567,19 @@ func (h *Handler) UpdateUserRole(c echo.Context) error {
 // GetUsersByCompanyID gets users by company ID (admin only)
 // @Summary Get users by company ID
 // @Description Get users belonging to a specific company (admin only)
-// @Tags users
+// @Tags Users
 // @Accept json
 // @Produce json
 // @Security BearerAuth
 // @Param company_id path string true "Company ID"
 // @Param limit query int false "Limit results"
 // @Param offset query int false "Offset results"
-// @Success 200 {object} response.APIResponse
+// @Success 200 {object} response.APIResponse{data=map[string]interface{}} "Users with pagination metadata"
 // @Failure 400 {object} response.APIResponse
 // @Failure 401 {object} response.APIResponse
 // @Failure 403 {object} response.APIResponse
 // @Failure 500 {object} response.APIResponse
-// @Router /users/admin/company/{company_id} [get]
+// @Router /users/company/{company_id} [get]
 func (h *Handler) GetUsersByCompanyID(c echo.Context) error {
 	companyIDStr := c.Param("company_id")
 	companyID, err := uuid.Parse(companyIDStr)
@@ -631,19 +631,19 @@ func (h *Handler) GetUsersByCompanyID(c echo.Context) error {
 // GetUsersByRole gets users by role (admin only)
 // @Summary Get users by role
 // @Description Get users with a specific role (admin only)
-// @Tags users
+// @Tags Users
 // @Accept json
 // @Produce json
 // @Security BearerAuth
 // @Param role path string true "User role"
 // @Param limit query int false "Limit results"
 // @Param offset query int false "Offset results"
-// @Success 200 {object} response.APIResponse
+// @Success 200 {object} response.APIResponse{data=map[string]interface{}} "Users with pagination metadata"
 // @Failure 400 {object} response.APIResponse
 // @Failure 401 {object} response.APIResponse
 // @Failure 403 {object} response.APIResponse
 // @Failure 500 {object} response.APIResponse
-// @Router /users/admin/role/{role} [get]
+// @Router /users/role/{role} [get]
 func (h *Handler) GetUsersByRole(c echo.Context) error {
 	roleStr := c.Param("role")
 	role := UserRole(roleStr)