20260404 #623 거래 완료 후 후기 작성 api

RomRom-Common/src/main/java/com/romrom/common/constant/TradeReviewRating.java

@@ -0,0 +1,15 @@
+package com.romrom.common.constant;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+@AllArgsConstructor
+@Getter
+public enum TradeReviewRating {
+  BAD("별로예요"),
+  GOOD("좋아요"),
+  GREAT("최고예요"),
+  ;
+
+  private final String description;
+}

RomRom-Common/src/main/java/com/romrom/common/constant/TradeReviewTag.java

@@ -0,0 +1,17 @@
+package com.romrom.common.constant;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+@AllArgsConstructor
+@Getter
+public enum TradeReviewTag {
+  FAST_RESPONSE("답장이 빨라요"),
+  GOOD_ITEM_CONDITION("물건 상태가 좋아요"),
+  MATCHES_PHOTO("사진과 같아요"),
+  PUNCTUAL("약속을 잘 지켜요"),
+  KIND("친절해요"),
+  ;
+
+  private final String description;
+}

RomRom-Common/src/main/java/com/romrom/common/exception/ErrorCode.java

@@ -138,6 +138,14 @@ public enum ErrorCode {
 
   TRADE_COMPLETION_REQUEST_FORBIDDEN(HttpStatus.FORBIDDEN, "교환 완료 요청 처리 권한이 없습니다."),
 
+  // TRADE REVIEW
+
+  TRADE_NOT_COMPLETED(HttpStatus.BAD_REQUEST, "거래가 완료되지 않아 후기를 작성할 수 없습니다."),
+
+  TRADE_REVIEW_ALREADY_EXISTS(HttpStatus.BAD_REQUEST, "이미 해당 거래에 후기를 작성했습니다."),
+
+  TRADE_REVIEW_ACCESS_FORBIDDEN(HttpStatus.FORBIDDEN, "해당 거래의 당사자만 후기를 작성할 수 있습니다."),
+
   // CHAT
 
   CANNOT_SEND_MESSAGE_TO_DELETED_CHATROOM(HttpStatus.FORBIDDEN, "거래요청이 취소되었거나 거래완료된 상태이므로, 메시지를 보낼 수 없습니다."),

RomRom-Domain-Item/src/main/java/com/romrom/item/dto/TradeRequest.java

@@ -2,6 +2,8 @@
 
 import com.fasterxml.jackson.annotation.JsonIgnore;
 import com.romrom.common.constant.ItemTradeOption;
+import com.romrom.common.constant.TradeReviewRating;
+import com.romrom.common.constant.TradeReviewTag;
 import com.romrom.member.entity.Member;
 import io.swagger.v3.oas.annotations.media.Schema;
 import jakarta.validation.constraints.Max;
@@ -54,4 +56,15 @@ public TradeRequest() {
   @Min(value = 0, message = "페이지 사이즈에 음수는 입력될 수 없습니다.")
   @Max(value = Integer.MAX_VALUE, message = "정수 최대 범위를 넘을 수 없습니다.")
   private Integer pageSize; // 페이지 사이즈
+
+  // 후기 작성 필드
+  @Schema(description = "종합 평가 (BAD/GOOD/GREAT)")
+  private TradeReviewRating tradeReviewRating;
+
+  @Schema(description = "세부 항목 태그 목록")
+  @Builder.Default
+  private List<TradeReviewTag> tradeReviewTags = new ArrayList<>();
+
+  @Schema(description = "한마디 (최대 200자, 선택)")
+  private String reviewComment;
 }

RomRom-Domain-Item/src/main/java/com/romrom/item/dto/TradeResponse.java

@@ -2,12 +2,7 @@
 
 import com.romrom.item.entity.postgres.Item;
 import com.romrom.item.entity.postgres.TradeRequestHistory;
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Getter;
-import lombok.NoArgsConstructor;
-import lombok.Setter;
-import lombok.ToString;
+import lombok.*;
 import org.springframework.data.domain.Page;
 
 @ToString

RomRom-Domain-Item/src/main/java/com/romrom/item/entity/postgres/TradeReview.java

@@ -0,0 +1,48 @@
+package com.romrom.item.entity.postgres;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.romrom.common.constant.TradeReviewRating;
+import com.romrom.common.constant.TradeReviewTag;
+import com.romrom.common.entity.postgres.BasePostgresEntity;
+import com.romrom.member.entity.Member;
+import jakarta.persistence.*;
+import lombok.*;
+import lombok.experimental.SuperBuilder;
+
+import java.util.List;
+import java.util.UUID;
+
+@Entity
+@Getter
+@Setter
+@SuperBuilder
+@AllArgsConstructor
+@NoArgsConstructor
+@ToString(callSuper = true)
+@JsonIgnoreProperties({"hibernateLazyInitializer", "handler"})
+public class TradeReview extends BasePostgresEntity {
+
+  @Id
+  @GeneratedValue(strategy = GenerationType.UUID)
+  @Column(nullable = false, updatable = false)
+  private UUID tradeReviewId;
+
+  @ManyToOne(fetch = FetchType.LAZY)
+  private TradeRequestHistory tradeRequestHistory;
+
+  @ManyToOne(fetch = FetchType.LAZY)
+  private Member reviewerMember; // 후기 작성자
+
+  @ManyToOne(fetch = FetchType.LAZY)
+  private Member reviewedMember; // 후기 받는 사람
+
+  @Enumerated(EnumType.STRING)
+  @Column(nullable = false)
+  private TradeReviewRating tradeReviewRating; // 종합 평가
+
+  @ElementCollection
+  private List<TradeReviewTag> tradeReviewTags; // 세부 항목
+
+  @Column(length = 200)
+  private String reviewComment; // 한마디
+}

RomRom-Domain-Item/src/main/java/com/romrom/item/repository/postgres/TradeReviewRepository.java

@@ -0,0 +1,14 @@
+package com.romrom.item.repository.postgres;
+
+import com.romrom.item.entity.postgres.TradeRequestHistory;
+import com.romrom.item.entity.postgres.TradeReview;
+import com.romrom.member.entity.Member;
+import java.util.UUID;
+import org.springframework.data.jpa.repository.JpaRepository;
+
+public interface TradeReviewRepository extends JpaRepository<TradeReview, UUID> {
+
+  // 동일 거래에 같은 작성자의 후기가 이미 존재하는지 확인
+  boolean existsByTradeRequestHistoryAndReviewerMember(
+      TradeRequestHistory tradeRequestHistory, Member reviewerMember);
+}

RomRom-Domain-Item/src/main/java/com/romrom/item/service/TradeReviewService.java

@@ -0,0 +1,92 @@
+package com.romrom.item.service;
+
+import com.romrom.common.constant.TradeStatus;
+import com.romrom.common.exception.CustomException;
+import com.romrom.common.exception.ErrorCode;
+import com.romrom.item.dto.TradeRequest;
+import com.romrom.item.entity.postgres.TradeRequestHistory;
+import com.romrom.item.entity.postgres.TradeReview;
+import com.romrom.item.repository.postgres.TradeRequestHistoryRepository;
+import com.romrom.item.repository.postgres.TradeReviewRepository;
+import com.romrom.member.entity.Member;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.dao.DataIntegrityViolationException;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.util.UUID;
+
+@Service
+@RequiredArgsConstructor
+@Slf4j
+public class TradeReviewService {
+
+  private final TradeReviewRepository tradeReviewRepository;
+  private final TradeRequestHistoryRepository tradeRequestHistoryRepository;
+
+  // 후기 작성
+  @Transactional
+  public void postTradeReview(TradeRequest request) {
+    TradeRequestHistory tradeRequestHistory = findTradeRequestHistoryById(request.getTradeRequestHistoryId());
+    Member reviewerMember = request.getMember();
+
+    // 종합 평가 필수 검증
+    if (request.getTradeReviewRating() == null) {
+      log.error("종합 평가가 누락되었습니다. memberId={}", reviewerMember.getMemberId());
+      throw new CustomException(ErrorCode.INVALID_REQUEST);
+    }
+
+    // 거래 완료 상태 검증
+    if (tradeRequestHistory.getTradeStatus() != TradeStatus.TRADED) {
+      log.error("거래 완료 상태가 아닙니다. tradeRequestHistoryId={}, status={}",
+          tradeRequestHistory.getTradeRequestHistoryId(), tradeRequestHistory.getTradeStatus());
+      throw new CustomException(ErrorCode.TRADE_NOT_COMPLETED);
+    }
+
+    // 후기 작성 권한 검증 (거래 당사자만 작성 가능)
+    Member takeItemOwner = tradeRequestHistory.getTakeItem().getMember();
+    Member giveItemOwner = tradeRequestHistory.getGiveItem().getMember();
+    boolean isTradeParticipant = reviewerMember.getMemberId().equals(takeItemOwner.getMemberId())
+        || reviewerMember.getMemberId().equals(giveItemOwner.getMemberId());
+    if (!isTradeParticipant) {
+      log.error("거래 당사자가 아닙니다. memberId={}, tradeRequestHistoryId={}",
+          reviewerMember.getMemberId(), tradeRequestHistory.getTradeRequestHistoryId());
+      throw new CustomException(ErrorCode.TRADE_REVIEW_ACCESS_FORBIDDEN);
+    }
+
+    // 중복 후기 검증
+    if (tradeReviewRepository.existsByTradeRequestHistoryAndReviewerMember(tradeRequestHistory, reviewerMember)) {
+      log.error("이미 후기를 작성했습니다. memberId={}, tradeRequestHistoryId={}",
+          reviewerMember.getMemberId(), tradeRequestHistory.getTradeRequestHistoryId());
+      throw new CustomException(ErrorCode.TRADE_REVIEW_ALREADY_EXISTS);
+    }
+
+    // 후기 받는 사람 결정 (작성자의 반대편 거래 참여자)
+    Member reviewedMember = reviewerMember.getMemberId().equals(takeItemOwner.getMemberId())
+        ? giveItemOwner
+        : takeItemOwner;
+
+    TradeReview tradeReview = TradeReview.builder()
+        .tradeRequestHistory(tradeRequestHistory)
+        .reviewerMember(reviewerMember)
+        .reviewedMember(reviewedMember)
+        .tradeReviewRating(request.getTradeReviewRating())
+        .tradeReviewTags(request.getTradeReviewTags())
+        .reviewComment(request.getReviewComment())
+        .build();
+    try {
+      tradeReviewRepository.save(tradeReview);
+    } catch (DataIntegrityViolationException e) {
+      log.warn("중복 후기 저장 시도 (DB 유니크 제약 위반): tradeRequestHistoryId={}, memberId={}",
+          tradeRequestHistory.getTradeRequestHistoryId(), reviewerMember.getMemberId());
+      throw new CustomException(ErrorCode.TRADE_REVIEW_ALREADY_EXISTS);
+    }
+    log.debug("후기 작성 완료: tradeReviewId={}", tradeReview.getTradeReviewId());
+  }
+
+  private TradeRequestHistory findTradeRequestHistoryById(UUID tradeRequestHistoryId) {
+    return tradeRequestHistoryRepository.findByTradeRequestHistoryIdWithItems(tradeRequestHistoryId)
+        .orElseThrow(() -> new CustomException(ErrorCode.TRADE_REQUEST_NOT_FOUND));
+  }
+}

RomRom-Web/src/main/java/com/romrom/web/controller/api/TradeController.java

@@ -4,6 +4,7 @@
 import com.romrom.item.dto.TradeRequest;
 import com.romrom.item.dto.TradeResponse;
 import com.romrom.item.service.TradeRequestService;
+import com.romrom.item.service.TradeReviewService;
 import io.swagger.v3.oas.annotations.tags.Tag;
 import lombok.RequiredArgsConstructor;
 import me.suhsaechan.suhlogger.annotation.LogMonitor;
@@ -25,6 +26,7 @@
 public class TradeController implements TradeControllerDocs {
 
   private final TradeRequestService tradeRequestService;
+  private final TradeReviewService tradeReviewService;
 
   @Override
   @PostMapping(value = "/check", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
@@ -139,4 +141,16 @@ public ResponseEntity<TradeResponse> getAiRecommendedItems(
     request.setMember(customUserDetails.getMember());
     return ResponseEntity.ok(tradeRequestService.getAiRecommendedItems(request));
   }
+
+  @Override
+  @PostMapping(value = "/review/post", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
+  @LogMonitor
+  public ResponseEntity<Void> postTradeReview(
+      @AuthenticationPrincipal CustomUserDetails customUserDetails,
+      @ModelAttribute TradeRequest request) {
+    request.setMember(customUserDetails.getMember());
+    tradeReviewService.postTradeReview(request);
+    return ResponseEntity.ok().build();
+  }
+
 }

RomRom-Web/src/main/java/com/romrom/web/controller/api/TradeControllerDocs.java

@@ -1339,4 +1339,38 @@ ResponseEntity<TradeResponse> getSentTradeRequests(
           """
   )
   ResponseEntity<TradeResponse> getAiRecommendedItems(CustomUserDetails customUserDetails, TradeRequest tradeRequest);
+
+  @ApiChangeLogs({
+      @ApiChangeLog(date = "2026.04.06", author = Author.KIMNAYOUNG, issueNumber = 623, description = "거래 완료 후기 작성 " +
+        "API 구현"),
+  })
+  @Operation(
+      summary = "거래 완료 후기 작성",
+      description = """
+          ## 인증(JWT): **필요**
+
+          ## 요청 파라미터 (TradeRequest)
+          - **`tradeRequestHistoryId`**: 거래 요청 ID (UUID)
+          - **`tradeReviewRating`**: 종합 평가 (BAD/GOOD/GREAT)
+          - **`tradeReviewTags`**: 세부 항목 태그 목록 (복수 선택 가능)
+            - FAST_RESPONSE, GOOD_ITEM_CONDITION, MATCHES_PHOTO, PUNCTUAL, KIND
+          - **`reviewComment`**: 한마디
+
+          ## 반환값
+          - 없음 (200 OK)
+
+          ## 에러코드
+          - **`TRADE_REQUEST_NOT_FOUND`**: 거래 요청이 존재하지 않습니다.
+          - **`TRADE_NOT_COMPLETED`**: 거래가 완료되지 않아 후기를 작성할 수 없습니다.
+          - **`TRADE_REVIEW_ACCESS_FORBIDDEN`**: 해당 거래의 당사자만 후기를 작성할 수 있습니다.
+          - **`TRADE_REVIEW_ALREADY_EXISTS`**: 이미 해당 거래에 후기를 작성했습니다.
+
+          ## 설명
+          - 거래 상태가 TRADED(거래 완료)인 경우에만 후기 작성 가능
+          - 거래 당사자(takeItem 소유자 또는 giveItem 소유자) 각자 1회씩 작성 가능
+          - 동일 거래에 대한 중복 후기 작성 방지
+          """
+  )
+  ResponseEntity<Void> postTradeReview(CustomUserDetails customUserDetails, TradeRequest tradeRequest);
+
 }

RomRom-Web/src/main/resources/db/migration/V1_4_58__add_trade_review_constraints.sql

@@ -0,0 +1,76 @@
+-- trade_review 테이블 무결성 제약 추가
+--   tradeRequestHistory → trade_request_history_trade_request_history_id
+--   reviewerMember      → reviewer_member_member_id
+--   reviewedMember      → reviewed_member_member_id
+-- 1. FK 컬럼 NOT NULL 제약
+-- 2. (trade_request_history_trade_request_history_id, reviewer_member_member_id) 복합 유니크 제약 → 동시성 환경에서 중복 후기 방지
+DO $$
+BEGIN
+    IF EXISTS (
+        SELECT 1 FROM information_schema.tables
+        WHERE table_schema = 'public'
+        AND table_name = 'trade_review'
+    ) THEN
+
+        -- trade_request_history_trade_request_history_id NOT NULL
+        IF EXISTS (
+            SELECT 1 FROM information_schema.columns
+            WHERE table_schema = 'public'
+            AND table_name = 'trade_review'
+            AND column_name = 'trade_request_history_trade_request_history_id'
+            AND is_nullable = 'YES'
+        ) THEN
+            ALTER TABLE public.trade_review
+                ALTER COLUMN trade_request_history_trade_request_history_id SET NOT NULL;
+            RAISE NOTICE 'trade_request_history_trade_request_history_id NOT NULL 제약을 추가했습니다';
+        END IF;
+
+        -- reviewer_member_member_id NOT NULL
+        IF EXISTS (
+            SELECT 1 FROM information_schema.columns
+            WHERE table_schema = 'public'
+            AND table_name = 'trade_review'
+            AND column_name = 'reviewer_member_member_id'
+            AND is_nullable = 'YES'
+        ) THEN
+            ALTER TABLE public.trade_review
+                ALTER COLUMN reviewer_member_member_id SET NOT NULL;
+            RAISE NOTICE 'reviewer_member_member_id NOT NULL 제약을 추가했습니다';
+        END IF;
+
+        -- reviewed_member_member_id NOT NULL
+        IF EXISTS (
+            SELECT 1 FROM information_schema.columns
+            WHERE table_schema = 'public'
+            AND table_name = 'trade_review'
+            AND column_name = 'reviewed_member_member_id'
+            AND is_nullable = 'YES'
+        ) THEN
+            ALTER TABLE public.trade_review
+                ALTER COLUMN reviewed_member_member_id SET NOT NULL;
+            RAISE NOTICE 'reviewed_member_member_id NOT NULL 제약을 추가했습니다';
+        END IF;
+
+        -- (trade_request_history_trade_request_history_id, reviewer_member_member_id) 복합 유니크 제약
+        IF NOT EXISTS (
+            SELECT 1 FROM information_schema.table_constraints
+            WHERE table_schema = 'public'
+            AND constraint_name = 'uk_trade_review_history_reviewer'
+            AND table_name = 'trade_review'
+        ) THEN
+            ALTER TABLE public.trade_review
+                ADD CONSTRAINT uk_trade_review_history_reviewer
+                    UNIQUE (trade_request_history_trade_request_history_id, reviewer_member_member_id);
+            RAISE NOTICE 'uk_trade_review_history_reviewer 유니크 제약을 추가했습니다';
+        ELSE
+            RAISE NOTICE 'uk_trade_review_history_reviewer 이미 존재합니다. 스킵합니다';
+        END IF;
+
+    ELSE
+        RAISE NOTICE 'trade_review 테이블이 존재하지 않습니다. JPA가 생성할 예정입니다';
+    END IF;
+
+EXCEPTION
+    WHEN OTHERS THEN
+        RAISE WARNING '마이그레이션 중 오류 발생: %', SQLERRM;
+END $$;