| name | k-parent-culture-center-events |
| description | 대한민국 부모가 문화센터·도서관·지자체 강좌와 체험 프로그램을 찾을 때 쓰는 스킬. 서울 공공서비스예약·도서관정보나루·문화포털(packages/k-parent-source-seoul/library/culture)로 지역·연령·접수기간 기준으로 안내한다. "백화점 문화센터 강좌", "도서관 프로그램 신청", "주말 체험 강좌 찾아줘" 같은 요청에 사용. 접수기간이 있는 강좌·체험·예약형 전용이며, 야외 놀거리는 k-parent-play-finder, 축제는 k-parent-festival-finder. 예약·결제는 사용자 승인 전에는 실행하지 않습니다. |
문화센터 이벤트 도우미
개요
부모가 자녀와 함께 갈 수 있는 문화 강좌·체험·공연/전시를 한 번에 찾아 줍니다.
서울 공공서비스예약(강좌/체험/시설예약), 도서관 정보, 문화포털 공연전시정보를
모아 지역·연령·기간으로 필터링하고 비용/대상연령/접수기간/예약상태/예약링크를
정리해 안내합니다.
사용하는 패키지
k-parent-source-seoul — fetchReservations(options), parseReservations(payload, options),
RESERVATION_SERVICES (ListPublicReservationCulture / ListPublicReservationEducation /
ListPublicReservationSport). 강좌·체험·시설예약 정보.k-parent-source-library — fetchLibraries(options), parseLibraries(payload).
지역(region, dtl_region) 도서관 위치·연락처·홈페이지.k-parent-source-culture — fetchCultureEvents(options), parseCultureEvents(payload).
공연/전시 정보.
환경 변수
KSKILL_SEOUL_KEY — 서울 열린데이터광장 인증키KSKILL_LIBRARY_KEY — 도서관정보나루 인증키KSKILL_CULTURE_KEY — 문화포털 서비스키
흐름
- 사용자에게 지역, 자녀 연령, 원하는 기간을 확인한다.
fetchReservations를 세 reservation service에 대해 호출하고
fetchCultureEvents, fetchLibraries로 보조 정보를 수집한다.- 각
parse* 함수로 정규화한다.
- 지역(
areaName/area), 대상연령(useTarget), 기간(rcptBgnDt/rcptEndDt,
startDate/endDate)으로 필터링한다.
- 비용·대상연령·접수기간·예약상태·예약링크를 표로 정리해 안내한다.
데이터 계약 (data contract)
서울 예약(envelope: payload[SERVICE].row, RESULT.CODE)는 다음 형태로 정규화됩니다.
{
"items": [
{
"institution": { "name": "서울시립미술관", "region": "중구" },
"svcId": "S240101",
"svcName": "어린이 도자기 체험",
"place": "서울시립미술관",
"areaName": "중구",
"useTarget": "만 5세 이상",
"svcStatus": "접수중",
"rcptBgnDt": "2026-05-01 09:00:00.0",
"rcptEndDt": "2026-06-30 18:00:00.0",
"svcUrl": "https://yeyak.seoul.go.kr/...",
"x": "126.9779",
"y": "37.5663"
}
],
"metadata": { "source": "SeoulOpenData", "fetched_at": null },
"resultCode": "INFO-000"
}
공연/전시(envelope: response.msgBody.perforList)는 title, place, startDate,
endDate, area, genre, url, image, charge로 정규화됩니다.
도서관(envelope: response.libs[].lib)은 libCode, libName, address, tel,
homepage, latitude, longitude로 정규화됩니다.
신선도 (freshness)
metadata.fetched_at을 k-parent-core의 isFresh로 검사해 오래된 결과는 갱신 후
안내합니다. 접수기간이 지난 항목은 svcStatus(예: 접수마감)와 함께 표시합니다.
가드레일
예약·결제·로그인·취소는 승인이 필요한 작업입니다. 정보 조회·정리까지만 자동으로
수행하고, 예약 진행/결제는 k-parent-core의 assertApproved로 사용자 승인을 확인하기
전에는 실행하지 않습니다. 예약링크(svcUrl/url)는 안내만 합니다.
