test: 리뷰 관리 기능 테스트 코드 작성

src/main/java/com/codeit/team5/mopl/config/SecurityConfig.java

@@ -86,6 +86,7 @@ public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Excepti
                         .requestMatchers("/api/conversations/**").authenticated()
                         .requestMatchers("/api/notifications/**").authenticated()
                         .requestMatchers("/api/sse/**").authenticated()
+                        .requestMatchers("/api/reviews/**").authenticated()
 
                         .requestMatchers(HttpMethod.POST, "/api/auth/reset-password").permitAll()
                         .requestMatchers("/api/auth/sign-in").permitAll()

src/main/java/com/codeit/team5/mopl/config/WebConfig.java

@@ -1,6 +1,7 @@
 package com.codeit.team5.mopl.config;
 
 import com.codeit.team5.mopl.global.exception.InvalidSortDirectionException;
+import com.codeit.team5.mopl.review.contant.ReviewSortBy;
 import com.codeit.team5.mopl.user.constant.UserSortBy;
 import org.springframework.context.annotation.Configuration;
 import org.springframework.data.domain.Sort;
@@ -23,5 +24,6 @@ public void addFormatters(FormatterRegistry registry) {
         });
 
         registry.addConverter(String.class, UserSortBy.class, UserSortBy::from);
+        registry.addConverter(String.class, ReviewSortBy.class, ReviewSortBy::from);
     }
 }

src/main/java/com/codeit/team5/mopl/review/contant/ReviewSortBy.java

@@ -0,0 +1,36 @@
+package com.codeit.team5.mopl.review.contant;
+
+import com.codeit.team5.mopl.review.exception.InvalidReviewSortByException;
+import com.codeit.team5.mopl.review.exception.ReviewSortByMismatchException;
+import java.time.Instant;
+import java.util.function.Function;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
+@Getter
+@RequiredArgsConstructor
+public enum ReviewSortBy {
+    CREATED_AT("createdAt", Instant::parse),
+    RATING("rating", Double::parseDouble),
+    ;
+
+    private final String sortByType;
+    private final Function<String, ?> parser;
+
+    public static ReviewSortBy from(String string) {
+        for (ReviewSortBy value : ReviewSortBy.values()) {
+            if (string.equalsIgnoreCase(value.sortByType)) {
+                return value;
+            }
+        }
+        throw new InvalidReviewSortByException(string);
+    }
+
+    public Object parse(String cursor){
+        try{
+            return parser.apply(cursor);
+        } catch (Exception e){
+            throw new ReviewSortByMismatchException(sortByType, cursor);
+        }
+    }
+}

src/main/java/com/codeit/team5/mopl/review/controller/ReviewController.java

