Regras de Negócio

Esta seção documenta as regras que governam o comportamento do sistema — coisas que não estão óbvias no código mas determinam como tudo funciona.

Por que esta seção existe

Regras de negócio são o conhecimento mais frágil do sistema. Elas estão espalhadas em condicionais, constantes e comentários pelo código. Um dev que não as conhece pode silenciosamente quebrá-las ao refatorar algo que "parece igual".

Índice de regras

Área	Arquivo
WhatsApp & Meta API	whatsapp
Campanhas (envio, rate limit, atribuição)	campanhas
Redirecionamento de campanha	redirecionamento
Caixas (Inboxes Chatwoot)	caixas
Lojas e aliases	lojas
RFM e segmentação	rfm
Permissões (RBAC)	permissoes

Regras críticas (não violar)

Regras que já causaram incidentes

1. Deploy sem os 3 arquivos docker-compose → Traefik perde roteamento → 404 em tudo
2. Rebuild de frontend sem buscar key do Key Vault → Clerk não carrega → sistema fora do ar
3. Enviar mensagem fora da janela 24h sem usar template aprovado → erro 131026 na Meta → mensagem não entregue
4. Editar botão de template aprovado sem criar novo template → Meta rejeita → campanha falha