Zybald DOC-01 In sviluppo
Gestione documentale · riservatezza · assistente

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.

5
Canali di ingresso
unificati
3
Livelli di permesso
per cartella
1
Punto unico di verifica
dei permessi
1
Installazione per cliente,
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.

01funzione

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.

01 · cartelle
Cartelle che non obbligano a scegliere
Cartelle e sottocartelle virtuali, più i tag. Lo stesso documento può stare in più cartelle senza essere duplicato: la fattura di un fornitore sta nell'amministrazione e nella pratica a cui si riferisce. Una pratica può nascere da un modello, con le sue sottocartelle e i documenti attesi, e mostra in ogni momento che cosa manca.
02 · permessi
Permessi che si spiegano
Ogni gruppo ha su una cartella uno di tre livelli: lettura, contributo, gestione. I livelli scendono lungo l'albero. Un divieto esplicito, «questo gruppo non vede mai questo documento», prevale su qualunque concessione. Ogni persona può chiedere perché vede un documento; il confronto per qualunque utente sta nelle pagine di prova.
03 · ricerca
Ricerca dentro i permessi
Ricerca a testo pieno nella lingua dell'installazione, italiano o inglese, combinabile con cartella, tag, tipo, mittente, date e campi del tipo di documento. Il filtro dei permessi sta nella stessa interrogazione: un documento vietato non può comparire nemmeno per un disallineamento. Le ricerche si salvano, personali o condivise con il proprio gruppo, e mostrano sempre solo ciò che vede chi le apre.
04 · lavoro quotidiano
Segnalare, modificare, collegare
Segnalare un documento a un collega che lo vede già, con una scadenza e un avviso per posta: la segnalazione non apre a nessuno un documento che non poteva leggere. Modificare fino a cinquecento documenti insieme, tutto o niente. Collegare documenti fra loro. Una vista «Da verificare» raccoglie ciò che chiede una persona: una data non trovata, un campo da confermare, un probabile doppione, un PDF protetto senza password.
05 · pagine e versioni
Ogni modifica è una versione
Ruotare, eliminare e riordinare le pagine; dividere un documento in due o unirne più d'uno. Ogni modifica è una versione nuova e immutabile, e alla versione precedente si torna quando si vuole.
«Il vero costo di un documento non è archiviarlo, è ritrovarlo dopo nove mesi.» Premessa di progetto
02architettura

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.

FIG · 01 · Architettura logica del sistema ZYBALD · STRUTTURA
CANALI · INGRESSO Inbox USB raspberry pi zero Cartella PC programma windows Posta casella dedicata Bot Telegram smartphone · foto Interfaccia carica · trascina PROCESSI Servizio web API · interfaccia Canali posta · bot Worker coda · assistente LOGICA · REGOLE Strato di logica UN SOLO PUNTO DI VERIFICA Identità e accessi Permessi · divieti Archivio · impronte Versioni Ricerca a testo pieno Registro degli eventi AYXZA Relay classificazione · assistente DATI PostgreSQL metadati · coda registro Archivio file cifrati AES-256 modello LEGENDA flusso interno chiamata al modello
  • 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.

03percorso

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.

FIG · 02 · Percorso di un singolo documento INGRESSO · ELABORAZIONE IN BACKGROUND
1 Ingresso impronta SHA-256 2 Deduplica nessun doppione 3 Archivio file cifrato in «In arrivo» 4 Lettura OCR · ufficio → PDF 5 Classificazione regole, poi Relay 6 Collocazione regole e fascicoli 7 Notifica senza dati del documento Subito IL CANALE RICEVE LA RISPOSTA In background WORKER · CODA DEI LAVORI
  • 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.

04ingresso

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.

canale 01 · inbox USB
Un dispositivo, come una chiavetta
Un piccolo dispositivo si collega al PC come una chiavetta. I file copiati al suo interno partono verso il server e vengono tolti dal dispositivo.
canale 02 · cartella PC
Una cartella dedicata su Windows
I file copiati nella cartella partono in background, e un file che non passa resta da parte con il motivo, senza bloccare gli altri.
canale 03 · posta
Un indirizzo dedicato dell'azienda
Ogni mail di un mittente autorizzato diventa un documento, con una copia in PDF da sfogliare e gli allegati collegati. Scrivendo #nome-cartella nell'oggetto, un collega la deposita dove ha già diritto di aggiungere documenti.
canale 04 · bot Telegram
Dal telefono, dove si trova il documento
Una foto o un file inviati dal telefono, dal luogo in cui si trova il documento.
canale 05 · interfaccia
Dalla finestra di Zybald
Si trascina un file nella finestra di Zybald, o lo si carica dall'assistente durante una conversazione: in quel caso finisce nello spazio personale di chi lo carica.

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.

05intelligenza artificiale

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.

06assistente

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.

01 · spazio personale
Uno spazio che i colleghi non vedono
Ogni persona ha uno spazio suo, con le sue conversazioni, i suoi file e le sue cartelle, che i colleghi e il titolare non vedono. Un documento si porta nell'archivio comune con un gesto della persona, mai da solo. L'accesso di emergenza vale anche qui, con le sue regole: motivazione, durata limitata, registro, notifica.
02 · progetti condivisi
Istruzioni, documenti e memoria comune
Un progetto raccoglie istruzioni, documenti di riferimento e una memoria comune, e si condivide con un gruppo o con una persona. Ognuno vi trova solo i documenti che vede già; le conversazioni restano di chi le ha scritte finché non sceglie di condividerle, con un avviso.
03 · memoria
Una memoria che si conferma
L'assistente propone che cosa ricordare; ricorda solo ciò che la persona conferma, e una pagina mostra tutto ciò che sa, da modificare o cancellare riga per riga. Salute, opinioni politiche e religiose, orientamento e dati identificativi di terzi non si salvano.
04 · strumenti
Con i permessi di chi chiede
Cerca e legge i documenti, crea un documento nel tuo spazio, allega al progetto: sempre con i permessi della persona e senza accessi di emergenza. Niente navigazione sul web, niente esecuzione di codice. Nel registro resta che cosa è stato letto e per mezzo dell'assistente, mai il testo della conversazione.

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.

