🧠 Doutrina Mestre dos Agentes (Multi-VPS)

Este documento define a consciência situacional obrigatória para todos os agentes de IA.

📍 Identificação de Localização

Antes de qualquer ação, identifique seu IP interno:

10.99.0.1 (VPS 1 - PRODUÇÃO): Ambiente CRÍTICO. Rodando Traefik e Nginx.
- Regra: Apenas deploys homologados em Staging. Nunca mexa na infraestrutura de rede.
10.99.0.3 (VPS 3 - CÉREBRO): Onde reside o Gitea, Postgres e DragonflyDB.
- Regra: Proteja os dados. Backups antes de qualquer alteração de schema.
10.99.0.4 (VPS 4 - LABORATÓRIO): Desenvolvimento e Staging.
- Regra: Liberdade para testar, criar e quebrar containers. É o local de nascimento do código.

🔐 Segurança e VPN

Interface wg0: É a sua linha de vida. Nunca altere configurações de rede ou firewall (UFW) que possam isolar a VPS.
Chaves SSH: Use apenas chaves locais autorizadas para sincronização entre as VPSs do enxame.

📇 Protocolo de Identidade Estática (`~/.vps_identity`)

Para garantir 100% de consciência situacional à prova de falhas sem depender de chamadas de rede externas, cada máquina do enxame possui um arquivo de identidade em /home/deploy/.vps_identity.

📄 Estrutura Obrigatória do JSON:

Todo arquivo .vps_identity deve conter exatamente a seguinte estrutura:

{
  "vps_id": 4,
  "vps_name": "VPS-4-LABORATORIO",
  "ip_vpn": "10.99.0.4",
  "role": "Desenvolvimento, Builds e Staging",
  "danger_level": "BAIXO - Liberdade para testar e recriar"
}

🚨 Obrigações das IAs e Agentes:

Verificação Obrigatória: Toda execução de script ou agente deve prioritariamente ler e interpretar o arquivo /home/deploy/.vps_identity para calibrar o seu escopo de atuação.
Respeito ao Danger Level (Nível de Perigo):
- Nível de Perigo ALTO (ex: VPS 1, VPS 3): Agentes NÃO PODEM rodar comandos experimentais, mutações não homologadas de bancos de dados ou reinstalar dependências críticas sem backups nítidos e aprovação explícita.
- Nível de Perigo BAIXO (ex: VPS 4): O agente possui total autonomia para realizar testes, compilar códigos, reinstalar pacotes e reiniciar contêineres Docker de staging.
Resiliência (Fallback): Caso o arquivo .vps_identity não exista ou esteja ilegível, o agente deve fazer o fallback dinâmico (buscando o IP 10.99.x.x via hostname -I) e assumir o perfil de segurança mais restritivo por padrão.

🗣️ Comunicação

Todo o desenvolvimento, comentários e commits devem ser em PORTUGUÊS.
Use o protocolo PGS (Protocolo Gitea Swarm) para hand-offs.

🚫 NUNCA...

Nunca tente acessar servidores fora da rede 10.99.0.x.
Nunca exponha senhas ou chaves privadas em logs ou comentários.
Nunca altere o serviço swarm-listener sem autorização.

📂 Diretórios de Projetos e Stacks Ativos (VPS 4)

Para garantir a integridade dos serviços em execução no Laboratório / Sandbox (VPS 4 - 10.99.0.4), os seguintes diretórios dentro de /home/deploy/stack/ são de produção/homologação ativa e devem ser ESTRITAMENTE PRESERVADOS contra qualquer comando de deleção ou limpeza órfã:

📁 scoreodonto.com/: Aplicação e containers do ecossistema ScoreOdonto.
📁 subdominio.clube67.com/: Branding, front-end e back-end do Gerenciador de Subdomínios Clube67.
📁 traefik/: Roteador e proxy reverso de borda da VPS 4.
📁 portainer/: Interface gráfica de monitoramento e gerenciamento de containers Docker.
📁 self-healing/: Scripts e rotinas de auto-recuperação e integridade do sistema.
📁 webhook-listener/: Ouvinte de webhooks de GitOps (porta 9000) para deploys contínuos.
📁 soc/: Scripts de auditoria de segurança e detecção de intrusões.

3.8 KiB Raw Blame History