JEJURO (개인 AI 맞춤 여행)

flowchart LR
	U["사용자 브라우저"] -->|HTTPS| W
	subgraph EC2["AWS EC2 · Docker Compose"]
		W["web<br>Nginx :443 + React"] -->|"/api, /oauth2"| A["api<br>Spring Boot :8080"]
		A --> D[("db<br>MySQL 8")]
		A --> AI["ai<br>FastAPI + CatBoost"]
	end
	A -.-> X["외부 연동<br>카카오모빌리티 · OAuth 3사<br>Open-Meteo · Gmail SMTP"]

@Transactional(isolation = Isolation.READ_COMMITTED)   // 여행 행 잠금 뒤 최신 데이터를 읽도록
public RouteDetailResponse save(Long routeId, Long userId, RouteSaveRequest req) {
    // 여행 행을 먼저 잠근다: 다른 탭의 저장·장소 빼기·일정 확정과 겹치지 않게 차례로 처리
    Travel travel = travelRepository.findOwnedByRouteForUpdate(routeId, userId)
            .orElseThrow(() -> ApiException.notFound("경로를 찾을 수 없습니다."));
    ...
    if (req.baseVersion() != null
            && !req.baseVersion().equals(version(route.getRouteName(), currentDays(routeId)))) {
        throw new ApiException(HttpStatus.CONFLICT,
                "다른 화면(탭)에서 이 경로가 먼저 바뀌었어요. 최신 경로를 불러온 뒤 다시 수정해 주세요.");
    }
    ...
}

# Spring으로 넘기는 경로: API, 소셜 로그인 시작·콜백
location ~ ^/(api|oauth2|login/oauth2)/ {
    proxy_pass http://api:8080;
}
# 나머지는 React 화면 (새로고침해도 index.html로)
location / { ... }

sequenceDiagram
	participant U as 화면
	participant S as Spring Boot
	participant DB as MySQL
	participant AI as FastAPI
	U->>S: 추천 요청
	S->>S: 여행별 잠금 (동시 요청 한 줄로)
	alt 이미 성공한 추천 있음
		S-->>U: 저장된 결과 반환
	else 처음 요청
		S->>DB: 설문 · 동반자 조회 (VIEW)
		alt 설문 미완료
			S-->>U: 409
		else 설문 완료
			S->>AI: POST /recommend (제외 목록, top_n 10)
			alt 시간 초과 · 형식 오류
				S->>DB: 실패 기록
				S-->>U: 502
			else 정상 응답
				AI-->>S: place_name 10개
				S->>S: 우리 관광지 ID로 연결
				alt 연결된 곳 0개
					S-->>U: 502 (매핑 장애)
				else 연결 성공
					S->>DB: 요청 · 결과 기록
					S-->>U: 추천 10곳
				end
			end
		end
	end