# 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).