docs: implement strict Context Migration Protocol (Domain <-> Subdomain) in staging and deploy protocol

This commit is contained in:
Rui
2026-05-18 22:35:45 +02:00
parent a121c70d2c
commit 5715a97b7a
+27 -1
View File
@@ -68,5 +68,31 @@ Para permitir a colaboração fluida entre as VPSs e agentes sem causar conflito
--- ---
*Este protocolo de governança e deploy é mandatório para todos os nós do enxame.* ## 🔀 4. Protocolo de Migração de Contexto (Domínio ⇄ Subdomínio)
Sempre que um projeto necessitar de migração de endereço (seja de um domínio próprio para um subdomínio, ou vice-versa), o agente de IA deve seguir rigorosamente as diretrizes abaixo para evitar conflitos, órfãos e quebras na automação:
### 📁 A. Governança de Repositórios no Gitea
* **Solicitação / Criação**: Se o projeto mudar de nome ou escopo (ex: `scoreodonto.com` para `scoreodonto.clube67.com`), o agente deve:
* Verificar se o novo repositório correspondente já existe no Gitea.
* Caso não exista, o agente deve **solicitar a criação** do novo repositório ao Administrador ou, caso possua credenciais via API/Terminal, **criar ele mesmo o novo repositório** para manter o versionamento limpo.
* **Nova Documentação**: O agente deve escrever e publicar uma **nova documentação de arquitetura, portas e roteamento** na Wiki específica do novo repositório antes de realizar a migração.
### ⚙️ B. Ajuste de Scripts, Webhooks e Contêineres
* O agente deve efetuar uma varredura cirúrgica e atualizar todos os arquivos de suporte do ecossistema:
* **Scripts de automação (`.sh`)**: Alterar caminhos, nomes de diretórios e URLs de produção.
* **Webhooks**: Remover webhooks do repositório antigo no Gitea e configurar o novo webhook no novo repositório, ou garantir que o Webhook do Sistema unificado cubra a nova rota.
* **Configurações de Proxy Reverso**: Atualizar os arquivos do Traefik, arquivos de configuração do Nginx (`/etc/nginx/sites-available`), e as portas reservadas na VPN (VPS 4 para VPS 1).
* **Contêineres e Dockerfiles**: Renomear contêineres e atualizar as variáveis de ambiente (`.env`) e chaves do banco de dados no PostgreSQL/DragonflyDB.
### 🔍 C. Análise de Atritos e Inconsistências (Mapeamento Obrigatório)
* **Antes de alterar qualquer código**, o agente deve mapear e relatar formalmente na Issue do Gitea:
1. **Listagem Completa**: Todos os recursos consumidos pelo projeto antes da migração (portas, caminhos de volumes, credenciais de banco).
2. **Inconsistências e Conflitos**: Verificar se há risco de colisão de portas com outros projetos ativos na VPS 1 ou VPS 4.
3. **Atritos de Integração**: Garantir que as dependências (como bancos de dados e chaves SSH) não sejam interrompidas e listar potenciais incompatibilidades de rede.
* *Se houver atrito, o agente deve aplicar o **Protocolo Fail-Safe de Parada Imediata**, abortar e aguardar orientação.*
---
*Este protocolo de governança, deploy e migração é mandatório para todos os nós do enxame.*