GustavoandClaude Sonnet 5
7a4979e0e1
- Baseline sobre upstream 2GT-Media-Group-LLC/mikrotik-manager @ 1a4b635 (v0.24.5-beta)
- Adiciona docs/SISTEMA_ATUAL.md e CLAUDE.md (documentação operacional)
- Ignora .secrets-local/ (nunca versionar secrets)
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
25 lines
1.4 KiB
Markdown
25 lines
1.4 KiB
Markdown
# 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).
|