Feedback system design

src/main/java/com/wcc/platform/configuration/GlobalExceptionHandler.java

@@ -12,6 +12,7 @@
 import com.wcc.platform.domain.exceptions.DuplicatedException;
 import com.wcc.platform.domain.exceptions.EmailSendException;
 import com.wcc.platform.domain.exceptions.ErrorDetails;
+import com.wcc.platform.domain.exceptions.FeedbackNotFoundException;
 import com.wcc.platform.domain.exceptions.ForbiddenException;
 import com.wcc.platform.domain.exceptions.InvalidProgramTypeException;
 import com.wcc.platform.domain.exceptions.InvalidTokenException;
@@ -50,7 +51,8 @@ public class GlobalExceptionHandler {
     NoSuchElementException.class,
     MemberNotFoundException.class,
     MentorNotFoundException.class,
-    ApplicationNotFoundException.class
+    ApplicationNotFoundException.class,
+    FeedbackNotFoundException.class
   })
   @ResponseStatus(NOT_FOUND)
   public ResponseEntity<ErrorDetails> handleNotFoundException(

src/main/java/com/wcc/platform/controller/FeedbackController.java

@@ -0,0 +1,179 @@
+package com.wcc.platform.controller;
+
+import com.wcc.platform.domain.platform.feedback.Feedback;
+import com.wcc.platform.domain.platform.feedback.FeedbackDto;
+import com.wcc.platform.domain.platform.feedback.FeedbackSearchCriteria;
+import com.wcc.platform.domain.platform.type.FeedbackType;
+import com.wcc.platform.service.FeedbackService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.security.SecurityRequirement;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.Max;
+import jakarta.validation.constraints.Min;
+import java.util.List;
+import lombok.AllArgsConstructor;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PatchMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.ResponseStatus;
+import org.springframework.web.bind.annotation.RestController;
+
+/** Rest controller for feedback APIs. */
+@RestController
+@RequestMapping("/api/platform/v1/feedback")
+@SecurityRequirement(name = "apiKey")
+@Tag(name = "Feedback", description = "Feedback management APIs")
+@AllArgsConstructor
+@Validated
+public class FeedbackController {
+
+  private final FeedbackService feedbackService;
+
+  /**
+   * API to retrieve all feedback with optional filters.
+   *
+   * @param reviewerId Filter by reviewer ID
+   * @param revieweeId Filter by reviewee I)
+   * @param mentorshipCycleId Filter by mentorship cycle ID
+   * @param feedbackType Filter by feedback type
+   * @param year Filter by year
+   * @param isAnonymous Filter by anonymous status
+   * @param isApproved Filter by approval status
+   * @return List of feedback matching the criteria
+   */
+  @GetMapping
+  @Operation(summary = "Get all feedback with optional filters")
+  @ResponseStatus(HttpStatus.OK)
+  public ResponseEntity<List<Feedback>> getAllFeedback(
+      @Parameter(description = "Reviewer ID") @RequestParam(required = false) final Long reviewerId,
+      @Parameter(description = "Reviewee ID") @RequestParam(required = false) final Long revieweeId,
+      @Parameter(description = "Mentorship Cycle ID") @RequestParam(required = false)
+          final Long mentorshipCycleId,
+      @Parameter(description = "Feedback Type") @RequestParam(required = false)
+          final FeedbackType feedbackType,
+      @Parameter(description = "Year") @RequestParam(required = false) @Min(2000) @Max(2100)
+          final Integer year,
+      @Parameter(description = "Anonymous status") @RequestParam(required = false)
+          final Boolean isAnonymous,
+      @Parameter(description = "Approved status") @RequestParam(required = false)
+          final Boolean isApproved) {
+    final FeedbackSearchCriteria criteria =
+        FeedbackSearchCriteria.builder()
+            .reviewerId(reviewerId)
+            .revieweeId(revieweeId)
+            .mentorshipCycleId(mentorshipCycleId)
+            .feedbackType(feedbackType)
+            .year(year)
+            .isAnonymous(isAnonymous)
+            .isApproved(isApproved)
+            .build();
+
+    final List<Feedback> feedback = feedbackService.getAllFeedback(criteria);
+    return ResponseEntity.ok(feedback);
+  }
+
+  /**
+   * API to retrieve feedback by ID.
+   *
+   * @param feedbackId ID of the feedback
+   * @return Feedback details
+   */
+  @GetMapping("/{feedbackId}")
+  @Operation(summary = "Get feedback by ID")
+  @ResponseStatus(HttpStatus.OK)
+  public ResponseEntity<Feedback> getFeedbackById(
+      @Parameter(description = "ID of the feedback") @PathVariable final Long feedbackId) {
+    final Feedback feedback = feedbackService.getFeedbackById(feedbackId);
+    return ResponseEntity.ok(feedback);
+  }
+
+  /**
+   * API to create feedback.
+   *
+   * @param feedbackDto DTO containing feedback data
+   * @return Created feedback
+   */
+  @PostMapping
+  @Operation(summary = "Create feedback")
+  @ResponseStatus(HttpStatus.CREATED)
+  public ResponseEntity<Feedback> createFeedback(
+      @Valid @RequestBody final FeedbackDto feedbackDto) {
+    final Feedback feedback = feedbackService.createFeedback(feedbackDto);
+    return new ResponseEntity<>(feedback, HttpStatus.CREATED);
+  }
+
+  /**
+   * API to update feedback.
+   *
+   * @param feedbackId ID of the feedback to update
+   * @param feedbackDto DTO with updated feedback data
+   * @return Updated feedback
+   */
+  @PutMapping("/{feedbackId}")
+  @Operation(summary = "Update feedback")
+  @ResponseStatus(HttpStatus.OK)
+  public ResponseEntity<Feedback> updateFeedback(
+      @Parameter(description = "ID of the feedback") @PathVariable final Long feedbackId,
+      @Valid @RequestBody final FeedbackDto feedbackDto) {
+    final Feedback feedback = feedbackService.updateFeedback(feedbackId, feedbackDto);
+    return ResponseEntity.ok(feedback);
+  }
+
+  /**
+   * API to approve feedback (admin only).
+   *
+   * @param feedbackId ID of the feedback to approve
+   * @return No content
+   */
+  @PatchMapping("/{feedbackId}/approve")
+  @Operation(summary = "Approve feedback (admin only)")
+  @ResponseStatus(HttpStatus.OK)
+  public ResponseEntity<Void> approveFeedback(
+      @Parameter(description = "ID of the feedback") @PathVariable final Long feedbackId) {
+    feedbackService.approveFeedback(feedbackId);
+    return ResponseEntity.ok().build();
+  }
+
+  /**
+   * API to set feedback anonymous status (to hide/show reviewer name).
+   *
+   * @param feedbackId ID of the feedback
+   * @param isAnonymous true to hide reviewer name, false to show reviewer name
+   * @return No content
+   */
+  @PatchMapping("/{feedbackId}/anonymous-status")
+  @Operation(summary = "Update feedback anonymous status (to hide/show reviewer name)")
+  @ResponseStatus(HttpStatus.OK)
+  public ResponseEntity<Void> updateFeedbackAnonymousStatus(
+      @Parameter(description = "ID of the feedback") @PathVariable final Long feedbackId,
+      @Parameter(description = "Is anonymous") @RequestParam final Boolean isAnonymous) {
+    feedbackService.updateFeedbackAnonymousStatus(feedbackId, isAnonymous);
+    return ResponseEntity.ok().build();
+  }
+
+  /**
+   * API to delete feedback.
+   *
+   * @param feedbackId ID of the feedback to delete
+   * @return No content
+   */
+  @DeleteMapping("/{feedbackId}")
+  @Operation(summary = "Delete feedback")
+  @ResponseStatus(HttpStatus.NO_CONTENT)
+  public ResponseEntity<Void> deleteFeedback(
+      @Parameter(description = "ID of the feedback") @PathVariable final Long feedbackId) {
+    feedbackService.deleteFeedback(feedbackId);
+    return ResponseEntity.noContent().build();
+  }
+}

src/main/java/com/wcc/platform/domain/exceptions/FeedbackNotFoundException.java

@@ -0,0 +1,16 @@
+package com.wcc.platform.domain.exceptions;
+
+import lombok.extern.slf4j.Slf4j;
+
+/** Platform Feedback not found exception. */
+@Slf4j
+public class FeedbackNotFoundException extends RuntimeException {
+
+  public FeedbackNotFoundException(final Long feedbackId) {
+    super("Feedback with id: " + feedbackId + " not found.");
+  }
+
+  public FeedbackNotFoundException(final String message) {
+    super("Feedback not found: " + message);
+  }
+}

src/main/java/com/wcc/platform/domain/platform/feedback/Feedback.java

@@ -0,0 +1,48 @@
+package com.wcc.platform.domain.platform.feedback;
+
+import com.wcc.platform.domain.platform.type.FeedbackType;
+import jakarta.validation.constraints.Max;
+import jakarta.validation.constraints.Min;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import java.time.OffsetDateTime;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.EqualsAndHashCode;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import lombok.Setter;
+import lombok.ToString;
+
+/** Feedback for tracking member feedback. */
+@NoArgsConstructor
+@AllArgsConstructor
+@ToString
+@EqualsAndHashCode
+@Getter
+@Builder(toBuilder = true)
+public class Feedback {
+
+  @Setter private Long id;
+  @NotNull private Long reviewerId;
+  private String reviewerName;
+  private Long revieweeId; // For MENTOR_REVIEW
+  private String revieweeName;
+  private Long mentorshipCycleId; // For MENTORSHIP_PROGRAM
+  @NotNull private FeedbackType feedbackType;
+
+  @Min(1)
+  @Max(5)
+  private Integer rating;
+
+  @NotBlank private String feedbackText;
+
+  @Min(2000)
+  @Max(2100)
+  private Integer year;
+
+  @Setter private Boolean isAnonymous;
+  @Setter private Boolean isApproved;
+  private OffsetDateTime createdAt;
+  private OffsetDateTime updatedAt;
+}

src/main/java/com/wcc/platform/domain/platform/feedback/FeedbackDto.java

@@ -0,0 +1,58 @@
+package com.wcc.platform.domain.platform.feedback;
+
+import com.wcc.platform.domain.platform.feedback.validation.ValidFeedback;
+import com.wcc.platform.domain.platform.type.FeedbackType;
+import jakarta.validation.constraints.Max;
+import jakarta.validation.constraints.Min;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+/** DTO for feedback creation/update - uses IDs for member identification. */
+@Getter
+@AllArgsConstructor
+@NoArgsConstructor
+@Builder
+@ValidFeedback
+public class FeedbackDto {
+  private Long id;
+  @NotNull private Long reviewerId;
+  private Long revieweeId;
+  private Long mentorshipCycleId;
+  @NotNull private FeedbackType feedbackType;
+
+  @Min(1)
+  @Max(5)
+  private Integer rating;
+
+  @NotBlank private String feedbackText;
+
+  @Min(2000)
+  @Max(2100)
+  private Integer year;
+
+  @NotNull private Boolean isAnonymous;
+
+  /**
+   * Convert to domain object.
+   *
+   * @return Feedback domain entity
+   */
+  public Feedback merge() {
+    return Feedback.builder()
+        .id(id)
+        .reviewerId(reviewerId)
+        .revieweeId(revieweeId)
+        .mentorshipCycleId(mentorshipCycleId)
+        .feedbackType(feedbackType)
+        .rating(rating)
+        .feedbackText(feedbackText)
+        .year(year)
+        .isAnonymous(isAnonymous)
+        .isApproved(false) // Default - requires admin approval
+        .build();
+  }
+}

src/main/java/com/wcc/platform/domain/platform/feedback/FeedbackSearchCriteria.java

@@ -0,0 +1,25 @@
+package com.wcc.platform.domain.platform.feedback;
+
+import com.wcc.platform.domain.platform.type.FeedbackType;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.EqualsAndHashCode;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+@NoArgsConstructor
+@AllArgsConstructor
+@ToString
+@EqualsAndHashCode
+@Getter
+@Builder
+public class FeedbackSearchCriteria {
+  private Long reviewerId;
+  private Long revieweeId;
+  private Long mentorshipCycleId;
+  private FeedbackType feedbackType;
+  private Integer year;
+  private Boolean isAnonymous;
+  private Boolean isApproved;
+}