docs(clube67): alinhar regras de versionamento automatico (+1) e contexto Docker com o padrao da infraestrutura

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.