name	django-services-use-cases
description	Criar e evoluir regras de negócio em `services.py` ou `use_cases.py` por app. Usar quando implementar fluxos de domínio, integrações externas e operações com múltiplas escritas.

Objetivo

Concentrar regras de negócio fora da camada HTTP para melhorar testabilidade e reuso.

Fluxo

Identificar a regra de negócio e definir o app dono do fluxo.
Criar função ou classe focada em um caso de uso.
Encapsular operações de escrita múltipla com transaction.atomic() quando necessário.
Integrar com managers e serializers sem acoplamento indevido.
Expor retorno simples e previsível para consumo pela API.

Evitar lógica de domínio em views e serializers.
Não alterar arquivos da app core/ (ver AGENTS.md §8.1).
Evitar dependência direta de models de outro app sem contrato claro.
Garantir mensagens de erro seguras e alinhadas a core.excecoes quando aplicável.
Não registrar PII em logs.
Tratar integrações externas com timeout, retries e falhas controladas quando aplicável.

name	django-services-use-cases
description	Criar e evoluir regras de negócio em `services.py` ou `use_cases.py` por app. Usar quando implementar fluxos de domínio, integrações externas e operações com múltiplas escritas.

Concentrar regras de negócio fora da camada HTTP para melhorar testabilidade e reuso.

Identificar a regra de negócio e definir o app dono do fluxo.
Criar função ou classe focada em um caso de uso.
Encapsular operações de escrita múltipla com transaction.atomic() quando necessário.
Integrar com managers e serializers sem acoplamento indevido.
Expor retorno simples e previsível para consumo pela API.

Evitar lógica de domínio em views e serializers.
Não alterar arquivos da app core/ (ver AGENTS.md §8.1).
Evitar dependência direta de models de outro app sem contrato claro.
Garantir mensagens de erro seguras e alinhadas a core.excecoes quando aplicável.
Não registrar PII em logs.
Tratar integrações externas com timeout, retries e falhas controladas quando aplicável.