@@ -0,0 +1,88 @@
+package com.codeit.team5.mopl.review.controller;
+
+import com.codeit.team5.mopl.auth.security.details.MoplPrincipal;
+import com.codeit.team5.mopl.global.dto.CursorResponse;
+import com.codeit.team5.mopl.review.controller.api.ReviewApi;
+import com.codeit.team5.mopl.review.dto.request.ReviewCreateRequest;
+import com.codeit.team5.mopl.review.dto.request.ReviewGetRequest;
+import com.codeit.team5.mopl.review.dto.request.ReviewUpdateRequest;
+import com.codeit.team5.mopl.review.dto.response.ReviewResponse;
+import com.codeit.team5.mopl.review.service.ReviewService;
+import jakarta.validation.Valid;
+import java.util.UUID;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.data.domain.Sort;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.security.core.annotation.AuthenticationPrincipal;
+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.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+@RestController
+@RequiredArgsConstructor
+@Validated
+@Slf4j
+@RequestMapping("/api/reviews")
+public class ReviewController implements ReviewApi {
+
+    private final ReviewService reviewService;
+
+    @Override
+    @GetMapping
+    public ResponseEntity<CursorResponse<ReviewResponse>> getReviews(@Valid ReviewGetRequest request) {
+
+        log.info("리뷰 목록 조회: GET /api/reviews, contentId={}", request.contentId());
+
+        CursorResponse<ReviewResponse> response = reviewService.getReviews(request);
+
+        return ResponseEntity.ok(response);
+    }
+
+    @Override
+    @PostMapping
+    public ResponseEntity<ReviewResponse> createReview(
+        @AuthenticationPrincipal MoplPrincipal moplPrincipal,
+        @RequestBody @Valid ReviewCreateRequest request) {
+
+        log.info("리뷰 생성: POST /api/reviews, authorId={}", moplPrincipal.getId());
+
+        ReviewResponse response = reviewService.createReview(moplPrincipal.getId(), request);
+
+        return ResponseEntity.status(HttpStatus.CREATED).body(response);
+    }
+
+    @Override
+    @PatchMapping("/{reviewId}")
+    public ResponseEntity<ReviewResponse> updateReview(
+        @AuthenticationPrincipal MoplPrincipal moplPrincipal,
+        @PathVariable UUID reviewId,
+        @RequestBody @Valid ReviewUpdateRequest request) {
+
+        log.info("리뷰 수정: PATCH /api/reviews/{}, authorId={}", reviewId, moplPrincipal.getId());
+
+        ReviewResponse response = reviewService.updateReview(reviewId, moplPrincipal.getId(), request);
+
+        return ResponseEntity.ok(response);
+    }
+
+    @Override
+    @DeleteMapping("/{reviewId}")
+    public ResponseEntity<Void> deleteReview(
+        @AuthenticationPrincipal MoplPrincipal moplPrincipal,
+        @PathVariable UUID reviewId) {
+
+        log.info("리뷰 삭제: DELETE /api/reviews/{}, authorId={}", reviewId, moplPrincipal.getId());
+
+        reviewService.deleteReview(reviewId, moplPrincipal.getId());
+
+        return ResponseEntity.noContent().build();
+    }
+}

src/main/java/com/codeit/team5/mopl/review/controller/api/ReviewApi.java

