bisco/hoopscout
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Align balldontlie OpenAPI integration and clarify search metric semantics

Browse Source
This commit is contained in:
Alfredo Di Stasio
2026-03-12 16:37:02 +01:00
parent c9dd10a438
commit dac63f9148
16 changed files with 1562 additions and 82 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
docs/provider-normalization.md
View File

@ -24,9 +24,11 @@ Raw provider response structures must remain inside `apps/providers` (client/ada
- Source scope is NBA-centric.
- Competition is normalized as a single NBA competition (`competition-nba`).
- API contract source is `https://www.balldontlie.io/openapi.yml` (server `https://api.balldontlie.io`, NBA endpoints under `/nba/v1/*`).
- Team country is not reliably available in source payloads and is normalized to `null`.
- Player nationality/birth/physical details are not available in player list payloads and are normalized to `null` (except fields explicitly present).
- Configured seasons are normalized from `PROVIDER_BALLDONTLIE_SEASONS`; the highest configured season is marked `is_current=true`.
- Stats ingestion uses `/nba/v1/stats` with `seasons[]` and cursor pagination.
- Advanced metrics (`usage_rate`, `true_shooting_pct`, `player_efficiency_rating`) are currently unavailable from this source path and normalized to `null`.
## Domain rules vs provider assumptions