Merge pull request #60 from Sportize/feat/admin

✨ Feat: Admin 도메인 도입 및 Geocoding 기반 체육시설·매칭 관리 기능 확장

Author: angoroa

src/main/java/com/be/sportizebe/domain/admin/controller/AdminController.java

@@ -0,0 +1,77 @@
+package com.be.sportizebe.domain.admin.controller;
+
+import com.be.sportizebe.domain.admin.service.AdminService;
+import com.be.sportizebe.domain.facility.dto.request.FacilityCreateRequest;
+import com.be.sportizebe.domain.facility.dto.request.FacilityUpdateRequest;
+import com.be.sportizebe.domain.facility.dto.response.FacilityResponse;
+import com.be.sportizebe.domain.match.dto.request.MatchCreateRequest;
+import com.be.sportizebe.domain.match.dto.response.MatchResponse;
+import com.be.sportizebe.global.cache.dto.UserAuthInfo;
+import com.be.sportizebe.global.response.BaseResponse;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.security.core.annotation.AuthenticationPrincipal;
+import org.springframework.web.bind.annotation.*;
+
+
+@RestController
+@RequiredArgsConstructor
+@RequestMapping("/api/admin")
+@Tag(name = "admin", description = "관리자 전용 API")
+public class AdminController {
+
+    private final AdminService adminService;
+
+    @Operation(summary = "체육시설 등록 (관리자 전용)", description = "새로운 체육시설을 등록합니다.")
+    @PostMapping("/facilities")
+    public ResponseEntity<BaseResponse<FacilityResponse>> createFacility(
+            @RequestBody @Valid FacilityCreateRequest request
+    ) {
+        FacilityResponse response = adminService.createFacility(request);
+        return ResponseEntity.status(HttpStatus.CREATED)
+                .body(BaseResponse.success("체육시설 등록 성공", response));
+    }
+
+    @Operation(summary = "체육시설 수정 (관리자 전용)", description = "체육시설 정보를 수정합니다. null 필드는 수정하지 않습니다.")
+    @PutMapping("/facilities/{facilityId}")
+    public ResponseEntity<BaseResponse<FacilityResponse>> updateFacility(
+            @PathVariable Long facilityId,
+            @RequestBody @Valid FacilityUpdateRequest request
+    ) {
+        FacilityResponse response = adminService.updateFacility(facilityId, request);
+        return ResponseEntity.ok(BaseResponse.success("체육시설 수정 성공", response));
+    }
+
+    @Operation(summary = "체육시설 삭제 (관리자 전용)", description = "체육시설을 삭제합니다.")
+    @DeleteMapping("/facilities/{facilityId}")
+    public ResponseEntity<BaseResponse<Void>> deleteFacility(
+            @PathVariable Long facilityId
+    ) {
+        adminService.deleteFacility(facilityId);
+        return ResponseEntity.ok(BaseResponse.success("체육시설 삭제 성공", null));
+    }
+
+    @Operation(summary = "매칭 생성 (관리자 전용)", description = "체육시설 기반 매칭을 생성합니다.")
+    @PostMapping("/matches")
+    public ResponseEntity<BaseResponse<MatchResponse>> createMatch(
+            @AuthenticationPrincipal UserAuthInfo userAuthInfo,
+            @RequestBody @Valid MatchCreateRequest request
+    ) {
+        MatchResponse response = adminService.createMatch(userAuthInfo.getId(), request);
+        return ResponseEntity.status(HttpStatus.CREATED)
+                .body(BaseResponse.success("매칭 생성 성공", response));
+    }
+
+    @Operation(summary = "매칭 삭제 (관리자 전용)", description = "매칭을 강제 삭제합니다.")
+    @DeleteMapping("/matches/{matchId}")
+    public ResponseEntity<BaseResponse<Void>> deleteMatch(
+            @PathVariable Long matchId
+    ) {
+        adminService.deleteMatch(matchId);
+        return ResponseEntity.ok(BaseResponse.success("매칭 삭제 성공", null));
+    }
+}

