Flocoteca · Pollaris Reading

Produtividade DisponívelVersão 1.0.0

📚 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:

  • busca obrigatório — ISBN ou nome do livro
  • paginas opcional — Páginas da sua edição
  • autor opcional — 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:

  • nome obrigatório — Nome do livro
  • paginas obrigatório — Total de páginas
  • autor opcional — Autor

Exemplos:

  • .livro manual "Meu livro" 200

.livro buscar

Consulta um livro nos catálogos.

Parâmetros:

  • busca obrigató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:

  • livro obrigatório — Livro da sua estante (nome ou #número)

.livro paginas

Informa o total de páginas da sua edição.

Parâmetros:

  • livro obrigatório — Livro da sua estante (nome ou #número)
  • total obrigatório — Total de páginas

.livro capa

Põe a foto da capa (anexe a imagem). Fica na sua estante.

Parâmetros:

  • livro obrigatório — Livro da sua estante (nome ou #número)
  • imagem obrigatório — Foto da capa (anexo)
  • remover opcional — 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:

  • livro obrigatório — Livro da sua estante (nome ou #número)
  • paginas opcional — Total de páginas
  • capa opcional — Foto da capa (anexo)

.livro concluir

Marca como concluído.

Parâmetros:

  • livro obrigatório — Livro da sua estante (nome ou #número)

.livro reabrir

Reabre um concluído (releitura ou correção).

Parâmetros:

  • livro obrigatório — Livro da sua estante (nome ou #número)

.livro remover

Tira um livro da estante.

Parâmetros:

  • livro obrigató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:

  • livro obrigatório — Livro da sua estante (nome ou #número)
  • modo obrigatório — adicionar ou definir
  • paginas obrigató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:

  • usuario opcional — Quem

.leitura estatisticas

Páginas, tempo cronometrado, ritmo e metas.

Parâmetros:

  • periodo opcional — semana, mes, ano ou tudo

.desejos adicionar

Adiciona aos desejos pelo ISBN ou nome.

Parâmetros:

  • busca obrigatório — ISBN ou nome

.desejos lista

Sua lista de desejos.

.desejos mover

Move um desejo para a biblioteca.

Parâmetros:

  • livro obrigatório — Livro da sua estante (nome ou #número)

.desejos remover

Tira um livro dos desejos.

Parâmetros:

  • livro obrigatório — Livro da sua estante (nome ou #número)

.desejos usuario

Os desejos de outra pessoa (se o perfil for público).

Parâmetros:

  • usuario obrigatório — Quem

.avaliacao criar

Avalia de 0 a 5 estrelas, com comentário opcional.

Parâmetros:

  • livro obrigatório — Livro da sua estante (nome ou #número)
  • nota obrigatório — 0 a 5, de meia em meia
  • comentario opcional — Texto

Exemplos:

  • .avaliacao criar "O Hobbit" 4,5 Maravilhoso

.avaliacao editar

Muda a sua avaliação.

Parâmetros:

  • livro obrigatório — Livro da sua estante (nome ou #número)
  • nota obrigatório — 0 a 5

.avaliacao remover

Apaga a sua avaliação.

Parâmetros:

  • livro obrigatório — Livro da sua estante (nome ou #número)

.avaliacao buscar

Média e comentários do Pollaris para um livro.

Parâmetros:

  • busca obrigatório — ISBN ou nome

.avaliacao usuario

Avaliações públicas de alguém.

Parâmetros:

  • usuario obrigatório — Quem

.meta criar

Meta diária ou semanal, com lembrete opcional.

Parâmetros:

  • tipo obrigatório — diaria ou semanal
  • paginas obrigatório — Páginas
  • horario opcional — Ex.: 20:00
  • dias opcional — todos, uteis, seg,qua...
  • aviso opcional — 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:

  • tipo obrigatório — diaria ou semanal

.meta pausar

Pausa ou retoma os lembretes.

Parâmetros:

  • tipo obrigatório — diaria ou semanal

.meta remover

Apaga uma meta.

Parâmetros:

  • tipo obrigatório — diaria ou semanal

.sessao iniciar

Começa uma sessão cronometrada.

Parâmetros:

  • livro obrigatório — Livro da sua estante (nome ou #número)
  • minutos obrigató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:

  • paginas obrigató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:

  • canal opcional — 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.