Add DTOs and exceptions for upcoming match endpoints

src/main/java/org/patinanetwork/patchats/api/match/MatchController.java

@@ -0,0 +1 @@
+

src/main/java/org/patinanetwork/patchats/api/match/dto/cycle/CreateMatchCycleRequest.java

@@ -0,0 +1,6 @@
+package org.patinanetwork.patchats.api.match.dto.cycle;
+
+import jakarta.validation.constraints.NotNull;
+import java.time.Instant;
+
+public record CreateMatchCycleRequest(@NotNull Instant runAt, String period) {}

src/main/java/org/patinanetwork/patchats/api/match/dto/cycle/MatchCycleDetailQuery.java

@@ -0,0 +1,3 @@
+package org.patinanetwork.patchats.api.match.dto.cycle;
+
+public record MatchCycleDetailQuery(String memberIndustry, String status) {}

src/main/java/org/patinanetwork/patchats/api/match/dto/cycle/MatchCycleDetailResponse.java

@@ -0,0 +1,22 @@
+package org.patinanetwork.patchats.api.match.dto.cycle;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import java.util.List;
+import lombok.Builder;
+import lombok.EqualsAndHashCode;
+import lombok.Getter;
+import lombok.ToString;
+import org.patinanetwork.patchats.api.match.dto.match.AdminMatchResponse;
+
+@Getter
+@Builder
+@ToString
+@EqualsAndHashCode
+public class MatchCycleDetailResponse {
+
+    @Schema(requiredMode = Schema.RequiredMode.REQUIRED)
+    private final MatchCycleResponse cycle;
+
+    @Schema(requiredMode = Schema.RequiredMode.REQUIRED)
+    private final List<AdminMatchResponse> matches;
+}

src/main/java/org/patinanetwork/patchats/api/match/dto/cycle/MatchCycleListQuery.java

@@ -0,0 +1,5 @@
+package org.patinanetwork.patchats.api.match.dto.cycle;
+
+import java.time.Instant;
+
+public record MatchCycleListQuery(String period, Instant startTime, Instant endTime) {}

src/main/java/org/patinanetwork/patchats/api/match/dto/cycle/MatchCycleResponse.java

@@ -0,0 +1,43 @@
+package org.patinanetwork.patchats.api.match.dto.cycle;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import java.time.Instant;
+import lombok.Builder;
+import lombok.EqualsAndHashCode;
+import lombok.Getter;
+import lombok.ToString;
+import org.patinanetwork.patchats.api.match.db.models.MatchCycle;
+
+@Getter
+@Builder
+@ToString
+@EqualsAndHashCode
+public class MatchCycleResponse {
+
+    @Schema(requiredMode = Schema.RequiredMode.REQUIRED)
+    private final Integer matchCycleId;
+
+    @Schema(requiredMode = Schema.RequiredMode.REQUIRED, nullable = true)
+    private final String period;
+
+    @Schema(requiredMode = Schema.RequiredMode.REQUIRED)
+    private final Instant runAt;
+
+    @Schema(requiredMode = Schema.RequiredMode.REQUIRED)
+    private final boolean isDraft;
+
+    @Schema(requiredMode = Schema.RequiredMode.REQUIRED)
+    private final Integer totalMembers;
+
+    @Schema(requiredMode = Schema.RequiredMode.REQUIRED)
+    private final Integer totalMatched;
+
+    public static MatchCycleResponse from(final MatchCycle cycle) {
+        return MatchCycleResponse.builder()
+                .matchCycleId(cycle.getId())
+                .period(cycle.getPeriod())
+                .runAt(cycle.getRunAt())
+                .isDraft(cycle.isDraft())
+                .build();
+    }
+}

src/main/java/org/patinanetwork/patchats/api/match/dto/cycle/UpdateMatchCycleRequest.java

@@ -0,0 +1,5 @@
+package org.patinanetwork.patchats.api.match.dto.cycle;
+
+import java.time.Instant;
+
+public record UpdateMatchCycleRequest(Instant runAt, String period, Boolean isDraft) {}

src/main/java/org/patinanetwork/patchats/api/match/dto/match/BulkCreateMatchesRequest.java

@@ -0,0 +1,7 @@
+package org.patinanetwork.patchats.api.match.dto.match;
+
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotEmpty;
+import java.util.List;
+
+public record BulkCreateMatchesRequest(@Valid @NotEmpty List<CreateMatchRequest> matches) {}

