Enhance API documentation and restructure routes for improved clarity

- Updated README.md to include comprehensive Swagger documentation details, highlighting new features and endpoint categories.
- Introduced a new router structure to streamline route registration for admin and public endpoints, enhancing maintainability.
- Updated health check endpoint documentation to reflect comprehensive server status information.
- Enhanced customer and company management routes with improved descriptions and examples in Swagger.
- Refactored customer and user handlers to remove obsolete route registrations, aligning with the new router structure.
- Improved response handling in customer and user services to utilize string IDs consistently.
- Updated validation rules and forms for customer management to support multiple company assignments.
- Enhanced logging practices across services to ensure better traceability and error handling.

internal/user/service.go

@@ -8,7 +8,7 @@ import (
 	"tm/pkg/authorization"
 	"tm/pkg/logger"
 
-	"github.com/google/uuid"
+	"go.mongodb.org/mongo-driver/bson/primitive"
 	"golang.org/x/crypto/bcrypt"
 )
 
@@ -118,7 +118,7 @@ func (s *userService) CreateUser(ctx context.Context, form *CreateUserForm, crea
 		"email":      user.Email,
 		"username":   user.Username,
 		"role":       user.Role,
-		"created_by": *createdBy,
+		"created_by": createdBy,
 	})
 
 	return user, nil
@@ -160,7 +160,7 @@ func (s *userService) Login(ctx context.Context, form *LoginForm) (*AuthResponse
 	}
 
 	// Update last login
-	err = s.repository.UpdateLastLogin(ctx, user.ID)
+	err = s.repository.UpdateLastLogin(ctx, user.ID.Hex())
 	if err != nil {
 		s.logger.Error("Failed to update last login", map[string]interface{}{
 			"error":   err.Error(),
@@ -175,7 +175,7 @@ func (s *userService) Login(ctx context.Context, form *LoginForm) (*AuthResponse
 	}
 
 	tokenPair, err := s.authService.GenerateTokenPair(
-		user.ID,
+		user.ID.Hex(),
 		user.Email,
 		string(user.Role),
 		companyID,
@@ -230,7 +230,7 @@ func (s *userService) RefreshToken(ctx context.Context, refreshToken string) (*A
 	}
 
 	// Get user information
-	userID, err := uuid.Parse(validationResult.Claims.UserID)
+	userID, err := primitive.ObjectIDFromHex(validationResult.Claims.UserID)
 	if err != nil {
 		s.logger.Error("Failed to parse user ID from token", map[string]interface{}{
 			"error": err.Error(),
@@ -238,11 +238,11 @@ func (s *userService) RefreshToken(ctx context.Context, refreshToken string) (*A
 		return nil, errors.New("invalid token format")
 	}
 
-	user, err := s.repository.GetByID(ctx, userID.String())
+	user, err := s.repository.GetByID(ctx, userID.Hex())
 	if err != nil {
 		s.logger.Error("Failed to get user for token refresh", map[string]interface{}{
 			"error":   err.Error(),
-			"user_id": userID.String(),
+			"user_id": userID.Hex(),
 		})
 		return nil, errors.New("user not found")
 	}
@@ -420,7 +420,7 @@ func (s *userService) UpdateUser(ctx context.Context, id string, form *UpdateUse
 	if form.Username != nil {
 		// Check if username already exists
 		existingUser, _ := s.repository.GetByUsername(ctx, *form.Username)
-		if existingUser != nil && existingUser.ID != id {
+		if existingUser != nil && existingUser.ID.Hex() != id {
 			return nil, errors.New("username already exists")
 		}
 		user.Username = *form.Username
@@ -429,7 +429,7 @@ func (s *userService) UpdateUser(ctx context.Context, id string, form *UpdateUse
 	if form.Email != nil {
 		// Check if email already exists
 		existingUser, _ := s.repository.GetByEmail(ctx, *form.Email)
-		if existingUser != nil && existingUser.ID != id {
+		if existingUser != nil && existingUser.ID.Hex() != id {
 			return nil, errors.New("email already exists")
 		}
 		user.Email = *form.Email