docs: add quick vps deploy guide

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