From bc016ab76dafad931d66c6b0009b80c6ab3306b3 Mon Sep 17 00:00:00 2001 From: tkrmagid Date: Wed, 20 May 2026 16:10:58 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20Phase=201a~6=20=EC=99=84=EB=A3=8C=20?= =?UTF-8?q?=EC=B2=B4=ED=81=AC=20+=20API=20=EC=97=94=EB=93=9C=ED=8F=AC?= =?UTF-8?q?=EC=9D=B8=ED=8A=B8=20=EC=9A=94=EC=95=BD=20=ED=91=9C?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 진행 계획에 체크박스로 완료 상태 표시. Phase 7(백테스트 + shadow 예측)만 남음. Co-Authored-By: Claude Opus 4.7 --- README.md | 32 +++++++++++++++++++++++--------- 1 file changed, 23 insertions(+), 9 deletions(-) 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=` | 최근 뉴스/공시 + 감성 | ## 동작 모델 메모