MaterialFlow - Manuale

Introduzione e panoramica

MaterialFlow organizza le consegne di materiali a gruppi di persone. Ogni lista contiene i materiali da distribuire; per ciascuna persona puoi registrare cosa è stato consegnato e quando. Questa guida descrive la copia aggiornata durante la revisione del 1 novembre 2026.

1.1 A chi serve e come leggere la guida

La guida è destinata a chi prepara materiali, gestisce partecipanti e registra distribuzioni. Per iniziare segui il capitolo 3; per le operazioni quotidiane consulta i capitoli 4–7. Backup e gestione delle schede sono spiegati nei capitoli 10 e 11.

1.2 I concetti principali

Gruppo persone

Elenco riutilizzabile di destinatari, con nome, ruolo e colore. Lo stesso gruppo può essere associato a più liste.

Lista materiali

Insieme di materiali, categorie, quantità, unità e note, con un eventuale gruppo associato.

Consegna

Stato sì/no di un materiale per una persona, con data e ora. Senza gruppo, la lista mantiene una consegna generica per materiale.

1.3 Dove si trovano i dati

L’app salva nel browser utilizzato. Il comando Manuale nella barra superiore apre questa guida; tieni il file del manuale accanto all’app. Il file HTML dell’applicazione e l’archivio dei dati sono elementi distinti: copiare solo l’HTML non garantisce di trasferire liste e consegne.

Requisiti e accesso

Apri materialflow.html in un browser aggiornato che consenta l’archiviazione locale.

2.1 Browser e collegamento Internet

Per il normale utilizzo serve un browser con JavaScript e archiviazione locale abilitati. Chrome ed Edge espongono le funzioni richieste per collegare file e cartelle, quando il contesto e i permessi del browser lo consentono. Negli altri casi usa il backup JSON manuale.

Le librerie per importazioni ed esportazioni avanzate vengono scaricate al primo utilizzo. Una connessione Internet può quindi essere necessaria per XLSX, Word, PDF e immagini PNG. Non considerare garantito il funzionamento interamente offline di queste operazioni.

2.2 Primo accesso

1. Apri l’applicazione e compila Username e Password.
2. Per un archivio nuovo, le credenziali iniziali presenti nel file sono admin e password. Se l’archivio è già utilizzato, valgono le credenziali memorizzate in quell’archivio.
3. Se necessario seleziona Rimani connesso, quindi premi Accedi oppure Invio.

2.3 Cambiare la password e uscire

Dalla barra superiore scegli Password. Inserisci password attuale, nuova password e conferma, poi premi Aggiorna Password. L’app richiede almeno quattro caratteri; scegli una password più robusta per l’uso effettivo.

Per chiudere la sessione usa il pulsante con etichetta accessibile Esci accanto al nome utente. Il logout svuota anche le operazioni di consegna annullabili nella sessione.

Primi passi: preparare una consegna

Un percorso completo, dalla creazione del gruppo al primo backup.

3.1 Preparazione iniziale

1. In Dashboard, apri Gruppi Persone e scegli Nuovo Gruppo.
2. Salva il gruppo, aprilo e usa Aggiungi Persona per inserire i destinatari.
3. Torna alla Dashboard e seleziona Liste Materiali.
4. Scegli Nuova Lista, assegna un nome e seleziona il gruppo nel campo Gruppo Persone.
5. Apri la lista e aggiungi i materiali con ＋ Materiale, oppure usa Importa File.

3.2 Registrazione e chiusura del lavoro

1. Nel riquadro Persone seleziona un destinatario.
2. Spunta i materiali consegnati e verifica la percentuale di completamento.
3. Ripeti per gli altri destinatari. Se commetti un errore usa Annulla consegna.
4. Apri Report & PNG per consultare o esportare il riepilogo.
5. Apri Backup e scegli Scarica Backup JSON.

Dashboard e liste materiali

La Dashboard è il punto di partenza per aprire liste e gruppi e consultare i riepiloghi.

4.1 Ricerca e apertura

