Skip to content
Veritas
  • Nothing matches. Try the name of a library or a stack.

Titles, descriptions and sections of every skill.

Convenções, camadas e proibições do Veritas para projetos Django e Django REST Framework. Use ao criar, revisar ou alterar views, serializers, services, models, migrations ou autenticação em qualquer projeto Django ou DRF da casa.

The convention text is written in Portuguese and is shown here as it is in the repository.

Django / DRF — convenções da casa

Projeto que já existe? Estas convenções valem para código novo e para remodelação. Em sistema legado, de cliente ou de outra equipe, a arquitetura do projeto manda: antes da primeira mudança, siga veritas:projeto-existente.

Dado pessoal? Código que toca CPF, contato, saúde, dado financeiro ou credencial, e todo log, exportação ou integração, segue também a veritas:lgpd, em qualquer modo.

Filosofia

A lógica de negócios deve ser isolada e testável fora de qualquer camada de transporte (HTTP, Celery). O framework Django é uma ferramenta a ser alavancada, nunca o dono do domínio.

Tecnologias

  • API: Django REST Framework (DRF)
  • Banco: ORM nativo e migrations do Django
  • Autenticação: SimpleJWT para DRF
  • Pacotes: ambiente gerenciado com uv

Camadas

Request → View → Serializer → Service → Model

  • View: orquestração HTTP. Autentica, chama serializer e service, molda a resposta. Não decide nada.
  • Serializer: valida formato e shape. Nunca faz query a outra tabela, nunca dispara efeito colateral.
  • Service: lógica de negócio. Validação que depende do estado do sistema, transações, efeitos colaterais. Sempre funções.
  • Model: acesso a dados.

A camada de services/ nunca importa nada de api/.

Proibições (violação = erro)

  • Lógica de negócio em views.py ou serializers.py — delegue ao service.
  • Validador de serializer consultando o banco — se depende de estado, é service.
  • @transaction.atomic em view — efeito colateral vai em transaction.on_commit().
  • Exceção do DRF levantada direto do service — crie exceção de domínio e traduza num handler central.
  • User default sem AUTH_USER_MODEL customizado — e, para JWT, nada de lógica complexa direto na view do simplejwt.
  • Lógica em save_model() do admin — o admin também delega ao service.

Recursos adicionais

Origem

Portada do scaffold/stacks/django.py do Veritas v1, onde vivia como string dentro do Python. Aqui é dado: o time edita por PR e adicionar uma stack não exige deploy.

View on GitHub →