caadiq
9eb49929c7
- PC/모바일 YouTube 상세 페이지 그림자 감소, 배경색 조정 - 모바일 YouTube 섹션을 카드에서 배경 스타일로 변경 - 문서 업데이트: 완료된 마이그레이션 작업 반영, 누락된 API 추가 Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
146 lines
5.1 KiB
Markdown
146 lines
5.1 KiB
Markdown
# Express → Fastify 마이그레이션
|
|
|
|
## 개요
|
|
|
|
`backend-backup/` (Express) → `backend/` (Fastify)로 마이그레이션 완료
|
|
|
|
## 완료된 작업
|
|
|
|
### 서버 기반
|
|
- [x] Fastify 앱 구조 (`src/app.js`, `src/server.js`)
|
|
- [x] 플러그인 시스템 (`src/plugins/`)
|
|
- db.js (MariaDB)
|
|
- redis.js
|
|
- auth.js (JWT)
|
|
- meilisearch.js
|
|
- scheduler.js (봇 스케줄러)
|
|
|
|
### API 라우트 (`src/routes/`)
|
|
- [x] 인증 (`/api/auth`)
|
|
- POST /login - 로그인
|
|
- GET /verify - 토큰 검증
|
|
- [x] 멤버 (`/api/members`)
|
|
- GET / - 목록 조회
|
|
- GET /:name - 상세 조회
|
|
- PUT /:name - 수정 (이미지 업로드 포함)
|
|
- [x] 앨범 (`/api/albums`)
|
|
- GET / - 목록 조회
|
|
- GET /:id - ID로 조회
|
|
- GET /by-name/:name - 이름으로 조회
|
|
- GET /by-name/:albumName/track/:trackTitle - 트랙 조회
|
|
- POST / - 생성
|
|
- PUT /:id - 수정
|
|
- DELETE /:id - 삭제
|
|
- 사진 관리 (`/api/albums/:id/photos`)
|
|
- GET / - 목록
|
|
- POST / - 업로드
|
|
- PUT /:photoId - 수정
|
|
- DELETE /:photoId - 삭제
|
|
- 티저 관리 (`/api/albums/:id/teasers`)
|
|
- GET / - 목록
|
|
- POST / - 업로드
|
|
- DELETE /:teaserId - 삭제
|
|
- [x] 일정 (`/api/schedules`)
|
|
- GET / - 월별 조회 (생일 포함)
|
|
- GET /?search= - Meilisearch 검색
|
|
- GET /:id - 상세 조회
|
|
- DELETE /:id - 삭제
|
|
- POST /sync-search - Meilisearch 동기화
|
|
- [x] 추천 검색어 (`/api/schedules/suggestions`)
|
|
- GET / - 추천 검색어 조회
|
|
- GET /popular - 인기 검색어 조회
|
|
- POST /save - 검색어 저장
|
|
- GET /dict - 사용자 사전 조회 (관리자)
|
|
- PUT /dict - 사용자 사전 저장 (관리자)
|
|
- [x] 통계 (`/api/stats`)
|
|
- GET / - 대시보드 통계
|
|
|
|
### 관리자 API (`src/routes/admin/`)
|
|
- [x] 봇 관리 (`/api/admin/bots`)
|
|
- GET / - 봇 목록
|
|
- POST /:id/start - 봇 시작
|
|
- POST /:id/stop - 봇 정지
|
|
- POST /:id/sync-all - 전체 동기화
|
|
- GET /quota-warning - 할당량 경고 조회
|
|
- DELETE /quota-warning - 할당량 경고 해제
|
|
- [x] YouTube 관리 (`/api/admin/youtube`)
|
|
- GET /video-info - 영상 정보 조회
|
|
- POST /schedule - 일정 저장
|
|
- PUT /schedule/:id - 일정 수정
|
|
- [x] X 관리 (`/api/admin/x`)
|
|
- GET /post-info - 게시글 정보 조회
|
|
- POST /schedule - 일정 저장
|
|
|
|
### 서비스 (`src/services/`)
|
|
- [x] YouTube 봇 (`services/youtube/`)
|
|
- 영상 자동 수집
|
|
- 채널별 필터링 (제목 필터, 멤버 추출)
|
|
- [x] X(Twitter) 봇 (`services/x/`)
|
|
- Nitter 스크래핑
|
|
- 이미지 URL 추출
|
|
- [x] Meilisearch 검색 (`services/meilisearch/`)
|
|
- 일정 검색
|
|
- 전체 동기화
|
|
- [x] 추천 검색어 (`services/suggestions/`)
|
|
- 형태소 분석 (kiwi-nlp)
|
|
- bi-gram 빈도
|
|
- 초성 검색
|
|
- 사용자 사전 관리
|
|
- [x] 이미지 업로드 (`services/image.js`)
|
|
- 앨범 커버
|
|
- 멤버 이미지
|
|
- 앨범 사진/티저
|
|
|
|
## 남은 작업 (미구현)
|
|
|
|
### 일반 일정 CRUD
|
|
- [ ] POST /api/schedules - 일정 생성 (일반)
|
|
- [ ] PUT /api/schedules/:id - 일정 수정 (일반)
|
|
|
|
※ 현재는 YouTube/X 전용 일정 생성 API만 구현됨
|
|
|
|
### 카테고리 관리
|
|
- [ ] POST /api/schedule-categories - 생성
|
|
- [ ] PUT /api/schedule-categories/:id - 수정
|
|
- [ ] DELETE /api/schedule-categories/:id - 삭제
|
|
- [ ] PUT /api/schedule-categories-order - 순서 변경
|
|
|
|
※ GET은 구현됨 (목록 조회)
|
|
|
|
### 기타
|
|
- [ ] GET /api/kakao/places - 카카오 장소 검색 프록시
|
|
|
|
## 파일 비교표
|
|
|
|
| Express (backend-backup) | Fastify (backend) | 상태 |
|
|
|--------------------------|-------------------|------|
|
|
| routes/admin.js (로그인) | routes/auth.js | 완료 |
|
|
| routes/admin.js (앨범 CRUD) | routes/albums/index.js | 완료 |
|
|
| routes/admin.js (사진/티저) | routes/albums/photos.js, teasers.js | 완료 |
|
|
| routes/admin.js (멤버 수정) | routes/members/index.js | 완료 |
|
|
| routes/admin.js (일정 삭제) | routes/schedules/index.js | 완료 |
|
|
| routes/admin.js (일정 생성/수정) | - | 미완료 |
|
|
| routes/admin.js (카테고리 CUD) | - | 미완료 |
|
|
| routes/admin.js (봇 관리) | routes/admin/bots.js | 완료 |
|
|
| routes/admin.js (할당량) | routes/admin/bots.js | 완료 |
|
|
| routes/admin.js (카카오) | - | 미완료 |
|
|
| - | routes/admin/youtube.js | 신규 |
|
|
| - | routes/admin/x.js | 신규 |
|
|
| routes/albums.js | routes/albums/index.js | 완료 |
|
|
| routes/members.js | routes/members/index.js | 완료 |
|
|
| routes/schedules.js | routes/schedules/index.js | 완료 |
|
|
| routes/stats.js | routes/stats/index.js | 완료 |
|
|
| services/youtube-bot.js | services/youtube/ | 완료 |
|
|
| services/youtube-scheduler.js | plugins/scheduler.js | 완료 |
|
|
| services/x-bot.js | services/x/ | 완료 |
|
|
| services/meilisearch.js | services/meilisearch/ | 완료 |
|
|
| services/meilisearch-bot.js | services/meilisearch/ | 완료 |
|
|
| services/suggestions.js | services/suggestions/ | 완료 |
|
|
|
|
## 참고 사항
|
|
|
|
- 기존 Express 코드는 `backend-backup/` 폴더에 보존
|
|
- 마이그레이션 시 기존 코드 참조하여 동일 기능 구현
|
|
- DB 스키마 변경 사항:
|
|
- `tracks` → `album_tracks` (이름 변경)
|
|
- `venues` → `concert_venues` (이름 변경)
|