🛠 운영 · 복구 가이드

새 방송 데이터를 반영하거나, 노트북을 포맷한 뒤 0부터 되살릴 때 이 순서대로 따라 하세요. 이 페이지는 항상 배포된 사이트에서 열 수 있습니다.

한눈에 포맷된 PC → A. 환경 복구(클론·설치·키) → bash admin.sh → B. 로컬 관리자 4버튼으로 업데이트 → Cloudflare Pages 배포

A. 포맷된 PC에서 0부터 복구

사전 도구 설치 (macOS 기준 — Homebrew)
brew install node python ffmpeg yt-dlp gh
전사(mlx-whisper)는 Apple Silicon 맥에서만 동작합니다. Windows/Linux는 setup.sh가 faster-whisper로 자동 전환합니다.
GitHub 로그인 후 저장소 클론 (비공개 repo)
gh auth login git clone https://github.com/SangSeobLEE/popcast_book_from_library cd popcast_book_from_library
환경 부트스트랩 — venv 생성 + 의존성 + STT 백엔드 자동 설치
bash setup.sh
키 설정 — 프로젝트 루트에 .env 파일 생성 (git에 안 올라감)
cat > .env <<'EOF' LLM_API_KEY=여기에_API_키 LLM_MODEL=gpt-4o ALADIN_TTB_KEY=ttb여기에_알라딘_키 EOF
분석(③)에만 필요합니다. 키가 없으면 분석 단계는 자동으로 건너뜁니다.
로컬 관리자 실행
bash admin.sh
브라우저에서 http://127.0.0.1:8787 가 열립니다.

권장 순서 ① → ② → ③ → ④. 한 번에 한 작업만 실행됩니다.

① 새 방송 수집
유튜브에서 제목·설명·조회수·새 에피소드 메타데이터를 받아옵니다.

② 전사
아직 전사 안 된 편만 mlx-whisper로 전사·화자분리(재개 가능). 새 에피소드 수에 따라 오래 걸립니다.

③ 분석
책·주제 / 진행자 평가·핵심대목 / 페르소나 + 알라딘 책정보 보강. (.env 키 필요)

④ 빌드 + 배포
사이트 데이터 재빌드 후 Cloudflare Pages 배포(+GitHub 백업 push). 끝나면 공개 사이트에 반영됩니다.

bash admin.sh를 먼저 실행한 PC에서만 열립니다.