@@ -0,0 +1,92 @@
+package com.codeit.team5.mopl.review.controller.api;
+
+import com.codeit.team5.mopl.auth.security.details.MoplPrincipal;
+import com.codeit.team5.mopl.global.dto.CursorResponse;
+import com.codeit.team5.mopl.global.dto.suggestion.ErrorResponseSuggestion;
+import com.codeit.team5.mopl.review.dto.request.ReviewCreateRequest;
+import com.codeit.team5.mopl.review.dto.request.ReviewGetRequest;
+import com.codeit.team5.mopl.review.dto.request.ReviewUpdateRequest;
+import com.codeit.team5.mopl.review.dto.response.ReviewResponse;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.media.Content;
+import io.swagger.v3.oas.annotations.media.Schema;
+import io.swagger.v3.oas.annotations.responses.ApiResponse;
+import io.swagger.v3.oas.annotations.responses.ApiResponses;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.validation.Valid;
+import java.util.UUID;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.RequestBody;
+
+@Tag(name = "리뷰 관리", description = "리뷰 API")
+public interface ReviewApi {
+
+    @Operation(operationId = "getReviews", summary = "리뷰 목록 조회 (커서 페이지네이션)")
+    @ApiResponses({
+        @ApiResponse(responseCode = "200", description = "조회 성공"),
+        @ApiResponse(responseCode = "400", description = "잘못된 요청",
+            content = @Content(schema = @Schema(implementation = ErrorResponseSuggestion.class))),
+        @ApiResponse(responseCode = "401", description = "인증 오류",
+            content = @Content(schema = @Schema(implementation = ErrorResponseSuggestion.class))),
+        @ApiResponse(responseCode = "500", description = "서버 내부 오류",
+            content = @Content(schema = @Schema(implementation = ErrorResponseSuggestion.class)))
+    })
+    ResponseEntity<CursorResponse<ReviewResponse>> getReviews(
+        @Valid ReviewGetRequest request);
+
+    @Operation(operationId = "createReview", summary = "리뷰 생성",
+        description = "생성한 리뷰는 API 요청자 본인의 리뷰로 생성됩니다.")
+    @ApiResponses({
+        @ApiResponse(responseCode = "201", description = "생성 성공"),
+        @ApiResponse(responseCode = "400", description = "잘못된 요청",
+            content = @Content(schema = @Schema(implementation = ErrorResponseSuggestion.class))),
+        @ApiResponse(responseCode = "401", description = "인증 오류",
+            content = @Content(schema = @Schema(implementation = ErrorResponseSuggestion.class))),
+        @ApiResponse(responseCode = "409", description = "이미 리뷰 작성함",
+            content = @Content(schema = @Schema(implementation = ErrorResponseSuggestion.class))),
+        @ApiResponse(responseCode = "500", description = "서버 오류",
+            content = @Content(schema = @Schema(implementation = ErrorResponseSuggestion.class)))
+    })
+    ResponseEntity<ReviewResponse> createReview(
+        @Parameter(hidden = true) MoplPrincipal moplPrincipal,
+        @RequestBody @Valid ReviewCreateRequest request);
+
+    @Operation(operationId = "updateReview", summary = "리뷰 수정")
+    @ApiResponses({
+        @ApiResponse(responseCode = "200", description = "수정 성공"),
+        @ApiResponse(responseCode = "400", description = "잘못된 요청",
+            content = @Content(schema = @Schema(implementation = ErrorResponseSuggestion.class))),
+        @ApiResponse(responseCode = "401", description = "인증 오류",
+            content = @Content(schema = @Schema(implementation = ErrorResponseSuggestion.class))),
+        @ApiResponse(responseCode = "403", description = "권한 없음",
+            content = @Content(schema = @Schema(implementation = ErrorResponseSuggestion.class))),
+        @ApiResponse(responseCode = "404", description = "리뷰 없음",
+            content = @Content(schema = @Schema(implementation = ErrorResponseSuggestion.class))),
+        @ApiResponse(responseCode = "500", description = "서버 오류",
+            content = @Content(schema = @Schema(implementation = ErrorResponseSuggestion.class)))
+    })
+    ResponseEntity<ReviewResponse> updateReview(
+        @Parameter(hidden = true) MoplPrincipal moplPrincipal,
+        @Parameter(description = "리뷰 ID", required = true)
+        @PathVariable UUID reviewId,
+        @RequestBody @Valid ReviewUpdateRequest request);
+
+    @Operation(operationId = "deleteReview", summary = "리뷰 삭제")
+    @ApiResponses({
+        @ApiResponse(responseCode = "204", description = "삭제 성공"),
+        @ApiResponse(responseCode = "401", description = "인증 오류",
+            content = @Content(schema = @Schema(implementation = ErrorResponseSuggestion.class))),
+        @ApiResponse(responseCode = "403", description = "권한 없음",
+            content = @Content(schema = @Schema(implementation = ErrorResponseSuggestion.class))),
+        @ApiResponse(responseCode = "404", description = "리뷰 없음",
+            content = @Content(schema = @Schema(implementation = ErrorResponseSuggestion.class))),
+        @ApiResponse(responseCode = "500", description = "서버 오류",
+            content = @Content(schema = @Schema(implementation = ErrorResponseSuggestion.class)))
+    })
+    ResponseEntity<Void> deleteReview(
+        @Parameter(hidden = true) MoplPrincipal moplPrincipal,
+        @Parameter(description = "리뷰 ID", required = true)
+        @PathVariable UUID reviewId);
+}

src/main/java/com/codeit/team5/mopl/review/dto/request/ReviewCreateRequest.java

