Costruire un sistema documentale

Ogni archivio, prima o poi, smette di funzionare: i documenti sono sparsi fra cartelle, email e telefono, e cercarne uno che sai di avere costa più fatica che rifarlo.

Questo libro racconta come si costruisce, da zero e fino alla produzione, il software che risolve il problema. Si chiama DjangoVault, ed è un progetto reale: è quello che l'autore usa ogni giorno per tenere in ordine i suoi documenti. Le scelte che incontrerai, comprese quelle sbagliate e poi corrette, sono quelle fatte davvero, e ogni capitolo spiega perché.

Che cosa costruisci

• Un sistema che riceve i documenti da browser, cartella, posta e telefono, e li conserva con tutte le versioni.
• La lettura automatica dei file, con OCR per le scansioni, in background con Celery.
• La ricerca per parole e per significato, con PostgreSQL e pgvector, fusa in un'unica classifica.
• Un assistente che risponde alle domande sui tuoi documenti citando le fonti, solo con il consenso per ciascun documento.
• La classificazione automatica, con la coda «Da smistare» in cui decide sempre una persona.
• Condivisione a tre livelli, revisione e approvazione, notifiche in tempo reale.
• Una app per il telefono che fotografa un foglio e lo manda nell'archivio.
• La produzione: Nginx, Daphne, HTTPS privato, copie di sicurezza, ripristino e manutenzione.

Come è scritto

Diciassette capitoli in cinque parti, seguendo la vita di un documento dentro il sistema. Ogni capitolo ha obiettivi, spiegazione, il codice essenziale, l'errore in cui l'autore è incappato e come l'ha risolto, e alla fine un riepilogo con esercizi. L'ultimo capitolo è dedicato interamente agli errori: otto storie in cui la causa non era dove la si cercava.

A chi serve

A chi scrive in Python e ha già costruito almeno una piccola applicazione con Django. Non serve conoscere Celery, Docker, Redis, Nginx, pgvector o HTMX: li incontrerai uno alla volta, nel punto in cui il progetto ne ha bisogno.