src/main/java/org/patinanetwork/patchats/api/match/dto/match/MatchListQuery.java

@@ -0,0 +1,6 @@
+package org.patinanetwork.patchats.api.match.dto.match;
+
+import java.time.Instant;
+import java.util.UUID;
+
+public record MatchListQuery(UUID memberId, String period, Instant startTime, Instant endTime, String status) {}

src/main/java/org/patinanetwork/patchats/api/match/dto/match/MatchResponse.java

@@ -0,0 +1,41 @@
+package org.patinanetwork.patchats.api.match.dto.match;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import java.util.UUID;
+import lombok.Builder;
+import lombok.EqualsAndHashCode;
+import lombok.Getter;
+import lombok.ToString;
+import org.patinanetwork.patchats.api.match.db.models.Match;
+
+@Getter
+@Builder
+@ToString
+@EqualsAndHashCode
+public class MatchResponse {
+
+    @Schema(requiredMode = Schema.RequiredMode.REQUIRED)
+    private final UUID matchId;
+
+    @Schema(requiredMode = Schema.RequiredMode.REQUIRED)
+    private final UUID memberAId;
+
+    @Schema(requiredMode = Schema.RequiredMode.REQUIRED)
+    private final UUID memberBId;
+
+    @Schema(requiredMode = Schema.RequiredMode.REQUIRED)
+    private final String month;
+
+    @Schema(requiredMode = Schema.RequiredMode.REQUIRED)
+    private final String status;
+
+    public static MatchResponse from(final Match match, final String month) {
+        return MatchResponse.builder()
+                .matchId(match.getId())
+                .memberAId(match.getMemberAId())
+                .memberBId(match.getMemberBId())
+                .month(month)
+                .status(match.getStatus())
+                .build();
+    }
+}

src/main/java/org/patinanetwork/patchats/api/match/dto/match/UpdateMatchFeedbackRequest.java

@@ -0,0 +1,5 @@
+package org.patinanetwork.patchats.api.match.dto.match;
+
+import jakarta.validation.constraints.NotBlank;
+
+public record UpdateMatchFeedbackRequest(@NotBlank String feedback) {}

src/main/java/org/patinanetwork/patchats/api/match/dto/match/UpdateMatchStatusRequest.java

@@ -0,0 +1,5 @@
+package org.patinanetwork.patchats.api.match.dto.match;
+
+import jakarta.validation.constraints.NotBlank;
+
+public record UpdateMatchStatusRequest(@NotBlank String status) {}

src/main/java/org/patinanetwork/patchats/common/web/ApiExceptionHandler.java

@@ -6,6 +6,7 @@
 import org.patinanetwork.patchats.common.web.exception.EmailNotResendableException;
 import org.patinanetwork.patchats.common.web.exception.EmailTemplateNotFoundException;
 import org.patinanetwork.patchats.common.web.exception.MatchCycleNotFoundException;
+import org.patinanetwork.patchats.common.web.exception.MatchNotFoundException;
 import org.patinanetwork.patchats.common.web.exception.MemberDuplicateException;
 import org.patinanetwork.patchats.common.web.exception.MemberNotFoundException;
 import org.patinanetwork.patchats.common.web.exception.ValidationException;
@@ -64,6 +65,11 @@ public ResponseEntity<ApiResponder<Void>> handleMatchCycleNotFound(final MatchCy
         return ResponseEntity.status(HttpStatus.NOT_FOUND).body(ApiResponder.failure(ex.getMessage()));
     }
 
+    @ExceptionHandler(MatchNotFoundException.class)
+    public ResponseEntity<ApiResponder<Void>> handleMatchNotFound(final MatchNotFoundException ex) {
+        return ResponseEntity.status(HttpStatus.NOT_FOUND).body(ApiResponder.failure(ex.getMessage()));
+    }
+
     private String formatError(final FieldError error) {
         return error.getField() + " " + error.getDefaultMessage();
     }

src/main/java/org/patinanetwork/patchats/common/web/exception/MatchNotFoundException.java

@@ -0,0 +1,9 @@
+package org.patinanetwork.patchats.common.web.exception;
+
+import java.util.UUID;
+
+public class MatchNotFoundException extends RuntimeException {
+    public MatchNotFoundException(UUID id) {
+        super("Match with ID " + id + " not found");
+    }
+}