> 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/produto/03-funcionalidades.md).

# Funcionalidades

> **Última atualização:** 07/10/2026 Descreve o produto em produção (beta fechado). Quando o texto e o app divergem, o app está certo.

## Importação

* Envio de ebooks (EPUB e formatos compatíveis), com fila de cards para revisar antes de confirmar. Nada é gravado se a importação for abandonada.
* **Enriquecimento em cadeia:** EPUB, nome do arquivo, Google Books, Open Library, ISBN e IA (Groq). Nunca sobrescreve um campo já preenchido.
* **Base de Conhecimento global:** obras já conhecidas são reconhecidas na hora (título e autor normalizados, série, hash de conteúdo).
* Detecção de duplicados e substituição de registro existente.
* Busca automática de capa e nomenclatura padronizada configurável.

## Biblioteca

* Visualizações em grade, lista e pilha por série. Ordenação (padrão: Recentes) e filtros por autor, série, gênero, tags e status de envio.
* Ficha completa do livro, um componente único para o modal no desktop e a página no celular: dados bibliográficos, leitura, arquivos e ações.
* Edição com normalização de gênero e subgêneros (listas canônicas com aliases e aprendizado) e herança de gênero por série.
* **Buscar/Completar informações:** preenche campos vazios pela Base de Conhecimento e pela cadeia de enriquecimento, com a IA cobrindo lacunas como a sinopse.
* **Séries incompletas:** painel com volumes faltantes no meio e possíveis continuações, com opção de dispensar o aviso.
* Status de leitura, favoritos, notas, tags e meta anual de leitura.
* Botão **Pendências**, com contador, no cabeçalho. Só aparece quando há algo a ajustar.

## Pendências (`/pendencias`)

Fila de pequenos ajustes, cada um resolvido na própria linha (ADR-064). `/organizador` só redireciona para cá.

* **Resumo:** anel com a porcentagem da estante em ordem e uma frase de estado ("Tudo em ordem ☾" ou "Faltam N ajustes"). Cada ajuste (livro com pendência ou série incompleta) desconta da estante, e o anel nunca marca 100% enquanto houver algo a ajustar.
* **Completar com a Lunarie:** busca autor, gênero, série e capa dos livros com pendência, um por vez, com progresso e botão "Parar" (pede confirmação acima de 50 livros). Só preenche campos vazios, como o "Completar" da biblioteca.
* **Seções:** sem série (escolher série e volume, ou "É avulso"), sem capa (buscar capa), sem autor, sem gênero (editar ali), séries incompletas (com "Adicionar livros" e "Está completa") e livros repetidos (cópias lado a lado, com "Remover este" e confirmação).
* **Entradas:** card no dashboard e botão na biblioteca, só quando há pendência. A página tem estados de carregando, erro, biblioteca vazia e tudo em ordem.

## Kindle

* Envio por e-mail para o endereço Kindle da pessoa, com remetente dedicado. Os anexos vão em lotes de até 25 anexos ou cerca de 25 MB por mensagem. Não há limite mensal de envios (ADR-067).
* Marcar ou desmarcar "Já está no meu Kindle" manualmente.
* **Detecção de falhas E999:** as notificações da Amazon são recebidas e processadas automaticamente. O histórico sinaliza o erro em tom de aviso e a pessoa recebe um e-mail acolhedor.
* Histórico de envios com status por livro.

## Arquivo efêmero

A Lunarie descarta o arquivo do ebook depois que ele chega ao destino e mantém só as informações do livro.

* Ao final da importação, a pessoa escolhe **uma única ação**: enviar ao Kindle, baixar em .zip ou concluir sem nenhum dos dois.
* O arquivo é removido assim que a ação é confirmada, só dos livros em que ela teve sucesso. Se um arquivo falhar ao ser enviado ou empacotado, ele continua disponível para nova tentativa.
* O .zip contém só o lote recém-importado, nunca a biblioteca inteira.
* O livro fica na biblioteca "sem arquivo", que é o estado normal. Não há opção de guardar o arquivo.

## Cadastro de livro sem arquivo

Para livros de papel ou comprados direto no Kindle, em "Não tem o arquivo? Catalogar assim mesmo", na tela de importação.

* **Buscar livro:** um campo aceita título, autor ou ISBN. A busca mostra até 6 edições com capa, autor, ano e editora. Ao tocar na certa, a ficha é preenchida (título, autor, editora, idioma, ano, páginas, sinopse) e a capa da edição é trazida. Gênero e série vêm do botão "Buscar informações" ou das Pendências.
* A busca usa o Google Books e, se ele não responder ou não achar nada, a Open Library. Dá para ignorá-la, porque todos os campos continuam editáveis à mão.
* **Capa:** se nenhuma fonte tiver a capa, a pessoa pode enviar uma imagem ("Adicionar capa"). Sem imagem, a biblioteca mostra uma **capa de reserva** com título e autor sobre as cores da marca. Ela não é gravada como imagem, então o livro continua "sem capa" para a busca automática e para as Pendências.

## Conta

* Perfil com nome editável e foto (corte automático, bucket privado).
* Indicador de força e de confirmação de senha em todos os formulários.
* Selos Primeira Estante e Apoiador, exibidos junto à identidade do perfil.
* **Conquistas:** seção do perfil com a meta anual de leitura (livros lidos no ano em relação à meta definida pela pessoa). Total de páginas lidas e desafios temáticos estão em desenvolvimento, com tom de celebração acolhedora, compartilhamento opcional e sem ranking entre pessoas.
* **Apoio:** doações avulsas via Stripe, sem cobrança automática, com o selo Apoiador como agradecimento.
* **Exportar biblioteca (Configurações):** uma exportação em planilha CSV com 20 colunas em português (título, autor, série, gênero, ano, editora, idioma, páginas, ISBN/ASIN, status de leitura, favorito, notas, tags, envio ao Kindle, data de adição). Separador `;` e UTF-8 com BOM, para abrir direto no Excel. Biblioteca vazia não baixa arquivo, e os arquivos dos livros não entram (ADR-063).

## Entrada (beta fechado)

* Fila da Lua (lista de espera pública) e convites por e-mail com código seguro, válido por 7 dias.
* **Onboarding de conta nova:** assistente de 6 passos na primeira entrada: boas-vindas, nome e foto, preferências de leitura (gêneros favoritos e ritmo, que alimentam a primeira sugestão), endereço Kindle, aprovação do remetente `biblioteca@lunarie.net.br` em amazon.com.br/mycd e uma introdução ao fluxo de importar, padronizar e enviar. A aprovação do remetente é o passo crítico, sem ele o primeiro envio falha em silêncio.
  * "Pular" e "Concluir" marcam o mesmo campo (`profiles.onboarding_concluido_em`), e quem pula completa depois em Perfil e Configurações.
  * Contas criadas antes da feature foram marcadas como concluídas, então só contas novas veem o assistente.

## Administração (admin)

* Convites: emitir, reenviar e arquivar.
* Envios ao Kindle por pessoa (ADR-068).
* Diagnóstico de integrações e painel de uso de IA.

## Documentos relacionados

* [Escopo do MVP](/lunarie-docs/produto/04-escopo-do-mvp.md)
* [Regras de Negócio](/lunarie-docs/requisitos/04-regras-de-negocio.md)