Pular para conteúdo

ADR 0002 — Django 5.2 LTS + PostgreSQL/PostGIS + React

Status: Aceita · Data: 09/11/2026

Contexto

O sistema precisa de login e permissões, um painel de administração, migrações de banco confiáveis, dados geográficos (mapa, traçado de cabos) e tarefas em segundo plano. Também precisa de uma interface rica para o mapa e o diagrama unifilar.

Decisão

  • Backend: Django 5.2 (versão LTS, com suporte de segurança até abril de 2028) + Django REST Framework.
  • Geo: GeoDjango sobre PostgreSQL 17 + PostGIS.
  • Frontend (a partir da F2): React + Vite + MapLibre (mapa) + React Flow (diagrama unifilar).
  • API documentada automaticamente com drf-spectacular (OpenAPI).

Alternativas consideradas

  • FastAPI: mais leve, mas exigiria montar à mão autenticação, admin, migrações e permissões, que o Django já entrega testados.
  • Só templates Django + HTMX: simples, mas o mapa e o diagrama unifilar precisam de um frontend rico.

Consequências

  • Um único backend e um único banco para tudo.
  • O admin do Django serve como painel de manutenção desde a F0.
  • Atualizar para o próximo Django LTS (6.2, previsto para 2028) é uma tarefa planejada.