2026-09-17 현재 공개 API 8개 엔드포인트(2026-09-20에 GET /v1/places 추가)의 점검 결과 중, 코드만으로 고치지 않고 기록으로 남긴 항목이다. 각 항목은 팀 결정, 외부 승인, 또는 API 계약 변경이 필요하다.
관광지 원천 5개 재활성화: 2026-09-17 결정으로 다시 켰고, KTO_TATS↔TourAPI 매핑(app/normalization/place_crosswalk.py)을 구현했다. 이름이 같은 시도 안에서 유일하지 않거나 좌표가 1km 넘게 어긋나는 행은 매핑하지 않으므로 일부 관광지는hub,related_places가 계속 비어 있을 수 있다. 매핑률은 배포 후 운영 DB에서 확인한다.관광지 소개문(: 2026-09-17 결정으로 구현했다. essential 관광지의 소개문을 detailCommon2로 한 실행에 60곳씩 수집한다(무료 쿼터 1,000/일 안).overview)- 공지 번역과 요약:
ALERT_ENRICHMENT_BATCH_SIZE=0으로 신규 유료 LLM 보강이 꺼져 있다. 기존 DB에 저장된 번역과 요약은 계속 제공하며 대시보드에 AI 요약임을 표시한다. 시군구 방문 전망: 2026-09-17 결정. 지역 요청은 지역 내 관광지들의 공식 집중률 평균을official로 내고sample_count와basis로 근거를 밝힌다.시도 방문 전망: 2026-09-20 구현. 시도 요청은 소속 시군구 전체 관광지의 평균을 내며basis에 시군구·관광지 수를 표시한다. 시군구 집중률 수집이 약 11~12일 순환이므로 아직 수집되지 않은 시군구는 평균에서 빠진다.트렌드의 KTO 관광자원 수요: 관측이 있으면 기본 응답에 포함된다. 2026-09-17 DB에서 확인된 키워드는관광서비스수요와문화자연자원 수요다.area_code필터도 지원한다.- 대시보드 파라미터: 지역 비교에
compare=previous_period를 연결했다. 추천 전용 조건과 화면은 삭제했다.
| 엔드포인트 | 필드 | 상태 |
|---|---|---|
| trends, inbound | instagram / facebook / reddit 블록, sns_mentions |
어댑터 없음, 외부 승인 필요 |
| trends | destination_searches |
어떤 원천도 연결되지 않음 |
| regions/insights | demand.avg_stay_nights, diversity.age_index |
KTO 원천에 대응 지표 없음. 가용성 판정에서는 제외 |
| visitors/timeseries | concentration_rate, attraction_name 경로 |
작성 경로 없음, SRC_TOURISM_ADMISSION은 HTTP 전용이라 어댑터가 unavailable |
| forecasts/visitors | expected_visitors, confidence, adjustment_factors |
공식 원천이 없으면 null. 과거 실적 대체와 임의 보정 로직 제거 |
| markets/inbound | social_interest.youtube.score, inbound_score |
YouTube는 설계상 국가 신호에서 제외. passengers는 2026-09-17 인천공항 국가별 여객 오퍼레이션(getTotalNumberOfPassenger)을 추가해 수집한다 |
| markets/{country}/alerts | source_scope=local, status=inactive, source_type=foreign_affairs |
현지 기관 수집기 없음, 비활성 문서는 삭제되므로 도달 불가 |
결정(2026-09-17): 검증 가능한 추천 근거가 부족하여 사용자 승인으로 여행지 추천 API와 화면을 삭제했다. 나머지 API는 수집 근거가 없는 응답값을 제공하지 않는다. 고정 seed와 임의 가중 점수를 제거하며 과거 실적을 미래 전망으로 대체하지 않는다.
- passengers: 인천공항 국가별 항공통계 서비스(B551177/AviationStatsByCountry)의
getTotalNumberOfPassenger가 국가별 월간 도착 및 출발 여객 수를 제공한다(2026-07 기준 57개국, 라이브 확인). 같은 서비스 키로 되며 수집을 추가했다. - avg_stay_nights, age_index: 관광공사 데이터랩 공개 API(AreaTarDemDsService, AreaTarDivService)는 관광체류강도 및 관광소비강도 및 관광객 다양성 및 소비 다양성 및 국제적 다양성 지수만 준다. 숙박일수와 연령 구성은 데이터랩 웹에만 있고 오픈 API에는 없다. 원천 없음 유지.
- concentration_rate(시계열), expected_visitors, confidence: 공개 원천 없음.
- search_ratio: 2026-09-17 NAVER 검색 트렌드(NCP API Hub)를 켰다. 외국어 시장 키워드에는 데이터가 없어 한국어 지역 여행 키워드 18개("서울 여행" 등)를 하루 5개씩 순환 수집한다. 운영에서 켜지려면
.ops/.env에NAVER_STORAGE_POLICY_APPROVED=true가 있어야 한다(저장 및 재게시 권리 확인 플래그). - destination_searches: 절대 검색 수는 어떤 원천도 주지 않는다.
- 축제(
SRC_FESTIVAL) 격리 50행: 종료일이 시작일보다 앞서거나 주소가 여러 지역에 걸치는 원천 데이터다. 코드가 추측하지 않고 제외한 것이며 버그가 아니다. - 10개 비활성 SNS 원천이 주기마다 0건 실행 기록(
ingestion_run)을 남긴다. 무해하지만 노이즈다.
- 6055a3e에서 soak 필수 서비스와
eden-scheduler.service의존성에서mariadb.service를 뺐다. 2026-09-17에 옮긴 새 VPS도 MariaDB가 같은 호스트에 있다. 부팅 순서는Restart=always가 흡수하지만 soak 증거는 더 이상 MariaDB 재시작을 잡지 않는다. - 2026-09-17 배포(release
20260917T014213Z) 직후 확인: 다시 켠 원천 5개 실행 성공, 허브 및 연관 매핑 첫 배치 870곳. NAVER 및 소개문 및 여객 수 및 대사관 공지는 각 원천의 다음 실행(같은 날 오후 및 저녁) 이후 채워진다.