refactor: Update DTOs to use string type for IDs and enhance API documentation for activity and user handlers

backend/internal/api/handlers/activity_handler.go

@@ -19,6 +19,7 @@ func NewActivityHandler() *ActivityHandler {
 }
 
 // GetActivities handles GET /activities
+//
 //	@Summary		Get all activities
 //	@Description	Get a list of all activities
 //	@Tags			activities
@@ -47,6 +48,7 @@ func (h *ActivityHandler) GetActivities(c *gin.Context) {
 }
 
 // GetActivityByID handles GET /activities/:id
+//
 //	@Summary		Get activity by ID
 //	@Description	Get an activity by its ID
 //	@Tags			activities
@@ -88,6 +90,7 @@ func (h *ActivityHandler) GetActivityByID(c *gin.Context) {
 }
 
 // CreateActivity handles POST /activities
+//
 //	@Summary		Create a new activity
 //	@Description	Create a new activity
 //	@Tags			activities
@@ -125,6 +128,7 @@ func (h *ActivityHandler) CreateActivity(c *gin.Context) {
 }
 
 // UpdateActivity handles PUT /activities/:id
+//
 //	@Summary		Update an activity
 //	@Description	Update an existing activity
 //	@Tags			activities
@@ -156,7 +160,7 @@ func (h *ActivityHandler) UpdateActivity(c *gin.Context) {
 	}
 
 	// Set ID from URL
-	activityUpdateDTO.ID = id
+	activityUpdateDTO.ID = id.String()
 
 	// Convert DTO to model
 	activityUpdate := convertUpdateActivityDTOToModel(activityUpdateDTO)
@@ -180,6 +184,7 @@ func (h *ActivityHandler) UpdateActivity(c *gin.Context) {
 }
 
 // DeleteActivity handles DELETE /activities/:id
+//
 //	@Summary		Delete an activity
 //	@Description	Delete an activity by its ID
 //	@Tags			activities
@@ -215,7 +220,7 @@ func (h *ActivityHandler) DeleteActivity(c *gin.Context) {
 
 func convertActivityToDTO(activity *models.Activity) dto.ActivityDto {
 	return dto.ActivityDto{
-		ID:          activity.ID,
+		ID:          activity.ID.String(),
 		CreatedAt:   activity.CreatedAt,
 		UpdatedAt:   activity.UpdatedAt,
 		Name:        activity.Name,
@@ -231,8 +236,9 @@ func convertCreateActivityDTOToModel(dto dto.ActivityCreateDto) models.ActivityC
 }
 
 func convertUpdateActivityDTOToModel(dto dto.ActivityUpdateDto) models.ActivityUpdate {
+	id, _ := ulid.Parse(dto.ID)
 	update := models.ActivityUpdate{
-		ID: dto.ID,
+		ID: id,
 	}
 
 	if dto.Name != nil {

backend/internal/api/handlers/user_handler.go

@@ -20,6 +20,7 @@ func NewUserHandler() *UserHandler {
 }
 
 // GetUsers handles GET /users
+//
 //	@Summary		Get all users
 //	@Description	Get a list of all users
 //	@Tags			users
@@ -48,6 +49,7 @@ func (h *UserHandler) GetUsers(c *gin.Context) {
 }
 
 // GetUserByID handles GET /users/:id
+//
 //	@Summary		Get user by ID
 //	@Description	Get a user by their ID
 //	@Tags			users
@@ -89,6 +91,7 @@ func (h *UserHandler) GetUserByID(c *gin.Context) {
 }
 
 // CreateUser handles POST /users
+//
 //	@Summary		Create a new user
 //	@Description	Create a new user
 //	@Tags			users
@@ -126,6 +129,7 @@ func (h *UserHandler) CreateUser(c *gin.Context) {
 }
 
 // UpdateUser handles PUT /users/:id
+//
 //	@Summary		Update a user
 //	@Description	Update an existing user
 //	@Tags			users
@@ -157,7 +161,7 @@ func (h *UserHandler) UpdateUser(c *gin.Context) {
 	}
 
 	// Set ID from URL
-	userUpdateDTO.ID = id
+	userUpdateDTO.ID = id.String()
 
 	// Convert DTO to model
 	userUpdate := convertUpdateDTOToModel(userUpdateDTO)
@@ -181,6 +185,7 @@ func (h *UserHandler) UpdateUser(c *gin.Context) {
 }
 
 // DeleteUser handles DELETE /users/:id
+//
 //	@Summary		Delete a user
 //	@Description	Delete a user by their ID
 //	@Tags			users
@@ -213,6 +218,7 @@ func (h *UserHandler) DeleteUser(c *gin.Context) {
 }
 
 // Login handles POST /auth/login
+//
 //	@Summary		Login
 //	@Description	Authenticate a user and get a JWT token
 //	@Tags			auth
@@ -256,6 +262,7 @@ func (h *UserHandler) Login(c *gin.Context) {
 }
 
 // GetCurrentUser handles GET /auth/me
+//
 //	@Summary		Get current user
 //	@Description	Get the currently authenticated user
 //	@Tags			auth
@@ -296,7 +303,7 @@ func (h *UserHandler) GetCurrentUser(c *gin.Context) {
 
 func convertUserToDTO(user *models.User) dto.UserDto {
 	return dto.UserDto{
-		ID:         user.ID,
+		ID:         user.ID.String(),
 		CreatedAt:  user.CreatedAt,
 		UpdatedAt:  user.UpdatedAt,
 		Email:      user.Email,
@@ -320,8 +327,9 @@ func convertCreateDTOToModel(dto dto.UserCreateDto) models.UserCreate {
 }
 
 func convertUpdateDTOToModel(dto dto.UserUpdateDto) models.UserUpdate {
+	id, _ := ulid.Parse(dto.ID)
 	update := models.UserUpdate{
-		ID: dto.ID,
+		ID: id,
 	}
 
 	if dto.Email != nil {