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. The demo seed creates a broader scouting board across European leagues plus Australia and New Zealand so filters, sorting, and profile review can be exercised locally.