The-Ouroboros/docs/testing.md

Testing Guidelines

Current Test Baseline (2026-02-16)

수집 기준:

pytest --collect-only -q
# 538 tests collected

V2 핵심 영역 테스트가 포함되어 있습니다.

• tests/test_strategy_models.py
• tests/test_pre_market_planner.py
• tests/test_scenario_engine.py
• tests/test_playbook_store.py
• tests/test_context_scheduler.py
• tests/test_daily_review.py
• tests/test_scorecard.py
• tests/test_dashboard.py
• tests/test_main.py

Required Checks

pytest -v --cov=src
ruff check src/ tests/
mypy src/ --strict

FastAPI Note

대시보드 테스트(tests/test_dashboard.py)는 fastapi가 환경에 없으면 skip될 수 있습니다. 의도된 동작이며 CI/개발환경에서 의존성 설치 여부를 확인하세요.

Targeted Smoke Commands

# dashboard integration
pytest -q tests/test_main.py -k "dashboard"

# planner/scenario/review paths
pytest -q tests/test_pre_market_planner.py tests/test_scenario_engine.py tests/test_daily_review.py

# context rollup/scheduler
pytest -q tests/test_context.py tests/test_context_scheduler.py

Review Checklist (테스트 관점)

• 플랜 항목별 테스트 존재 여부 확인
• 시장 스코프 키(*_KR, *_US) 검증 확인
• EOD 흐름(aggregate_daily_from_trades, scorecard_{market} 저장) 검증
• decision outcome 연결(decision_id) 검증
• 대시보드 API market filter 검증