diff --git a/clube67/arquitetura.md b/clube67/arquitetura.md index 1dd7838..e9298d5 100644 --- a/clube67/arquitetura.md +++ b/clube67/arquitetura.md @@ -260,3 +260,27 @@ Para configurar alertas de auto-cura no Grafana: 3. Roteie a notificação para o Contact Point `Gitea-Bridge`. Assim que a falha disparar, a Gitea-Bridge multi-tenant criará uma Issue automática com o prefixo `🚨 [AUTO-BUG]` no repositório `clube67_newwhats.local`, contendo todo o stack trace para o Agente IA realizar a manutenção e o hotfix. + +--- + +## 🔄 Fluxo de Deploy Contínuo e Versionamento Automático (+1) +No ecossistema do **Clube67 / NewWhats**, o webhook escuta na porta `9000` na VPS 4 e aciona a automação de compilação e rsync para a VPS 1. + +### 📦 Regras Obrigatórias de Incremento de Versão (Build Bump) +Para assegurar que a interface web do painel exiba sempre a versão real compilada e que o histórico de deploys em `deploys.json` avance de forma autônoma: + +1. O script `update-version.js` deve ser mantido na raiz do projeto. +2. No arquivo `frontend/package.json`, o comando de build DEVE ser rigorosamente configurado como: + ```json + "scripts": { + "build": "node ../update-version.js && next build" + } + ``` + +### 🐳 Regra de Contexto Docker +1. O **Build Context** no `docker-compose.yml` deve obrigatoriamente apontar para a raiz do projeto (`context: .`). +2. O `Dockerfile` do frontend deve copiar os arquivos da raiz e definir o `WORKDIR` apropriado. + +> [!WARNING] +> **COMPORTAMENTO DE VERSIONAMENTO NO DOCKER** +> O incremento do `+1` ocorre dentro do container isolado durante a compilação na VPS 4. A nova versão aparecerá instantaneamente no ar, mas os arquivos no repositório Git não sofrerão commit automático. Em lançamentos de grandes releases (ex: `V2.0.0`), o desenvolvedor deve realizar o bump manual no VSCode antes de disparar o webhook.