netgescon-day0/docs/DOCUMENTI-NFC-E-ACQUISIZIONE.md

Documenti, NFC e acquisizione

Stato attuale archivio documenti

La pagina Strumenti > Documenti gestisce gia un flusso rapido di archiviazione:

• selezione stabile;
• scelta cartella archivio con ACL;
• categoria protocollo e titolo;
• metadati principali del documento;
• upload PDF;
• protocollo progressivo automatico;
• collegamento eventuale a movimento contabile;
• indicazione faldone fisico per l'archivio cartaceo.

Dopo il salvataggio il documento viene gia memorizzato con:

• file PDF archiviato;
• protocollo interno;
• cartella logica;
• visibilita per ruolo, gruppo e utente singolo;
• estrazione testo best-effort per ricerca tramite PdfTextExtractionService.

Dashboard protocollo comunicazioni

La pagina Strumenti > Documenti ora apre di default una prima tab dedicata al protocollo comunicazioni.

Questa vista e pensata come dashboard operativa per l'amministratore e mostra solo i documenti visibili diversi dalle fatture.

Funzioni attive:

• ricerca live su protocollo, titolo, descrizione, ente e riferimento archivio;
• filtro per categoria documento;
• vista a box con anteprima PDF incorporata;
• vista lista compatta per consultazione rapida;
• contatori rapidi su totale documenti, PDF disponibili, inserimenti del mese e categorie presenti.

Scelta implementativa:

• la tab usa i record Documento gia protocollati e gia filtrati dal servizio di visibilita;
• le fatture restano nella loro vista archivio digitale separata;
• non e stato aperto un sottosistema parallelo su CommunicationMessage per evitare doppioni funzionali in questa fase.

Archivio fisico ed etichette

La base operativa dell'archivio cartaceo e ora utilizzabile con etichette e codici persistenti.

Capacita disponibili:

• registrazione di elementi fisici come documento, busta, cartella a tre lembi, faldone con anelli, faldone con lacci e scatola;
• collegamento facoltativo tra voce fisica e documento digitale;
• codifica univoca persistente per la movimentazione dell'archivio;
• stampa etichette nei formati DYMO 11354 e DYMO 99014;
• pagina pubblica firmata per dettaglio contenitore o documento tramite QR.

Per i documenti digitali resta disponibile anche l'assegnazione dei metadati fisici principali:

• supporto fisico;
• contenitore o faldone;
• busta;
• fascicolo;
• periodo di riferimento;
• modello etichetta;
• watermark predefinito in stampa.

QR locale sulle etichette

La generazione QR per le etichette fisiche non dipende piu da servizi remoti.

Dettagli operativi:

• viene usata la libreria gia presente nel progetto chillerlan/php-qrcode;
• non e stato aggiunto simple-qrcode per incompatibilita con il lock corrente su bacon/bacon-qr-code;
• il rendering finale viene convertito in SVG inline, cosi il preview di stampa resta visibile anche nel browser e il QR non esce dai margini dell'etichetta.

Questo elimina la dipendenza da URL esterni per il QR e rende piu stabile il preview di stampa.

Stampa PDF e watermark archivio

Per i documenti PDF sono ora previste due aperture distinte dalla tab archivio:

• apertura/stampa standard del PDF;
• apertura con watermark archivio digitale e fisico, quando i riferimenti archivistici sono presenti.

Il watermark usa Ghostscript solo se disponibile lato server. In assenza del binario, il PDF continua ad aprirsi senza bloccare il flusso.

Topbar contestuale

La topbar Filament non usa piu lo scorrimento orizzontale per stabile, gestione e anno.

La soluzione adottata e strutturale:

• i controlli ora vanno a capo;
• il contenitore topbar nasconde l'overflow orizzontale;
• il selettore riscaldamento continua a dipendere dallo stato operativo reale dello stabile.

Indicizzazione e OCR

La base applicativa e gia predisposta per:

• testo OCR o testo estratto dal PDF;
• metadati OCR;
• ricerca documentale su contenuto;
• classificazione guidata con cartelle e categorie.

La parte da verificare operativamente e la qualita reale dell'estrazione sui documenti scansionati e sui PDF immagine. Il prossimo test utile e:

