docs: add new project auto-config protocol to doutrina_agentes

2026-05-17 09:38:03 +02:00
parent abb92ad7a0
commit beeea9bab4
1 changed files with 22 additions and 4 deletions
@@ -37,15 +37,33 @@ Todo arquivo `.vps_identity` deve conter exatamente a seguinte estrutura:
   - **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.
 3. **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.

+## 🔄 Protocolo de Criação e Configuração de Novos Projetos (Auto-Config de Webhook)
+
+Sempre que um novo projeto for criado no ecossistema Swarm, os agentes e desenvolvedores **devem** seguir e configurar automaticamente a seguinte rotina de integração de CI/CD para que o GitOps funcione perfeitamente:
+
+### 1. Criação Obrigatória do Webhook de Deploy
+Todo novo repositório criado no Gitea **DEVE** possuir um Webhook de deploy ativo configurado da seguinte forma:
+*   **URL de Destino**: `http://10.99.0.3:5000/webhook` (Se configurado externamente) ou `http://127.0.0.1:5000/webhook` (Se configurado de dentro da VPS 3).
+*   **Tipo de Conteúdo**: `application/json`
+*   **Segredo (Secret)**: Em branco ou chave secreta padrão.
+*   **Eventos que disparam**: Apenas o evento de **Push** (Commit enviado).
+
+> [!IMPORTANT]
+> **Autonomia do Agente (Auto-Identificação)**:
+> Se você (o Agente de IA) identificar que está trabalhando em um **novo projeto** ou que o repositório do projeto atual **não possui** o webhook do Swarm Dispatcher (`http://127.0.0.1:5000/webhook`) configurado no Gitea:
+> 1. Você **DEVE** usar a API REST do Gitea para criar ou corrigir esse webhook automaticamente.
+> 2. Você **DEVE** garantir a criação do arquivo `.vps_identity` apropriado nas VPSs correspondentes.
+> 3. Você **DEVE** estruturar o `docker-compose.yml` do projeto sob a pasta `/home/deploy/stack/<nome-do-projeto>/` seguindo o padrão rootless.
+
+## 🗣️ Comunicação
+- Todo o desenvolvimento, comentários e commits devem ser em **PORTUGUÊS**.
+- Use o protocolo **PGS (Protocolo Gitea Swarm)** para hand-offs.
+
 ## 📂 Diretórios de Projetos e Stacks Ativos (Mapeamento de Preservação)

 ### 🖥️ VPS 1 - Produção (10.99.0.1)