docs: restore onboarding context and clarify runtime-impact gaps
Some checks failed
CI / test (pull_request) Has been cancelled

This commit is contained in:
agentson
2026-02-16 12:29:54 +09:00
parent cc1489fd7c
commit 93e31cf667
4 changed files with 82 additions and 3 deletions

View File

@@ -16,15 +16,20 @@ The Ouroboros V2는 `Proactive` 구조를 중심으로 동작합니다.
- `DailyReviewer` / `EvolutionOptimizer`
- `TelegramClient` / `TelegramCommandHandler`
안전/운영 컴포넌트도 핵심입니다.
- `RiskManager`: circuit breaker, fat-finger 검증
- `PriorityTaskQueue` + `CriticalityAssessor`: 우선순위/지연 제어
## Market Scope
V2 기본 설정은 `ENABLED_MARKETS="KR,US"` 입니다.
현재 코드 기준 주의점:
현재 코드 기준 주의점(런타임 영향):
- 설정은 `KR,US`를 기본값으로 사용
- 스케줄 레이어(`src/markets/schedule.py`)는 `US_NASDAQ`, `US_NYSE` 구조를 아직 유지
- 완전한 `US` 단일 코드 통합은 추가 정리 필요
- `US` 코드가 스케줄에 직접 정의되지 않아 US 시장 누락 가능성이 있음
## Decision Flow
@@ -50,6 +55,30 @@ V2 기본 설정은 `ENABLED_MARKETS="KR,US"` 입니다.
4. `generate_lessons()`로 장후 교훈 생성
5. (US 종료 시) `EvolutionOptimizer.evolve()` 실행
## Risk Policy
- `RiskManager`는 주문 전 검증을 강제합니다.
- circuit breaker: 손실 임계치 하회 시 거래 중단
- fat-finger: 주문 금액 과대 시 주문 차단
- 실패 시 알림은 보내되, 예외 처리로 루프 안정성 유지
## Error Handling Strategy
- API 호출 실패: 재시도(지수 백오프) 후 종목/사이클 스킵
- 시나리오/플래너 실패: empty 또는 defensive playbook으로 안전 폴백
- Telegram 실패: warning 로깅 후 거래 루프 지속
- 대시보드 스레드 실패: warning 로깅 후 메인 트레이딩 루프와 분리 유지
## Configuration Reference
상세 설정은 `src/config.py`를 기준으로 합니다.
- 거래 모드: `TRADE_MODE`, `DAILY_SESSIONS`, `SESSION_INTERVAL_HOURS`
- 전략: `PRE_MARKET_MINUTES`, `MAX_SCENARIOS_PER_STOCK`, `RESCAN_INTERVAL_SECONDS`
- 시장: `ENABLED_MARKETS`
- 대시보드: `DASHBOARD_ENABLED`, `DASHBOARD_HOST`, `DASHBOARD_PORT`
- 알림: `TELEGRAM_*`
## Context Tree
레이어 전략:
@@ -107,5 +136,6 @@ V2 기본 설정은 `ENABLED_MARKETS="KR,US"` 입니다.
- `Issue 4-1` Telegram 확장 명령 미구현 (`/report`, `/scenarios`, `/review`, `/dashboard`)
- `Issue 1-7` 일부 미완:
- `price_change_pct` 정규화 계층 명시 미흡
- 영향: `price_change_pct` 기반 조건은 현재 사실상 매칭되지 않음
- HOLD 시 별도 손절 모니터링 플래그 처리 미완
- US 스캐닝 확장(`fetch_overseas_rankings`) 미구현