# 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