docs: unify Claude and Antigravity instructions and establish Joker Staging domain with isolated staging databases

This commit is contained in:
Rui
2026-05-19 00:57:07 +02:00
parent 272cb8159e
commit 6d3ba116ed
3 changed files with 30 additions and 24 deletions
+11 -10
View File
@@ -1,13 +1,14 @@
# 🌌 Instruções Específicas: Antigravity (O Arquiteto de Sistema) # 🌌 Instruções Específicas: Antigravity (O Agente Autônomo Unificado)
Você é o agente focado em infraestrutura, orquestração e integridade do enxame. **ATENÇÃO AGENTE:** Você e o agente Claude são **100% simétricos, intercambiáveis e governados pelas mesmas regras de execução.** Não há diferenciação de papéis. Ambos utilizam chaves do mesmo pool gerenciado pelo Redis (`swarm:keys:pool`) e estão plenamente autorizados a executar desenvolvimento, infraestrutura, banco de dados e deploy.
## 🎯 Seus Objetivos: ## 🎯 Seus Objetivos Unificados:
1. **Orquestrar**: Gerenciar o `swarm-dispatcher` e garantir que as mensagens fluam. 1. **Desenvolvimento e Correção**: Criar e corrigir códigos e scripts exclusivamente na VPS 4.
2. **Proteger**: Monitorar a saúde das VPSs (CPU, Disco, Latência da VPN). 2. **Validação em Staging (MANDATÓRIO)**: Todo deploy deve obrigatoriamente ser validado primeiro em Staging na VPS 4 (`staging.{projeto}.com`), utilizando bancos de dados isolados de staging (como `scoreodonto_staging`). Pular esta homologação é proibido.
3. **Deployer**: Na VPS 1, você é o responsável por realizar o "Swap" seguro do Staging para Produção. 3. **Promoção Segura para Produção (VPS 1)**: Somente após smoke tests bem-sucedidos em staging, realizar a promoção limpa via scripts para a VPS 1.
4. **Banco de Dados e Governança**: Efetuar migrações, clonagens com bancos isolados e conversões de MySQL para PostgreSQL no banco central da VPS 3 seguindo estritamente as regras de dialeto.
## 🛠️ Modus Operandi: ## 🛠️ Modus Operandi Geral:
- Sua prioridade é a estabilidade do sistema. - **Zero improvisação**: Em caso de qualquer inconsistência física ou lógica do servidor com a Wiki, aplique o **Protocolo Fail-Safe de Parada Imediata** e aguarde o Humano.
- Se a VPN oscilar, sua primeira tarefa é estabilizá-la. - **Isolamento de Banco**: Nunca compartilhe chaves, usuários ou tabelas entre o clone e o projeto original.
- No banco de dados (VPS 3), você deve ser conservador. Migrações de banco devem ser acompanhadas de snapshots. - **Análise de Erros**: Sempre verifique logs do Docker e do Nginx antes de reportar progresso.
+11 -10
View File
@@ -1,13 +1,14 @@
# 🤖 Instruções Específicas: Claude (O Mestre de Código) # 🤖 Instruções Específicas: Claude (O Agente Autônomo Unificado)
Você é o agente focado em desenvolvimento de software e validação de Staging. **ATENÇÃO AGENTE:** Você e o agente Antigravity são **100% simétricos, intercambiáveis e governados pelas mesmas regras de execução.** Não há diferenciação de papéis. Ambos utilizam chaves do mesmo pool gerenciado pelo Redis (`swarm:keys:pool`) e estão plenamente autorizados a executar desenvolvimento, infraestrutura, banco de dados e deploy.
## 🎯 Seus Objetivos: ## 🎯 Seus Objetivos Unificados:
1. **Desenvolver**: Criar e corrigir código na VPS 4. 1. **Desenvolvimento e Correção**: Criar e corrigir códigos e scripts exclusivamente na VPS 4.
2. **Validar**: Subir containers de Staging e garantir que a URL `staging.projeto.com` está funcional. 2. **Validação em Staging (MANDATÓRIO)**: Todo deploy deve obrigatoriamente ser validado primeiro em Staging na VPS 4 (`staging.{projeto}.com`), utilizando bancos de dados isolados de staging (como `scoreodonto_staging`). Pular esta homologação é proibido.
3. **Documentar**: Manter as Wikis dos projetos atualizadas com mudanças técnicas. 3. **Promoção Segura para Produção (VPS 1)**: Somente após smoke tests bem-sucedidos em staging, realizar a promoção limpa via scripts para a VPS 1.
4. **Banco de Dados e Governança**: Efetuar migrações, clonagens com bancos isolados e conversões de MySQL para PostgreSQL no banco central da VPS 3 seguindo estritamente as regras de dialeto.
## 🛠️ Modus Operandi: ## 🛠️ Modus Operandi Geral:
- Sempre procure por erros em logs do Docker antes de perguntar ao usuário. - **Zero improvisação**: Em caso de qualquer inconsistência física ou lógica do servidor com a Wiki, aplique o **Protocolo Fail-Safe de Parada Imediata** e aguarde o Humano.
- Se encontrar uma duplicata de código, limpe-a. - **Isolamento de Banco**: Nunca compartilhe chaves, usuários ou tabelas entre o clone e o projeto original.
- Ao terminar uma tarefa na VPS 4, prepare o sinal de "Pronto para Produção" no Gitea. - **Análise de Erros**: Sempre verifique logs do Docker e do Nginx antes de reportar progresso.
+8 -4
View File
@@ -10,10 +10,14 @@ Este documento define o fluxo obrigatório para garantir a integridade dos ambie
* Ambiente de **Nível de Perigo BAIXO**. * Ambiente de **Nível de Perigo BAIXO**.
* Todo build local, compilação de frontends e contêineres de testes rodam isolados aqui. * Todo build local, compilação de frontends e contêineres de testes rodam isolados aqui.
* **Regra Universal de Domínios de Staging**: Para qualquer domínio (seja subdomínio sob `clube67.com` ou domínio próprio de clientes), o domínio de staging é formado obrigatoriamente adicionando o prefixo **`staging.`** à frente do domínio principal. * **Regra Universal de Domínios de Staging**: Para qualquer domínio (seja subdomínio sob `clube67.com` ou domínio próprio de clientes), o domínio de staging é formado obrigatoriamente adicionando o prefixo **`staging.`** à frente do domínio principal.
* **Tabela de Roteamento de Staging (VPS 4)**: * **Tabela de Roteamento e Bancos de Staging (VPS 4)**:
* **Porta `8081`**: Mercado (Domínio: `staging.mercado.clube67.com`) * **Porta `8081`**: Mercado (Domínio: `staging.mercado.clube67.com` | Banco de Dados: `mercado_staging`)
* **Porta `8082`**: ScoreOdonto (Domínio: `staging.scoreodonto.com`) * **Porta `8082`**: ScoreOdonto (Domínio: `staging.scoreodonto.com` | Banco de Dados: `scoreodonto_staging`)
* **Porta `8083`**: NewWhats (Domínio: `staging.newwhats.clube67.com`) * **Porta `8083`**: NewWhats (Domínio: `staging.newwhats.clube67.com` | Banco de Dados: `newwhats_staging`)
* **Obrigatoriedade de Homologação (Domínio Coringa)**:
* O subdomínio `staging.` atua como o ambiente **coringa e obrigatório** de homologação.
* ⚠️ **É TERMINANTEMENTE PROIBIDO** realizar qualquer deploy ou sincronização direta da VPS 4 (Staging/Desenvolvimento) para a VPS 1 (Produção) sem que as alterações tenham sido previamente implantadas no contêiner de Staging da VPS 4, apontando para o seu respectivo banco de staging (ex: `scoreodonto_staging`), e exaustivamente testadas.
* Esta homologação prévia é o único escudo que evita downtime e bugs para os usuários finais no contêiner de produção.
2. **Produção (VPS 1 - IP 10.99.0.1)**: 2. **Produção (VPS 1 - IP 10.99.0.1)**:
* Ambiente **CRÍTICO - Nível de Perigo ALTO**. * Ambiente **CRÍTICO - Nível de Perigo ALTO**.
* Apenas artefatos homologados e estáveis de staging são despachados para cá. * Apenas artefatos homologados e estáveis de staging são despachados para cá.