Lojas da Pedreira
Cada loja tem a sua estante (curada pelo Mestre Bibliotecário dela) sobre o acervo comum, e as suas quatro senhas — três graus e o Bibliotecário. As senhas vivem na base de dados: definir ou trocar uma não precisa de redeploy. A senha nunca sai deste browser — só a impressão digital (SHA-256).
Criar loja nova
A loja nasce com a estante e os temas copiados da loja-fonte, e sem senhas — ninguém entra até as definires acima.
Temas por loja
As secções da estante de cada loja, na ordem em que aparecem. Cada loja tem o seu vocabulário — normalmente é o Bibliotecário que trata disto na página Loja; aqui chega-se a todas.
Obras sem ficheiro
Estas obras não aparecem na biblioteca. Sem ficheiro não há nada para abrir, e um botão que devolve um erro é pior do que a obra não estar à vista — por isso ficam retidas aqui, no catálogo mas fora da estante. Dá-lhes o formato e o ficheiro: são carregados e ligados na hora, e a obra passa a aparecer.
Reciclagem
Nada sai da biblioteca sem passar por aqui. Ao substituir o ficheiro de uma obra, a versão anterior fica guardada e pode descarregar-se. Ao apagar uma obra, ela fica inteira — com ficheiros e metadados — e pode voltar ao catálogo. É só nesta página que alguma coisa desaparece do servidor de vez.
Links partilhados
Cada link gerado pelo botão de partilha fica registado aqui, com as descargas que teve. Abrir uma obra na biblioteca não entra nesta lista — só o que saiu para fora. Um link caduca ao fim de 72 horas e a partir daí deixa de servir o ficheiro; a linha fica para se poder ver o que aconteceu.
Definições da biblioteca
Valem para toda a biblioteca — ficam guardadas no servidor, não neste browser.
Como funciona a biblioteca
O que cada parte faz e porque está assim. Se andas a classificar obras, começa em A bancada.
A ideia
Um catálogo privado da biblioteca da loja. Os ficheiros são nossos — estão no nosso servidor, não numa nuvem de terceiros — e cada pessoa vê o que é próprio do seu grau.
Quem decide o que se vê é o servidor, não o browser. Um Aprendiz não recebe a lista completa para depois o JavaScript lhe esconder metade: as obras dos outros graus nunca lhe chegam.
Entrar
Há três senhas, uma por grau — Aprendiz, Companheiro, Mestre. A senha fica guardada só neste browser e só até fechares o separador.
Com a senha de Mestre aparece a engrenagem no cabeçalho, que é a porta desta página de Configuração.
Ao fim de 10 tentativas falhadas, a entrada fecha-se por 15 minutos para quem estiver a tentar. É contra quem adivinha à sorte, não contra quem se esqueceu.
Trocar as senhas
A biblioteca nunca guarda as senhas — guarda só a impressão digital de cada uma. Por isso trocar uma senha não mexe no catálogo nem em código: mudam-se três variáveis no Coolify e reinicia-se.
Na caixa de entrada da biblioteca, em vez de entrares, escreve o comando do grau seguido da senha nova:
PassAA:senha nova → Aprendiz →HASH_APRENDIZPassCC:senha nova → Companheiro →HASH_COMPANHEIROPassMM:senha nova → Mestre →HASH_MESTRE
Aparece um painel com a impressão digital e com o nome da variável a que ela pertence, e um botão para copiar. A senha não sai do teu browser — a conta é feita ali, sem pedido nenhum ao servidor.
No Coolify, cola cada valor na variável respectiva. Muda as três e faz um só reinício: uma de cada vez são três janelas em que uns graus têm senha nova e outros a antiga.
Testa a entrada dos três logo a seguir. Se uma variável ficar vazia, o arranque queixa-se nos registos. Mas se ficar com uma impressão digital errada — um carácter perdido ao colar — não há aviso nenhum: esse grau passa simplesmente a recusar tudo. É a única avaria desta aplicação que não se anuncia, e é por isso que o painel te mostra o comprimento da senha que escreveste.
Encontrar uma obra
- Pesquisa — procura no título, no autor, no tema e no código do
Librarium. Escrever
GI-079encontra a obra desse código. - Grau — mostra só as obras de um grau. No telemóvel as pastilhas aparecem abreviadas: A∴ C∴ M∴.
- Vista — Por temas agrupa em secções que se abrem e fecham; Cartões mostra uma grelha.
- Formato e Ordenar — por nome ou pelas melhores avaliações.
No telemóvel, Vista, Formato e Ordenar estão recolhidos atrás do botão Filtros, para a estante começar mais acima.
Ler, descarregar, anotar
O botão de cada obra diz o que vai acontecer: um PDF abre no browser, os outros formatos descarregam. As estrelas avaliam-se com um toque, e passar o rato por cima de uma obra mostra as suas notas, se tiver.
Sendo Mestre, clicar no título abre a modal de edição.
A modal de edição
Título, autor, grau, tema, avaliação, ano e notas. Em baixo, os ficheiros da obra: podem juntar-se, substituir-se e remover-se.
- Pré-visualizar — a pastilha do formato abre o ficheiro ali mesmo, quando o browser o sabe desenhar (PDF e JPG). É o que permite perceber o que é uma obra sem sair do sítio. Um segundo toque fecha.
- Passar de obra em obra — as setas ‹ › no topo da modal, ou as teclas N (seguinte) e P (anterior). As setas ← → também servem. A navegação segue a lista que está no ecrã: com uma pesquisa activa, anda dentro dos resultados dela.
- Ano — 67 obras já vêm com o ano do índice Librarium. Em branco significa que não se sabe.
O que fazer quando se muda de obra com alterações por gravar decide-se em Definições: gravar e avançar (para classificar em série), ou parar e perguntar.
Partilhar uma obra
O botão de partilha gera um endereço curto que dura 72 horas e depois
deixa de servir o ficheiro, sozinho. Sai por um domínio neutro
(d.pelicano.cc) que não diz de onde veio.
Quem recebe o link não precisa de senha — o link é a credencial. É isso que faz a partilha funcionar, e é por isso que caduca.
O que chega à estante
Uma obra só aparece na biblioteca se cumprir duas condições:
- tem ficheiro no nosso servidor;
- tem grau e tema.
Falhando alguma, não se perde: fica à espera aqui, em Por classificar ou em Sem conteúdo, com o que lhe falta à frente.
Temas
São as secções da biblioteca, e a ordem aqui é a ordem em que aparecem na estante. Toca no nome para o mudar — Enter grava, Escape desfaz.
Mudar o nome de um tema reescreve o tema de todas as obras que o usam, e o aviso diz quantas foram. Um tema só se apaga quando estiver vazio.
A bancada — Por classificar
É a entrada da biblioteca. Carrega aqui material novo em lote: os ficheiros entram sem tema de propósito, e ficam nesta lista à espera de grau e tema.
- Visualizar ou Descarregar para ver o que é antes de decidir.
- Corrigir título e autor — o título vem adivinhado do nome do ficheiro e quase sempre precisa de emenda.
- Dar grau e tema, e Gravar.
- Editar abre a ficha completa (ano, notas, avaliação, ficheiros) — a mesma da biblioteca; as setas ‹ › passam à obra seguinte sem fechar.
- 🗑 remove o que não interessa: vai para a reciclagem.
Ficheiros repetidos são reconhecidos pelo conteúdo, não pelo nome: o mesmo livro carregado outra vez com outro nome não entra duas vezes.
No telemóvel a linha mostra só o nome e as acções; Campos abre os campos de classificação, Editar abre a ficha completa.
Sem conteúdo
Obras registadas de que não temos ficheiro. Dá-se-lhes conteúdo aqui e passam a aparecer na estante.
Reciclagem
Nada se apaga à primeira. Apagar uma obra, substituir ou remover um ficheiro manda tudo para aqui, e daqui recupera-se ou apaga-se de vez.
Antes de tirar um ficheiro do disco, o sistema confirma que mais nenhuma obra o usa — obras com o mesmo conteúdo partilham o mesmo ficheiro.
Partilhas
O registo dos links que saíram, com as descargas que tiveram. Abrir uma obra na biblioteca não entra nesta lista — só o que foi mesmo partilhado.
Nos links ainda válidos há um ícone para copiar o endereço, para o reenviar sem o gerar de novo.
Os códigos do Librarium
O código de uma obra (GI-079, GIII-016) vem do
nome do ficheiro na pasta do bibliotecário. Em algumas obras não coincide
com o número que o índice em Excel lhes deu.
Quando os dois discordam, a app segue o ficheiro que existe. Procurar pelo número do índice pode não encontrar nada — não é defeito da pesquisa, é a pasta e o índice a discordarem.
Atalhos
- N · → — obra seguinte (na modal)
- P · ← — obra anterior (na modal)
- Escape — desfazer a edição de um nome de tema (a modal fecha só pelos botões, para um clique fora não deitar a edição fora)
- Enter — gravar o nome de um tema
As teclas de navegação não actuam enquanto se escreve num campo — senão escrever "Napoleão" no título saltava seis obras.