src/main/java/com/be/sportizebe/domain/admin/dto/request/.gitkeep

@@ -0,0 +1,16 @@
+package com.be.sportizebe.domain.admin.exception;
+
+import com.be.sportizebe.global.exception.model.BaseErrorCode;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+import org.springframework.http.HttpStatus;
+
+@Getter
+@AllArgsConstructor
+public enum AdminErrorCode implements BaseErrorCode {
+    ADMIN_ACCESS_DENIED("ADMIN_001", "관리자 권한이 없습니다.", HttpStatus.FORBIDDEN);
+
+    private final String code;
+    private final String message;
+    private final HttpStatus status;
+}

src/main/java/com/be/sportizebe/domain/admin/dto/response/.gitkeep

@@ -0,0 +1,20 @@
+package com.be.sportizebe.domain.admin.service;
+
+import com.be.sportizebe.domain.facility.dto.request.FacilityCreateRequest;
+import com.be.sportizebe.domain.facility.dto.request.FacilityUpdateRequest;
+import com.be.sportizebe.domain.facility.dto.response.FacilityResponse;
+import com.be.sportizebe.domain.match.dto.request.MatchCreateRequest;
+import com.be.sportizebe.domain.match.dto.response.MatchResponse;
+
+public interface AdminService {
+
+    FacilityResponse createFacility(FacilityCreateRequest request); // 체육시설 등록
+
+    FacilityResponse updateFacility(Long facilityId, FacilityUpdateRequest request); // 체육시설 수정
+
+    void deleteFacility(Long facilityId); // 체육시설 삭제
+
+    MatchResponse createMatch(Long adminId, MatchCreateRequest request); // 매칭 생성
+
+    void deleteMatch(Long matchId); // 매칭 삭제
+}

src/main/java/com/be/sportizebe/domain/admin/exception/AdminErrorCode.java

@@ -0,0 +1,51 @@
+package com.be.sportizebe.domain.admin.service;
+
+import com.be.sportizebe.domain.facility.dto.request.FacilityCreateRequest;
+import com.be.sportizebe.domain.facility.dto.request.FacilityUpdateRequest;
+import com.be.sportizebe.domain.facility.dto.response.FacilityResponse;
+import com.be.sportizebe.domain.facility.service.SportsFacilityService;
+import com.be.sportizebe.domain.match.dto.request.MatchCreateRequest;
+import com.be.sportizebe.domain.match.dto.response.MatchResponse;
+import com.be.sportizebe.domain.match.service.MatchService;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+@Service
+@RequiredArgsConstructor
+@Transactional(readOnly = true)
+public class AdminServiceImpl implements AdminService {
+
+    private final SportsFacilityService sportsFacilityService;
+    private final MatchService matchService;
+
+    @Override
+    @Transactional
+    public FacilityResponse createFacility(FacilityCreateRequest request) {
+        return sportsFacilityService.create(request);
+    }
+
+    @Override
+    @Transactional
+    public FacilityResponse updateFacility(Long facilityId, FacilityUpdateRequest request) {
+        return sportsFacilityService.update(facilityId, request);
+    }
+
+    @Override
+    @Transactional
+    public void deleteFacility(Long facilityId) {
+        sportsFacilityService.delete(facilityId);
+    }
+
+    @Override
+    @Transactional
+    public MatchResponse createMatch(Long adminId, MatchCreateRequest request) {
+        return matchService.createMatch(adminId, request);
+    }
+
+    @Override
+    @Transactional
+    public void deleteMatch(Long matchId) {
+        matchService.deleteMatch(matchId);
+    }
+}

src/main/java/com/be/sportizebe/domain/admin/service/AdminService.java

@@ -1,7 +1,6 @@
 // src/main/java/com/be/sportizebe/domain/facility/controller/SportsFacilityController.java
 package com.be.sportizebe.domain.facility.controller;
 
