Pular para o conteúdo
Veritas
  • Nada com esse termo. Tente o nome de uma lib ou de uma stack.

Títulos, descrições e seções de todas as skills.

Arquivo de apoio da skill django · architecture.md

Django — estrutura e configuração

Detalhamento das camadas descritas no SKILL.md. Carrega sob demanda.

Estrutura de pastas

Use apps/ como pasta guarda-chuva para separar domínio de infraestrutura.

apps/
  <dominio>/
    services/      # lógica de negócio isolada, sempre em funções
    api/
      views.py
      urls.py
      serializers/

A regra que não se quebra: services/ nunca importa nada de api/. A dependência aponta sempre de fora para dentro — o transporte conhece o domínio, o domínio não conhece o transporte.

Configurações

Centralizadas e tipadas, via django-environ ou pydantic-settings. Nada de os.environ solto espalhado pelo código.

Onde cada coisa acontece

Preciso... Vai em
Autenticar e autorizar a requisição View
Validar o formato do payload Serializer
Validar contra o estado do sistema Service
Abrir transação Service
Disparar email, webhook, fila transaction.on_commit() dentro do service
Consultar ou gravar Model / QuerySet, chamado pelo service
Ver no GitHub →