Usa le schede Liste Materiali e Gruppi Persone per cambiare elenco. Il campo Cerca... restringe le schede mostrate. Apri una scheda per entrare nel dettaglio; il marchio MaterialFlow nella barra superiore e il comando Dashboard riportano alla schermata iniziale.

Illustrazione semplificata, non screenshot. Nomi e contenuti sono esempi.

4.2 Creare e modificare una lista

Scegli Nuova Lista oppure Crea Lista se l’elenco è vuoto. Compila il nome obbligatorio; descrizione, responsabile e gruppo sono facoltativi. Conferma con Salva Lista. Per intervenire in seguito usa Modifica nel dettaglio o il comando di modifica sulla scheda.

4.3 Duplicare, riordinare ed eliminare

Il comando Duplica sulla scheda crea una copia della lista con i materiali, ma senza le consegne precedenti. Usa la maniglia di trascinamento della scheda per riordinare le liste dove il dispositivo supporta questa interazione.

Elimina richiede conferma e rimuove la lista. Questa eliminazione non viene recuperata con Annulla consegna; un eventuale ripristino da JSON riguarda l’archivio e può sostituire altri dati.

Gruppi e persone

Gestisci l’anagrafica dei destinatari prima di collegarla alle liste.

5.1 Creare un gruppo e inserire persone

In Gruppi Persone scegli Nuovo Gruppo, inserisci il nome, una descrizione facoltativa e un colore. Premi Salva Gruppo. Apri il gruppo e scegli Aggiungi Persona: compila il nome obbligatorio, il campo Ruolo / Gruppo facoltativo e il colore dell’avatar. Conferma con Salva Persona.

Il campo Ruolo / Gruppo è una descrizione della persona: non crea un altro gruppo anagrafico.

5.2 Modifica, duplicazione ed eliminazione

Nel dettaglio del gruppo puoi modificarlo, duplicarlo, cercare persone ed esportare l’elenco. La duplicazione assegna nuovi identificativi alle persone: non trasferisce le consegne registrate nelle liste esistenti.

Per eliminare più persone usa le caselle di selezione e Elimina selezionati. Eliminare una persona rimuove anche le sue consegne nelle liste che utilizzano il gruppo. Eliminare un gruppo scollega quel gruppo dalle liste associate.

5.3 Importare un elenco persone

1. Apri il gruppo di destinazione e premi Importa Elenco.
2. Se utile inserisci un Ruolo predefinito.
3. Carica un file Excel .xlsx/.xls, Word .docx oppure PDF.
4. Controlla l’anteprima: escludi voci con il comando di rimozione o con la selezione multipla. I nominativi già presenti vengono separati; + Aggiungi permette di includerli comunque.
5. Premi Importa per confermare.

Le intestazioni Nome e Cognome, quando riconosciute, possono essere unite in un nominativo. Per PDF e documenti con impaginazione complessa controlla attentamente il risultato. Non è presente una funzione OCR per immagini scansionate.

Materiali, categorie e selezioni

La tabella della lista raggruppa i materiali per categoria e mostra quantità, stato, note e azioni.

6.1 Aggiungere e modificare materiali

Premi ＋ Materiale. Inserisci nome, quantità positiva, unità, categoria e note. Unità e categoria propongono valori già utilizzati nella lista. Se la categoria è vuota viene usato Generale; se l’unità è vuota viene usato pz. Premi Salva.

Le quantità nulle, negative o vuote vengono rifiutate nell’inserimento manuale. Se il nome coincide con un materiale esistente, l’app chiede se vuoi salvare comunque.

6.2 Ricerca, filtri e ordinamento

Il campo Cerca filtra per nome o categoria. Il menu di stato offre Tutti, Da consegnare e Consegnati. Le intestazioni Materiale e Qtà permettono di ordinare le righe; le categorie restano gruppi distinti.

6.3 Caselle di selezione e cancellazione

Le caselle della prima colonna selezionano righe per la cancellazione multipla: non registrano una consegna. La casella di consegna è un controllo distinto, mostrato nella vista della singola persona o nelle liste senza gruppo.

