> 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/experiencia-do-usuario/03-fluxos-principais.md).

# Fluxos Principais

> **Última atualização:** 08/10/2026 Caminhos que existem hoje no app, conferidos no código. A visão da pessoa ao longo do tempo está em [Jornada da Pessoa Usuária](/lunarie-docs/pesquisa/05-jornada-do-usuario.md).

## 1. Primeiro acesso

1. A pessoa chega com um código de convite, ou entra na Fila da Lua (`/fila-da-lua`) enquanto espera.
2. Cria a conta por e-mail e senha ou por Google. O código de convite é exigido nos dois caminhos.
3. O onboarding abre com 6 passos: boas-vindas, nome e foto, preferências de leitura, endereço Kindle, aprovação do remetente na Amazon e uma introdução ao fluxo. Pode ser pulado.
4. Quem pula o passo do Kindle vê um lembrete (`KindleReminderBanner`) no topo do app até configurar.
5. Cai no Início, com a biblioteca vazia e o atalho para adicionar livros.

## 2. Adicionar livros com arquivo

1. Em `/importar`, a pessoa solta ou seleciona os arquivos.
2. A Lunarie lê cada arquivo e completa o que falta, sem sobrescrever o que já existe.
3. Cada livro aparece em um card para revisão. Nada é salvo antes da confirmação.
4. A pessoa confirma e escolhe o destino do arquivo: enviar ao Kindle, baixar em .zip ou concluir sem enviar.
5. A Lunarie guarda as informações do livro e descarta o arquivo (ADR-031).

## 3. Catalogar sem arquivo

1. Em `/importar`, a pessoa abre "Não tem o arquivo? Catalogar assim mesmo".
2. Digita o título, e a Lunarie sugere candidatos, ou busca por ISBN.
3. Revisa as informações e confirma. Sem capa, o livro recebe uma capa de reserva com o título, e a pessoa pode enviar uma foto da capa.

É o caminho para livros de papel e para livros que já estão no Kindle.

## 4. Enviar ao Kindle

1. O envio parte do fim da importação, com o arquivo ainda disponível.
2. O e-mail Kindle precisa estar configurado e o remetente aprovado na Amazon.
3. O resultado aparece no histórico da ficha do livro, com um selo de enviado. Uma falha da Amazon (E999) é sinalizada em tom de aviso, e a pessoa recebe um e-mail.

Reenviar um livro já enviado pede confirmação.

## 5. Organizar a biblioteca

1. O Início avisa quando há ajustes ("Faltam N ajustes na sua estante") e leva a `/pendencias`.
2. Em Pendências, cada ajuste é resolvido na própria linha. "Completar" resolve vários de uma vez.
3. Para editar um livro à mão, a pessoa abre a ficha, vai para `/book/:id/editar`, usa "Completar informações" se quiser e salva.

## 6. Encontrar um livro

1. Em `/biblioteca`, a pessoa busca por título, autor, série, gênero ou tag.
2. Refina com filtros: gênero, subgênero, autor, série, tags e status de envio (todos, enviados, ainda não enviados).
3. Escolhe a visão (grade, lista ou séries) e a ordenação (série, título, autor ou data).
4. Abre o livro.

## Documentos relacionados

* [Arquitetura de Informação](/lunarie-docs/experiencia-do-usuario/02-arquitetura-de-informacao.md)
* [Jornada da Pessoa Usuária](/lunarie-docs/pesquisa/05-jornada-do-usuario.md)
* [Requisitos Funcionais](/lunarie-docs/requisitos/02-requisitos-funcionais.md)