name	django-managers
description	Projetar QuerySets e managers customizados em `managers.py` para encapsular consultas reutilizáveis e evitar N+1. Usar quando criar filtros complexos, seleção por contexto e acessos de dados de domínio.

Objetivo

Centralizar regras de consulta em managers e QuerySets para reduzir duplicação e melhorar performance.

Fluxo

Mapear consultas repetidas e mover a lógica para app/managers.py.
Implementar métodos explícitos com nomes de intenção clara.
Encadear select_related e prefetch_related para casos de listagem e detalhe.
Tratar erros esperados de consulta com exceções seguras.
Expor o manager no model com objects = MeuManager() quando necessário.

Não colocar regra de negócio de processo no manager; manter foco em acesso a dados.
Não alterar arquivos da app core/ (ver AGENTS.md §8.1).
Evitar filtros implícitos ambíguos; usar assinaturas previsíveis.
Evitar consultas em loop dentro de serializers ou views quando um QuerySet resolvido atende.
Usar logs sem PII em falhas de consulta.

name	django-managers
description	Projetar QuerySets e managers customizados em `managers.py` para encapsular consultas reutilizáveis e evitar N+1. Usar quando criar filtros complexos, seleção por contexto e acessos de dados de domínio.

Centralizar regras de consulta em managers e QuerySets para reduzir duplicação e melhorar performance.

Mapear consultas repetidas e mover a lógica para app/managers.py.
Implementar métodos explícitos com nomes de intenção clara.
Encadear select_related e prefetch_related para casos de listagem e detalhe.
Tratar erros esperados de consulta com exceções seguras.
Expor o manager no model com objects = MeuManager() quando necessário.

Não colocar regra de negócio de processo no manager; manter foco em acesso a dados.
Não alterar arquivos da app core/ (ver AGENTS.md §8.1).
Evitar filtros implícitos ambíguos; usar assinaturas previsíveis.
Evitar consultas em loop dentro de serializers ou views quando um QuerySet resolvido atende.
Usar logs sem PII em falhas de consulta.