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. Na segunda fila, as senhas de convidado (uma por grau): dão a irmãos de outras lojas a leitura da estante no grau deles, sem poderem alterar nada; o interruptor ao lado desliga-as todas na hora (o Bibliotecário tem o mesmo nas Definições da página Loja). 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
Ficam guardadas no servidor, não neste browser. A primeira vale para toda a biblioteca; o acesso de convidados decide-se loja a loja.
Com as senhas de convidado (definem-se no painel Lojas, na fila «Convidados»), irmãos de outras lojas lêem a estante no grau deles, sem poder alterar nada. Fechar corta na hora — sessões abertas incluídas; as senhas ficam guardadas para reabrir. O Bibliotecário de cada loja tem o mesmo interruptor nas Definições da página Loja.
Temas do Arquivo de Pranchas (taxonomia global): geridos na página Loja de qualquer Bibliotecário, aba Definições — não há um segundo sítio aqui.
Como funciona a biblioteca
O que cada parte faz e porque está assim. Se acabaste de criar uma loja, começa em O painel Lojas.
A ideia
Um acervo privado, comum às lojas da Pedreira, servido em estantes — uma por loja. O título, o autor e o ano de uma obra são do acervo, iguais para todos; a curadoria — estar ou não na estante, grau, tema, avaliação, notas, alias — é de cada loja, decidida pelo seu Mestre Bibliotecário na página Loja. Esta Configuração é a casa toda: lojas e senhas, temas de todas, obras sem conteúdo, reciclagem, partilhas e definições.
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 — e das outras lojas — nunca lhe chegam.
Entrar — quem é quem
Cada loja tem quatro senhas: uma por grau — Aprendiz, Companheiro, Mestre — e a do Bibliotecário. A senha diz ao servidor a loja e o papel, e fica guardada só no browser, até se fechar o separador. Acima de todos está o superuser, que não pertence a loja nenhuma — é quem chega a esta página.
A engrenagem no cabeçalho da biblioteca leva cada gestor à sua consola: o Bibliotecário à página Loja, o superuser a esta Configuração. Os restantes irmãos não a vêem.
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.
O painel Lojas
Uma linha por loja, com tudo o que a define:
- As quatro senhas — Definir arma um papel que ainda não tinha senha, Trocar muda uma que já existe. A senha nunca sai do browser: a conta é feita aqui e só a impressão digital (SHA-256) viaja para a base de dados — sem reinício nenhum.
- Convidados (leitura) — a segunda fila: três senhas, uma por grau, que dão a irmãos de outras lojas a leitura da estante no grau deles. Nunca escrevem nada — é o servidor que recusa, não o ecrã. O interruptor ao lado (Activos ✓ — desligar / Desligados — ligar) corta na hora, sessões abertas incluídas; as senhas ficam guardadas para religar.
- Renomear — muda o nome de apresentação da loja. O slug, que é a chave das estantes e dos temas, fica quieto.
- Criar loja — a loja nasce com a estante e os temas copiados da loja-fonte, e sem senhas: ninguém entra até as definires.
Depois de definir ou trocar uma senha, testa a entrada logo a seguir. Um hash errado não dá erro nenhum: esse papel passa simplesmente a recusar tudo. É a única avaria desta aplicação que não se anuncia.
A senha do superuser
É a única que não vive na base de dados — vive no ambiente do servidor
(HASH_SUPERUSER), de propósito: é a âncora que abre a casa mesmo
com a base vazia. Para a trocar, escreve na caixa de entrada da biblioteca
PassSU: seguido da senha nova: aparece a impressão digital,
calculada ali no browser, com um botão para copiar. Cola-a na variável no
Coolify e faz um redeploy — só então entra em vigor.
E testa a entrada a seguir, pela mesma razão de sempre: um hash mal colado não avisa, só recusa.
A biblioteca vista pelo superuser
O superuser não tem estante própria, por isso na biblioteca aparece-lhe um selector de estante ao lado do título. O título, o logo e o separador dizem sempre a loja cuja estante está mesmo no ecrã — e uma avaliação ou uma edição feitas aí escrevem nessa estante, como se fosse um Mestre da casa. A escolha sobrevive a um recarregar da página; o Sair limpa-a.
Como as obras entram
Carregar é livre: qualquer irmão autenticado traz obras — com o seu nome, que fica no registo — e elas ficam pendentes na loja dele até o Bibliotecário as aprovar, dando-lhes grau e tema. Nada aparece numa estante sem essa aprovação.
E a ficha é de todos: preencher o que está vazio entra logo — um autor ou ano em falta, um formato que não havia, o primeiro rating de um Mestre — e fica registado nas Edições do Bibliotecário; alterar o que está preenchido segue como sugestão, que ele aceita ou rejeita. Enquanto uma obra tiver ajuda por processar, a ficha mostra o selo «Em revisão».
A gestão de tudo isto — pipeline, novidades, sugestões, edições — vive na página Loja de cada Bibliotecário, não aqui.
Temas por loja
As secções da estante de cada loja, na ordem em que aparecem. Cada loja tem o seu vocabulário — mexer no de uma não toca nas outras — e normalmente é o Bibliotecário que trata dele na página Loja; aqui chega-se a todos, escolhendo a loja no selector. Toca no nome para o mudar — Enter grava, Escape desfaz.
Mudar o nome de um tema reescreve o tema de todas as fichas dessa estante que o usam, e o aviso diz quantas foram. Um tema só se apaga vazio.
Sem conteúdo
Obras do acervo de que não temos ficheiro — não aparecem em estante nenhuma, porque um botão que devolve um erro é pior do que a obra não estar à vista. Dá-se-lhes aqui o formato e o ficheiro, e passam a poder aparecer nas lojas que as tenham incluído.
Reciclagem
Nada se apaga à primeira. Substituir ou remover um ficheiro guarda aqui a versão anterior. Apagar uma obra do acervo — acto do superuser, porque a tira a todas as lojas de uma vez — guarda-a inteira, com as fichas de curadoria de cada estante, e o restauro repõe tudo. É só nesta página que alguma coisa desaparece do servidor 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 — de todas as lojas — com as descargas que
tiveram. Abrir uma obra na biblioteca não entra nesta lista: só o que foi
mesmo partilhado. Um link dura 72 horas e sai por um domínio neutro
(d.pedreira.cc) que não diz de onde veio; nos ainda válidos há
um ícone para copiar o endereço, e Limpar as caducadas despacha
as linhas mortas.
Quem recebe o link não precisa de senha — o link é a credencial. É isso que faz a partilha funcionar, e é por isso que caduca.
Definições
Ficam guardadas no servidor, não no browser. A navegação da modal — o que fazer às setas ‹ › quando há alterações por gravar: gravar e avançar, ou parar e perguntar — vale para a casa toda. O acesso de convidados decide-se loja a loja: é o mesmo interruptor do painel Lojas e das Definições do Bibliotecário na página Loja — os três são um só estado, nunca discordam.
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.