Técnico¶

Stack observada¶

Python 3.12 e Django; templates server-side.
PostgreSQL 16 e Django ORM.
Django REST Framework, autenticação por token/sessão e drf-spectacular para OpenAPI, Swagger e Redoc.
Celery, Redis e django-celery-beat.
OpenAI Python SDK; modelo configurável por OPENAI_MODEL, cujo padrão no código é gpt-4o-mini.
Gunicorn e WhiteNoise no runtime web de produção.
Tema visual Holo de aplicação, sem seletor de temas no produto atual.

Configuração¶

core/settings/base.py lê configurações com python-decouple; valores efetivos podem vir do ambiente ou da configuração dos containers. O fuso é America/Sao_Paulo, com USE_TZ=True; o Celery usa o mesmo fuso.

Em produção, core.settings.production desativa DEBUG, ativa cookies seguros e redirecionamento HTTPS. A origem de confiança CSRF é configurável. A revisão do Compose de produção encontrou credenciais de banco definidas diretamente no arquivo versionado; os valores não são reproduzidos nesta documentação. Isso precisa de correção operacional e rotação conforme a seção de Governança.

Persistência e desempenho¶

As chaves primárias usam BigAutoField. Chaves estrangeiras recebem índices pelo padrão do Django; Log.data_hora declara índice explícito. Etiqueta impõe unicidade do nome dentro do projeto. A listagem da API de tarefas pré-carrega etiquetas para evitar consultas adicionais por tarefa.

Qualidade registrada¶

A auditoria da API em 15/09/2026 registra correções de N+1, schema OpenAPI e testes de isolamento em operações comuns. Os pontos de validação das relações de propriedade descritos em Governança são achados desta leitura do código e requerem revisão de segurança própria.

Referências¶

Dependências: requirements.txt no repositório-fonte.
Configurações: core/settings/.
Governança