Merge branch 'develop' into feature/#35-API-Response

Author: rimeir

backend/build.gradle

@@ -54,6 +54,9 @@ dependencies {
 	testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
 	testImplementation 'com.h2database:h2' //테스트 환경 h2 DB
 	testImplementation 'org.assertj:assertj-core:3.24.2' //테스트 검증을 위한 AssertJ 라이브러리
+
+	implementation 'org.springframework.boot:spring-boot-starter-actuator' // Actuator 기능으로 서버 및 애플리케이션 상태 확인
+	runtimeOnly 'mysql:mysql-connector-java:8.0.33'
 }
 
 tasks.named('test') {

backend/src/main/java/com/postdm/backend/global/config/SecurityConfig.java

@@ -49,6 +49,9 @@ public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
                         .requestMatchers("/api/v1/auth/**").permitAll() // /api/v1/auth로 시작하는 경로는 모두 허용(회원가입, 로그인 등)
                         .requestMatchers("/api/v1/email/**").permitAll()
                         .requestMatchers("/api/v1/member/**").permitAll()
+                        .requestMatchers("/api/v1/ping**").permitAll() // /ping api 모두 허용
+                        .requestMatchers("/actuator/health").hasRole("ADMIN") // Actuator 헬스 체크 결과는 관리자만 접근 가능
+                        .requestMatchers("/actuator/**").denyAll() // 다른 Actuator 엔드포인트는 차단
                         .requestMatchers("/api/v1/estimates/**").hasAnyRole("MEMBER", "ADMIN") // 견적서 API는 MEMBER와 ADMIN만 접근 가능
                         .anyRequest().authenticated() // 이외의 경로는 인증을 필요로함.
                 );

backend/src/main/java/com/postdm/backend/global/controller/PingController.java

@@ -0,0 +1,25 @@
+package com.postdm.backend.global.controller;
+
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.responses.ApiResponse;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.Collections;
+import java.util.Map;
+
+@RestController
+@Tag(name = "Ping Check", description = "단순 서버 연결 상태 확인 API")
+@RequestMapping("/api/v1")
+public class PingController {
+
+    @Operation(summary = "서버 상태 체크", description = "서버가 정상적으로 동작하는지 확인하는 API입니다.")
+    @ApiResponse(responseCode = "200", description = "서버 정상 작동. 응답: text/plain (pong)")
+    @GetMapping("/ping")
+    public ResponseEntity<Map<String, String>> ping() {
+        return ResponseEntity.ok(Collections.singletonMap("message", "pong"));
+    }
+}

backend/src/main/resources/application.yml

@@ -18,4 +18,9 @@ springdoc:
       enabled: true
   cache:
     disabled: true
-  override-with-generic-response: false
+  override-with-generic-response: false
+
+management:
+  endpoint:
+    health:
+      show-details: when_authorized