Ambiente local de desenvolvimento

Com Docker (recomendado)

cp .env.example .env     # ajuste DJANGO_DEBUG=true e DJANGO_ALLOWED_HOSTS=localhost
docker compose up -d --build
docker compose exec web python manage.py createsuperuser
docker compose exec web pytest

Sem Docker

Requer Python 3.13, PostgreSQL com PostGIS, GDAL e Redis instalados.

cd backend
python3 -m venv .venv && . .venv/bin/activate
pip install -r requirements-dev.txt
# .env na raiz do repositório com POSTGRES_HOST=localhost e REDIS_URL=redis://localhost:6379/0
python manage.py migrate
python manage.py runserver
pytest

Telas (frontend)

Requer Node.js 22. Com o Django rodando na porta 8000:

cd frontend
npm ci
npm run dev        # → http://127.0.0.1:5173 (a API e o admin são repassados ao Django)
# No .env local, inclua http://127.0.0.1:5173 em DJANGO_CSRF_TRUSTED_ORIGINS (senão os POSTs falham)
npm run build      # confere os tipos e gera dist/ (o CI faz o mesmo)

Para ter o que ver no mapa, crie a rede fictícia (só funciona com o banco sem caixas):

python manage.py dados_de_exemplo

Documentação

pip install mkdocs-material
mkdocs serve     # na raiz do repositório → http://127.0.0.1:8000