Merge pull request #340 from SOLPLY/#333-feat-place-review

[FEAT] 장소 리뷰 api

Author: uykm

src/main/java/org/sopt/solply_server/domain/place/repository/PlaceRepository.java

@@ -65,4 +65,12 @@ public interface PlaceRepository extends JpaRepository<Place, Long>, PlaceReposi
             and p.active = true
     """)
     Optional<Place> findActiveByIdWithTownAndCheckpoints(@Param("placeId") Long placeId);
+
+  @Query("""
+    select p
+    from Place p
+    where p.id = :placeId
+      and p.active = true
+""")
+  Optional<Place> findActiveById(@Param("placeId") Long placeId);
 }

src/main/java/org/sopt/solply_server/domain/review/controller/PlaceReviewController.java

@@ -0,0 +1,28 @@
+package org.sopt.solply_server.domain.review.controller;
+
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+import org.sopt.solply_server.domain.review.dto.request.CreatePlaceReviewRequest;
+import org.sopt.solply_server.domain.review.dto.response.CreatePlaceReviewResponse;
+import org.sopt.solply_server.domain.review.service.PlaceReviewService;
+import org.sopt.solply_server.global.annotation.CurrentUserId;
+import org.sopt.solply_server.global.dto.CustomApiResponse;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.*;
+
+@RestController
+@RequiredArgsConstructor
+@RequestMapping("/api/places/reviews")
+public class PlaceReviewController {
+
+  private final PlaceReviewService placeReviewService;
+
+  @PostMapping
+  public ResponseEntity<CustomApiResponse<CreatePlaceReviewResponse>> createRecord(
+      @CurrentUserId Long userId,
+      @Valid @RequestBody CreatePlaceReviewRequest request
+  ) {
+    CreatePlaceReviewResponse response = placeReviewService.createReview(userId, request);
+    return CustomApiResponse.success("혼놀 기록 작성이 완료되었습니다.", response);
+  }
+}

src/main/java/org/sopt/solply_server/domain/review/dto/request/CreatePlaceReviewRequest.java

@@ -0,0 +1,29 @@
+package org.sopt.solply_server.domain.review.dto.request;
+
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.PastOrPresent;
+import jakarta.validation.constraints.Size;
+import java.time.LocalDate;
+import java.util.List;
+import org.sopt.solply_server.domain.review.entity.VisitTime;
+
+public record CreatePlaceReviewRequest(
+
+    @NotNull(message = "장소 ID는 필수입니다.")
+    Long placeId,
+
+    @NotNull(message = "방문 날짜는 필수입니다.")
+    @PastOrPresent(message = "방문 날짜는 오늘 또는 이전 날짜만 선택할 수 있습니다.")
+    LocalDate visitedAt,
+
+    @NotNull(message = "방문 시간대는 필수입니다.")
+    VisitTime visitTimeSlot,
+
+    @NotBlank(message = "오늘의 기록은 필수입니다.")
+    @Size(min = 10, max = 500, message = "오늘의 기록은 10자 이상 500자 이하여야 합니다.")
+    String content,
+
+    List<String> imageKeys
+) {
+}

src/main/java/org/sopt/solply_server/domain/review/dto/response/CreatePlaceReviewResponse.java

@@ -0,0 +1,11 @@
+package org.sopt.solply_server.domain.review.dto.response;
+
+import org.sopt.solply_server.domain.review.entity.PlaceReview;
+
+public record CreatePlaceReviewResponse(
+    Long reviewId
+) {
+  public static CreatePlaceReviewResponse from(PlaceReview placeReview) {
+    return new CreatePlaceReviewResponse(placeReview.getId());
+  }
+}

src/main/java/org/sopt/solply_server/domain/review/entity/PlaceReview.java

@@ -0,0 +1,94 @@
+package org.sopt.solply_server.domain.review.entity;
+
+import jakarta.persistence.*;
+import java.time.LocalDate;
+import java.util.ArrayList;
+import java.util.List;
+import lombok.AccessLevel;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import org.sopt.solply_server.domain.place.entity.Place;
+import org.sopt.solply_server.domain.user.entity.User;
+import org.sopt.solply_server.global.entity.BaseTimeEntity;
+
+@Entity
+@Table(
+        name = "place_reviews",
+        indexes = {
+                @Index(name = "idx_place_reviews_place_id_created_at", columnList = "place_id, created_at DESC"),
+                @Index(name = "idx_place_reviews_user_id_created_at", columnList = "user_id, created_at DESC")
+        }
+)
+@Getter
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+public class PlaceReview extends BaseTimeEntity {
+
+  @Id
+  @GeneratedValue(strategy = GenerationType.IDENTITY)
+  private Long id;
+
+  @ManyToOne(fetch = FetchType.LAZY, optional = false)
+  @JoinColumn(name = "user_id", nullable = false)
+  private User user;
+
+  @ManyToOne(fetch = FetchType.LAZY, optional = false)
+  @JoinColumn(name = "place_id", nullable = false)
+  private Place place;
+
+  @Column(name = "visited_at", nullable = false)
+  private LocalDate visitedAt;
+
+  @Enumerated(EnumType.STRING)
+  @Column(name = "visit_time_slot", nullable = false, length = 20)
+  private VisitTime visitTimeSlot;
+
+  @Column(name = "content", nullable = false, length = 500)
+  private String content;
+
+  @OneToMany(mappedBy = "placeReview", cascade = CascadeType.ALL, orphanRemoval = true)
+  private List<PlaceReviewImage> placeReviewImages = new ArrayList<>();
+
+  @Builder
+  private PlaceReview(
+      User user,
+      Place place,
+      LocalDate visitedAt,
+      VisitTime visitTimeSlot,
+      String content
+  ) {
+    this.user = user;
+    this.place = place;
+    this.visitedAt = visitedAt;
+    this.visitTimeSlot = visitTimeSlot;
+    this.content = content;
+  }
+
+  public static PlaceReview create(
+      User user,
+      Place place,
+      LocalDate visitedAt,
+      VisitTime visitTimeSlot,
+      String content
+  ) {
+    return PlaceReview.builder()
+        .user(user)
+        .place(place)
+        .visitedAt(visitedAt)
+        .visitTimeSlot(visitTimeSlot)
+        .content(content)
+        .build();
+  }
+
+  public void addImage(PlaceReviewImage placeReviewImage) {
+    this.placeReviewImages.add(placeReviewImage);
+  }
+
+  public void replaceImages(List<String> imageUrls) {
+    this.placeReviewImages.clear();
+
+    for (String imageUrl : imageUrls) {
+      this.placeReviewImages.add(PlaceReviewImage.create(this, imageUrl));
+    }
+  }
+}

src/main/java/org/sopt/solply_server/domain/review/entity/PlaceReviewImage.java

@@ -0,0 +1,38 @@
+package org.sopt.solply_server.domain.review.entity;
+
+import jakarta.persistence.*;
+import lombok.AccessLevel;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Entity
+@Table(name = "place_review_images")
+@Getter
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+public class PlaceReviewImage {
+
+  @Id
+  @GeneratedValue(strategy = GenerationType.IDENTITY)
+  private Long id;
+
+  @ManyToOne(fetch = FetchType.LAZY, optional = false)
+  @JoinColumn(name = "place_review_id", nullable = false)
+  private PlaceReview placeReview;
+
+  @Column(name = "image_url", nullable = false, length = 500)
+  private String imageUrl;
+
+  @Builder
+  private PlaceReviewImage(PlaceReview placeReview, String imageUrl) {
+    this.placeReview = placeReview;
+    this.imageUrl = imageUrl;
+  }
+
+  public static PlaceReviewImage create(PlaceReview placeReview, String imageUrl) {
+    return PlaceReviewImage.builder()
+        .placeReview(placeReview)
+        .imageUrl(imageUrl)
+        .build();
+  }
+}

src/main/java/org/sopt/solply_server/domain/review/entity/VisitTime.java

@@ -0,0 +1,7 @@
+package org.sopt.solply_server.domain.review.entity;
+
+public enum VisitTime {
+  MORNING,
+  AFTERNOON,
+  EVENING
+}

src/main/java/org/sopt/solply_server/domain/review/repository/PlaceReviewImageRepository.java

@@ -0,0 +1,7 @@
+package org.sopt.solply_server.domain.review.repository;
+
+import org.sopt.solply_server.domain.review.entity.PlaceReviewImage;
+import org.springframework.data.jpa.repository.JpaRepository;
+
+public interface PlaceReviewImageRepository extends JpaRepository<PlaceReviewImage, Long> {
+}

src/main/java/org/sopt/solply_server/domain/review/repository/PlaceReviewRepository.java

@@ -0,0 +1,7 @@
+package org.sopt.solply_server.domain.review.repository;
+
+import org.sopt.solply_server.domain.review.entity.PlaceReview;
+import org.springframework.data.jpa.repository.JpaRepository;
+
+public interface PlaceReviewRepository extends JpaRepository<PlaceReview, Long> {
+}

src/main/java/org/sopt/solply_server/domain/review/service/PlaceReviewImageFieldUpdater.java

@@ -0,0 +1,33 @@
+package org.sopt.solply_server.domain.review.service;
+
+import java.util.List;
+import lombok.RequiredArgsConstructor;
+import org.sopt.solply_server.domain.review.entity.PlaceReview;
+import org.sopt.solply_server.domain.review.repository.PlaceReviewRepository;
+import org.sopt.solply_server.global.exception.EntityNotFoundException;
+import org.sopt.solply_server.global.exception.ErrorCode;
+import org.sopt.solply_server.global.listener.ImageFieldUpdater;
+import org.sopt.solply_server.global.util.s3.TargetDir;
+import org.springframework.stereotype.Component;
+import org.springframework.transaction.annotation.Transactional;
+
+@Component
+@RequiredArgsConstructor
+public class PlaceReviewImageFieldUpdater implements ImageFieldUpdater {
+
+  private final PlaceReviewRepository placeReviewRepository;
+
+  @Override
+  public TargetDir supportedDir() {
+    return TargetDir.RECORD;
+  }
+
+  @Override
+  @Transactional
+  public void replaceImages(long targetId, List<String> destKeys) {
+    PlaceReview placeReview = placeReviewRepository.findById(targetId)
+        .orElseThrow(() -> new EntityNotFoundException(ErrorCode.PLACE_REVIEW_NOT_FOUND));
+
+    placeReview.replaceImages(destKeys);
+  }
+}