-import com.be.sportizebe.domain.facility.dto.request.FacilityCreateRequest;
 import com.be.sportizebe.domain.facility.dto.request.FacilityMarkerRequest;
 import com.be.sportizebe.domain.facility.dto.request.FacilityNearRequest;
 import com.be.sportizebe.domain.facility.dto.response.FacilityMarkerResponse;
@@ -43,12 +42,6 @@ public List<FacilityMarkerResponse> markers(
         return sportsFacilityService.getMarkers(request);
     }
 
-    @Operation(summary = "체육시설 등록", description = "체육시설을 등록합니다. (관리자/개발자용)")
-    @PostMapping
-    public FacilityResponse create(@Valid @RequestBody FacilityCreateRequest request) {
-        return sportsFacilityService.create(request);
-    }
-
     @Operation(summary = "체육시설 단건 조회", description = "facilityId로 체육시설을 단건 조회합니다.")
     @GetMapping("/{facilityId}")
     public FacilityResponse getById(@PathVariable Long facilityId) {

src/main/java/com/be/sportizebe/domain/admin/service/AdminServiceImpl.java

@@ -2,8 +2,6 @@
 
 import com.be.sportizebe.domain.facility.entity.FacilityType;
 import io.swagger.v3.oas.annotations.media.Schema;
-import jakarta.validation.constraints.DecimalMax;
-import jakarta.validation.constraints.DecimalMin;
 import jakarta.validation.constraints.NotBlank;
 import jakarta.validation.constraints.NotNull;
 
@@ -14,6 +12,10 @@ public record FacilityCreateRequest(
         @NotBlank
         String facilityName,
 
+        @Schema(description = "도로명 주소", example = "서울특별시 강남구 테헤란로 521")
+        @NotBlank
+        String address,
+
         @Schema(description = "시설 소개", example = "샤워실/주차장 있음")
         String introduce,
 
@@ -22,17 +24,7 @@ public record FacilityCreateRequest(
 
         @Schema(description = "시설 종목 타입", example = "SOCCER")
         @NotNull
-        FacilityType facilityType,
-
-        @Schema(description = "위도", example = "37.563")
-        @DecimalMin("-90.0")
-        @DecimalMax("90.0")
-        double lat,
-
-        @Schema(description = "경도", example = "126.982")
-        @DecimalMin("-180.0")
-        @DecimalMax("180.0")
-        double lng
+        FacilityType facilityType
 
 ) {
 }

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

@@ -0,0 +1,24 @@
+package com.be.sportizebe.domain.facility.dto.request;
+
+import com.be.sportizebe.domain.facility.entity.FacilityType;
+import io.swagger.v3.oas.annotations.media.Schema;
+
+@Schema(description = "체육시설 수정 요청 (null 필드는 수정하지 않음)")
+public record FacilityUpdateRequest(
+
+        @Schema(description = "체육시설 이름", example = "OO 풋살장 (리모델링)")
+        String facilityName,
+
+        @Schema(description = "도로명 주소 (변경 시 좌표 자동 재계산)", example = "서울특별시 강남구 테헤란로 521")
+        String address,
+
+        @Schema(description = "시설 소개", example = "샤워실/주차장 있음")
+        String introduce,
+
+        @Schema(description = "썸네일 이미지 URL", example = "https://example.com/facility/thumbnail.jpg")
+        String thumbnailUrl,
+
+        @Schema(description = "시설 종목 타입", example = "SOCCER")
+        FacilityType facilityType
+
+) {}

src/main/java/com/be/sportizebe/domain/facility/dto/request/FacilityCreateRequest.java

@@ -15,6 +15,9 @@ public class FacilityNearResponse {
     @Schema(description = "시설명", example = "수원종합운동장")
     private String facilityName;
 
+    @Schema(description = "도로명 주소", example = "경기도 수원시 팔달구 월드컵로 310")
+    private String address;
+
     @Schema(description = "소개", example = "수원시 대표 종합 스포츠 시설 (축구, 육상 등)")
     private String introduce;