📚 Pollaris Reading
Encontre livros pelo ISBN ou pelo nome (Google Books e Open Library), monte sua biblioteca, registre o progresso por páginas, avalie com estrelas, veja o que outros leitores acharam, organize desejos, crie metas diárias ou semanais com lembrete e cronometre sessões para descobrir seu ritmo. Sua biblioteca é sua: vale em todos os servidores que usam o Floco.
Principais funcionalidades
- Cadastro por ISBN (10 ou 13) ou pelo nome, com escolha da edição
- Cadastro manual quando o livro não está nos catálogos
- Biblioteca com capas, filtros e paginação
- Progresso por página: definir a página atual ou adicionar páginas, com correção
- Conclusão e releitura, com datas registradas
- Lista de desejos que vira leitura sem duplicar
- Avaliações de 0 a 5 estrelas (de meia em meia) com comentário
- Média e comentários da comunidade Pollaris
- Perfis de leitura públicos ou privados
- Metas diárias e semanais com lembrete por DM ou canal
- Sessões cronometradas com ritmo e estimativa para terminar
- Estatísticas por semana, mês, ano ou desde sempre
Comandos
.livro adicionar
Busca pelo ISBN ou nome e adiciona à biblioteca ou aos desejos.
Parâmetros:
buscaobrigatório — ISBN ou nome do livropaginasopcional — Páginas da sua ediçãoautoropcional — Autor, para refinar
Exemplos:
.livro adicionar 9780261103344.livro adicionar "O Hobbit" 310
.livro manual
Cadastra só com nome e páginas, sem ISBN.
Parâmetros:
nomeobrigatório — Nome do livropaginasobrigatório — Total de páginasautoropcional — Autor
Exemplos:
.livro manual "Meu livro" 200
.livro buscar
Consulta um livro nos catálogos.
Parâmetros:
buscaobrigatório — ISBN ou nome
.livro biblioteca
Sua biblioteca, com filtros Lendo, Concluídos e Todos.
.livro detalhes
Ficha, histórico de progresso e sua avaliação.
Parâmetros:
livroobrigatório — Livro da sua estante (nome ou #número)
.livro paginas
Informa o total de páginas da sua edição.
Parâmetros:
livroobrigatório — Livro da sua estante (nome ou #número)totalobrigatório — Total de páginas
.livro capa
Põe a foto da capa (anexe a imagem). Fica na sua estante.
Parâmetros:
livroobrigatório — Livro da sua estante (nome ou #número)imagemobrigatório — Foto da capa (anexo)removeropcional — Tirar a foto que você mandou
Exemplos:
.livro capa "Quarta Asa" (com a foto anexada)
.livro editar
Corrige o total de páginas e a capa de uma vez.
Parâmetros:
livroobrigatório — Livro da sua estante (nome ou #número)paginasopcional — Total de páginascapaopcional — Foto da capa (anexo)
.livro concluir
Marca como concluído.
Parâmetros:
livroobrigatório — Livro da sua estante (nome ou #número)
.livro reabrir
Reabre um concluído (releitura ou correção).
Parâmetros:
livroobrigatório — Livro da sua estante (nome ou #número)
.livro remover
Tira um livro da estante.
Parâmetros:
livroobrigatório — Livro da sua estante (nome ou #número)
.leitura atualizar
Registra páginas: definir a página atual ou adicionar páginas.
Parâmetros:
livroobrigatório — Livro da sua estante (nome ou #número)modoobrigatório — adicionar ou definirpaginasobrigatório — Número
Exemplos:
.leitura atualizar "O Hobbit" adicionar 20
.leitura perfil
Perfil de leitura seu ou de outra pessoa (se for público).
Parâmetros:
usuarioopcional — Quem
.leitura estatisticas
Páginas, tempo cronometrado, ritmo e metas.
Parâmetros:
periodoopcional — semana, mes, ano ou tudo
.desejos adicionar
Adiciona aos desejos pelo ISBN ou nome.
Parâmetros:
buscaobrigatório — ISBN ou nome
.desejos lista
Sua lista de desejos.
.desejos mover
Move um desejo para a biblioteca.
Parâmetros:
livroobrigatório — Livro da sua estante (nome ou #número)
.desejos remover
Tira um livro dos desejos.
Parâmetros:
livroobrigatório — Livro da sua estante (nome ou #número)
.desejos usuario
Os desejos de outra pessoa (se o perfil for público).
Parâmetros:
usuarioobrigatório — Quem
.avaliacao criar
Avalia de 0 a 5 estrelas, com comentário opcional.
Parâmetros:
livroobrigatório — Livro da sua estante (nome ou #número)notaobrigatório — 0 a 5, de meia em meiacomentarioopcional — Texto
Exemplos:
.avaliacao criar "O Hobbit" 4,5 Maravilhoso
.avaliacao editar
Muda a sua avaliação.
Parâmetros:
livroobrigatório — Livro da sua estante (nome ou #número)notaobrigatório — 0 a 5
.avaliacao remover
Apaga a sua avaliação.
Parâmetros:
livroobrigatório — Livro da sua estante (nome ou #número)
.avaliacao buscar
Média e comentários do Pollaris para um livro.
Parâmetros:
buscaobrigatório — ISBN ou nome
.avaliacao usuario
Avaliações públicas de alguém.
Parâmetros:
usuarioobrigatório — Quem
.meta criar
Meta diária ou semanal, com lembrete opcional.
Parâmetros:
tipoobrigatório — diaria ou semanalpaginasobrigatório — Páginashorarioopcional — Ex.: 20:00diasopcional — todos, uteis, seg,qua...avisoopcional — dm ou canal
Exemplos:
.meta criar diaria 20 20:00
.meta ver
Suas metas e o quanto já cumpriu.
.meta editar
Muda páginas, horário, dias ou aviso.
Parâmetros:
tipoobrigatório — diaria ou semanal
.meta pausar
Pausa ou retoma os lembretes.
Parâmetros:
tipoobrigatório — diaria ou semanal
.meta remover
Apaga uma meta.
Parâmetros:
tipoobrigatório — diaria ou semanal
.sessao iniciar
Começa uma sessão cronometrada.
Parâmetros:
livroobrigatório — Livro da sua estante (nome ou #número)minutosobrigatório — 1 a 600
Exemplos:
.sessao iniciar "O Hobbit" 30
.sessao ver
Mostra a sessão aberta.
.sessao finalizar
Encerra e registra as páginas lidas.
Parâmetros:
paginasobrigatório — Páginas lidas
.sessao cancelar
Cancela sem contar páginas.
.reading-config privacidade
Perfil e avaliações públicos ou privados.
.reading-config fuso
Seu fuso horário (ex.: America/Sao_Paulo).
.reading-config notificacoes
Lembretes por DM ou no canal do servidor.
.reading-config apagar-dados
Apaga todos os seus dados do Floco, com confirmação.
.reading-config canal
Canal dos lembretes de leitura do servidor.
Parâmetros:
canalopcional — Canal (vazio desliga)
Quem pode usar: Gerenciar servidor
Como utilizar
- Adicione o Floco ao servidor pela Flocoteca.
- Cadastre um livro: .livro adicionar <ISBN> ou .livro adicionar "Nome" <páginas>.
- Registre o progresso com .leitura atualizar e conclua com .livro concluir.
- Crie uma meta com .meta criar diaria 20 20:00 para receber lembretes.
- Opcional: a administração escolhe um canal de lembretes com /reading-config canal (ou aqui no painel, em Configurações).
- A biblioteca é de cada pessoa e vale em todos os servidores com o Floco. Remover o Floco de um servidor não apaga a biblioteca de ninguém.
- Lembretes no canal só chamam a pessoa: a meta e o progresso ficam na DM.
- Tempo de leitura só conta sessões cronometradas.
Permissões e dados
Permissões do Discord que o Pollaris precisa ter no servidor:
- Enviar mensagens
- Inserir links
- Anexar arquivos
Dados que o Floco usa:
- Biblioteca, desejos, progresso, avaliações, metas, sessões e preferências de cada pessoa, ligados ao ID do Discord (valem em todos os servidores).
- Catálogo de edições consultadas (dados bibliográficos públicos) e cache das buscas.
- Neste servidor: só o canal de lembretes escolhido pela administração.
- Cada pessoa apaga os próprios dados com /reading-config apagar-dados.
Serviços externos:
- Google Books API (busca por ISBN e nome; chave opcional GOOGLE_BOOKS_API_KEY).
- Open Library API e Open Library Covers (reserva e capas).
Ao remover: Os dados ficam guardados e voltam se o Floco for adicionado de novo.
Atualizações
Versão atual: 1.0.0
- 0.1.0 2026-11-14 — Cadastrado na Flocoteca; em desenvolvimento.
- 1.0.0 2026-11-14 — Primeira versão: biblioteca, catálogos, progresso, desejos, avaliações, perfis, metas, lembretes, sessões e estatísticas.
