Plano de Backup — CAIXA1¶

Doc canônico do sistema de backup diário automatizado que a CAIXA1 (VPS Local Windows) executa. Baseia decisões nos dados coletados em DEV-1727 (inventario-vps-2026-08.md).

1. Princípios¶

1. Backup só é backup se restore funciona — F6 valida restore em ≥3 tipos de fonte antes de fechar o projeto.
2. Snapshot-style, deduplicado e encriptado — restic é o motor central (equivalente ao snapshot da Hostinger). Primeiro backup ~100 GB, incrementais diários em MB.
3. Falha ruidosa — qualquer job que falha dispara notificação WhatsApp via Evo comercial. Silêncio ≠ sucesso.
4. Um comando de restore de emergência documentado por cenário — quem restaurar não deve precisar reconstruir o raciocínio.
5. Retention determinística — --keep-daily 30 --keep-weekly 12 --keep-monthly 12 em todas as fontes. Retention consistente vale mais que retention perfeita por fonte.

2. Storage layout no HD F: (PD-Backup)¶

F:\
├── restic-repo\                         ← repo restic encriptado (todas fontes filesystem)
│   ├── config
│   ├── data\
│   ├── index\
│   ├── keys\
│   └── snapshots\
├── Backups\
│   ├── VPS-Dev\
│   │   ├── db-dumps\
│   │   │   ├── lara-postgres-<YYYYMMDD>.sql.gz
│   │   │   ├── cadencia-agenda-mysql-<YYYYMMDD>.sql.gz
│   │   │   └── crontabs-<YYYYMMDD>.txt
│   │   └── (fs vai direto pro restic-repo)
│   ├── VPS-Master\
│   │   ├── coolify-dump\
│   │   │   └── coolify-<YYYYMMDD>.tar.gz
│   │   ├── db-dumps\
│   │   │   ├── evolution-<YYYYMMDD>.sql.gz
│   │   │   ├── lara-legada-<YYYYMMDD>.sql.gz
│   │   │   ├── ecuro-<YYYYMMDD>.sql.gz
│   │   │   ├── confirmation-queue-<YYYYMMDD>.sql.gz
│   │   │   ├── cadencia-agenda-master-<YYYYMMDD>.sql.gz
│   │   │   └── crontabs-<YYYYMMDD>.txt
│   │   └── (fs + docker volumes vão direto pro restic-repo)
│   ├── Supabase\
│   │   ├── cadencia-<YYYYMMDD>.sql.gz
│   │   ├── hubpd-<YYYYMMDD>.sql.gz
│   │   └── outros-<YYYYMMDD>.sql.gz
│   ├── Vercel\
│   │   └── <project>-envs-<YYYYMMDD>.txt.gpg
│   ├── GitHub\
│   │   └── <org>\<repo>.git\           ← mirror clones (git fetch --all diário)
│   ├── 1P\
│   │   └── 1p-export-<YYYYMMDD>.zip.gpg
│   ├── Linear\
│   │   └── linear-<YYYYMMDD>.json.gz   ← semanal
│   ├── Cloudflare\
│   │   └── cf-<YYYYMMDD>.json          ← semanal
│   └── Resend\
│       └── events-<YYYYMMDD>.json.gz   ← semanal
└── Logs\
    └── backup\
        └── run-<YYYYMMDD>.log          ← rotativo 30 dias

Nota: dumps em Backups\ são inputs pro restic-repo\ (o repo dedupa entre versões). Manter arquivos crus em paralelo agiliza restore de casos triviais sem precisar restic restore.

3. Fontes e estratégia por fonte¶

3.1 VPS Dev (ssh vps-dev)¶

3.2 VPS Master (ssh -i ~/.ssh/hostinger_prod_master master@72.60.4.71)¶

3.3 Supabase¶

Dumps .sql.gz vão pra F:\Backups\Supabase\ e são consumidos pelo restic (dedupe entre versões).

3.4 Vercel¶

3.5 GitHub¶

3.6 1Password¶

Cuidado: export do 1P sai em plaintext antes de encriptar. Encriptação com GPG é obrigatória; deletar plaintext imediatamente. Senha GPG guardada em Hosts no 1P + cópia impressa/física.

3.7 Notebook (via Tailscale)¶

Nota: OneDrive já tem versionamento nativo, mas backup local dá restore instantâneo sem depender de conta MS.

3.8 Semanal¶

4. Retention¶

Aplicada via restic forget --keep-daily 30 --keep-weekly 12 --keep-monthly 12 --prune após cada backup.

• 30 dias diários — restore pontual de última semana/mês
• 12 semanas — cobre trimestre
• 12 meses — cobre 1 ano (redundância anti-catástrofe)

Total esperado no F: (596 GB): primeiro backup ~100 GB, delta médio ~2 GB/dia. Depois de 1 ano: ~300 GB dedupados. Folga confortável.

5. Restore procedure — cenários¶

5.1 "Perdi arquivo do notebook"¶

# Lista snapshots do notebook
restic -r F:\restic-repo snapshots --tag notebook

# Restaura arquivo específico do snapshot de N dias atrás
restic -r F:\restic-repo restore <snapshot-id> --target C:\restore\ --include "C:\dev\pd-framework\times\infra\<arquivo>"

Tempo estimado: < 5 min.