Seleziona tutti riguarda le righe visibili. Una selezione già effettuata può restare attiva cambiando ricerca o filtri: verifica il contatore prima di usare Elimina selezionati. Usa Annulla selezione per svuotarla.

Registrare e annullare le consegne

Scegli prima il destinatario e poi registra i materiali consegnati.

7.1 Vista per persona e vista aggregata

Nel riquadro Persone seleziona un nome. La tabella mostra lo stato individuale e la data di consegna: attiva la casella per registrare, disattivala per rimuovere la consegna. La data viene assegnata quando la consegna è registrata.

La voce che mostra tutte le persone apre la vista aggregata, con indicatori per destinatario. Gli indicatori sono un riepilogo: per modificare una singola consegna seleziona la persona. solo incompleti restringe l’elenco delle persone con lavoro ancora da completare.

Senza gruppo associato, le spunte registrano una consegna generica per materiale.

Illustrazione semplificata con dati dimostrativi, non screenshot.

7.2 Consegna visibili e Azzera visibili

Consegna visibili imposta come consegnati solo i materiali che passano ricerca e filtro di stato. Azzera visibili rimuove le consegne degli stessi materiali e richiede conferma.

Con una persona selezionata l’azione riguarda solo quella persona; nella vista aggregata riguarda tutte le persone del gruppo. Con una lista senza gruppo riguarda le consegne generiche.

7.3 Annulla consegna e Storico

Il pulsante Annulla consegna ripristina l’ultima modifica alle consegne, incluse le date precedenti. Un’azione in blocco vale come un’unica operazione annullabile. Sono conservate fino a cinquanta operazioni durante la sessione, in ordine inverso.

La pila di annullamento viene svuotata con ricaricamento della pagina, uscita o ripristino di un backup. Se i materiali, i destinatari o gli stati interessati sono cambiati, l’app può rifiutare l’annullamento per evitare di ripristinare dati incoerenti.

Storico apre invece la cronologia delle operazioni: è un registro, non un elenco di comandi di ripristino. Esporta storico CSV scarica il registro con data, utente, operazione e descrizione. Cancella elimina il registro dopo conferma; non azzera le consegne.

Importare ed esportare materiali

L’importazione prepara un’anteprima prima di aggiungere i materiali alla lista.

8.1 Scegliere file e destinazione

1. Crea almeno una lista, quindi scegli Importa File.
2. Controlla il campo Lista di destinazione.
3. Carica o trascina un file CSV/TXT, Excel XLSX/XLS, Word DOCX o PDF.
4. Esamina le righe trovate. Puoi escluderle singolarmente o in blocco; i nomi già presenti o ripetuti vengono separati. Usa + Aggiungi solo se vuoi includere una voce segnalata come duplicata.
5. Premi Importa.

Cambiando la lista di destinazione, l’app ricalcola le corrispondenze senza rileggere il file. Le caselle nell’anteprima servono a escludere le voci con il comando dedicato: Importa aggiunge tutte le righe rimaste nell’elenco da importare.

8.2 Preparare un CSV corretto

Usa preferibilmente le intestazioni Nome;Quantità;Unità;Categoria;Note. Sono riconosciuti virgola, punto e virgola e tabulazione come separatori. Senza intestazioni riconosciute, le cinque colonne vengono lette in questo ordine.

