한적한 날 (hanjeok)

가려는 곳, 언제 가면 덜 붐빌까? 한국관광 데이터랩의 향후 30일간 지역 집중률을 전국 시군구 단위로 모아 덜 붐비는 날과, 같은 날 덜 붐비는 비슷한 여행지(데이터랩 유사지역)를 보여주는 웹서비스입니다.

• 지역 보기 /r/<시군구코드> — 30일 물때표, 이번·다음 주말 중 한적한 날, 유사지역 비교, 인기관광지, 강수확률
• 날짜 보기 /d/ — 날짜 하나에서 전국·시도별 한적한 순위
• 임베드 /embed.html?sgg=<코드> — 지자체·관광지 누리집용 7일 혼잡 예보

데이터

모든 데이터랩 값은 한국관광 데이터랩 공식 「데이터 다운로드」 파일(회원 로그인 후 각 시군구 화면의 다운로드 버튼)에서만 읽습니다. 데이터랩 회원 로그인 후 각 시군구 화면의 공식 「데이터 다운로드」 버튼을 직접 눌러 받은 파일만 씁니다. 2026-09-29 16시 기준 「데이터 준비 중」(일괄 다운로드 파일은 주최 안내에 따라 내림).

원천	쓰는 값
데이터랩 공식 다운로드 — 향후 30일간 지역 집중률	일별 지수 0~100(전년도 전체 지역 평균·표준편차 기반 누적분포확률)
데이터랩 공식 다운로드 — AI 관광 분석(유사지역)	유사지역 이름(점수 없음) → 지역 코드 대조
데이터랩 공식 다운로드 — 인기관광지(전체)	순위·관광지명·분류(검색건수 없음)
기상청 단기예보 조회서비스(공공데이터포털 오픈API)	날짜별 강수확률 최고값·강수 여부
통계청 SGIS 행정경계(vuski/admdongkor, CC BY 4.0)	시군구 대표점 → 기상청 격자

다운로드 파일에 없는 값(예측 방문자 수·유사도 점수·검색건수)은 쓰지 않습니다.

개발

npm test                                  # 도메인·유스케이스·어댑터·레이어 테스트
npm run from-downloads <다운로드 폴더>      # 공식 다운로드 zip → public/data/snapshot.json·effect.json
npm run weather                           # 기상청 강수확률만 갱신(KMA_SERVICE_KEY)
npm run build                             # src/domain → public/domain 복사
node tools/dev-server.js                  # http://127.0.0.1:4173 (vercel.json rewrites 흉내)

다운로드 폴더: <코드>_1282.zip(집중률) · <코드>_1205.zip(AI 관광 분석) · <코드>_1211.zip(인기관광지) · regions.json · manifest.json. 구조: src/domain ← src/application ← src/adapters ← src/infrastructure (SPEC.md §7).

변경 이력

• 2026-09-29 v0.2: 데이터랩 원자료를 공식 「데이터 다운로드」 파일로 전환. v0.1(9/24~9/29 오전)은 데이터랩 화면이 쓰는 조회 경로를 GitHub Actions로 하루 1회 호출했습니다. 데이터랩 고지(「공식 제공되는 다운로드 이외의 방법에 의한 무단 수집이 금지」)와 경진대회 사무국 안내에 따라 9/29 일일 자동 수집을 중단하고(워크플로 비활성화), 수집 코드·수집 스냅샷을 삭제했습니다. 이후 데이터랩 값은 공식 다운로드 파일에서만 읽습니다.

• 2026-09-29 16:2x — 주최 회신(9/29 15:52: 「자동 실행으로 받은 파일은 이번 출품에 사용하지 마시고, 직접 버튼을 눌러 다운로드한 지역의 데이터만 활용」)에 따라 일괄 다운로드로 만든 스냅샷을 배포에서 내림. 사이트는 「데이터 준비 중」 상태이며, 직접 받은 공식 다운로드 파일로 교체한다. 자동 수집·자동 다운로드 워크플로는 모두 꺼짐(daily-collect·weather-refresh disabled).