docs: 한국문화정보원 전시 동기화와 KOPIS 제목 정리 기록

place-db.md §12.1 에 지역 꼬리표 제거 규칙, §12.2 에 전시 동기화 순서·중복 판단·이미지 보류를 적었다.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-11-03 23:02:16 +09:00
parent 175e2d454b
commit 7e59ac0205
2 changed files with 17 additions and 4 deletions
+16 -3
View File
@@ -419,8 +419,21 @@ node dist/commands/place-sync.js tour-kor
- '이번 주말'은 기간이 겹치는지만 본다. 평일만 하는 공연도 섞인다(`dtguidance` 요일 해석은 나중에).
- 기간이 60일 넘는 공연(대구 8건)은 상시 프로그램 규칙으로 목록에서 빠진다.
### 12.2 다음 출처
### 12.2 한국문화정보원 전시 (구현됨)
- **전시: 한국문화정보원 한눈에보는문화정보**(15138937). 진단 결과 앞으로 90일 대구 42건(전시 13 · 음악/콘서트 17 …), 경북 17건(전시 1)이다. 좌표 채움 38/42.
공연은 KOPIS 와 겹치므로 **전시(realm 전시)만** 받을 계획이다. 이미지 이용 조건은 아직 확인하지 않았다(조사 문서 4장 4번).
**동기화** `place:sync -- kcisa [--regions=27,47] [--days=90]` (매일, 공공데이터포털 키 — 15138937 활용신청 필요)
- 진단(2026-11-03): 앞으로 90일 대구 42건(전시 13 · 음악/콘서트 17 …), 경북 17건(전시 1). 좌표 채움 대구 38/42.
- 순서(`sync/kcisa.sync.ts`)
1. **목록** `area2`(sido=대구·경북, from·to). **분야가 '전시'인 것만** 넣는다 — 공연은 KOPIS 와 겹친다.
관광공사·KOPIS 에 이름 비교 키(`event-name.ts`, 괄호·문장부호·공백 제거)가 같고 기간이 겹치는 행사가 있으면 넣지 않는다.
목록을 끝까지 받았으면 받은 기간 안에서 이번에 넣지 않은 전시를 숨긴다(원본 장애 판단은 §4.1).
2. **상세** `detail2` — 새 전시와 상세를 받은 지 7일 지난 전시만(원본에 수정일이 없다). 요금 `price`, 소개 `contents1`, 전화, 주소 `placeAddr`, 안내 링크 `url`.
- 좌표는 목록에 있다(`gpsY` 위도 · `gpsX` 경도). 지역의 시·도 영역 밖이면 버린다.
- 제목에 `&amp;lsquo;` 처럼 한 번 더 인코딩된 문자가 온다 → `htmlToText` 가 따옴표·가운뎃점·번호 엔티티까지 푼다.
- **이미지는 저장하지 않는다.** 문화공공데이터광장 저작권정책상 공공누리 1유형이 아니면 사전 협의가 필요한데 아직 확인하지 않았다
(조사 문서 4장 4번). 확인되면 `kcisa-mapper.ts` 에서 `thumbnail`·`imgUrl` 을 넣고 다시 실행한다.
- 전시는 몇 달씩 하므로 상시 프로그램 상한이 183일이다(§2.4). 1년짜리 상설 전시는 목록에서 빠진다.
- 출처 표기: "한국문화정보원 문화포털". 호출: 대구·경북 하루 20회 안팎(개발 계정 10,000/일).
- 검증: `backend/test/kcisa-sync.e2e-spec.ts` — 전시만 넣기 · 다른 출처 중복 건너뛰기 · 상세 · 빈 목록이면 숨기지 않기 · 없어진 전시 숨기기.