hoopscout-v3/README.md

HoopScout

HoopScout is a private basketball scouting web application for searching and comparing male players across European and selected international leagues.

The MVP focuses on local usage for a restricted group of users. It provides a Django REST API, PostgreSQL persistence, and an Angular scouting dashboard.

Stack

• Docker Compose
• Django and Django REST Framework
• PostgreSQL
• Angular

Local Development

cp .env.example .env
docker compose up --build

Run database migrations and seed synthetic local scouting data:

docker compose run --rm backend python manage.py migrate
docker compose run --rm backend python manage.py seed_demo_data
docker compose run --rm backend python manage.py createsuperuser

The backend is available at http://localhost:8000; the Angular frontend is available at http://localhost:4200.

Tests

All tests are run inside Docker containers:

docker compose run --rm backend ruff check .
docker compose run --rm backend pytest
docker compose run --rm frontend npm test
docker compose config

Demo data is synthetic. RealGM, Proballers, or other external sources must be integrated only through authorized APIs or documented, compliant import workflows.