From be9816a3a8503b1aa305ef829aa2eb0845cf2f40 Mon Sep 17 00:00:00 2001
From: codex-bot <bot@local>
Date: Thu, 30 Oct 2025 16:45:50 -0300
Subject: [PATCH] docs: add quick vps deploy guide

---
 docs/DEPLOY-MANUAL.md | 46 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 46 insertions(+)
 create mode 100644 docs/DEPLOY-MANUAL.md

diff --git a/docs/DEPLOY-MANUAL.md b/docs/DEPLOY-MANUAL.md
new file mode 100644
index 0000000..4487d5c
--- /dev/null
+++ b/docs/DEPLOY-MANUAL.md
@@ -0,0 +1,46 @@
+# Deploy Manual via VPS
+
+## Acesso rápido
+- Host: 31.220.78.20
+- Usuário: root
+- Caminho do projeto: /srv/apps/sistema
+- Chave SSH (local): ./codex_ed25519 (chmod 600)
+- Login: `ssh -i ./codex_ed25519 root@31.220.78.20`
+
+## Passo a passo resumido
+1. Conectar na VPS usando o comando acima.
+2. Dentro de `/srv/apps/sistema`, atualizar o código:
+   ```bash
+   cd /srv/apps/sistema
+   git pull
+   ```
+3. Aplicar a stack Docker (web + Convex):
+   ```bash
+   docker stack deploy --with-registry-auth -c stack.yml sistema
+   ```
+4. (Opcional) Forçar o rollout do serviço web após o deploy:
+   ```bash
+   docker service update --force sistema_web
+   ```
+5. Verificar status dos serviços:
+   ```bash
+   docker stack services sistema
+   docker service ps sistema_web
+   ```
+6. Consultar logs em tempo real quando necessário:
+   ```bash
+   docker service logs -f sistema_web
+   docker service logs -f sistema_convex_backend
+   ```
+
+## Quando o GitHub Actions travar
+- Execute o fluxo acima manualmente para liberar o deploy.
+- Se somente funções Convex mudaram:
+   ```bash
+   docker service update --force sistema_convex_backend
+   ```
+- Se precisar ajustar variáveis de ambiente, edite `/srv/apps/sistema/.env` e reexecute o passo 3.
+
+## Referências
+- Runbook completo: docs/OPERATIONS.md
+- Workflow automatizado: .github/workflows/ci-cd-web-desktop.yml