검색 페이지(memogipost)를 크롤링하여 프로미스나인 출연 대학 축제를 Gemini url_context로 추출, 행사 일정을 자동 생성하는 봇. 백엔드: - services/event.js: 이벤트 생성 로직 공유화 (upsertVenue, createEventSchedule, 카카오 검색) - services/festival/: scraper(검색 페이지 크롤) + gemini(추출) + index(봇 플러그인) - routes/admin/festival-bots.js: 축제 봇 CRUD API - scheduler.js: festival 타입 지원, 시간 단위 cron(0 */H * * *) 변환 - 처리한 글 URL은 festival_crawl_log에 기록, 새 글 없으면 Gemini 미호출 - 학교명 부분일치 중복 감지, 활동 멤버 전체 자동 등록 - Gemini 503/500/429 재시도 로직 기타 수정: - 행사 상세 페이지 관련 링크 줄바꿈 (truncate → break-all) - 대학 축제 아이콘 변경 (GraduationCap → PartyPopper) - docs/api.md, CLAUDE.md 환경변수 문서화 Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
1.2 KiB
1.2 KiB
fromis_9 프로젝트
K-pop 그룹 프로미스나인 팬사이트
기술 스택
- Frontend: React 18, Vite, Tailwind CSS, React Query, Zustand
- Backend: Fastify, MySQL2, Meilisearch, Redis, AWS S3
- Infrastructure: Docker, Caddy
개발 환경
docker compose up -d --build
docker compose logs -f fromis9-frontend
환경 변수
DB 및 외부 서비스 접근 정보는 .env 파일 참조:
- DB_HOST, DB_USER, DB_PASSWORD, DB_NAME (MariaDB)
- RUSTFS_* (S3 호환 스토리지)
- YOUTUBE_API_KEY
- MEILI_MASTER_KEY (Meilisearch)
- KAKAO_REST_KEY (카카오맵 장소 검색)
- GEMINI_API_KEY (대학 축제 크롤러 봇)
문서
- docs/architecture.md - 프로젝트 구조
- docs/api.md - API 명세
- docs/development.md - 개발/배포 가이드
- docs/logs.md - 활동 로그 시스템
작업 시 주의사항
- 문서 업데이트 필수: 작업이 완료되면 항상
docs/폴더의 관련 문서를 업데이트할 것 - 활동 로그 필수: 새로운 관리자 라우트나 봇 기능을 추가할 때
logActivity호출을 포함할 것 (자세한 사용법은docs/development.md참조)