07riservatezza

Chi può leggere, e come lo si prova.

La riservatezza non è un'impostazione: è il modo in cui sono costruiti archivio, accessi e registro.

01 · installazione
Installazione dedicata
Una installazione per cliente, su un server europeo o su una macchina in azienda. Nessuna piattaforma condivisa.
02 · file
File cifrati
Ogni file è cifrato sul disco con AES-256, con una chiave propria dell'installazione. Sul disco i nomi dei file sono impronte: nessun titolo, nessun nome di cliente.
03 · accessi
Accessi
Password conservate con argon2id; secondo fattore obbligatorio per chi gestisce; blocco dopo tentativi falliti e limiti di frequenza su accessi e recuperi. L'applicazione non è raggiungibile direttamente dalla rete: passa solo da un reverse proxy con HTTPS.
04 · registro
Registro
Ogni operazione è registrata, comprese le letture e gli scarichi: chi, quando, che cosa, con quale esito. Le righe sono concatenate da impronte crittografiche, così una modifica o una cancellazione si rileva. Conservazione minima di ventiquattro mesi.
05 · amministratore
L'amministratore non legge
Chi amministra l'installazione gestisce utenti, configurazione e salute del sistema, ma non ha accesso ad alcuna cartella, non ha uno spazio personale e non usa l'assistente. Se serve davvero aprire un documento, esiste un accesso di emergenza: motivazione scritta, durata limitata, ogni lettura registrata, notifica immediata al titolare.
06 · divieti
Divieti e custode
I divieti li pone e li toglie solo il «custode dei permessi», con motivazione registrata. Chi amministra il sistema non può nominarsi custode né inserirsi nei gruppi.

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.

08verifica

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.

09funzioni

Che cosa comprende.

L'archivio è il centro; link pubblici, flussi, portale e assistente lavorano sopra di esso, con gli stessi permessi.

AreaContenuto
ArchivioDocumenti, 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 pubbliciLink 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.
FlussiEditor 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.
PortaleUtenze per clienti e fornitori, solo su invito e con secondo fattore, con un'area propria, il caricamento dei documenti e la partecipazione ai flussi.
AssistenteSpazio 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.

10configurazione

Che cosa l'azienda può cambiare.

Ogni realtà ha cartelle, gruppi e regole propri. Si adattano dall'interfaccia, senza toccare il codice.

AreaChe cosa si modifica
Utenti e gruppiInviti, sospensioni, ruoli; appartenenze ai gruppi gestite dal custode dei permessi.
Cartelle e permessiAlbero delle cartelle, livelli per gruppo, divieti motivati.
CanaliChiavi delle postazioni e dei dispositivi, mittenti di posta autorizzati.
Regole di collocazioneCartelle di destinazione per canale, tipo di documento e mittente.
Regole sul testoParole ed espressioni che assegnano tipo, mittente, tag e cartella prima del modello.
CampiCampi di ogni tipo di documento, e quali propone il modello.
Modelli di fascicoloSottocartelle e documenti attesi di ogni tipo di pratica.
Istruzioni per l'AIContesto aziendale e criteri di classificazione; lo schema della risposta resta bloccato.
SoglieSomiglianza per riconoscere mittenti e pratiche.
LinguaLingua dell'installazione per ricerca, lettura del testo e AI; ogni persona sceglie la propria lingua dell'interfaccia.
PDF protettiPassword con cui aprire i PDF in arrivo, conservate cifrate.
NotificheChi le riceve e se possono contenere dati dei documenti.
AssistenteAttivazione, profilo predefinito, strumenti attivi, proposta automatica dei ricordi, conservazione delle conversazioni.
Accesso di emergenzaDurata; la notifica al titolare non si può disattivare.
ConservazioneDurata del registro (minimo ventiquattro mesi) e del cestino.

Ogni modifica di configurazione è a sua volta un evento del registro.

11stack

Che cosa c'è sotto.

Per chi valuta l'integrazione dal punto di vista IT, una vista sintetica dei componenti tecnici.

ComponenteTecnologia
Sistema operativoUbuntu 24.04 LTS
ApplicazionePython 3.12, Flask 3 con gunicorn, SQLAlchemy 2 e Alembic
DatabasePostgreSQL 16, ricerca a testo pieno in italiano e in inglese
Lettura del testoOCRmyPDF e Tesseract, italiano e inglese
PDF dei messaggiWeasyPrint, in un processo separato
Formati da ufficioLibreOffice senza interfaccia, facoltativo, senza macro e senza rete
InterfacciaVue 3, Vite, TypeScript, in italiano e in inglese; caratteri ospitati nell'installazione
Motore AIAYXZA Relay, per classificazione e assistente
ProcessiTre servizi systemd con utente di sistema dedicato
Reverse proxy e HTTPSCaddy
Client WindowsProgramma per Windows che invia la cartella dedicata
Inbox USBRaspberry Pi Zero 2W
BackupBorg, 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.

12limiti

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.