docs: Phase 1a~6 완료 체크 + API 엔드포인트 요약 표

진행 계획에 체크박스로 완료 상태 표시. Phase 7(백테스트 + shadow 예측)만 남음.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

README.md

@@ -129,15 +129,29 @@ stock_chart_site/
 
 ## 진행 계획
 
-- Phase 0 — 스캐폴드 (현재): Docker 환경 + DB 스키마 + 빈 FastAPI/Next.js + build.bat
+- [x] Phase 0 — 스캐폴드: Docker 환경 + DB 스키마 + FastAPI/Next.js + build.bat
-- Phase 1a — pykrx 데이터 파이프: 일봉/외인기관/지수 + DART + 뉴스 RSS + 거시
+- [x] Phase 1a — pykrx 데이터 파이프: 일봉/외인기관/지수 + DART + 뉴스 RSS + 거시
-- Phase 1b — KIS EOD (키 받으면)
+- [x] Phase 1b — KIS read-only EOD (스모크 통과)
-- Phase 2 — KR-FinBERT 감성 점수 + 일별 집계
+- [x] Phase 2 — KR-FinBERT 감성 점수 + 일별 집계 뷰
-- Phase 3 — Chronos zero-shot 예측 적재
+- [x] Phase 3 — Chronos zero-shot 예측 어댑터 + 피처 빌더
-- Phase 4 — LightGBM walk-forward + `prediction_outcomes` 누적 시작
+- [x] Phase 4 — LightGBM walk-forward + ensemble + 매칭/재학습 잡
-- Phase 5 — FastAPI 엔드포인트 (검색, 차트, on-demand 예측, 메트릭)
+- [x] Phase 5 — FastAPI 엔드포인트 (검색/차트/예측/메트릭/뉴스)
-- Phase 6 — Next.js UI (검색 + 현재 차트 + 예상차트 토글)
+- [x] Phase 6 — Next.js UI (검색 + 현재 차트 + 예상차트 overlay)
-- Phase 7 (옵션) — 백테스트 페이지 + 주간 자동 재학습
+- [ ] Phase 7 (옵션) — 백테스트 페이지 + Chronos/LGBM 단독 shadow 예측
+
+### API 엔드포인트 (요약)
+
+| 메서드 | 경로 | 설명 |
+|---|---|---|
+| GET | `/health`, `/health/db`, `/health/keys` | 헬스/외부키 ping |
+| POST | `/api/refresh/{code}?lookback_days=N` | 수동 갱신 |
+| GET | `/api/symbols/search?q=&seed_only=` | 종목 검색 (trigram + prefix) |
+| GET | `/api/symbols/{code}` | 종목 메타 |
+| GET | `/api/chart/{code}?days=N` | OHLCV + 감성 + 외인기관거래대금 |
+| POST | `/api/predict/{code}?horizons=1,3,5` | on-demand 앙상블 예측 (user_triggered) |
+| GET | `/api/predict/{code}/latest` | 최신 base_date 예측 묶음 (UI overlay) |
+| GET | `/api/metrics/{code}?window_days=N` | 종목 hit_rate / mae |
+| GET | `/api/news/{code}?limit=N&source=` | 최근 뉴스/공시 + 감성 |
 
 ## 동작 모델 메모