fix: PR review 반영

Author: pooreumjung

CLAUDE.md

@@ -24,7 +24,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ### Package Structure
 
-```
+```text
 com.semosan.api
 ├── common/          # 공통 인프라 (응답, 예외, JWT, 설정, FCM, 알림 공통)
 └── domain/          # 도메인별 비즈니스 로직
@@ -108,7 +108,7 @@ prod에서 필요한 주요 변수: `DB_URL`, `DB_USERNAME`, `DB_PASSWORD`, `RED
 ## Branch & Commit Convention
 
 브랜치명:
-```
+```text
 feat/#이슈번호-기능명
 fix/#이슈번호-버그명
 ```

src/main/java/com/semosan/api/domain/tracking/controller/docs/TrackingControllerDocs.java

@@ -58,6 +58,11 @@ ResponseEntity<ApiResponse<NearbyMountainResponse>> getNearbyMountain(
                     responseCode = "404",
                     description = "코스를 찾을 수 없음",
                     content = @Content(schema = @Schema(implementation = ApiResponse.class))
+            ),
+            @io.swagger.v3.oas.annotations.responses.ApiResponse(
+                    responseCode = "422",
+                    description = "코스 경로 좌표가 등록되지 않음",
+                    content = @Content(schema = @Schema(implementation = ApiResponse.class))
             )
     })
     ResponseEntity<ApiResponse<LiveActivityCourseResponse>> getLiveActivityCourse(

src/main/java/com/semosan/api/domain/tracking/service/TrackingSessionService.java

@@ -20,6 +20,7 @@
 import com.semosan.api.domain.user.service.UserReader;
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
+import org.hibernate.exception.ConstraintViolationException;
 import org.springframework.context.ApplicationEventPublisher;
 import org.springframework.dao.DataIntegrityViolationException;
 import org.springframework.stereotype.Service;
@@ -33,6 +34,8 @@
 @Transactional(readOnly = true)
 public class TrackingSessionService {
 
+    private static final String ACTIVE_SESSION_UNIQUE_INDEX = "uq_tracking_sessions_user_active";
+
     private final TrackingSessionRepository trackingSessionRepository;
     private final MountainRepository mountainRepository;
     private final CourseRepository courseRepository;
@@ -153,7 +156,26 @@ private TrackingSession saveSession(TrackingSession session) {
         try {
             return trackingSessionRepository.save(session);
         } catch (DataIntegrityViolationException e) {
-            throw new GeneralException(ErrorStatus.TRACKING_SESSION_ALREADY_IN_PROGRESS);
+            if (isActiveSessionUniqueViolation(e)) {
+                throw new GeneralException(ErrorStatus.TRACKING_SESSION_ALREADY_IN_PROGRESS);
+            }
+            throw e;
+        }
+    }
+
+    private boolean isActiveSessionUniqueViolation(Throwable exception) {
+        Throwable current = exception;
+        while (current != null) {
+            if (current instanceof ConstraintViolationException constraintViolation
+                    && ACTIVE_SESSION_UNIQUE_INDEX.equals(constraintViolation.getConstraintName())) {
+                return true;
+            }
+            String message = current.getMessage();
+            if (message != null && message.contains(ACTIVE_SESSION_UNIQUE_INDEX)) {
+                return true;
+            }
+            current = current.getCause();
         }
+        return false;
     }
 }

src/main/resources/db/migration/V16__add_tracking_session_active_unique_index.sql

@@ -1,5 +1,24 @@
 -- 유저당 활성 트래킹 세션(IN_PROGRESS/PAUSED)은 1개만 허용한다.
 -- 애플리케이션의 exists -> save 검증만으로는 동시 생성 요청을 막을 수 없어서 DB 제약으로 보강한다.
+-- 기존 중복 데이터가 있으면 사용자별 최신 활성 세션 1건만 유지하고 나머지는 ABANDONED 처리한다.
+WITH ranked_active_sessions AS (
+    SELECT
+        id,
+        ROW_NUMBER() OVER (
+            PARTITION BY user_id
+            ORDER BY started_at DESC, id DESC
+        ) AS row_number
+    FROM tracking_sessions
+    WHERE status IN ('IN_PROGRESS', 'PAUSED')
+)
+UPDATE tracking_sessions ts
+SET status = 'ABANDONED',
+    ended_at = COALESCE(ts.ended_at, now()),
+    updated_at = now()
+FROM ranked_active_sessions ras
+WHERE ts.id = ras.id
+  AND ras.row_number > 1;
+
 CREATE UNIQUE INDEX IF NOT EXISTS uq_tracking_sessions_user_active
     ON tracking_sessions (user_id)
     WHERE status IN ('IN_PROGRESS', 'PAUSED');