인라이튼드(Enlightened)

README excerpt

# 🎬 K-Pilgrimage Assistant (K-드라마 성지순례 도우미)

> **Gemini 해커톤 2026 제출작 - 구글 딥마인드 주최**  


<br/>

## 📌 1. 프로젝트 개요 (Overview)

**K-Pilgrimage Assistant**는 K-드라마 팬들을 위해 좋아하는 드라마 제목만 입력하면, **Gemini AI가 추천하는 주요 촬영지 및 1일 당일치기 투어 동선(Itinerary)을 자동으로 생성**해주는 지능형 큐레이션 서비스입니다.

복잡한 회원가입이나 여행 계획 수립 과정 없이, 검색 한 번으로 가장 직관적이고 시각적인 여행 루트를 제공하는 데 초점을 맞추었습니다.

<br/>

## ✨ 2. 주요 기능 및 특장점 (Key Features)

### 🌍 자동 다국어 번역 지원 (Zero-config i18n)
- **프론트엔드 Regex 감지**: 사용자가 검색어를 입력하는 즉시 언어를 빠르게 감지하여 **로딩 화면부터 해당 언어로 렌더링**됩니다.
- **백엔드 프롬프트 번역**: Gemini가 응답을 생성할 때, 모든 장소 데이터와 UI 텍스트(공유 버튼, 길찾기 버튼 등)를 감지된 언어로 직접 번역하여 JSON으로 내려줍니다. Gemini 모델이 언어를 파악하므로, Gemini가 가능한 모든 언어를 지원합니다.

### 🤖 AI 기반 다이내믹 동선 생성
- **Gemini 2.5 Flash** 모델을 활용하여, 드라마 제목만으로도 실제 존재하는 주요 촬영지(3~5곳)를 찾아냅니다.
- 거리와 이동 시간을 고려한 최적의 당일치기 스케줄(타임라인)과 각 장소에 대한 매력적인 설명을 반환합니다.

### 🗺️ 스마트 구글맵 알고리즘 적용
- 단순한 지도 표출을 넘어, AI가 반환한 모든 마커(Spot)들의 좌표(위도/경도)를 프론트엔드에서 계산합니다.
- `Google Maps LatLngBounds`를 활용하여 **모든 장소가 한 화면에 딱 맞게 들어오도록 자동 줌 인/아웃(fitBounds) 기능**을 구현해 사용자 피로도를 줄였습니다.

### 🎨 드라마 맞춤형 테마 컬러 UI
- AI가 해당 드라마의 분위기에 맞는 포인트 컬러(Hex 코드)를 내려주면, 검색 버튼, 로딩 스피너, 지도 아이콘, 공유 버튼 등의 테마가 동적으로 변경되어 시각적인 즐거움을 줍니다.

<br/>

## 🏆 3. 해커톤 룰 완벽 준수 (Hackathon Compliance)

본 프로젝트는 주어진 6시간 내에 작동하는 MVP를 만들기 위한 **"Speed Over Perfection"** 원칙을 엄격히 따랐습니다.

1. **DB 및 인증(Auth) 배제**: 복잡한 아키텍처를 과감히 생략하고오로지 프론트엔드 상태 관리(React State)와 AI 프롬프트 엔지니어링에 집중했습니다.
2. **완벽한 Error Fallback (앱 크래시 방지)**: 
   - 일시적인 API 트래픽 초과나 크레딧 고갈로 오류가 발생하더라도 앱이 죽지 않습니다!
   - 즉시 사전에 준비된 Mock Data("눈물의 여왕" 예시)