L'archivio che decide chi può leggere.
Zybald raccoglie i documenti dell'azienda da cinque canali, li legge, li classifica con le regole dell'azienda e con un modello linguistico, e li colloca nelle cartelle giuste. Il punto di partenza però non è la classificazione: è la riservatezza. Ogni documento è visibile solo a chi ne ha titolo, ogni lettura lascia una traccia, e nemmeno chi amministra l'installazione può aprire un contenuto senza dichiararlo. Sopra l'archivio lavora un assistente con un vero modello linguistico, che cerca e legge soltanto ciò che la persona che chiede può già vedere.
Zybald è l'evoluzione di Vdoc, riscritta su un motore documentale proprio.
unificati
per cartella
dei permessi
nessun dato condiviso
Proprietà di progetto, non misure di esercizio.
Stato, ottobre 2026. Zybald è in sviluppo. Questa pagina descrive il prodotto completo: archivio, link pubblici, flussi, portale e assistente. Le funzioni entrano in esercizio per gradi, a partire dall'archivio.
Che cosa fa Zybald.
Arriva un documento: una fattura in PDF, un contratto firmato, una mail con tre allegati, un foglio di calcolo, la foto di uno scontrino. Zybald lo registra, riconosce se è già presente, lo legge, gli assegna titolo, tipo, mittente, data, i campi del suo tipo e un riassunto, e lo colloca nelle cartelle stabilite dalle regole dell'azienda. Da quel momento lo vedono soltanto i gruppi che hanno accesso a quelle cartelle.
Tre processi, una sola logica.
Zybald è organizzato attorno a uno strato di logica che concentra tutte le regole: identità, permessi, archivio, versioni, ricerca, registro. Attorno ci sono tre processi distinti, così che un guasto in uno non fermi gli altri.
- Il servizio web espone le API all'interfaccia e ai client di ingresso.
- Il worker esegue in background i lavori lunghi: lettura del testo, conversione dei formati da ufficio e dei messaggi di posta in PDF, classificazione, indicizzazione, notifiche, controlli di coerenza, e le risposte dell'assistente, su processi riservati perché una conversazione non rallenti l'archivio.
- I canali ricevono la posta e i messaggi del bot.
Quando un documento arriva, Zybald lo salva e risponde subito al canale; la lettura e la classificazione proseguono nel worker. Un lavoro interrotto riprende dopo un riavvio, perché la coda dei lavori sta nel database.
L'interfaccia è un'applicazione che parla solo con le API.
Il viaggio di un documento.
Qualunque sia il canale, ogni documento attraversa le stesse sette tappe. Le prime tre avvengono subito, e il canale riceve la risposta; le altre proseguono in background.
- 1 · Ingresso. Il canale consegna il file; Zybald calcola l'impronta SHA-256.
- 2 · Deduplica. Se lo stesso contenuto esiste già, lo dice e non crea un doppione, qualunque sia il canale da cui era arrivato.
- 3 · Archivio. Il file viene cifrato e scritto; il documento nasce nella cartella «In arrivo» del suo canale. Il canale riceve la risposta.
- 4 · Lettura. OCR locale sulle pagine senza testo, con testo ricercabile e anteprima. I documenti da ufficio diventano un PDF con LibreOffice, conservando l'originale; i PDF protetti si aprono con le password che il titolare ha salvato, oppure con una password data una volta da chi ha il documento.
- 5 · Classificazione. Prima le regole sul testo scritte dall'azienda, poi il modello linguistico tramite AYXZA Relay: titolo, tipo, mittente, data, tag, campi del tipo, riassunto, pratica di riferimento. Le regole prevalgono sul modello, e ciò che una persona ha corretto a mano non viene più toccato. Senza modello, Zybald classifica con regole e data letta dal testo.
- 6 · Collocazione. Le regole dell'azienda, per canale, tipo e mittente, portano il documento nelle cartelle giuste; i documenti di una pratica nata da un modello vanno nella sottocartella che li attende. Se nessuna regola si applica, resta in «In arrivo», visibile solo a chi gestisce.
- 7 · Notifica. Le persone indicate ricevono un messaggio. Le notifiche non contengono dati dei documenti, salvo una scelta esplicita del titolare.
Quando l'AI non riconosce la data o non è sicura della pratica, Zybald non indovina: apre una segnalazione che una persona risolve, la mette nella vista «Da verificare», e registra chi l'ha risolta e quando.
Cinque modi per consegnare un documento.
Il modo in cui un documento entra in azienda dipende da chi lo invia, da dove e con quale dispositivo. I cinque canali convergono nello stesso percorso.
Ogni postazione e ogni dispositivo ha una propria chiave di accesso, revocabile da sola senza toccare gli altri.
Formati accettati: PDF, anche protetti da password; immagini JPG, PNG, TIFF, BMP, WEBP e GIF, che diventano PDF prima della lettura; messaggi di posta salvati (EML); e, dove l'installazione ha LibreOffice, documenti da ufficio Word, Excel, PowerPoint e OpenDocument (DOC, DOCX, ODT, RTF, XLS, XLSX, ODS, PPT, PPTX, ODP), convertiti in PDF senza macro e senza rete.
Il motore che interpreta.
Quando l'azienda lo sceglie, Zybald usa AYXZA Relay, il motore di AYXZA che rende intercambiabile il fornitore del modello linguistico. Cambiare modello è una configurazione, non una riscrittura; si può usare anche un modello eseguito in proprio, attraverso un endpoint compatibile.
Che cosa fa l'AI
- Estrae titolo, tipo, mittente, data, tag, campi del tipo e riassunto dal contenuto, senza modelli rigidi.
- Legge come testo anche i messaggi di posta.
- Riconosce il mittente anche quando è scritto in modo diverso, con un secondo giudizio quando la somiglianza è incerta.
- Propone la pratica a cui il documento appartiene.
Che cosa l'AI non fa
Non decide chi vede il documento: la visibilità discende solo da cartelle, livelli e divieti, regole scritte dalle persone. Non sovrascrive ciò che una persona ha corretto, e cede alle regole scritte dall'azienda.
Dati inviati all'AI
Per classificare, il documento da classificare, per il tempo della classificazione. Per l'assistente, i messaggi della conversazione e il testo dei soli documenti che la persona fa leggere, sempre fra quelli che può già vedere. Utenti, gruppi, permessi e registro non lasciano mai l'installazione. La lettura del testo avviene in locale; l'estrazione tramite AI è un'opzione che si attiva solo se l'azienda la sceglie.
Un modello che legge solo ciò che vedi.
Zybald ha un assistente con un vero modello linguistico, non una casella di ricerca travestita. Si apre dalla testata, accanto all'Archivio, o dal campo «Chiedi» sulla Scrivania. L'interruttore è del titolare: l'assistente resta spento finché non lo attiva, e chi amministra l'installazione non lo usa.
Il motore
Il modello si sceglie per profilo, secondo riservatezza, costo e potenza, e lo instrada AYXZA Relay: Zybald non conosce i nomi dei modelli. Il consumo è contato per persona.
Chi può leggere, e come lo si prova.
La riservatezza non è un'impostazione: è il modo in cui sono costruiti archivio, accessi e registro.
Esportazione
I dati non restano prigionieri. Un comando del server produce un pacchetto cifrato con gli originali in chiaro ordinati per cartella, i metadati, i campi, i collegamenti, le note e il registro in formati aperti; ogni esportazione è registrata e notificata al titolare. Lo stesso pacchetto ricostruisce un'installazione vuota.
Limite dichiarato
Chi ha i privilegi di amministratore del sistema operativo può leggere ciò che la macchina legge: lettura del testo e ricerca richiedono il contenuto in chiaro durante l'elaborazione, e anche il testo delle conversazioni dell'assistente sta nel database in chiaro, come il testo estratto dei documenti. Zybald rende questo accesso difficile, visibile e tracciato nell'applicazione, ma non lo elimina, e lo scrive nel contratto.
La chiave dell'installazione
Se va perduta, i file non si leggono più. All'installazione se ne conserva una copia fuori dalla macchina; il backup la include solo se il titolare lo sceglie, perché un backup con la chiave accanto ai file annulla la cifratura per chi lo sottrae.
Pagine di prova anche in produzione.
Pagine di prova accessibili solo a titolare e amministratore, che non scrivono alcun dato e si possono usare sull'archivio reale. La pagina delle regole è del solo titolare.
- Salute dei processi e impronta della chiave caricata.
- Prova di ingestione a secco.
- Confronto «perché vede / perché non vede» fra due calcoli indipendenti dei permessi.
- Tempi della ricerca.
- Coerenza fra archivio e database.
- Integrità del registro.
- Stato della coda dei lavori.
- Campi, segnalazioni e «che cosa manca» di un fascicolo.
- Regole sul testo applicate a secco.
- Copertura delle lingue.
- Validità di un link pubblico.
- Esecuzione a secco di un flusso.
- Perimetro di un soggetto esterno del portale.
- Assistente, con i soli conteggi.
Per chi valuta il sistema dal punto di vista IT, è il modo di controllare che cosa fa senza fidarsi della documentazione.
Che cosa comprende.
L'archivio è il centro; link pubblici, flussi, portale e assistente lavorano sopra di esso, con gli stessi permessi.
| Area | Contenuto |
|---|---|
| Archivio | Documenti, cartelle virtuali e tag, permessi con divieti, versioni, operazioni sulle pagine, lettura del testo, ricerca, campi per tipo, fascicoli da modello, ricerche salvate, collegamenti, modifica massiva, cinque canali, registro, accesso di emergenza, esportazione. |
| Link pubblici | Link al singolo documento con scadenza obbligatoria, password facoltativa, sola lettura e revoca; un link mostra sempre la versione per cui è nato; un divieto revoca da solo i link esistenti. |
| Flussi | Editor grafico con rami paralleli, condizioni, compiti e azioni automatiche; tre modelli pronti (approvazione semplice, doppia approvazione, protocollazione in arrivo); un compito non apre il documento a chi non lo vede. |
| Portale | Utenze per clienti e fornitori, solo su invito e con secondo fattore, con un'area propria, il caricamento dei documenti e la partecipazione ai flussi. |
| Assistente | Spazio personale, progetti condivisi, memoria confermata, strumenti con i permessi di chi chiede. |
Le tabelle di link pubblici, flussi e portale esistono dalla prima versione dello schema: attivarli non richiede di migrare l'archivio.
Che cosa l'azienda può cambiare.
Ogni realtà ha cartelle, gruppi e regole propri. Si adattano dall'interfaccia, senza toccare il codice.
| Area | Che cosa si modifica |
|---|---|
| Utenti e gruppi | Inviti, sospensioni, ruoli; appartenenze ai gruppi gestite dal custode dei permessi. |
| Cartelle e permessi | Albero delle cartelle, livelli per gruppo, divieti motivati. |
| Canali | Chiavi delle postazioni e dei dispositivi, mittenti di posta autorizzati. |
| Regole di collocazione | Cartelle di destinazione per canale, tipo di documento e mittente. |
| Regole sul testo | Parole ed espressioni che assegnano tipo, mittente, tag e cartella prima del modello. |
| Campi | Campi di ogni tipo di documento, e quali propone il modello. |
| Modelli di fascicolo | Sottocartelle e documenti attesi di ogni tipo di pratica. |
| Istruzioni per l'AI | Contesto aziendale e criteri di classificazione; lo schema della risposta resta bloccato. |
| Soglie | Somiglianza per riconoscere mittenti e pratiche. |
| Lingua | Lingua dell'installazione per ricerca, lettura del testo e AI; ogni persona sceglie la propria lingua dell'interfaccia. |
| PDF protetti | Password con cui aprire i PDF in arrivo, conservate cifrate. |
| Notifiche | Chi le riceve e se possono contenere dati dei documenti. |
| Assistente | Attivazione, profilo predefinito, strumenti attivi, proposta automatica dei ricordi, conservazione delle conversazioni. |
| Accesso di emergenza | Durata; la notifica al titolare non si può disattivare. |
| Conservazione | Durata del registro (minimo ventiquattro mesi) e del cestino. |
Ogni modifica di configurazione è a sua volta un evento del registro.
Che cosa c'è sotto.
Per chi valuta l'integrazione dal punto di vista IT, una vista sintetica dei componenti tecnici.
| Componente | Tecnologia |
|---|---|
| Sistema operativo | Ubuntu 24.04 LTS |
| Applicazione | Python 3.12, Flask 3 con gunicorn, SQLAlchemy 2 e Alembic |
| Database | PostgreSQL 16, ricerca a testo pieno in italiano e in inglese |
| Lettura del testo | OCRmyPDF e Tesseract, italiano e inglese |
| PDF dei messaggi | WeasyPrint, in un processo separato |
| Formati da ufficio | LibreOffice senza interfaccia, facoltativo, senza macro e senza rete |
| Interfaccia | Vue 3, Vite, TypeScript, in italiano e in inglese; caratteri ospitati nell'installazione |
| Motore AI | AYXZA Relay, per classificazione e assistente |
| Processi | Tre servizi systemd con utente di sistema dedicato |
| Reverse proxy e HTTPS | Caddy |
| Client Windows | Programma per Windows che invia la cartella dedicata |
| Inbox USB | Raspberry Pi Zero 2W |
| Backup | Borg, cifrato, verso uno spazio separato, con prova di ripristino su macchina pulita alla messa in servizio |
Nessun servizio esterno obbligatorio oltre al fornitore del modello, e nemmeno quello, se l'azienda classifica solo con le regole.
Che cosa Zybald non fa.
Zybald è pensato per archiviare, classificare e proteggere documenti. Non sostituisce strumenti aziendali con responsabilità diverse.
- Non è un gestionale. Non registra movimenti contabili, non emette fatture, non gestisce scadenzari.
- Non è PEC, né Sistema di Interscambio, né conservazione a norma. Può ricevere per posta le copie delle fatture elettroniche dopo che sono state acquisite dai canali ordinari.
- Non cancella per scadenza normativa. Le regole di conservazione fiscale e legale restano responsabilità dell'azienda.
- Non perdona tutti gli errori di battitura. La ricerca è precisa sulle parole; quando non trova nulla propone termini simili tra titoli, mittenti e tag.
- Non serve più organizzazioni nella stessa installazione. Ogni cliente ha la propria.
- Non legge codici a barre e non numera l'archivio con etichette fisiche.
- Non riconosce i documenti quasi uguali, solo quelli identici.
- Non si collega ancora all'accesso unico aziendale.
- L'assistente non naviga sul web e non esegue codice.
- Non sostituisce la lettura. Il riassunto aiuta a ritrovare un documento, non a decidere sul suo contenuto.