hoopscout-v3/docs/architecture.md

Architecture

HoopScout is a private scouting application composed of three local Docker services:

• frontend: Angular single-page application for player search and profile review.
• backend: Django REST Framework API with Django admin for restricted data management.
• db: PostgreSQL database for users, leagues, teams, players, season stats, and game logs.

Data Flow

Users authenticate through Django session/basic authentication. The Angular application calls /api/players/ with search and filter query parameters. The backend returns paginated player summaries ranked by efficiency and points, plus detailed player profiles at /api/players/{id}/.

Persistence

The initial schema stores:

• users and user profiles with admin, scout, and viewer roles;
• male player identity, bio, position, optional role, measurements in cm/kg, nationality, current team, and external source metadata;
• leagues and teams, with an initial focus on European leagues;
• one active season;
• per-season averages, totals, and advanced metrics;
• per-game logs for best and worst performance views.

External Integrations

No automated external ingestion is included in the MVP. Demo data is synthetic. RealGM, Proballers, or similar data providers require a later authorized API/import decision before real data is collected.

Relevant ADRs

• docs/adr/0001-bootstrap-stack-and-data-boundaries.md