# Testing Guidelines

## Current Test Baseline (2026-02-16)

수집 기준:

```bash
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

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

## FastAPI Note

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

## Targeted Smoke Commands

```bash
# 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 검증