5.2 "Supabase apagou tabela"¶

# Restaura dump do último dia
gunzip -c F:\Backups\Supabase\cadencia-20260808.sql.gz > cadencia-20260808.sql

# Sobe Postgres temp local
docker run -d --name pg-restore -p 55432:5432 -e POSTGRES_PASSWORD=temp postgres:15
psql -h localhost -p 55432 -U postgres -f cadencia-20260808.sql

# Extrai só a tabela e re-injeta na produção
pg_dump -h localhost -p 55432 -U postgres -t <tabela> > tabela.sql
psql "postgresql://<supabase-connection>" -f tabela.sql

Tempo estimado: 15-30 min.

5.3 "VPS Master crashou total"¶

Sequência: 1. Provisionar nova VM Hostinger 2. Instalar Docker + Coolify 3. Restaurar /data/coolify do restic-repo → montar em /data/coolify da nova VM 4. Restaurar coolify-db dump em Postgres novo (Coolify vai reconectar) 5. Restaurar docker volumes de DBs por app (docker volume create + restic restore + subir container) 6. Ajustar DNS Cloudflare pro novo IP

Tempo estimado: 3-6 horas dependendo do tamanho dos volumes.

5.4 "GitHub bloqueou conta"¶

# Cada mirror clone em F:\Backups\GitHub\<org>\<repo>.git é um repo bare completo
cd F:\Backups\GitHub\felipeluissalgueiro\cadencia-app.git
git worktree add /tmp/restore main
# Ou push pra novo remoto (GitLab, Bitbucket, self-hosted)
git remote add new-remote git@gitlab.com:...
git push new-remote --all --tags

Tempo estimado: 1-2 horas pra restaurar acesso operacional.

5.5 "1P bloqueou conta"¶

# Export mais recente encriptado
gpg --decrypt F:\Backups\1P\1p-export-20260808.zip.gpg > 1p-export.zip
# Descompactar e importar em cliente 1P novo, Bitwarden, ou Vaultwarden self-hosted

Tempo estimado: 30 min-1h.

5.0 Comando de restore de emergência (setup-free)¶

Se você precisa restaurar algo agora, sem ler nada além disto:

# Na CAIXA1 (via SSH ou local):
$env:RESTIC_PASSWORD = cmd /c "op item get `"restic - CAIXA1 backup repo`" --vault Databases --fields password --reveal < NUL"
$env:RESTIC_REPOSITORY = "F:\restic-repo"

# Lista todos os snapshots
C:\Tools\restic\restic.exe snapshots

# Restaura último snapshot completo pra C:\restore\
C:\Tools\restic\restic.exe restore latest --target C:\restore\

# Restaura arquivo específico
C:\Tools\restic\restic.exe restore <snapshot-id> --target C:\restore\ --include "/path/no/backup"

Se op não estiver disponível, a senha está no 1P vault Databases, item restic - CAIXA1 backup repo (ID: tfso2ux7uajctdq4nbawainkn4).

5.6 "Restic repo corrompeu"¶

# Check integridade (roda semanal automático)
restic -r F:\restic-repo check --read-data

# Se corrompido: fallback pros dumps crus em F:\Backups\ (sem incrementalidade mas dados presentes)

Última linha de defesa: os dumps crus em F:\Backups\<fonte>\ não dependem de restic. Se restic morrer, ainda temos o essencial.

6. Monitoramento¶

6.1 Log local¶

Todo script escreve em F:\Logs\backup\run-<YYYYMMDD>.log (formato: timestamp | fonte | ação | status | tamanho | duração). Rotação: 30 dias.

6.2 Notificação de falha¶

Wrapper run-all-backups.ps1 captura exit code de cada script. Qualquer falha → mensagem WhatsApp via evo_client.py pro número comercial de Felipe:

[BACKUP CAIXA1] ❌ FALHA <fonte> em <data> <hora>
Erro: <primeira linha do stderr>
Log completo: F:\Logs\backup\run-<data>.log

Sucesso silencioso — sem notificação diária de sucesso (evita ruído). Digest semanal (domingo 10h) com resumo dos 7 dias: quantos backups OK, tamanhos, retention aplicada.

6.3 Deadman¶

Se nenhum backup rodar por 48h, cron separado na CAIXA1 dispara alerta ("último snapshot restic tem mais de 48h — CAIXA1 sem backup"). Detecta cenário onde CAIXA1 desligou/travou e ninguém notou.

7. Riscos e mitigações¶

8. Dependências¶

• Restic instalado no CAIXA1 (F3 — DEV-1730)
• Senha restic no 1P (F3)
• HDs renomeados (F2 — DEV-1729)
• Chaves SSH CAIXA1 → VPS Dev + Master já validadas (session 08/08 01:02)
• op service account rodando no CAIXA1 (validado)
• evo_client.py acessível do CAIXA1 (validar em F4)

9. Referências¶

• Inventário fonte: inventario-vps-2026-08.md — F0/DEV-1727
• Skills: /vps-local, /vps-local-acesso-remoto
• Doc VPS Local: Obsidian_Vaults_Pessoal/Infra/2026-08-08 VPS Local CAIXA1 (Windows).md
• Restic docs: https://restic.readthedocs.io/
• Coolify backup: https://coolify.io/docs/knowledge-base/backup