Files
auto-stock/backend/app/api/endpoints/market_playbook.py
shuim de7921d270 fix: CRITICAL/HIGH 버그 30건 수정 + 전체 코드 주석 추가 + 중복 정리
## CRITICAL 수정 (20건)
- day_trading: global 선언 누락, loss_tracker 연동, ban 체크 추가
- trade_executor: BUY 체결가 order_price로 수정, remaining_pct 누적 계산
- risk_validator: get_current_price dict 파싱, MAX_POSITION_SIZE 동기화, DB 세션 누수
- risk_management/recommendations: date.today() → KST 변환
- mdd_manager: Lock 밖 executed_key 참조 수정
- correlation_filter: output → output2 키 수정
- portfolio: 해외 종목 USD/KRW 환율 적용 분리
- Sharpe Ratio 거래빈도 기반 연간화
- telegram_notifier: send_message() 공개 래퍼 추가
- position_manager: 앱 재시작 시 DB 포지션 복원
- swing exit_service: remaining_pct 조건 범위 수정
- run_backtest: original_qty 기반 remaining_pct 계산
- us_market_schedule: 2027년 미국 공휴일 추가
- Login.tsx: res.ok 검증 추가
- mean_reversion_strategy: RSI 로그 하드코딩 수정

## HIGH 수정 (10건)
- db_worker: DLQ 파일 백업 메커니즘 추가
- korea_investment_api: 만료 토큰 임의 연장 제거
- market_data: chart_cache 최대 100개 + TTL 만료
- main.py: rate_limit_store 1시간 미접근 IP 정리
- recommendations: fire-and-forget try/except 추가
- swing/scheduler: DB 세션 3개 분리
- Dashboard: wsMessages 전체 순회
- Layout: /health 엔드포인트 + 30초 폴링
- ml_ensemble: POST /train require_api_key 추가
- day_trading: record_trade_result_safe() 전환

## 코드 정리
- 프론트엔드: isUsStock, formatTime 공통 유틸 추출
- 백엔드: dead code 제거, 중복 import 통합
- MCP: JSON 파싱 헬퍼 추출 (~60줄 감소)
- 전체 ~100개 파일 한국어 주석 추가
- 테스트 13건 코드 기준 수정 (468 passed)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-26 16:05:41 +09:00

98 lines
3.0 KiB
Python

"""시장 이벤트 플레이북 API
읽기 전용 엔드포인트:
GET /api/playbook/today — 오늘 적용 중인 플레이북
GET /api/playbook/upcoming — 향후 N일 이벤트 목록
GET /api/playbook/realtime — 실시간 이벤트 상태 (서킷브레이커, VI)
쓰기 엔드포인트 (require_api_key):
POST /api/playbook/circuit-breaker — 서킷브레이커 수동 발동
DELETE /api/playbook/circuit-breaker — 서킷브레이커 수동 해제
POST /api/playbook/vi/{stock_code} — VI 수동 발동
"""
import logging
from fastapi import APIRouter, Query
from app.services.market_playbook import (
get_today_playbook,
get_upcoming_events,
check_realtime_events,
trigger_circuit_breaker,
clear_circuit_breaker,
trigger_vi,
get_realtime_state_summary,
)
logger = logging.getLogger(__name__)
router = APIRouter()
@router.get("/today")
async def get_today_playbook_endpoint():
"""오늘 적용 중인 플레이북 행동 지침."""
playbook = get_today_playbook()
return playbook.to_dict()
@router.get("/upcoming")
async def get_upcoming_events_endpoint(days: int = Query(default=7, ge=1, le=30)):
"""향후 N일 이내 예정된 시장 이벤트 목록."""
events = get_upcoming_events(days=days)
return {
"days": days,
"count": len(events),
"events": [
{
"type": e.event_type.value,
"date": e.event_date.isoformat(),
"description": e.description,
"phase": e.phase.value,
"days_until": e.days_until,
}
for e in events
],
}
@router.get("/realtime")
async def get_realtime_events_endpoint():
"""실시간 이벤트 상태 (서킷브레이커, VI)."""
alerts = check_realtime_events()
state = get_realtime_state_summary()
return {
"alerts": [
{
"type": a.event_type.value,
"description": a.description,
"severity": a.severity,
}
for a in alerts
],
"state": state,
}
@router.post("/circuit-breaker")
async def trigger_circuit_breaker_endpoint(description: str = "수동 서킷브레이커 발동"):
"""서킷브레이커 수동 발동 (긴급 매매 중단)."""
trigger_circuit_breaker(description)
logger.warning(f"[PlaybookAPI] 서킷브레이커 수동 발동: {description}")
return {"status": "activated", "description": description}
@router.delete("/circuit-breaker")
async def clear_circuit_breaker_endpoint():
"""서킷브레이커 수동 해제."""
clear_circuit_breaker()
logger.info("[PlaybookAPI] 서킷브레이커 수동 해제")
return {"status": "cleared"}
@router.post("/vi/{stock_code}")
async def trigger_vi_endpoint(stock_code: str, description: str = ""):
"""특정 종목 VI 수동 발동."""
trigger_vi(stock_code, description or f"수동 VI 발동: {stock_code}")
return {"status": "triggered", "stock_code": stock_code}