나가요 ✈️
휴가는 정했고, 어디 가지? — https://nagayo.vercel.app
여행 기간과 원하는 날씨를 고르면, 그때 실제로 여행하기 좋은 해외 여행지를 추천해요.
"가서 망하지 않는 곳"이 핵심이라 기후(우기·태풍·폭염·짧은 해)와 외교부 여행경보로 걸러요.
실행
npm install
cp .env.example .env.local # 키 넣기 (없어도 돌아가요)
npm run dev # http://localhost:3000
| 환경변수 | 용도 | 없으면 |
|---|
DATA_GO_KR_KEY | 공공데이터포털 일반 인증키(Decoding). 외교부 여행경보·특별여행주의보 | data/alerts-snapshot.json(2026.10.25) 사용 |
GEMINI_API_KEY | Google AI Studio 키. 그 기간 실제 행사를 구글 검색으로 찾음 | 매년 반복되는 대표 행사만 표시 |
NEXT_PUBLIC_GA_ID | GA4 측정 ID (G-로 시작) | GA 안 붙음 |
GEMINI_MODEL | 선택. 기본 gemini-3.5-flash-lite, 더 정확하게는 gemini-3.8-flash | |
Vercel 배포
- GitHub에 올리고 Vercel에서 Import
- Settings → Environment Variables 에 위 키 입력
- Deploy
구조
app/page.tsx 서버: 여행경보 받아 도시별 단계로 변환(하루 캐시) → Planner
app/api/alerts 도시별 여행경보 JSON (하루 캐시)
app/api/festivals Gemini + 구글 검색 행사 조회 (도시×월 단위 7일 캐시)
components/Planner.tsx 화면 전체 (입력, 연휴 시트, 로딩, 탑승권, 공유 시트)
lib/climate.ts 추천 점수·탈락 규칙
lib/holidays.ts 공휴일, 연차 붙인 최장 연휴 계산
lib/alerts.ts 외교부 데이터 → 도시별 경보 매칭
lib/festivals.ts Gemini 호출
lib/share-image.ts 1080×1920 공유 탑승권 이미지 (캔버스)
data/cities.json 69개 도시 월별 기후(Open-Meteo ERA5 2021–2024), 공항코드, 이모지, 대표 행사
data/city-regions.ts 도시 → 경보 지역 매칭 키워드
scripts/check-logic.ts 추천 로직 회귀 테스트 (npm run check:logic)
공유하기
휴대폰에서는 브라우저 기본 공유(Web Share API)로 인스타그램 스토리·카카오톡·사진 저장을 바로 고를 수 있어요.
공유를 지원하지 않는 PC에서는 PNG로 저장돼요.
데이터 출처
- 기후: Open-Meteo Historical Weather API (ERA5), CC BY 4.0 — 무료는 비상업용. 수익화 전 유료 플랜 확인 필요
- 여행경보: 외교부 국가·지역별 여행경보, 특별여행주의보 (공공데이터포털, 이용허락범위 제한 없음)
- 행사: Gemini + Google 검색 결과. 사용 조건에 따라 출처와 "Google 검색 추천" 영역을 화면에 함께 표시
