melgarafael DeskcommCRM — doutrina de código
A fonte da verdade é o
CLAUDE.mdda raiz, lido doorigin/maine não de um resumo. Esta skill existe para te fazer abri-lo na hora certa e para carregar as três regras que mais custam caro quando esquecidas.
1. Leia antes de escrever
| arquivo | quando |
|---|---|
CLAUDE.md |
sempre, antes de qualquer código — contém a Definition of Done, que muda |
VISION.md |
antes de decidir escopo, ou de dizer não a uma feature |
docs/doctrine/ |
ao mexer em canal, agente, ou peça que se conecte a outra |
ARCHITECTURE.md |
para a visão de uma página |
Não confie em resumo de doutrina — nem neste arquivo. A Definition of Done já foi de 13 para 14
itens; cópia congelada ensina a regra de ontem. Abra o CLAUDE.md.
2. As três que mais custam
Multi-tenancy. Toda tabela tenant-aware leva organization_id uuid not null e RLS com policy
tenant_isolation_<tabela>_all via fn_user_org_ids(). Service role bypassa RLS — handler que o usa
filtra organization_id manualmente, resolvido de fonte confiável (cookie, JWT, segredo de
webhook, token de path), nunca do body. No backend é sempre getUser(), nunca getSession().
Schema sai em tripla. Arquivo em supabase/migrations/, apêndice idempotente no
supabase/baseline.sql, e linha no MANIFEST.md. O kit self-host aplica só o baseline — o que
não chega lá não chega em quem instalou numa VPS, que é o cliente que paga. Constraint nova exige
corrigir os dados antes, senão o update.sh do clone quebra.
Nenhuma feature nomeia um provider. Provider vive em lib/channels/. pnpm lint:channels é
catraca com lista de dívida: arquivo novo sujo reprova — e arquivo que ficou limpo e não saiu da
lista também reprova.
3. O eixo que não é técnico
A monetização é self-host em VPS, não assinatura: quem instala é o cliente. Então uma mudança pode ser tecnicamente impecável e ainda assim ser recusada — env var nova sem default quebra instalação fresca, dependência de serviço pago obrigatório quebra o modelo, e a pior de todas é a falha-em-verde: a sonda que declara sucesso medindo caminho diferente do que o usuário usa. Num produto que a pessoa instala sozinha, ela não descobre que está quebrado.
4. Antes de dizer "pronto"
Verde de teste não é prova de comportamento. Sabote a linha que você corrigiu e confirme que a suíte fica vermelha — teste que não reprova não guarda nada. E declare o que não mediu: é o campo que separa medição de relato.
Não-objetivos
Não lista comandos de fluxo — não existem /fix-bug nem /add-module neste repo. Não descreve
estrutura de pastas nem convenção de nome de arquivo: a versão anterior deste arquivo era gerada
automaticamente e ensinava snake_case com imports relativos, quando o repo usa kebab-case com
alias @/. Detalhe correto mora no CLAUDE.md, que está atualizado — o que este arquivo não pode
prometer.