chore/#122 -> staging merge commit

Co-authored-by: darren <darren@darrenui-MacBookPro.local>

Author: Darren4641

src/main/kotlin/com/yapp2app/auth/infra/oauth/OidcTokenValidator.kt

@@ -42,12 +42,10 @@ class OidcTokenValidator(
             // 1차 시도: 캐시된 공개키로 토큰 검증
             validateTokenWithPublicKeys(idToken, oidcAdapter, oauthHelperAdapter, platform)
         } catch (e: BusinessException) {
-            log.info("Kakao OIDC token expired. 갱신 로직")
             // 캐시 무효화 후 재시도
             authRedisCacheAdapter.clearPublicKeys(AuthCacheKeys.KAKAO_OIDC_KEY)
             validateTokenWithPublicKeys(idToken, oidcAdapter, oauthHelperAdapter, platform)
         } catch (e: Exception) {
-            e.printStackTrace() // TODO 인증 실패 예외 로그 모니터링용
             throw e
         }
     }

src/main/kotlin/com/yapp2app/auth/infra/oauth/oidc/KakaoOidc.kt

@@ -41,7 +41,6 @@ class KakaoOidc(
         val cached = authRedisCacheAdapter.getPublicKeys(AuthCacheKeys.KAKAO_OIDC_KEY)
 
         if (cached != null) {
-            log.info("Found cached OIDC key") // TODO 임시 코드
             return cached
         }
 

src/main/kotlin/com/yapp2app/common/exception/handler/ExceptionHandler.kt

@@ -30,7 +30,7 @@ class ExceptionHandler {
 
     @ExceptionHandler(BusinessException::class)
     fun businessExceptionHandler(ex: BusinessException): ResponseEntity<ExceptionMsg> {
-        log.error("{} message = {}", ex.resultCode.code, ex.resultCode.message)
+        log.error("[BUSINESS_ERROR] code={} | message={}", ex.resultCode.code, ex.resultCode.message)
 
         if (ex.resultCode == ResultCode.INVALID_TOKEN_ERROR) {
             return ResponseEntity(
@@ -55,7 +55,7 @@ class ExceptionHandler {
 
     @ExceptionHandler(Exception::class)
     fun exceptionHandler(ex: Exception): ResponseEntity<ExceptionMsg> {
-        log.error("No Handler ex message = {}", ex)
+        log.error("[SYSTEM_ERROR] unhandled exception", ex)
 
         val temp = ResponseEntity(
             ExceptionMsg(

src/main/kotlin/com/yapp2app/common/filter/RequestLoggingFilter.kt

@@ -0,0 +1,53 @@
+package com.yapp2app.common.filter
+
+import jakarta.servlet.FilterChain
+import jakarta.servlet.http.HttpServletRequest
+import jakarta.servlet.http.HttpServletResponse
+import org.slf4j.LoggerFactory
+import org.slf4j.MDC
+import org.springframework.web.filter.OncePerRequestFilter
+
+/**
+ * API 요청의 수명주기(응답 시간, 상태 코드)를 로깅하는 필터.
+ * RequestMdcFilter 이후에 실행되어 MDC 컨텍스트(requestId, userId)를 활용한다.
+ *
+ * JSON 로그: message는 간결하게, 상세 정보는 MDC 필드(durationMs, responseStatus, logCategory)로 분리.
+ * 콘솔 로그: [API_REQUEST] POST /api/auth/kakao/login | status=200 | duration=342ms
+ */
+class RequestLoggingFilter : OncePerRequestFilter() {
+
+    private val log = LoggerFactory.getLogger(javaClass)
+
+    override fun doFilterInternal(
+        request: HttpServletRequest,
+        response: HttpServletResponse,
+        filterChain: FilterChain,
+    ) {
+        val startTime = System.currentTimeMillis()
+
+        try {
+            filterChain.doFilter(request, response)
+        } finally {
+            val duration = System.currentTimeMillis() - startTime
+            val status = response.status
+
+            MDC.put("logCategory", "API_REQUEST")
+            MDC.put("durationMs", duration.toString())
+            MDC.put("responseStatus", status.toString())
+
+            log.info("[API_REQUEST]")
+
+            MDC.remove("logCategory")
+            MDC.remove("durationMs")
+            MDC.remove("responseStatus")
+        }
+    }
+
+    override fun shouldNotFilter(request: HttpServletRequest): Boolean {
+        val uri = request.requestURI
+        return uri.startsWith("/actuator") ||
+            uri.startsWith("/swagger-ui") ||
+            uri.startsWith("/v3/api-docs") ||
+            uri.startsWith("/file")
+    }
+}

src/main/kotlin/com/yapp2app/common/filter/ServletFilterConfig.kt

@@ -19,6 +19,15 @@ class ServletFilterConfig {
 
     @Bean
     fun requestMdcFilterRegistration(filter: RequestMdcFilter): FilterRegistrationBean<RequestMdcFilter> =
+        FilterRegistrationBean(filter).apply {
+            order = SecurityProperties.DEFAULT_FILTER_ORDER - 2
+        }
+
+    @Bean
+    fun requestLoggingFilter(): RequestLoggingFilter = RequestLoggingFilter()
+
+    @Bean
+    fun requestLoggingFilterRegistration(filter: RequestLoggingFilter): FilterRegistrationBean<RequestLoggingFilter> =
         FilterRegistrationBean(filter).apply {
             order = SecurityProperties.DEFAULT_FILTER_ORDER - 1
         }

src/main/resources/logback-spring.xml

@@ -27,6 +27,9 @@
             <includeMdcKeyName>requestMethod</includeMdcKeyName>
             <includeMdcKeyName>requestUri</includeMdcKeyName>
             <includeMdcKeyName>clientIp</includeMdcKeyName>
+            <includeMdcKeyName>logCategory</includeMdcKeyName>
+            <includeMdcKeyName>durationMs</includeMdcKeyName>
+            <includeMdcKeyName>responseStatus</includeMdcKeyName>
 
             <!-- 기본 필드명 커스터마이징 -->
             <fieldNames>