diff --git a/README.md b/README.md index 221a93d..34a6afe 100644 --- a/README.md +++ b/README.md @@ -129,15 +129,29 @@ stock_chart_site/ ## 진행 계획 -- Phase 0 — 스캐폴드 (현재): Docker 환경 + DB 스키마 + 빈 FastAPI/Next.js + build.bat -- Phase 1a — pykrx 데이터 파이프: 일봉/외인기관/지수 + DART + 뉴스 RSS + 거시 -- Phase 1b — KIS EOD (키 받으면) -- Phase 2 — KR-FinBERT 감성 점수 + 일별 집계 -- Phase 3 — Chronos zero-shot 예측 적재 -- Phase 4 — LightGBM walk-forward + `prediction_outcomes` 누적 시작 -- Phase 5 — FastAPI 엔드포인트 (검색, 차트, on-demand 예측, 메트릭) -- Phase 6 — Next.js UI (검색 + 현재 차트 + 예상차트 토글) -- Phase 7 (옵션) — 백테스트 페이지 + 주간 자동 재학습 +- [x] Phase 0 — 스캐폴드: Docker 환경 + DB 스키마 + FastAPI/Next.js + build.bat +- [x] Phase 1a — pykrx 데이터 파이프: 일봉/외인기관/지수 + DART + 뉴스 RSS + 거시 +- [x] Phase 1b — KIS read-only EOD (스모크 통과) +- [x] Phase 2 — KR-FinBERT 감성 점수 + 일별 집계 뷰 +- [x] Phase 3 — Chronos zero-shot 예측 어댑터 + 피처 빌더 +- [x] Phase 4 — LightGBM walk-forward + ensemble + 매칭/재학습 잡 +- [x] Phase 5 — FastAPI 엔드포인트 (검색/차트/예측/메트릭/뉴스) +- [x] Phase 6 — Next.js UI (검색 + 현재 차트 + 예상차트 overlay) +- [ ] 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=` | 최근 뉴스/공시 + 감성 | ## 동작 모델 메모