[BUILD FAIL] Feature/49 봉사 모집글 조회 기능

build.gradle

@@ -115,6 +115,7 @@ def jacocoExcludePatterns = [
         '**/auth/**',
         '**/domain/*',
         '**/domains/*',
+        '**/fixture/*'
 ]
 
 def jacocoExcludePatternsForVerify = [
@@ -129,6 +130,7 @@ def jacocoExcludePatternsForVerify = [
         '*.auth.*',
         '*.domain.*',
         '*.domains.*',
+        '*.fixture.*'
 ]
 
 jacocoTestReport {

src/main/java/com/somemore/center/dto/response/CenterSimpleInfoResponseDto.java

@@ -0,0 +1,33 @@
+package com.somemore.center.dto.response;
+
+import com.fasterxml.jackson.databind.PropertyNamingStrategies.SnakeCaseStrategy;
+import com.fasterxml.jackson.databind.annotation.JsonNaming;
+import com.somemore.center.domain.Center;
+import io.swagger.v3.oas.annotations.media.Schema;
+import java.util.UUID;
+import lombok.Builder;
+
+@Builder
+@JsonNaming(SnakeCaseStrategy.class)
+@Schema(description = "기관 정보 응답 DTO")
+public record CenterSimpleInfoResponseDto(
+    @Schema(description = "기관 아이디", example = "123e4567-e89b-12d3-a456-426614174000")
+    UUID id,
+    @Schema(description = "기관 이름", example = "환경 봉사 센터")
+    String name
+) {
+
+    public static CenterSimpleInfoResponseDto from(Center center) {
+        return CenterSimpleInfoResponseDto.builder()
+            .id(center.getId())
+            .name(center.getName())
+            .build();
+    }
+
+    public static CenterSimpleInfoResponseDto of(UUID centerId, String name) {
+        return CenterSimpleInfoResponseDto.builder()
+            .id(centerId)
+            .name(name)
+            .build();
+    }
+}

src/main/java/com/somemore/global/exception/ExceptionMessage.java

@@ -15,12 +15,12 @@ public enum ExceptionMessage {
     UNAUTHORIZED_COMMUNITY_COMMENT("해당 댓글에 권한이 없습니다."),
     NOT_EXISTS_LOCATION("존재하지 않는 위치 ID 입니다."),
     NOT_EXISTS_RECRUIT_BOARD("존재하지 않는 봉사 모집글 ID 입니다."),
-    UNAUTHORIZED_RECRUIT_BOARD("자신이 작성한 봉사 모집글이 아닙니다."),
+    UNAUTHORIZED_RECRUIT_BOARD("해당 봉사 모집글에 권한이 없습니다."),
     UPLOAD_FAILED("파일 업로드에 실패했습니다."),
     INVALID_FILE_TYPE("지원하지 않는 파일 형식입니다."),
     FILE_SIZE_EXCEEDED("파일 크기가 허용된 한도를 초과했습니다."),
     EMPTY_FILE("파일이 존재하지 않습니다."),
-    INSTANTIATION_NOT_ALLOWED("인스턴스화 할 수 없는 클래스 입니다.")
+    INSTANTIATION_NOT_ALLOWED("인스턴스화 할 수 없는 클래스 입니다."),
     ;
 
     private final String message;

src/main/java/com/somemore/location/dto/response/LocationResponseDto.java

@@ -0,0 +1,38 @@
+package com.somemore.location.dto.response;
+
+import com.fasterxml.jackson.databind.PropertyNamingStrategies.SnakeCaseStrategy;
+import com.fasterxml.jackson.databind.annotation.JsonNaming;
+import com.somemore.location.domain.Location;
+import io.swagger.v3.oas.annotations.media.Schema;
+import java.math.BigDecimal;
+import lombok.Builder;
+
+@Builder
+@JsonNaming(SnakeCaseStrategy.class)
+@Schema(description = "위치 조회 응답 DTO")
+public record LocationResponseDto(
+    @Schema(description = "주소", example = "서울특별시 강남구 테헤란로 123")
+    String address,
+    @Schema(description = "위도", example = "37.5665")
+    BigDecimal latitude,
+    @Schema(description = "경도", example = "126.9780")
+    BigDecimal longitude
+) {
+
+    public static LocationResponseDto from(Location location) {
+        return LocationResponseDto.builder()
+            .address(location.getAddress())
+            .latitude(location.getLatitude())
+            .longitude(location.getLongitude())
+            .build();
+    }
+
+    public static LocationResponseDto of(String address, BigDecimal latitude,
+        BigDecimal longitude) {
+        return LocationResponseDto.builder()
+            .address(address)
+            .latitude(latitude)
+            .longitude(longitude)
+            .build();
+    }
+}

src/main/java/com/somemore/location/service/command/UpdateLocationService.java

@@ -7,7 +7,6 @@
 import com.somemore.location.dto.request.LocationUpdateRequestDto;
 import com.somemore.location.repository.LocationRepository;
 import com.somemore.location.usecase.command.UpdateLocationUseCase;
-import com.somemore.location.usecase.query.LocationQueryUseCase;
 import lombok.RequiredArgsConstructor;
 import org.springframework.stereotype.Service;
 import org.springframework.transaction.annotation.Transactional;
@@ -17,14 +16,17 @@
 @Service
 public class UpdateLocationService implements UpdateLocationUseCase {
 
-    private final LocationQueryUseCase locationQueryUseCase;
     private final LocationRepository locationRepository;
 
     @Override
     public void updateLocation(LocationUpdateRequestDto requestDto, Long locationId) {
-        Location location = locationQueryUseCase.findById(locationId)
-            .orElseThrow(() -> new BadRequestException(NOT_EXISTS_LOCATION.getMessage()));
+        Location location = getLocation(locationId);
         location.updateWith(requestDto);
         locationRepository.save(location);
     }
+
+    private Location getLocation(Long locationId) {
+        return locationRepository.findById(locationId)
+            .orElseThrow(() -> new BadRequestException(NOT_EXISTS_LOCATION.getMessage()));
+    }
 }

src/main/java/com/somemore/location/service/query/LocationQueryService.java

@@ -1,9 +1,11 @@
 package com.somemore.location.service.query;
 
+import static com.somemore.global.exception.ExceptionMessage.NOT_EXISTS_LOCATION;
+
+import com.somemore.global.exception.BadRequestException;
 import com.somemore.location.domain.Location;
 import com.somemore.location.repository.LocationRepository;
 import com.somemore.location.usecase.query.LocationQueryUseCase;
-import java.util.Optional;
 import lombok.RequiredArgsConstructor;
 import org.springframework.stereotype.Service;
 import org.springframework.transaction.annotation.Transactional;
@@ -16,8 +18,14 @@ public class LocationQueryService implements LocationQueryUseCase {
     private final LocationRepository locationRepository;
 
     @Override
-    public Optional<Location> findById(Long id) {
-        return locationRepository.findById(id);
+    public Location getById(Long id) {
+        return getLocation(id);
+    }
+
+    private Location getLocation(Long id) {
+        return locationRepository.findById(id).orElseThrow(
+            () -> new BadRequestException(NOT_EXISTS_LOCATION.getMessage())
+        );
     }
 
 }

src/main/java/com/somemore/location/usecase/query/LocationQueryUseCase.java

@@ -1,10 +1,9 @@
 package com.somemore.location.usecase.query;
 
 import com.somemore.location.domain.Location;
-import java.util.Optional;
 
 public interface LocationQueryUseCase {
 
-    Optional<Location> findById(Long id);
+    Location getById(Long id);
 
 }

src/main/java/com/somemore/location/utils/GeoUtils.java

@@ -0,0 +1,29 @@
+package com.somemore.location.utils;
+
+import static lombok.AccessLevel.PRIVATE;
+
+import lombok.NoArgsConstructor;
+
+@NoArgsConstructor(access = PRIVATE)
+public class GeoUtils {
+
+    private static final double EARTH_RADIUS = 6371.0;
+
+    public static double[] calculateMaxMinCoordinates(double latitude, double longitude,
+        double radius) {
+        double latRad = Math.toRadians(latitude);
+        double latDiff = radius / EARTH_RADIUS;
+        double maxLatRad = latRad + latDiff;
+        double minLatRad = latRad - latDiff;
+
+        double maxLat = Math.toDegrees(maxLatRad);
+        double minLat = Math.toDegrees(minLatRad);
+
+        double lonDiff = radius / (EARTH_RADIUS * Math.cos(latRad));
+        double maxLon = longitude + Math.toDegrees(lonDiff);
+        double minLon = longitude - Math.toDegrees(lonDiff);
+
+        return new double[]{minLat, minLon, maxLat, maxLon};
+    }
+
+}

src/main/java/com/somemore/recruitboard/controller/RecruitBoardQueryController.java

@@ -0,0 +1,141 @@
+package com.somemore.recruitboard.controller;
+
+import static org.springframework.data.domain.Sort.Direction.DESC;
+
+import com.somemore.global.common.response.ApiResponse;
+import com.somemore.recruitboard.domain.RecruitStatus;
+import com.somemore.recruitboard.domain.VolunteerType;
+import com.somemore.recruitboard.dto.condition.RecruitBoardNearByCondition;
+import com.somemore.recruitboard.dto.condition.RecruitBoardSearchCondition;
+import com.somemore.recruitboard.dto.response.RecruitBoardDetailResponseDto;
+import com.somemore.recruitboard.dto.response.RecruitBoardResponseDto;
+import com.somemore.recruitboard.dto.response.RecruitBoardWithCenterResponseDto;
+import com.somemore.recruitboard.dto.response.RecruitBoardWithLocationResponseDto;
+import com.somemore.recruitboard.usecase.query.RecruitBoardQueryUseCase;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import java.util.UUID;
+import lombok.RequiredArgsConstructor;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+import org.springframework.data.web.PageableDefault;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+@Tag(name = "Recruit Board Query API", description = "봉사 활동 모집 조회 관련 API")
+@RequiredArgsConstructor
+@RequestMapping("/api")
+@RestController
+public class RecruitBoardQueryController {
+
+    private final RecruitBoardQueryUseCase recruitBoardQueryUseCase;
+
+    @GetMapping("/recruit-board/{id}")
+    @Operation(summary = "봉사 모집글 상세 조회", description = "특정 모집글의 상세 정보를 조회합니다.")
+    public ApiResponse<RecruitBoardWithLocationResponseDto> getById(
+        @PathVariable Long id
+    ) {
+        return ApiResponse.ok(
+            200,
+            recruitBoardQueryUseCase.getWithLocationById(id),
+            "봉사 활동 모집 상세 조회 성공"
+        );
+    }
+
+    @GetMapping("/recruit-boards")
+    @Operation(summary = "전체 모집글 조회", description = "모든 봉사 모집글 목록을 조회합니다.")
+    public ApiResponse<Page<RecruitBoardWithCenterResponseDto>> getAll(
+        @PageableDefault(sort = "created_at", direction = DESC)
+        Pageable pageable
+    ) {
+        RecruitBoardSearchCondition condition = RecruitBoardSearchCondition.builder()
+            .pageable(pageable)
+            .build();
+
+        return ApiResponse.ok(
+            200,
+            recruitBoardQueryUseCase.getAllWithCenter(condition),
+            "봉사 활동 모집글 리스트 조회 성공"
+        );
+    }
+
+    @GetMapping("/recruit-boards/search")
+    @Operation(summary = "모집글 검색 조회", description = "검색 조건을 기반으로 모집글을 조회합니다.")
+    public ApiResponse<Page<RecruitBoardWithCenterResponseDto>> getAllBySearch(
+        @PageableDefault(sort = "created_at", direction = DESC) Pageable pageable,
+        @RequestParam(required = false) String keyword,
+        @RequestParam(required = false) VolunteerType type,
+        @RequestParam(required = false) String region,
+        @RequestParam(required = false) Boolean admitted,
+        @RequestParam(required = false) RecruitStatus status
+    ) {
+        RecruitBoardSearchCondition condition = RecruitBoardSearchCondition.builder()
+            .keyword(keyword)
+            .type(type)
+            .region(region)
+            .admitted(admitted)
+            .status(status)
+            .pageable(pageable)
+            .build();
+
+        return ApiResponse.ok(
+            200,
+            recruitBoardQueryUseCase.getAllWithCenter(condition),
+            "봉사 활동 모집글 검색 조회 성공"
+        );
+    }
+
+    @GetMapping("/recruit-boards/nearby")
+    @Operation(summary = "근처 모집글 조회", description = "주변 반경 내의 봉사 모집글을 조회합니다.")
+    public ApiResponse<Page<RecruitBoardDetailResponseDto>> getNearby(
+        @RequestParam double latitude,
+        @RequestParam double longitude,
+        @RequestParam(required = false, defaultValue = "5") double radius,
+        @RequestParam(required = false) String keyword,
+        @PageableDefault(sort = "created_at", direction = DESC) Pageable pageable
+    ) {
+        RecruitBoardNearByCondition condition = RecruitBoardNearByCondition.builder()
+            .latitude(latitude)
+            .longitude(longitude)
+            .radius(radius)
+            .keyword(keyword)
+            .pageable(pageable)
+            .build();
+
+        return ApiResponse.ok(
+            200,
+            recruitBoardQueryUseCase.getRecruitBoardsNearby(condition),
+            "근처 봉사 활동 모집글 조회 성공"
+        );
+    }
+
+    @GetMapping("/recruit-boards/center/{centerId}")
+    @Operation(summary = "특정 기관 모집글 조회", description = "특정 기관의 봉사 모집글을 조회합니다.")
+    public ApiResponse<Page<RecruitBoardResponseDto>> getRecruitBoardsByCenterId(
+        @PathVariable UUID centerId,
+        @PageableDefault(sort = "created_at", direction = DESC) Pageable pageable,
+        @RequestParam(required = false) String keyword,
+        @RequestParam(required = false) VolunteerType type,
+        @RequestParam(required = false) String region,
+        @RequestParam(required = false) Boolean admitted,
+        @RequestParam(required = false) RecruitStatus status
+    ) {
+        RecruitBoardSearchCondition condition = RecruitBoardSearchCondition.builder()
+            .keyword(keyword)
+            .type(type)
+            .region(region)
+            .admitted(admitted)
+            .status(status)
+            .pageable(pageable)
+            .build();
+
+        return ApiResponse.ok(
+            200,
+            recruitBoardQueryUseCase.getRecruitBoardsByCenterId(centerId, condition),
+            "기관 봉사 활동 모집글 조회 성공"
+        );
+    }
+}

src/main/java/com/somemore/recruitboard/dto/condition/RecruitBoardNearByCondition.java

@@ -0,0 +1,15 @@
+package com.somemore.recruitboard.dto.condition;
+
+import lombok.Builder;
+import org.springframework.data.domain.Pageable;
+
+@Builder
+public record RecruitBoardNearByCondition(
+    Double latitude,
+    Double longitude,
+    Double radius,
+    String keyword,
+    Pageable pageable
+) {
+
+}

src/main/java/com/somemore/recruitboard/dto/condition/RecruitBoardSearchCondition.java

@@ -0,0 +1,18 @@
+package com.somemore.recruitboard.dto.condition;
+
+import com.somemore.recruitboard.domain.RecruitStatus;
+import com.somemore.recruitboard.domain.VolunteerType;
+import lombok.Builder;
+import org.springframework.data.domain.Pageable;
+
+@Builder
+public record RecruitBoardSearchCondition(
+    String keyword,
+    VolunteerType type,
+    String region,
+    Boolean admitted,
+    RecruitStatus status,
+    Pageable pageable
+) {
+
+}