✨ Feat: 체육시설 도메인 및 위치 기반 조회 기능 구현

.gitignore

@@ -38,3 +38,6 @@ src/main/resources/*.yml
 
 ### VS Code ###
 .vscode/
+
+## local docker compose
+docker/docker-compose.local.yml

build.gradle

@@ -50,6 +50,13 @@ dependencies {
 
     // AWS S3
     implementation 'org.springframework.cloud:spring-cloud-starter-aws:2.2.6.RELEASE'
+
+    // PostGIS 공간 타입 <-> JTS(Point 등) 매핑 지원
+    implementation "org.hibernate.orm:hibernate-spatial"
+
+    // JTS
+    implementation 'org.locationtech.jts:jts-core:1.19.0'
+
 }
 
 tasks.named('test') {

src/main/java/com/be/sportizebe/domain/facility/controller/SportsFacilityController.java

@@ -0,0 +1,28 @@
+package com.be.sportizebe.domain.facility.controller;
+
+import com.be.sportizebe.domain.facility.dto.FacilityNearResponse;
+import com.be.sportizebe.domain.facility.service.SportsFacilityService;
+import lombok.RequiredArgsConstructor;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+
+@RestController
+@RequiredArgsConstructor
+@RequestMapping("/api/facilities")
+public class SportsFacilityController {
+
+    private final SportsFacilityService sportsFacilityService;
+
+    @GetMapping("/near")
+    public List<FacilityNearResponse> near(
+            @RequestParam double lat,
+            @RequestParam double lng,
+            @RequestParam(defaultValue = "3000") int radiusM,
+            @RequestParam(defaultValue = "50") int limit,
+            @RequestParam(required = false) String type
+
+    ) {
+        return sportsFacilityService.getNear(lat, lng, radiusM, limit, type);
+    }
+}

src/main/java/com/be/sportizebe/domain/facility/dto/FacilityNearResponse.java

@@ -0,0 +1,15 @@
+package com.be.sportizebe.domain.facility.dto;
+
+import lombok.Builder;
+import lombok.Getter;
+
+@Getter
+@Builder
+public class FacilityNearResponse {
+    private Long id;
+    private String facilityName;
+    private String introduce;
+    private String thumbnailUrl;
+    private String facilityType;
+    private int distanceM; // 프론트에서 보기 쉽게 미터 int로
+}

src/main/java/com/be/sportizebe/domain/facility/entity/FacilityType.java

@@ -0,0 +1,10 @@
+package com.be.sportizebe.domain.facility.entity;
+
+public enum FacilityType {
+    BASKETBALL,
+    SOCCER,
+    BADMINTON,
+    TENNIS,
+    BOWLING,
+    ETC
+}

src/main/java/com/be/sportizebe/domain/facility/entity/SportsFacility.java

@@ -0,0 +1,46 @@
+package com.be.sportizebe.domain.facility.entity;
+
+import com.be.sportizebe.global.common.BaseTimeEntity;
+import jakarta.persistence.*;
+import lombok.*;
+import org.locationtech.jts.geom.Point;
+
+@Entity
+@Table(name = "sports_facilities")
+@Getter
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+@AllArgsConstructor(access = AccessLevel.PRIVATE)
+@Builder
+public class SportsFacility extends BaseTimeEntity {
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+
+    @Column(nullable = false, length = 100)
+    private String facilityName;
+
+    @Column(columnDefinition = "text")
+    private String introduce;
+
+    // 리소스 부담 생각해서 일단 썸네일 이미지 1장으로만 구현하는 방식
+    private String thumbnailUrl;
+
+    @Enumerated(EnumType.STRING)
+    @Column(nullable = false, length = 30)
+    private FacilityType facilityType;
+
+    @Column(columnDefinition = "geography(Point, 4326)", nullable = false)
+    private Point location;
+
+    // 변경 메서드(Dirty Checking용)
+    public void changeInfo(String facilityName, String introduce, String thumbnailUrl, FacilityType facilityType) {
+        if (facilityName != null) this.facilityName = facilityName;
+        if (introduce != null) this.introduce = introduce;
+        if (thumbnailUrl != null) this.thumbnailUrl = thumbnailUrl;
+        if (facilityType != null) this.facilityType = facilityType;
+    }
+
+    public void changeLocation(Point location) {
+        this.location = location;
+    }
+}

src/main/java/com/be/sportizebe/domain/facility/mapper/FacilityMapper.java

@@ -0,0 +1,18 @@
+package com.be.sportizebe.domain.facility.mapper;
+
+import com.be.sportizebe.domain.facility.dto.FacilityNearResponse;
+import com.be.sportizebe.domain.facility.repository.FacilityNearProjection;
+
+public interface FacilityMapper {
+
+    public static FacilityNearResponse toNearResponse(FacilityNearProjection p){
+        return FacilityNearResponse.builder()
+                .id(p.getId())
+                .facilityName(p.getFacilityName())
+                .introduce(p.getIntroduce())
+                .thumbnailUrl(p.getThumbnailUrl())
+                .facilityType(p.getFacilityType())
+                .distanceM((int) Math.round(p.getDistanceM()))
+                .build();
+    }
+}

src/main/java/com/be/sportizebe/domain/facility/repository/FacilityNearProjection.java

@@ -0,0 +1,10 @@
+package com.be.sportizebe.domain.facility.repository;
+
+public interface FacilityNearProjection {
+    Long getId();
+    String getFacilityName();
+    String getIntroduce();
+    String getFacilityType();
+    String getThumbnailUrl();
+    Double getDistanceM();
+}

src/main/java/com/be/sportizebe/domain/facility/repository/SportsFacilityRepository.java

@@ -0,0 +1,40 @@
+package com.be.sportizebe.domain.facility.repository;
+
+import com.be.sportizebe.domain.facility.entity.SportsFacility;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.data.jpa.repository.Query;
+import org.springframework.data.repository.query.Param;
+
+import java.util.List;
+
+public interface SportsFacilityRepository extends JpaRepository<SportsFacility, Long> {
+
+    @Query(value = """
+        SELECT
+            sf.id AS id,
+            sf.facility_name AS facilityName,
+            sf.introduce AS introduce,
+            sf.thumbnail_url AS thumbnailUrl,
+            sf.facility_type AS facilityType,
+            ST_Distance(
+                sf.location,
+                ST_SetSRID(ST_MakePoint(:lng, :lat), 4326)::geography
+            ) AS distanceM
+        FROM sports_facilities sf
+        WHERE ST_DWithin(
+            sf.location,
+            ST_SetSRID(ST_MakePoint(:lng, :lat), 4326)::geography,
+            :radiusM
+        )
+        AND (:type IS NULL OR sf.facility_type = :type)
+        ORDER BY distanceM
+        LIMIT :limit
+        """, nativeQuery = true)
+    List<FacilityNearProjection> findNear(
+            @Param("lat") double lat,
+            @Param("lng") double lng,
+            @Param("radiusM") long radiusM,
+            @Param("limit") int limit,
+            @Param("type") String type
+    );
+}

src/main/java/com/be/sportizebe/domain/facility/service/SportsFacilityService.java

@@ -0,0 +1,39 @@
+package com.be.sportizebe.domain.facility.service;
+
+import com.be.sportizebe.domain.facility.dto.FacilityNearResponse;
+import com.be.sportizebe.domain.facility.mapper.FacilityMapper;
+import com.be.sportizebe.domain.facility.repository.FacilityNearProjection;
+import com.be.sportizebe.domain.facility.repository.SportsFacilityRepository;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.util.List;
+
+@Service
+@RequiredArgsConstructor
+@Transactional(readOnly = true)
+public class SportsFacilityService {
+
+    private final SportsFacilityRepository sportsFacilityRepository;
+
+    public List<FacilityNearResponse> getNear(
+            double lat,
+            double lng,
+            long radiusM,
+            int limit,
+            String type
+    ) {
+        if (radiusM <= 0) radiusM = 1000;
+        if (radiusM > 20000) radiusM = 20000;
+        if (limit <= 0) limit = 50;
+        if (limit > 200) limit = 200;
+
+        List<FacilityNearProjection> rows =
+                sportsFacilityRepository.findNear(lat, lng, radiusM, limit, type);
+
+        return rows.stream()
+                .map(FacilityMapper::toNearResponse)
+                .toList();
+    }
+}