Técnico¶
Stack observada¶
- Python 3.12 e Django 5.1.
- PostgreSQL 16, Django ORM e migrations.
- Django REST Framework, Token/Session Authentication e
drf-spectacular. - Celery, RabbitMQ, Redis e
django-celery-beat/django-celery-results. - Django Templates, JavaScript, tema Holo de tema único escuro.
- Gunicorn e WhiteNoise em produção; Docker Compose v2 para execução.
- QR Code com biblioteca Python e imagem/Pillow; leitura via câmera no cliente web.
Configuração¶
config.settings.base centraliza apps, middleware, fuso horário, logs, Celery e REST Framework. Settings específicos existem para desenvolvimento, produção e Contabo. python-decouple lê segredos e configuração pelo ambiente; .env.example enumera as variáveis sem valores reais. Produção ativa HTTPS, HSTS e cookies seguros.
Fuso do Django e do Celery: America/Sao_Paulo, USE_TZ=True. A porta de aplicação configurada nos containers é 8012.
Modelo-base e índices¶
apps.core.BaseModel fornece PK UUID, created_at, updated_at e is_active aos models de domínio que o herdam. Os models usam restrições de unicidade em código patrimonial, nome de categoria, unidade/setor e par rodada/ativo. Há índices declarados para código/status de ativo e para consultas de devolução em MovimentacaoAtivo; relações Django recebem índice automático.
Qualidade e auditoria registrada¶
A auditoria de 18/09/2026 registrou 75 testes, lint/formatação limpos e verificações de permissões; corrigiu entradas inválidas que retornavam 500, consultas N+1 em relatórios, botões sem ícone/tooltip e problemas de rolagem. O planejamento registra o MVP concluído (32/32).
Referências¶
- Dependências:
requirements/base.txt,requirements/dev-tools.txterequirements.lock. - Governança
- DevOps