Nome;Quantità;Unità;Categoria;Note
Quaderno A4;1;pz;Cancelleria;A quadretti
"Carta; colorata";"1,5";kg;Laboratorio;"Prima riga
Seconda riga con ""virgolette"""

L’esempio è illustrativo. Racchiudi tra doppi apici i campi contenenti separatori o ritorni a capo; raddoppia i doppi apici interni. Una quantità assente diventa 1. Le quantità non valide interrompono la lettura e mostrano un errore: correggi il file e ricaricalo.

8.3 Esporta CSV e limiti dei formati

Nel dettaglio lista scegli Esporta CSV. L’esportazione comprende tutti i materiali della lista, anche se la tabella è filtrata; con un gruppo associato include colonne per le persone e valori Sì/No.

Per PDF e Word l’estrazione dipende dalla struttura del documento. Le scansioni e i layout complessi possono non produrre un elenco corretto: verifica l’anteprima o usa CSV/Excel.

Report, immagini e stampa

Apri Report & PNG dal dettaglio della lista oppure il comando Report sulla scheda.

9.1 Leggere il riepilogo

Il report mostra i materiali della lista, i destinatari, le consegne completate e mancanti e la percentuale di avanzamento. Le sezioni per persona e categoria aiutano a controllare la distribuzione.

Il report riguarda l’intera lista: la ricerca e i filtri della tabella operativa non lo limitano.

9.2 Scaricare o condividere il report

• Scarica PNG: salva il report come immagine.
• Scarica PDF: genera il documento PDF.
• Stampa: apre la finestra di stampa del browser; se compare una nuova finestra, consentila per questa operazione.
• Copia Testo: copia un riepilogo testuale per incollarlo altrove.

Backup e sincronizzazione su disco

Il salvataggio nel browser è automatico, ma un backup separato serve per conservare e trasferire i dati.

10.1 Scaricare e ripristinare un backup JSON

1. Dalla barra superiore apri Backup.
2. Premi Scarica Backup JSON e conserva il file in una cartella riconoscibile.
3. Per il ripristino, nella sezione Importa Backup seleziona o trascina il file JSON.
4. Se la struttura viene riconosciuta, leggi la conferma prima di sovrascrivere i dati correnti.

10.2 File sincronizzato e cartella automatica

Collega file sincronizzato seleziona il file JSON destinato a ricevere gli aggiornamenti. Usa un nuovo file dedicato: il collegamento può scrivervi i dati correnti, quindi non scegliere un documento o un backup da preservare.

Collega cartella backup automatico abilita copie periodiche nella cartella scelta. Puoi mantenere anche una seconda destinazione indipendente: Collega cartella Google Drive. Seleziona una cartella resa disponibile sul computer da Google Drive per desktop, diversa dalla cartella locale. Il browser non verifica che la cartella scelta appartenga effettivamente a Drive. Sono disponibili intervalli comuni di 1, 5, 15, 30 e 60 minuti; Backup ora tenta una copia in tutte le destinazioni configurate. Ogni copia viene riletta e confrontata integralmente con i dati scritti. Un errore su una destinazione viene segnalato separatamente e non impedisce il tentativo sulle altre. Una copia verificata nella cartella Drive non certifica l’avvenuta sincronizzazione cloud: controlla lo stato in Google Drive per desktop. Il caricamento diretto tramite API Google non è integrato. Se non puoi collegare la cartella, usa Scarica Backup JSON e carica manualmente il file su Drive. I permessi e il supporto dipendono dal browser. L’automatismo opera mentre la pagina è in esecuzione, non è un servizio attivo a browser chiuso.

10.3 Permessi, cronologia e pulizia

Se compare Riautorizza sincronizzazione, usa il comando di riautorizzazione del file o della cartella e conferma il permesso nel browser. Più tardi rimanda la procedura. La richiesta distingue file sincronizzato, cartella locale e cartella Google Drive; rinnova ciascun permesso tramite il relativo pulsante.

In Cronologia Backup Automatico scegli Cartella locale o Cartella Google Drive in Destinazione da consultare, poi premi Aggiorna per rileggere l’elenco. Ripristino ed eliminazione agiscono solo sulla destinazione selezionata. Puoi ripristinare un backup oppure eliminarne uno o più tramite selezione. L’eliminazione riguarda i file nella cartella: conserva almeno le copie necessarie prima di fare pulizia.

Schede multiple e protezione dei dati

È preferibile lavorare in una sola scheda dell’app per ciascun archivio.

11.1 Dati aggiornati in un’altra scheda

Se viene rilevata una versione più recente nello stesso archivio del browser, compare Dati aggiornati in un’altra scheda. Le scritture della scheda obsoleta vengono sospese.

1. Se devi conservare il contenuto locale, premi Esporta copia di questa scheda.
2. Passa alla scheda con i dati aggiornati e scarica anche da lì un backup se necessario.
3. Nella scheda sospesa premi Ricarica dati aggiornati solo dopo avere conservato ciò che ti serve.

11.2 Archivio non leggibile

Se l’archivio del browser non supera i controlli, l’app sospende le scritture e permette di esportare l’archivio originale da verificare. Conserva quel file e le copie di backup disponibili, quindi chiedi assistenza a chi gestisce l’app.

Non cancellare i dati del browser per tentare di risolvere il problema prima di avere una copia utilizzabile. La schermata non offre una riparazione automatica dell’archivio.

Domande frequenti e problemi

Controlli pratici prima di riprovare un’operazione.

12.1 Accesso, dati e annullamento

Le credenziali iniziali non funzionano.

Potresti avere un archivio con password già modificata o ripristinata da backup. Verifica username e password; dopo il blocco per tentativi falliti attendi cinque minuti. Non è disponibile il recupero via email.

Ho aperto la copia aggiornata ma non vedo le mie liste.

Il percorso o il browser può usare un altro archivio. Esporta JSON dalla versione che mostra i dati e importalo nella copia desiderata, dopo avere salvato anche l’eventuale contenuto corrente.

Annulla consegna è disabilitato.

Non ci sono modifiche annullabili nella sessione corrente, oppure hai ricaricato, effettuato logout o ripristinato un backup.

La riga è sparita dopo la spunta.

Controlla il filtro: con Da consegnare una riga completata esce dai risultati. Seleziona Tutti.

12.2 Importazioni, salvataggio ed esportazioni

Un CSV non viene letto correttamente.

Controlla intestazioni, separatori e doppi apici. Se una quantità è negativa, nulla o non numerica, correggila nel file. Con virgola decimale e separatore virgola racchiudi il numero tra doppi apici.

Il PDF importato non contiene nomi o materiali.

Può essere una scansione o un documento con layout non riconosciuto. Prepara un CSV o un foglio Excel con dati tabellari.

Compare Salvataggio non riuscito.

Esporta subito un backup JSON del contenuto corrente. Verifica poi lo spazio e le impostazioni del browser, evitando di cancellare l’unica copia dei dati.

Il download PDF/PNG o l’importazione avanzata non parte.

Verifica connessione Internet, eventuali blocchi alle librerie esterne e messaggi del browser. Per la stampa controlla anche il blocco delle finestre aggiuntive.

Il browser non supporta il collegamento a cartelle.

Usa Scarica Backup JSON. Per le funzioni su disco prova un contesto compatibile in Chrome o Edge e concedi i permessi richiesti.

La tabella è più larga dello schermo.

Scorri orizzontalmente dentro la tabella per raggiungere note e azioni; la pagina principale resta adattata allo schermo.

Supporto e manutenzione

Il file dell’applicazione non indica un recapito di assistenza verificato.

13.1 Preparare una richiesta utile

Rivolgiti alla persona o all’organizzazione che ti ha fornito MaterialFlow. Indica il browser utilizzato, l’operazione eseguita, il messaggio preciso e i passaggi per riprodurre il problema. Se utile, allega un’immagine della schermata senza informazioni riservate.

13.2 Aggiornare l’applicazione

1. Scarica un backup dall’app ancora funzionante.
2. Conserva la copia del file HTML precedente.
3. Apri la nuova copia e verifica l’archivio visibile.
4. Importa il JSON solo se necessario, dopo aver controllato la conferma di sostituzione.
5. Verifica una lista, una persona e alcune consegne prima di riprendere il lavoro.

Questa guida documenta la revisione del 1 novembre 2026; la versione applicativa è 2026.11.01.

Note legali e copyright

Zeky System è la firma riportata nell’applicazione e in questo manuale.

14.1 Uso del documento e informazioni trattate

© Zeky System — MaterialFlow | Manuale Utente. Le illustrazioni sono schematiche e usano solo dati dimostrativi. I nomi dei browser e dei formati sono citati per descrivere le operazioni disponibili.

Non sono state fornite condizioni di licenza o una politica di assistenza specifica: questo manuale non le sostituisce né ne introduce di nuove. Chi gestisce l’archivio deve stabilire accessi, conservazione e condivisione adeguati alle informazioni effettivamente inserite.