Pinakes è nato come catalogo con i prestiti attaccati. Con la 0.9.0 prova a diventare il gestionale con cui una biblioteca passa l’intera giornata: la revisione dell’inventario, l’import dei record MARC, le tessere dei lettori, le regole di prestito diverse per bambini e docenti, i giorni di chiusura, le multe. È la versione più grande che abbia mai scritto, e per questo esce prima come release candidate: la 0.9.0-rc.1 arriva solo alle installazioni che scelgono di provarla, impostando UPDATER_CHANNEL=rc nel file .env.
La revisione inventariale
La revisione è il lavoro più faticoso di una biblioteca, e quello per cui i gestionali aiutano meno. In Pinakes si apre una sessione scegliendo cosa controllare: una scaffalatura, un genere, un intervallo di collocazioni. In quel momento la lista delle copie attese viene congelata, così spostare un libro o aggiungere una copia mentre la revisione è in corso non cambia quello che si sta cercando. Poi si legge: con un lettore di codici a barre, con la fotocamera del computer o caricando un elenco di codici. Ogni lettura ha il suo colore e il suo suono, trovato, fuori posto, in prestito, sconosciuto, e più persone possono lavorare sulla stessa sessione insieme. Alla chiusura si decide se dichiarare perse le copie mancanti: è un’azione da amministratore, e non tocca mai un libro in prestito o in attesa di ritiro.
MARC in entrata e in uscita
Chi arriva da un altro gestionale di solito ha un file MARC. Adesso Pinakes lo legge tutto in una volta, in ISO 2709 o MARCXML, mostra un’anteprima che dice quali record sono già in catalogo e importa a blocchi con una barra di avanzamento. L’operazione inversa esporta il catalogo, o una selezione, in MARC 21, MARCXML o UNIMARC, scrivendo il file mentre il download parte, così anche un catalogo grande non riempie la memoria del server. La libreria MARC è scritta da zero, senza dipendenze nuove, e la usa anche il server OAI-PMH. Un’attenzione l’ho messa nel giro completo: genere, tipo di supporto e codici RDA escono e rientrano senza perdersi, e un catalogo esportato si reimporta senza doppioni. Dalla stessa pagina si fa anche catalogazione derivata, cercando nei server SRU di SBN, Library of Congress, BnF, DNB e K10plus.
Tessere, foto e lettori da un file
Ogni lettore ha ora la sua tessera stampabile, in formato carta di credito o su fogli A4 di biglietti da visita, con codice a barre o QR, foto e scadenza. La foto si scatta dalla webcam direttamente nella scheda del lettore, viene ripulita dai dati EXIF e vive fuori dalla cartella pubblica del sito. I lettori si possono anche importare da un CSV: le colonne vengono riconosciute in cinque lingue, i doppioni vengono saltati e mai fusi, e le password non si importano mai. Chi vuole manda a ogni nuovo lettore l’invito a sceglierne una.
Regole diverse per lettori diversi
Fino alla 0.8 la durata del prestito e il numero massimo di libri erano uguali per tutti. Adesso ogni lettore appartiene a una tipologia, bambino, studente, docente, e ogni tipologia può avere i suoi limiti. Si può aggiungere una matrice tipologia per materiale: i DVD per una settimana, i libri per un mese, una copia tenuta solo per la consultazione in sede. La parte che mi ha richiesto più lavoro è invisibile: le regole erano lette in una ventina di punti diversi del codice, dal banco prestiti all’app, e ora passano tutte da un solo servizio. Un test confronta il comportamento nuovo con quello vecchio su una griglia di impostazioni, così chi non tocca niente ottiene esattamente le date di prima.
I giorni in cui la biblioteca è chiusa
Una scadenza che cade di domenica, o a Ferragosto, è un problema per chi deve restituire un libro. Il nuovo calendario delle chiusure tiene i giorni di chiusura settimanali, le chiusure singole o ricorrenti e le festività, anche per una sola sede. Le scadenze, i giorni di ritiro e i calendari di prenotazione ne tengono conto. Le festività si scelgono per paese: ci sono tabelle scritte a mano per ventidue paesi, con le loro regole, dalla Pasqua al Thanksgiving, e i dati aperti del progetto python-holidays per tutti gli altri, festività islamiche, cinesi e induiste comprese. La biblioteca può aggiungere anche le sue feste, perfino in calendari lunari.
Multe, ma solo se le vuoi
Le multe per ritardo erano la richiesta più delicata, perché toccano i soldi. Le ho costruite su un registro del lettore in cui ogni addebito, pagamento o condono è una riga che non si cancella mai, con la ricevuta in PDF e il blocco dei prestiti oltre una soglia di debito. I giorni di ritardo contano solo quando la biblioteca è aperta.
Tutto si può spegnere
Tanta roba nuova rischia di riempire il pannello di chi non la vuole. Per questo ogni modulo della 0.9.0 ha il suo interruttore nelle impostazioni, e un modulo spento sparisce davvero: niente voce di menu, niente campi nei moduli, niente pagine raggiungibili. Chi aggiorna trova accese solo le funzioni che compaiono quando le si usa, mentre revisione, fornitori, registro presenze, tipi RDA e multe partono spente, a meno che la biblioteca non abbia già dati per quel modulo. Le impostazioni di chi aggiorna non cambiano.
Una correzione che riguarda tutti
C’è anche un difetto vecchio che mi era sfuggito per mesi. Alla fine di ogni installazione nuova, la pagina avvertiva che l’utente del database non poteva creare i trigger e chiedeva di installarli a mano, anche quando erano stati creati tutti. Il controllo cercava l’istruzione solo all’inizio di ogni blocco del file, dove invece ci sono commenti. Ora l’avviso compare solo quando un trigger manca davvero, e mostra l’errore reale del database.
Come provarla
La release candidate è pensata per chi può permettersi di provarla prima della versione definitiva, magari su una copia del sito. Lo schema del database cresce con una migrazione sola che aggiunge tabelle e colonne senza cambiare i dati esistenti; l’unica conversione riguarda le vecchie sanzioni dei prestiti, che diventano le prime righe del registro dei lettori. Il pacchetto e le note complete sono sulla pagina della release su GitHub. Se qualcosa non va, una segnalazione su GitHub prima della 0.9.0 definitiva vale doppio.