Feat/#37 리뷰 관련 기능 구현(ocr제외)

.gitignore

@@ -26,6 +26,7 @@ bin/
 out/
 !**/src/main/**/out/
 !**/src/test/**/out/
+src/main/resources/oci
 
 ### NetBeans ###
 /nbproject/private/

src/main/java/com/campus/campus/domain/councilpost/application/service/StudentCouncilPostService.java

@@ -70,7 +70,7 @@ public GetPostResponse create(Long councilId, PostRequest dto) {
 		NormalizedDateTime normalized = dto.category().validateAndNormalize(dto);
 
 		//Place 객체 생성
-		Place place = placeService.findOrCreatePlace(dto);
+		Place place = placeService.findOrCreatePlace(dto.place());
 
 		StudentCouncilPost post = studentCouncilPostMapper.createStudentCouncilPost(
 			writer, place, dto, normalized.startDateTime(), normalized.endDateTime()
@@ -214,7 +214,7 @@ public GetPostResponse update(Long councilId, Long postId, PostRequest dto) {
 
 		Place place = post.getPlace();
 		if (dto.place() != null && (place == null || !dto.place().placeName().equals(place.getPlaceName()))) {
-			place = placeService.findOrCreatePlace(dto);
+			place = placeService.findOrCreatePlace(dto.place());
 		}
 
 		post.update(

src/main/java/com/campus/campus/domain/councilpost/domain/repository/StudentCouncilPostRepository.java

@@ -280,4 +280,46 @@ List<StudentCouncilPost> findPinsInBounds(
 		@Param("maxLng") Double maxLng,
 		@Param("now") LocalDateTime now
 	);
+
+	@Query(value = """
+		SELECT scp.*
+		       FROM student_council_post scp
+		       JOIN student_councils sc
+		         ON scp.writer_id = sc.student_council_id
+		       JOIN places p
+		         ON scp.place_id = p.place_id
+		       LEFT JOIN reviews r
+		         ON r.place_id = p.place_id
+		         AND r.created_at >= :from
+		       WHERE scp.start_date_time <= :now
+		         AND scp.end_date_time >= :now
+		         AND (
+		               (sc.council_type = 'MAJOR_COUNCIL'   AND sc.major_id   = :majorId)
+		            OR (sc.council_type = 'COLLEGE_COUNCIL' AND sc.college_id = :collegeId)
+		            OR (sc.council_type = 'SCHOOL_COUNCIL'  AND sc.school_id  = :schoolId)
+		         )
+		       GROUP BY scp.id
+		       ORDER BY COUNT(r.id) DESC
+		       LIMIT 3;
+
+		""", nativeQuery = true)
+	List<StudentCouncilPost> findTop3RecommendedPartnershipPlaces(
+		@Param("majorId") Long majorId,
+		@Param("collegeId") Long collegeId,
+		@Param("schoolId") Long schoolId,
+		@Param("from") LocalDateTime from,
+		@Param("now") LocalDateTime now
+	);
+
+	@Query("""
+			SELECT scp
+			FROM StudentCouncilPost scp
+			WHERE scp.place.placeId IN :placeIds
+			AND scp.writer.id = :writerId
+			ORDER BY scp.createdAt DESC
+		""")
+	List<StudentCouncilPost> findRepresentativePosts(
+		@Param("placeIds") List<Long> placeIds
+	);
+
 }

src/main/java/com/campus/campus/domain/place/application/dto/response/SavedPlaceInfo.java

@@ -6,6 +6,7 @@
 
 import io.swagger.v3.oas.annotations.media.Schema;
 import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
 
 public record SavedPlaceInfo(
 
@@ -32,6 +33,7 @@ public record SavedPlaceInfo(
 	String telephone,
 
 	@Schema(description = "위도/경도")
+	@NotNull
 	Coordinate coordinate,
 
 	@Schema(description = "이미지 url")

src/main/java/com/campus/campus/domain/place/application/service/PlaceService.java

@@ -14,7 +14,6 @@
 import org.springframework.stereotype.Service;
 import org.springframework.transaction.annotation.Transactional;
 
-import com.campus.campus.domain.councilpost.application.dto.request.PostRequest;
 import com.campus.campus.domain.place.application.dto.response.LikeResponse;
 import com.campus.campus.domain.place.application.dto.response.SavedPlaceInfo;
 import com.campus.campus.domain.place.application.dto.response.SearchCandidateResponse;
@@ -113,8 +112,7 @@ public List<SavedPlaceInfo> search(double lat, double lng, String keyword) {
 	}
 
 	@Transactional
-	public Place findOrCreatePlace(PostRequest request) {
-		SavedPlaceInfo place = request.place();
+	public Place findOrCreatePlace(SavedPlaceInfo place) {
 		String placeKey = place.placeKey();
 
 		//이미 Place 존재하는지 확인 후 없으면 객체 생성 후 저장

src/main/java/com/campus/campus/domain/review/application/dto/request/ReviewRequest.java

@@ -0,0 +1,47 @@
+package com.campus.campus.domain.review.application.dto.request;
+
+import java.util.List;
+
+import com.campus.campus.domain.place.application.dto.response.SavedPlaceInfo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+
+public record ReviewRequest(
+
+	@NotNull
+	@Size(min = 20, message = "리뷰 내용은 최소 20자 이상이어야 합니다.")
+	@Schema(example = "아주 정말 맛있습니다. 저의 완전 짱 또간집. 꼭꼮꼬꼬꼭 가세요.")
+	String content,
+
+	@NotNull
+	@Schema(example = "3.5")
+	double star,
+
+	List<String> imageUrls,
+
+	@Schema(example =
+		"""
+			"placeName": "숙명여자대학교",
+			      "placeKey": "string",
+			      "address": "서울특별시 용산구 청파로47길 99",
+			      "category": "교육,학문>대학교",
+			      "link": "https://map.naver.com/v5/search/%EC%88%99%EB%AA%85%EC%97%AC%EC%9E%90%EB%8C%80%ED%95%99%EA%B5%90+%EC%A0%9C1%EC%BA%A0%ED%8D%BC%EC%8A%A4?c=37.545947,126.964578,15,0,0,0,dh",
+			      "telephone": "010-1234-1234",
+			      "coordinate": {
+			        "latitude": 0.1,
+			        "longitude": 0.1
+			      },
+			      "imgUrls": [
+			        "string"
+			      ]
+			""",
+		description = "/search API에서 반환된 결과 중 하나를 선택")
+	@NotNull
+	@Valid
+	SavedPlaceInfo place
+
+) {
+}

src/main/java/com/campus/campus/domain/review/application/dto/response/CursorPageReviewResponse.java

@@ -0,0 +1,16 @@
+package com.campus.campus.domain.review.application.dto.response;
+
+import java.util.List;
+
+import lombok.Builder;
+import lombok.Getter;
+
+@Getter
+@Builder
+public class CursorPageReviewResponse<ReviewResponse> {
+
+	private List<ReviewResponse> items;
+	private String nextCursorCreatedAt;
+	private Long nextCursorId;
+	private boolean hasNext;
+}

src/main/java/com/campus/campus/domain/review/application/dto/response/PlaceReviewRankResponse.java

@@ -0,0 +1,14 @@
+package com.campus.campus.domain.review.application.dto.response;
+
+import lombok.Builder;
+
+@Builder
+public record PlaceReviewRankResponse(
+	Long placeId,
+	String placeName,
+	String category,
+	String partnership,
+	String thumbnailUrl
+	// double distance
+) {
+}

src/main/java/com/campus/campus/domain/review/application/dto/response/RankingScope.java

@@ -0,0 +1,10 @@
+package com.campus.campus.domain.review.application.dto.response;
+
+import lombok.Builder;
+
+@Builder
+public record RankingScope(
+	String scope,
+	long rank //n번째 리뷰
+) {
+}

src/main/java/com/campus/campus/domain/review/application/dto/response/ReviewCreateResponse.java

@@ -0,0 +1,12 @@
+package com.campus.campus.domain.review.application.dto.response;
+
+import lombok.Builder;
+
+@Builder
+public record ReviewCreateResponse(
+	ReviewResponse review,
+	ReviewCreateResult result,
+	ReviewRankingResponse ranking
+
+) {
+}

src/main/java/com/campus/campus/domain/review/application/dto/response/ReviewCreateResult.java

@@ -0,0 +1,12 @@
+package com.campus.campus.domain.review.application.dto.response;
+
+import lombok.Builder;
+
+@Builder
+public record ReviewCreateResult(
+	boolean isFirstReviewOfPlace,
+	int userReviewCountOfPlace,
+	// int NumberOfUserStamp,
+	String message
+) {
+}

src/main/java/com/campus/campus/domain/review/application/dto/response/ReviewRankingResponse.java

@@ -0,0 +1,8 @@
+package com.campus.campus.domain.review.application.dto.response;
+
+public record ReviewRankingResponse(
+	RankingScope major,
+	RankingScope college,
+	RankingScope school
+) {
+}

src/main/java/com/campus/campus/domain/review/application/dto/response/ReviewResponse.java

@@ -0,0 +1,19 @@
+package com.campus.campus.domain.review.application.dto.response;
+
+import java.time.LocalDate;
+import java.util.List;
+
+import lombok.Builder;
+
+@Builder
+public record ReviewResponse(
+	Long id,
+	Long userId,
+	String userName,
+	LocalDate createDate,
+	Long placeId,
+	String content,
+	double star,
+	List<String> imageUrls
+) {
+}

src/main/java/com/campus/campus/domain/review/application/exception/ErrorCode.java

@@ -0,0 +1,21 @@
+package com.campus.campus.domain.review.application.exception;
+
+import org.springframework.http.HttpStatus;
+
+import com.campus.campus.global.common.exception.ErrorCodeInterface;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+@Getter
+@AllArgsConstructor
+public enum ErrorCode implements ErrorCodeInterface {
+
+	REVIEW_NOT_FOUND(2700, HttpStatus.NOT_FOUND, "게시글을 찾을 수 없습니다."),
+	NOT_REVIEW_WRITER(2701, HttpStatus.FORBIDDEN, "작성자만 해당 작업을 수행할 수 있습니다.");
+
+	private final int code;
+	private final HttpStatus status;
+	private final String message;
+
+}

src/main/java/com/campus/campus/domain/review/application/exception/NotUserWriterException.java

@@ -0,0 +1,9 @@
+package com.campus.campus.domain.review.application.exception;
+
+import com.campus.campus.global.common.exception.ApplicationException;
+
+public class NotUserWriterException extends ApplicationException {
+	public NotUserWriterException() {
+		super(ErrorCode.NOT_REVIEW_WRITER);
+	}
+}

src/main/java/com/campus/campus/domain/review/application/exception/ReviewNotFoundException.java

@@ -0,0 +1,9 @@
+package com.campus.campus.domain.review.application.exception;
+
+import com.campus.campus.global.common.exception.ApplicationException;
+
+public class ReviewNotFoundException extends ApplicationException {
+	public ReviewNotFoundException() {
+		super(ErrorCode.REVIEW_NOT_FOUND);
+	}
+}