Tighten provider normalization contract and fallback semantics

2026-03-10 16:47:39 +01:00
parent 2252821daf
commit e0e75cfb0c
11 changed files with 340 additions and 59 deletions
--- a/.env.example
+++ b/.env.example
@ -58,6 +58,7 @@ PROVIDER_REQUEST_RETRY_SLEEP=1
 PROVIDER_HTTP_TIMEOUT_SECONDS=10
 PROVIDER_BALLDONTLIE_BASE_URL=https://api.balldontlie.io/v1
 PROVIDER_BALLDONTLIE_API_KEY=
+# NBA-centric MVP provider seasons to ingest (comma-separated years).
 PROVIDER_BALLDONTLIE_SEASONS=2024
 PROVIDER_BALLDONTLIE_PLAYERS_PAGE_LIMIT=5
 PROVIDER_BALLDONTLIE_PLAYERS_PER_PAGE=100