> For the complete documentation index, see [llms.txt](https://lunarie.gitbook.io/lunarie-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://lunarie.gitbook.io/lunarie-docs/operacao/03-backup-e-recuperacao.md).

# Backup e Recuperação

> **Última atualização:** 08/10/2026 O que protege os dados da Lunarie hoje, como recuperar em cada cenário e quais lacunas existem.

## O que está protegido

| Ativo                                       | Proteção                                                                                                                                                                              |
| ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Código do app, da landing e da documentação | GitHub (3 repositórios), cópia local e histórico do Lovable                                                                                                                           |
| Documentação                                | GitHub e GitBook (sincronizados)                                                                                                                                                      |
| Esquema do banco                            | 58 migrações no histórico do Supabase. A pasta `supabase/migrations` **não** está no repositório do app                                                                               |
| Dados do banco                              | **Sem backup automático nem PITR.** O projeto está no plano gratuito do Supabase (ADR-031, ADR sobre domínio personalizado) e o ADR registra que não há como recuperar dados apagados |
| Biblioteca de cada pessoa                   | Exportação em CSV, em *Configurações → Exportar minha biblioteca*, e o CSV enviado no e-mail de exclusão de conta (ADR-019)                                                           |
| Capas e avatares                            | Somente no Supabase Storage, sem cópia                                                                                                                                                |
| Arquivos dos livros                         | A Lunarie não os guarda (ADR-031, arquivo efêmero). A pessoa mantém o original                                                                                                        |

## Cenários

* **Regressão de código:** `git revert` e push. O Lovable rebuilda, e a publicação é manual.
* **Edge Function com problema:** `git revert` e push em `supabase/functions/**`. O workflow redeploya as 18 funções.
* **Ficha de livro perdida:** a pessoa reimporta o arquivo. A Base de Conhecimento restaura os dados do livro, mas notas, status e tags pessoais só voltam se o banco tiver sobrevivido.
* **Capa perdida:** a capa volta a ser buscada ao reimportar, ou a pessoa envia uma foto.
* **Tabela ou linhas apagadas por engano:** sem backup, não há recuperação. Isso já ocorreu uma vez, com o e-mail Kindle da admin, ao remover `preferencias_arquivo` (ADR-031).
* **Perda do projeto Supabase:** sem backup, os dados do banco e os arquivos do Storage se perdem. O esquema pode ser refeito a partir do histórico de migrações do Supabase, desde que o projeto ainda exista.

## Lacunas

1. **Nenhum backup dos dados do banco.** Mudança de dados em produção não tem plano de volta. Antes de qualquer migração destrutiva, exporte as tabelas afetadas.
2. **Migrações fora do Git.** O histórico existe só no Supabase. Perder o projeto significa perder também o histórico.
3. **Sem teste de restauração**, porque não há o que restaurar.
4. **Capas e avatares sem cópia secundária.** O impacto é menor, porque as capas são recuperáveis por reimportação.

O ADR do domínio personalizado já cita backups como um dos motivos que justificariam contratar o plano pago. Contratar o plano resolve a lacuna 1, mas não a 2.

## Documentos relacionados

* [Segurança](/lunarie-docs/arquitetura/05-seguranca.md)
* [Regras de Dados](/lunarie-docs/banco-de-dados/06-regras-de-dados.md)
* [Deploy](/lunarie-docs/desenvolvimento/06-deploy.md)
