How gabriel15vitor/nba-predictions works
NBA win-probability and championship-ranking API with a lightweight web UI and separate Python data-ingestion scripts. The principal workflow is a user selecting teams in the UI, requesting a matchup or ranking, and receiving JSON predictions based on latest-season team statistics and active roster strength. Separate ingestion scripts fetch NBA statistics and submit batch data to the API; roster management supports injury flags and pruning. The graph follows the documented layered design; unsampled frontend/API wiring is shown only where the README documents it.
Main entry points: PlayerRepository.java Player queries · TeamStatsRepository.java Team stats queries · PredictionService.java Scoring and ranking · static Prediction and roster UI
Components 17
Data ingestion
- NBA stats API
- Fetch players
data-scripts/fetch_players.py - Fetch team stats
data-scripts/fetch_team_stats.py
REST API
- Player endpoints
nba-predictor/src/main/java/com/gabrielbarbosa/nba_predictor/controller/PlayerController.java - Team stats endpoints
nba-predictor/src/main/java/com/gabrielbarbosa/nba_predictor/controller/TeamStatsController.java - Prediction endpoints
nba-predictor/src/main/java/com/gabrielbarbosa/nba_predictor/controller/PredictionController.java - Roster management
nba-predictor/src/main/java/com/gabrielbarbosa/nba_predictor/service/PlayerService.java - Stats ingestion
nba-predictor/src/main/java/com/gabrielbarbosa/nba_predictor/service/TeamStatsService.java
Prediction
- Scoring and ranking
nba-predictor/src/main/java/com/gabrielbarbosa/nba_predictor/service/PredictionService.java - Prediction results
nba-predictor/src/main/java/com/gabrielbarbosa/nba_predictor/model
Persistence
- Player queries
nba-predictor/src/main/java/com/gabrielbarbosa/nba_predictor/repository/PlayerRepository.java - Team stats queries
nba-predictor/src/main/java/com/gabrielbarbosa/nba_predictor/repository/TeamStatsRepository.java - Player records
nba-predictor/src/main/java/com/gabrielbarbosa/nba_predictor/model/Player.java - Season team records
nba-predictor/src/main/java/com/gabrielbarbosa/nba_predictor/model/TeamStats.java - PostgreSQL
Web interface
- Prediction and roster UI
nba-predictor/src/main/resources/static
Other components
- User
Connections 22
- NBA stats API → Fetch players: provides stats
readme.md - NBA stats API → Fetch team stats: provides stats
readme.md - Fetch players → Player endpoints: posts batches
readme.md - Fetch team stats → Team stats endpoints: posts batches
readme.md - User → Prediction and roster UI: uses
readme.md - Prediction and roster UI → Prediction endpoints: requests predictions
readme.md - Prediction and roster UI → Player endpoints: manages roster
readme.md - Prediction and roster UI → Team stats endpoints: lists teams
readme.md - Player endpoints → Roster management: delegates updates
nba-predictor/src/main/java/com/gabrielbarbosa/nba_predictor/controller/PlayerController.java - Player endpoints → Player queries: reads roster
nba-predictor/src/main/java/com/gabrielbarbosa/nba_predictor/controller/PlayerController.java - Team stats endpoints → Stats ingestion: delegates batches
nba-predictor/src/main/java/com/gabrielbarbosa/nba_predictor/controller/TeamStatsController.java - Team stats endpoints → Team stats queries: queries teams
nba-predictor/src/main/java/com/gabrielbarbosa/nba_predictor/controller/TeamStatsController.java - Prediction endpoints → Scoring and ranking: requests scores
nba-predictor/src/main/java/com/gabrielbarbosa/nba_predictor/controller/PredictionController.java - Scoring and ranking → Team stats queries: loads season stats
nba-predictor/src/main/java/com/gabrielbarbosa/nba_predictor/service/PredictionService.java - Scoring and ranking → Player queries: loads active rosters
nba-predictor/src/main/java/com/gabrielbarbosa/nba_predictor/service/PredictionService.java - Scoring and ranking → Prediction results: builds results
nba-predictor/src/main/java/com/gabrielbarbosa/nba_predictor/service/PredictionService.java - Roster management → Player queries: upserts and prunes
nba-predictor/src/main/java/com/gabrielbarbosa/nba_predictor/service/PlayerService.java - Stats ingestion → Team stats queries: checks and saves
nba-predictor/src/main/java/com/gabrielbarbosa/nba_predictor/service/TeamStatsService.java - Player queries → Player records: queries
nba-predictor/src/main/java/com/gabrielbarbosa/nba_predictor/repository/PlayerRepository.java - Team stats queries → Season team records: queries
nba-predictor/src/main/java/com/gabrielbarbosa/nba_predictor/repository/TeamStatsRepository.java - Player queries → PostgreSQL: persists via JPA
readme.md - Team stats queries → PostgreSQL: persists via JPA
readme.md