DURUDURU (두루두루)
사용자가 목적지를 먼저 정하지 않아도 되는 국내 여행 추천 서비스입니다. 출발지와 정확한 출발·복귀 시간, 이동수단, 관심사를 입력하면 주어진 시간 안에 갈 수 있는 목적지부터 추천하고, 선택한 지역의 일정을 만듭니다.
기존 여행 플래너가 “경주에 가는데 무엇을 할까?”를 돕는다면, DURUDURU는 “이번 주말 이 시간에 어디를 다녀올 수 있을까?”를 먼저 해결합니다.
현재 상태
현재는 기능 구현을 진행하는 MVP 단계입니다. 서비스 정의와 기능 요구사항은 아래 문서를 기준으로 합니다.
주요 사용자 흐름
- 출발지, 출발·복귀 일시, 이동수단, 관심사를 입력합니다.
- 전체 가용시간에서 왕복 예상 이동시간과 복귀 버퍼를 뺀 시간으로 목적지 후보를 걸러 점수순으로 보여 줍니다.
- 후보마다 추천 이유, 왕복 예상 이동시간, 현지 이용 가능 시간을 함께 표시합니다.
- 후보를 선택하면 운영시간·휴무·체류시간·이동·식사와 복귀 조건을 반영한 일정을 확인합니다.
- 여행 기간과 지역·관심사가 맞는 축제가 있으면 일정에 반영합니다.
이동시간은 실시간 정보가 아닌 평균·추정치이며, 결과에는 추정과 데이터 결측을 구분해 표시합니다.
기술 스택
- Next.js 16 (App Router), React 19, TypeScript 6
- TanStack Query, Axios, Zustand
- Tailwind CSS 4
- ESLint 9 +
eslint-config-next
- Jest + React Testing Library, Playwright
- 별도 백엔드·DB 없음
프로젝트 구조
app/ # App Router 화면
lib/ # 추천·일정 도메인 로직과 데이터
e2e/ # Playwright 화면 점검
scripts/ # 점검·작업 사이클 스크립트
docs/product/ # 여행 장소 추천·거리 계산 방법
docs/agent/ # 에이전트 공통 규칙
.env.local.example # TourAPI 점검용 환경변수 예시
파일 단위 구성은 개발 중 바뀌므로 여기에 옮겨 적지 않습니다.
로컬 실행
요구 사항: Node.js와 npm
npm install
npm run dev
브라우저에서 http://localhost:3000을 엽니다.
환경변수와 TourAPI 점검
앱을 실행하는 데 API 키는 필요 없습니다. 다만 한국관광공사 TourAPI의 실제 응답을 조사하는 스크립트에는 서비스 키가 필요합니다.
- 공공데이터포털에서 한국관광공사 국문 관광정보 서비스_GW를 활용 신청합니다.
.env.local.example을 .env.local로 복사합니다.TOUR_API_SERVICE_KEY에 발급받은 서비스 키를 넣습니다. .env.local은 저장소에 커밋하지 않습니다.- 다음 명령으로 경주·공주·강릉의 관광지/문화시설과 축제 응답, 주소·좌표·운영정보 필드의 충족 여부를 확인합니다.
npm run check:tour-api
스크립트는 TourAPI v4.4의 법정동 코드(lDongRegnCd, lDongSignguCd)로 조회합니다. 서비스 키는 스크립트에서 URL 인코딩을 처리하므로 인코딩 키와 디코딩 키 모두 입력할 수 있습니다.