@@ -0,0 +1,26 @@
+package com.codeit.team5.mopl.review.dto.request;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.DecimalMax;
+import jakarta.validation.constraints.DecimalMin;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import java.util.UUID;
+
+@Schema(name = "ReviewCreateRequest", description = "리뷰 생성 요청")
+public record ReviewCreateRequest(
+    @Schema(description = "콘텐츠 ID", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "contentId는 필수입니다.")
+    UUID contentId,
+
+    @Schema(description = "리뷰 내용", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotBlank(message = "리뷰 내용은 필수입니다.")
+    String text,
+
+    @Schema(description = "평점 (0.0 ~ 5.0)", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "rating은 필수입니다.")
+    @DecimalMin(value = "0.0", message = "평점은 0.0 이상이어야 합니다.")
+    @DecimalMax(value = "5.0", message = "평점은 5.0 이하여야 합니다.")
+    Double rating
+) {
+}

src/main/java/com/codeit/team5/mopl/review/dto/request/ReviewGetRequest.java

@@ -0,0 +1,26 @@
+package com.codeit.team5.mopl.review.dto.request;
+
+import com.codeit.team5.mopl.review.contant.ReviewSortBy;
+import jakarta.validation.constraints.Max;
+import jakarta.validation.constraints.Min;
+import jakarta.validation.constraints.NotNull;
+import java.util.UUID;
+import org.springframework.data.domain.Sort;
+
+public record ReviewGetRequest(
+    @NotNull
+    UUID contentId,
+
+    String cursor,
+
+    UUID idAfter,
+
+    @Min(1)
+    @Max(100)
+    Integer limit,
+
+    Sort.Direction sortDirection,
+
+    ReviewSortBy sortBy
+) {
+}

src/main/java/com/codeit/team5/mopl/review/dto/request/ReviewUpdateRequest.java

@@ -0,0 +1,17 @@
+package com.codeit.team5.mopl.review.dto.request;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.DecimalMax;
+import jakarta.validation.constraints.DecimalMin;
+
+@Schema(name = "ReviewUpdateRequest", description = "리뷰 수정 요청")
+public record ReviewUpdateRequest(
+    @Schema(description = "리뷰 내용")
+    String text,
+
+    @Schema(description = "평점 (0.0 ~ 5.0)")
+    @DecimalMin(value = "0.0", message = "평점은 0.0 이상이어야 합니다.")
+    @DecimalMax(value = "5.0", message = "평점은 5.0 이하여야 합니다.")
+    Double rating
+) {
+}

src/main/java/com/codeit/team5/mopl/review/dto/response/ReviewResponse.java

@@ -0,0 +1,13 @@
+package com.codeit.team5.mopl.review.dto.response;
+
+import com.codeit.team5.mopl.user.dto.response.UserSummaryResponse;
+import java.util.UUID;
+
+public record ReviewResponse(
+    UUID id,
+    UUID contentId,
+    UserSummaryResponse author,
+    String text,
+    Double rating
+) {
+}

src/main/java/com/codeit/team5/mopl/review/entity/Review.java

@@ -0,0 +1,66 @@
+package com.codeit.team5.mopl.review.entity;
+
+import com.codeit.team5.mopl.content.entity.Content;
+import com.codeit.team5.mopl.global.entity.BaseUpdatableEntity;
+import com.codeit.team5.mopl.user.entity.User;
+import jakarta.persistence.Column;
+import jakarta.persistence.Entity;
+import jakarta.persistence.FetchType;
+import jakarta.persistence.JoinColumn;
+import jakarta.persistence.ManyToOne;
+import jakarta.persistence.Table;
+import jakarta.persistence.UniqueConstraint;
+import java.util.UUID;
+import lombok.AccessLevel;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Entity
+@Table(name = "reviews",
+    uniqueConstraints = @UniqueConstraint(columnNames = {"content_id", "user_id"}))
+@Getter
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+public class Review extends BaseUpdatableEntity {
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "content_id", nullable = false)
+    private Content content;
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "user_id", nullable = false)
+    private User author;
+
+    @Column(columnDefinition = "TEXT", nullable = false)
+    private String text;
+
+    @Column(nullable = false)
+    private Double rating;
+
+    public static Review of(Content content, User author, String text, Double rating) {
+        return new Review(content, author, text, rating);
+    }
+
+    private Review(Content content, User author, String text, Double rating) {
+        this.content = content;
+        this.author = author;
+        this.text = text;
+        this.rating = rating;
+    }
+
+    public UUID getContentId() {
+        return content.getId();
+    }
+
+    public UUID getAuthorId() {
+        return author.getId();
+    }
+
+    public void update(String text, Double rating) {
+        if (text != null) {
+            this.text = text;
+        }
+        if(rating != null){
+            this.rating = rating;
+        }
+    }
+}