🕷️ FanPulse MVP 데이터 적재(4주) (Live/News)

원본 전체 문서: 크롤링.md

MVP는 “라이브 기능”을 위해 필요한 최소 적재 방식만 정의합니다.

1. MVP 원칙

• 4주 MVP에서 가장 큰 리스크는 “외부 API/크롤링 불안정”이므로,
  • 1차(MVP): seed(큐레이션) 기반으로 streaming_events, crawled_news를 채움
  • 2차(다음 릴리즈): YouTube/News API 등으로 자동 갱신 확장

1.1 용어 정리: streaming_events가 뭐야?

• streaming_events는 MVP에서 라이브 화면(H006/H019) 에서 보여줄 “라이브 방송(예정/진행/종료)”의 메타데이터를 담는 테이블입니다.
• 핵심은 임베드 재생 가능한 URL(stream_url) 을 저장해두고, 앱은 GET /live, GET /live/{id}로 이를 받아서 화면을 구성합니다.

참고: doc/mvp/mvp_데이터베이스_정의서.md의 streaming_events, doc/mvp/mvp_API_명세서.md의 GET /live/{id} 응답 필드(streamUrl)

1.2 MVP 크롤링(적재) 범위가 “작은” 이유

• MVP는 “크롤링 기술” 자체가 목표가 아니라, H001/H006/H019/H011에서 사용자에게 보여줄 데이터가 끊기지 않게 만드는 게 목표입니다.
• 그래서 4주 MVP에선 불안정/변동이 큰 자동 크롤링(셀레니움/플레이wright/다중 사이트 파싱) 대신,
  • 운영 가능한 seed(큐레이션) → DB upsert로 “항상 데이터가 있는 상태”를 먼저 보장합니다.
• 이 방향은 doc/mvp/mvp_기획서.md의 “seed 기반 적재” 결정과 동일합니다.

2. MVP 적재 방식(권장)

옵션 A: 수동 seed → DB 적재(가장 빠름)

• 운영자가 seed_live_events.json(또는 구글 시트 export) 형태로 이벤트를 관리
• 배포 시 또는 주기적으로 DB에 upsert