# 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`. ## Tab scansione documenti La pagina `Strumenti > Documenti` include ora una tab dedicata chiamata `Scansione documenti`. Questa tab copre il flusso subito testabile in staging senza dipendere da un comando diretto browser -> scanner: - upload del PDF prodotto dallo scanner; - selezione stabile, cartella archivio, categoria e classe archivio; - tracciamento del canale di acquisizione; - salvataggio del riferimento batch o sessione; - riuso dello stesso motore documento e della stessa pipeline OCR gia presenti. Metadati aggiuntivi salvati nel documento: - `canale_acquisizione`; - `scanner_profile`; - `riferimento_acquisizione`; - `origine_documento`. Canali previsti nella prima versione operativa: - upload PDF da scanner; - scanner Epson verso cartella o rete; - scanner via email; - upload mobile o camera; - acquisizione manuale. ## 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 universale per allegati PDF, immagini, file Office e testi; - vista lista compatta per consultazione rapida; - contatori rapidi su totale documenti, allegati disponibili, inserimenti del mese e categorie presenti. Aggiornamento operativo: - la griglia box e stata estesa fino a 4 schede per riga sui layout ampi; - il pulsante `Apri` usa lo stesso endpoint inline gia esistente e quindi non resta limitato ai soli PDF; - il pulsante `Stampa` viene mostrato solo per i tipi file che il browser puo gestire in modo utile in preview o print; - i documenti senza file restano comunque visibili come metadati di protocollo, senza forzare una falsa anteprima. 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. Etichette generiche evolute: - preset rapidi per scatole, raccoglitori, buste e nodi logistici; - scelta layout con varianti QR a destra o in basso; - binding dei campi DB nelle zone titolo, sottotitolo, meta e nota; - preview grafica live prima del salvataggio; - salvataggio del template dentro `metadati.generic_label_template`, cosi la stampa reale segue lo stesso disegno scelto in tab. Taratura operativa corrente: - `11354`: layout orizzontale principale con correzione verticale leggera verso l'alto; - `11354 verticale`: variante dedicata ai driver che ruotano l'etichetta, ora con rotazione corretta lato stampa; - `99014`: QR spostato in basso a destra per liberare spazio scrivibile nella parte alta. 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. ## QR pubblico e dominio esterno Il QR dell'archivio fisico non deve piu dipendere dall'IP interno del server. Implementazione attuale: - la firma della route pubblica viene generata in forma relativa; - il link finale viene costruito usando `APP_PUBLIC_URL`, con fallback su `APP_URL`; - la validazione avviene lato controller con firma relativa, cosi il QR resta valido anche dietro dominio pubblico o reverse proxy. Questo rende il QR gia abbastanza universale anche nel caso di passaggio del materiale tra amministratori, perche il riferimento stabile e l'item fisico firmato e non l'identita del singolo operatore che ha creato l'etichetta. Configurazione richiesta in ambiente: 1. impostare `APP_PUBLIC_URL` con il dominio realmente raggiungibile dall'esterno; 2. lasciare `APP_URL` per il contesto applicativo interno se serve; 3. rigenerare o aggiornare i QR gia salvati solo se si vuole riallineare anche il dato persistito nel database. Esempio: - `APP_PUBLIC_URL=https://netgescon.example.it` ## 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 nella tab `Scansione documenti` di NetGescon; 3. OCR e archiviazione automatica. Per il modello Epson WF-C5710 la direzione pratica da testare non e il browser puro, ma una di queste due: - scansione verso cartella di rete osservata da NetGescon; - piccolo bridge locale o di rete che espone una chiamata HTTP interna e usa il canale scanner disponibile sul dispositivo. Questo evita il vincolo dei browser su TWAIN/WIA e mantiene il flusso pilotabile dalla pagina archivio. ## Archivio digitale La vista `Strumenti > Documenti > Archivio digitale` e stata alleggerita per lavorare meglio dentro la cartella corrente. Stato attuale: - breadcrumb e cartelle restano in alto; - la tabella documenti ora usa tutta la larghezza utile; - le informazioni laterali sono state compattate in tre card sintetiche sopra la tabella; - la pagina mostra nome cartella attiva, numero documenti del livello e stato operativo digitale/fisico. ## 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 caricati dalla tab `Scansione documenti`; 2. prova con un PDF generato da Epson ADF e verifica dei metadati `canale_acquisizione` e `riferimento_acquisizione`; 3. attivazione watermark PDF in archiviazione; 4. tabella short links con dominio `bcards.it`; 5. bridge locale PC per ACR122U; 6. prova Dymo LAN con etichetta 11354; 7. definizione modulo presenza e voto assemblea.