chore: bootstrap MikroRMM local development baseline
- 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>
This commit is contained in:
co-authored by
Claude Sonnet 5
parent
1a4b635052
commit
7a4979e0e1
@@ -0,0 +1,24 @@
|
||||
# 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).
|
||||
Reference in New Issue
Block a user