MIKROTIK-RMM/CLAUDE.md

CLAUDE.md — MikroRMM

Antes de alterar qualquer coisa neste projeto, leia nesta ordem:

1. Este arquivo (CLAUDE.md)
2. docs/SISTEMA_ATUAL.md
3. git status
4. git log -5 --oneline

Regras permanentes

• Buscar causa-raiz antes de aplicar qualquer correção.
• Não alterar código sem entender o fluxo afetado.
• Preservar compatibilidade DEV/PROD (mesmo docker-compose.yml como base).
• Nunca versionar secrets. .env e .secrets-local/ ficam fora do Git.
• Mudança de schema exige migration (backend/src/db/migrate.ts), nunca alteração manual do banco.
• Testes focados primeiro (teste/módulo afetado), depois suíte completa como gate final.
• Smoke real (docker compose ps + curl https://localhost/api/health) quando a mudança afetar runtime.
• Atualizar docs/SISTEMA_ATUAL.md quando a mudança alterar arquitetura ou estado de verdade do sistema (não é changelog).
• Não executar ações destrutivas em RouterBOARD sem missão explícita autorizando.
• Não conectar clientes reais durante desenvolvimento.
• Não considerar uma missão concluída com Git sujo (git status deve estar limpo, salvo arquivos intencionalmente não commitados e justificados).

Ambiente local

Ver seção 12 de docs/SISTEMA_ATUAL.md. Stack sobe com docker compose up -d a partir de docker-compose.yml (build local, não usar docker-compose.ghcr.yml em DEV).