Manuale d’uso

1. Avvio dell’applicazione

Apri RegistroConsegne.html nel browser per l’uso locale semplice.

Per utilizzare le funzioni avanzate (PWA, modalità server, autenticazione PHP) è necessario servire l’app tramite HTTP. Da PowerShell, entra nella cartella del programma ed esegui:

python -m http.server 8000

Poi apri nel browser:

http://127.0.0.1:8000/RegistroConsegne.html

2. Scegliere la modalità di utilizzo

Dalla sezione Configurazione scegli la modalità più adatta alla tua situazione.

Locale

Usa questa modalità per lavorare su un singolo PC. I dati vengono salvati nel browser tramite localStorage.

• Usa Salva file per esportare un backup JSON.
• Usa Carica dati per importare un backup precedente.

Esporta backup regolari: se cancelli i dati del browser o cambi browser, i dati locali potrebbero andare persi.

Cartella condivisa

Permette a più persone di lavorare sugli stessi dati tramite una cartella locale, OneDrive, SharePoint sincronizzato o NAS. Richiede Chrome o Edge.

1. Vai in Configurazione.
2. Seleziona Cartella Condivisa.
3. Clicca Collega cartella e scegli una cartella scrivibile.
4. Al primo avvio viene creato il file utenti condiviso.
5. La lock bar mostra chi sta usando l’app. Usa Estendi per prolungare la sessione o Rilascia sessione per liberarla.

Server web

Salva i dati su un server PHP tramite api.php. Il salvataggio è automatico dopo ogni modifica.

1. Carica i file del progetto sul server (assicurati che data/ e logs/ siano scrivibili).
2. Vai in Configurazione → Server Web.
3. Inserisci l’URL dell’API, ad esempio https://tuodominio.it/registro/api.php.
4. Clicca Testa Connessione per verificare.
5. Salva la configurazione.

3. Flusso di lavoro consigliato

1. Configura la modalità di utilizzo.
2. Inserisci o importa gli utenti.
3. Inserisci le case (se necessario).
4. Inserisci o importa il catalogo articoli.
5. Crea una nuova consegna associando utente, tipo dotazione e articoli.
6. Stampa o salva il documento di consegna.
7. Registra le restituzioni quando gli articoli rientrano.
8. Usa Dashboard e report per controllare lo stato e le anomalie.

4. Gestione utenti

Dalla sezione Utenti puoi creare, cercare, modificare ed eliminare utenti.

La scheda dettaglio mostra:

• dati anagrafici;
• casa assegnata;
• storico consegne.

Per restituire più articoli in una sola operazione, usa la restituzione multipla dal dettaglio utente.

5. Gestione case

Dalla sezione Case registra appartamenti, camere o case aziendali.

Ogni casa può contenere residenti e articoli assegnati. Il report casa riepiloga gli articoli presenti nella casa e quelli collegati agli utenti associati.

6. Catalogo articoli

Dalla sezione Catalogo gestisci gli articoli assegnabili.

Ogni articolo può avere:

• categoria e descrizione;
• numero inventario;
• note aggiuntive.

Il badge disponibilità indica quanti articoli non risultano assegnati o persi.

7. Creare una consegna

1. Vai in Consegne.
2. Clicca Nuova Consegna.
3. Seleziona l’utente.
4. Scegli il tipo di dotazione: personale o casa.
5. Aggiungi uno o più articoli.
6. Imposta data, responsabile, firma e stato.
7. Clicca Salva oppure Salva e stampa.

8. Registrare una restituzione

Usa l’azione di restituzione nella tabella consegne oppure la restituzione multipla dal dettaglio utente per restituire più articoli contemporaneamente.

9. Documenti e template

La sezione Documenti permette di personalizzare i template per:

• consegna standard, formale e semplificata;
• restituzione;
• report utente e report casa;
• restituzione multipla.

I segnaposti tra graffe (es. {ente_nome}, {dipendente_nome}) vengono sostituiti automaticamente al momento della stampa. Usa Anteprima con dati esempio per verificare il risultato prima di usare il template.

Puoi scrivere direttamente nel campo di testo oppure caricare un file .html o .txt.

10. Import ed Export

La sezione Import/Export supporta l’importazione da Excel per utenti, case e catalogo.

Per importare:

1. Scarica il template Excel corrispondente.
2. Compila le colonne seguendo le intestazioni.
3. Carica il file compilato.

Gli import sono additivi: i dati esistenti non vengono cancellati automaticamente.

Gli export disponibili producono riepiloghi Excel per:

• beni per utente;
• beni per casa.

11. Configurazione avanzata

In Configurazione puoi:

• scegliere la modalità di utilizzo e i dati di connessione;
• personalizzare i campi per utenti, case e catalogo;
• nascondere campi non usati;
• scegliere lo stile dei documenti stampati;
• gestire gli utenti in modalità Cartella Condivisa (se loggato come amministratore).

12. Uso da mobile e PWA

L’app include manifest e service worker, quindi può essere installata come PWA da browser compatibili.

Requisiti:

• servire l’app via HTTPS o localhost;
• usare il comando del browser Installa app oppure Aggiungi a schermata Home.

Su mobile la navigazione usa il menu hamburger. La modalità Cartella Condivisa dipende dal supporto del browser (Chrome/Edge consigliati).

Problemi comuni

I dati non si salvano in modalità server

• Verifica l’URL dell’API in Configurazione.
• Controlla che data/ sia scrivibile dal server.
• Verifica la presenza di api.php sul server.

La cartella condivisa non si collega

Usa Chrome o Edge. Firefox e Safari potrebbero non supportare la File System Access API.

L’app chiede il login in locale

Controlla auth/config.php e imposta AUTH_ENABLED su false per l’uso locale senza autenticazione.

Le modifiche PWA non appaiono

Chiudi e riapri l’app installata. Se necessario, cancella i dati del sito e il service worker dal browser.

IP bloccato dopo tentativi di login errati

Attendi la fine del blocco oppure, se hai accesso amministrativo al server, rimuovi data/rate_limit.json.