caadiq
d530822a68
검색 페이지(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>
38 lines
1.2 KiB
Markdown
38 lines
1.2 KiB
Markdown
# fromis_9 프로젝트
|
|
|
|
K-pop 그룹 프로미스나인 팬사이트
|
|
|
|
## 기술 스택
|
|
|
|
- **Frontend**: React 18, Vite, Tailwind CSS, React Query, Zustand
|
|
- **Backend**: Fastify, MySQL2, Meilisearch, Redis, AWS S3
|
|
- **Infrastructure**: Docker, Caddy
|
|
|
|
## 개발 환경
|
|
|
|
```bash
|
|
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/architecture.md) - 프로젝트 구조
|
|
- [docs/api.md](docs/api.md) - API 명세
|
|
- [docs/development.md](docs/development.md) - 개발/배포 가이드
|
|
- [docs/logs.md](docs/logs.md) - 활동 로그 시스템
|
|
|
|
## 작업 시 주의사항
|
|
|
|
- **문서 업데이트 필수**: 작업이 완료되면 항상 `docs/` 폴더의 관련 문서를 업데이트할 것
|
|
- **활동 로그 필수**: 새로운 관리자 라우트나 봇 기능을 추가할 때 `logActivity` 호출을 포함할 것 (자세한 사용법은 `docs/development.md` 참조)
|