The-Ouroboros/docs/prs/PR-2026-02-17-scanner-diagnostics-for-zero-candidates.md

PR: Smart Scanner 진단 로그 추가 (0 candidates 원인 분해)

Linked Issue

• docs/issues/ISSUE-2026-02-17-no-trades-zero-candidates.md

What Changed

• src/analysis/smart_scanner.py에 스캔 진단 카운터 추가
• 국내 스캔 진단 로그 추가
• 해외 랭킹 스캔 진단 로그 추가
• 해외 fallback 심볼 스캔 진단 로그 추가

Diagnostics Keys

• total_rows
• missing_code
• invalid_price
• low_volatility
• connection_error (해당 경로에서만)
• unexpected_error (해당 경로에서만)
• qualified

Expected Log Examples

• Domestic scan diagnostics: {...}
• Overseas ranking scan diagnostics for US_NASDAQ: {...}
• Overseas fallback scan diagnostics for US_NYSE: {...}

Out of Scope

• 해외 랭킹 404 시 기본 심볼 유니버스 강제 주입
• 국내 경로 fallback 정책 변경

Validation

• .venv/bin/python -m py_compile src/analysis/smart_scanner.py