1. caricare un PDF nativo;
2. caricare un PDF da scanner;
3. verificare contenuto OCR salvato e ricercabilita.

PDF watermark e firma

Fattibile lato server:

• watermark visivo con protocollo, stabile, data e utente;
• timbro di archiviazione;
• overlay su PDF acquisiti;
• ristampa etichetta o frontespizio.

Da distinguere dalla firma digitale vera:

• watermark: semplice e interno, subito fattibile;
• firma PAdES/CAdES: richiede certificato, firma remota o dispositivo di firma.

Quindi la strada pragmatica e:

1. watermark/timbro immediato per i PDF archiviati;
2. firma digitale solo quando decidiamo provider o certificato operativo.

Short link con bcards.it

Il dominio bcards.it si presta bene a generare short link per:

• apertura rapida cartella archivio;
• apertura scheda stabile;
• apertura documento o checklist;
• accesso a presenza assemblea;
• accesso a votazione assemblea;
• accesso a pagina di scansione o acquisizione.

Architettura consigliata:

• short code univoco nel dominio corto;
• redirect verso URL NetGescon firmata o tokenizzata;
• scadenza opzionale;
• tracciamento accessi;
• associazione a tag NFC o QR.

iPhone e autenticazione dispositivo

Safari su iPhone non espone seriale hardware, IMEI o MAC address alla pagina web.

La soluzione corretta e:

• primo accesso con login normale;
• enrollment del dispositivo;
• passkey/WebAuthn o token revocabile;
• NFC che apre short link;
• il browser completa l'autenticazione con la credenziale gia registrata.

ACR122U e tag NFC da PC

Con il lettore/scrittore ACR122U su PC si puo lavorare, ma non in modo affidabile da una semplice pagina web pura per tutti i browser.

Strade realistiche:

• Chrome/Edge desktop con WebUSB/WebHID: possibile solo in alcuni scenari, non ideale come base di produzione;
• bridge locale su PC con PC/SC o libnfc: soluzione robusta;
• pagina web NetGescon che dialoga con un piccolo servizio locale: soluzione consigliata.

Uso previsto:

• leggere UID o NDEF del tag;
• scrivere short link bcards.it/...;
• associare il tag a faldone, cartella, documento o stabile;
• richiamare in un click la scheda giusta.

Presenze e votazioni assemblea

Fattibile nello stesso impianto:

• convocazione assemblea;
• check-in presenza via link corto, QR o NFC;
• conteggio deleghe e millesimi presenti;
• apertura votazioni per punto ODG;
• raccolta voto da device autenticato;
• verbale e report finale.

Per farlo bene conviene usare due livelli:

• regia assemblea da desktop operatore;
• accesso rapido da smartphone per presenza e voto quando previsto.

Scanner Epson da pagina web

Pilotare uno scanner Epson direttamente da una pagina web standard non e generalmente affidabile.

Le strade reali sono:

• scanner di rete che salva in cartella o invia via mail;
• agente locale Windows che usa TWAIN/WIA/SDK Epson;
• pagina web che invia il comando al servizio locale e acquisisce il PDF risultante.

Per operativita immediata la soluzione piu semplice e:

1. scansione verso cartella controllata;
2. upload/ingestione rapida in NetGescon;
3. OCR e archiviazione automatica.

Dymo LAN 11354

Domani si puo provare una stampa etichetta su rete con formato 11354 usando:

• template HTML/PDF per etichetta;
• spool di stampa verso stampante LAN;
• contenuti minimi: codice stabile, tipo archivio, faldone/cartella, short link o QR.

Nota stato attuale:

• l'app genera gia il layout etichetta e il QR locale;
• non e ancora stato collegato uno spool diretto verso la DYMO su IP 192.168.0.56;
• restano quindi aperte due strade operative: stampa via macchina Windows gia configurata oppure invio diretto future-proof verso stampante di rete.

Prossimi passi consigliati

1. test reale OCR e ricerca su 2-3 PDF campione;
2. attivazione watermark PDF in archiviazione;
3. tabella short links con dominio bcards.it;
4. bridge locale PC per ACR122U;
5. prova Dymo LAN con etichetta 11354;
6. definizione modulo presenza e voto assemblea.