docs: implement strict Context Migration Protocol (Domain <-> Subdomain) in staging and deploy protocol
This commit is contained in:
@@ -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.*
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user