From 5715a97b7a8fdd3d46d5650926e6015cd6c74cc1 Mon Sep 17 00:00:00 2001 From: Rui Date: Mon, 18 May 2026 22:35:45 +0200 Subject: [PATCH] docs: implement strict Context Migration Protocol (Domain <-> Subdomain) in staging and deploy protocol --- global/protocolo_deploy_staging.md | 28 +++++++++++++++++++++++++++- 1 file changed, 27 insertions(+), 1 deletion(-) diff --git a/global/protocolo_deploy_staging.md b/global/protocolo_deploy_staging.md index c55d04b..ad4eeb0 100644 --- a/global/protocolo_deploy_staging.md +++ b/global/protocolo_deploy_staging.md @@ -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.*