---
task_id: task-2321
type: checklist
scope: task
created: 2026-04-30
updated: 2026-04-30
status: in-progress
---

# 체크리스트: task-2321 (Phase 1: DB + 키워드 풀 선정)

**task**: task-2321

---

## 1-6. DB 마이그레이션

- [x] keywords 테이블 생성 SQL
- [x] keyword_trends 테이블 생성 SQL (UNIQUE 수정: keyword_id, period_start, period_end)
- [x] keyword_saturation 테이블 생성 SQL
- [x] keyword_rankings 테이블 생성 SQL
- [x] failed_batches 테이블 생성 SQL
- [x] 인덱스 4개 생성 SQL
- [x] server/migrations/ 디렉토리에 버전드 파일 저장

## 1-1. 키워드 풀 선정 파이프라인

- [x] server/config/keyword-seeds.json 작성 (6카테고리, 30개 시드)
- [x] keyword_pool_refresh.py — SearchAd API 호출 로직
- [x] keyword_pool_refresh.py — 중복 제거 (정규화: strip, 공백 축소)
- [x] keyword_pool_refresh.py — 검색량(PC+Mobile) 계산 + "< 10" 파싱
- [x] keyword_pool_refresh.py — 검색량 내림차순 정렬 → 상위 2,000개 컷오프
- [x] keyword_pool_refresh.py — 노이즈 필터링 (블록리스트 + 브랜드 exact match)
- [x] keyword_pool_refresh.py — 카테고리 자동 분류 (규칙 기반)
- [x] keyword_pool_refresh.py — keywords 테이블 INSERT/UPDATE
- [x] keyword_pool_refresh.py — Telegram 알림 (print 대체)
- [x] 크론 등록: 매월 1일 03:00

## 검증

- [x] 마이그레이션 SQL 문법 검증 (5테이블 확인)
- [x] keyword_pool_refresh.py 드라이런 테스트 통과
- [ ] QC 검증 완료
- [ ] 최종 보고