wooz-trip (여행 루트 서비스, 가칭 "우즈트립")

검증된 제주 장소를 시간대 슬롯에 넣으면 이동 동선과 타임라인이 자동으로 그려지는 가족 여행 루트 서비스.

• 개발 지침: CLAUDE.md · 기술 관례: docs/conventions.md · 기획서: docs/planning.md
• 스택: Next.js 15 (App Router, JS) · 공용 Supabase (wooz_trip_ 프리픽스) · Vercel

처음 실행

1. Supabase SQL 실행 → supabase/README.md
2. .env.local 준비 (.env.example 참고 — Supabase 값은 toto와 같다)
3. npm install → npm run dev → http://localhost:3000

npm test              # 계산 로직 단위 테스트
npm run build         # 빌드 + 린트
npm run routes:sql    # AI 루트 JSON 검사 → SQL 생성 (docs/ai-routes.md)

배포 (Vercel)

GitHub jeyounge/wooz-trip 의 main 에 올리면 Vercel 이 자동 배포한다 (처음 한 번만 연결).

1. vercel.com/new → GitHub wooz-trip 저장소 Import (Framework: Next.js, 설정 그대로)
2. Environment Variables 에 .env.vercel.local 내용을 붙여 넣기 (로컬에만 있는 파일, 커밋 안 됨)
   • 필요한 키: NEXT_PUBLIC_SUPABASE_URL, NEXT_PUBLIC_SUPABASE_ANON_KEY, SUPABASE_SERVICE_ROLE_KEY, ADMIN_EMAIL, NEXT_PUBLIC_KAKAO_MAP_KEY(선택), NEXT_PUBLIC_SERVICE_NAME(선택)
   • TourAPI·카카오 REST 키는 넣지 않는다 (수집은 로컬 PC 스케줄러에서만 돈다)
3. Deploy → 나온 주소(*.vercel.app)를
   • Supabase → Authentication → URL Configuration → Redirect URLs 에 https://<주소>/** 추가
   • 카카오 개발자센터 → 앱 → 플랫폼 → Web 사이트 도메인에 https://<주소> 추가 (카카오맵)

AI 초안

서비스는 LLM API를 부르지 않는다. 운영자가 LLM으로 미리 만든 루트(data/ai-routes/*.json)를 DB에 넣어 두고, "AI 초안"을 누르면 조건에 맞는 루트를 꺼내 내 날짜 기준으로 휴무·영업시간을 다시 검사해 넣는다. 루트 추가 방법과 LLM 프롬프트는 docs/ai-routes.md.

실데이터 (장소)

한국관광공사 TourAPI로 전국 장소 후보를 매일 자동 수집·DB 반영하고(LLM 호출 없음) /admin에서 승인한다. 계획: docs/data-plan.md · 명령: docs/real-data.md.

화면

경로	화면
/	S01 홈 (동행 유형별 인기 루트)
/trips/new	S02 여행 정보 입력
/trips/:id/edit	S03 루트 짜기 + S04 장소 선택 바텀시트
/trips/:id	S05 루트 결과 (지도 동선·타임라인·공유·공개)
/routes, /routes/:id	둘러보기 목록, S06 공개 루트 상세 + 내 일정으로 복사
/s/:shareId	가족 공유 링크 (읽기 전용, 로그인 불필요)
/trips, /my, /login	내 여행, 마이, 로그인
/admin	운영자: 장소 검수 · 제보 처리 · AI 루트 켜기/끄기 · 지표