Nessuna connessione a Internet

Guida utente — Gestionale Inventario

Questa guida spiega come usare l'app dal punto di vista di chi la usa ogni giorno per gestire oggetti, locazioni e inventari. Non tratta aspetti tecnici o di sviluppo.

Indice

  1. Accesso e sicurezza
  2. Profilo personale
  3. Aziende
  4. Dashboard
  5. Oggetti
  6. Locazioni
  7. Inventari
  8. Categorie
  9. Attività (manutenzione)
  10. Documenti
  11. Scanner QR
  12. Notifiche
  13. Installazione come app e modalità offline
  14. Limiti dell'account
  15. Assistente AI
  16. Persone
  17. Addestramenti
  18. Interventistica

1. Accesso e sicurezza

  • Login: email e password.
  • Password dimenticata: link "Hai dimenticato la password?" nella pagina di accesso, invia un'email per reimpostarla.
  • Autenticazione a due fattori (2FA): obbligatoria. Al primo accesso l'app chiede di inquadrare un QR code con un'app di autenticazione (es. Google Authenticator, Authy) e di inserire il codice a 6 cifre generato per confermare. Da quel momento, ad ogni accesso verrà richiesto il codice dell'app oltre a email e password. Se non si completa questa configurazione non è possibile usare l'app.
  • Sessione: il dispositivo può essere ricordato per circa 4 settimane; uscire da un dispositivo non disconnette gli altri.
  • Logout: richiede conferma prima di uscire.

2. Profilo personale

Dal menu profilo si gestiscono:

  • Informazioni personali: nome, cognome, email, lingua dell'interfaccia (Italiano, English, Deutsch).
  • Cambio password: richiede la password attuale, la nuova e la conferma.
  • Preferenze notifiche: per ciascuna azienda a cui si è associati, si possono attivare/disattivare indipendentemente le notifiche via email e via push (vedi sezione 12).

3. Aziende

L'app è multi-azienda: uno stesso utente può essere associato a più aziende contemporaneamente e passare dall'una all'altra dal menu utente in basso nella barra laterale. Tutti i dati (oggetti, locazioni, inventari, categorie) sono sempre relativi all'azienda attiva in quel momento.

Nella pagina "Azienda" (menu utente) si trova l'elenco degli utenti collegati a quell'azienda, con indicazione se sono attualmente online e la data dell'ultimo accesso, e l'utilizzo dell'Assistente AI (sezione 15).

Navigazione: le voci principali (Oggetti, Locazioni, Inventari, Categorie, Scanner e, se abilitato, Assistente) sono nella barra laterale. Su schermi grandi si può comprimere; su mobile si apre dal pulsante menu in alto.

Nota: non esistono ruoli differenziati (es. amministratore vs utente base): chiunque vi sia associato può vedere e modificare tutti i dati di quell'azienda.

4. Dashboard

Pagina iniziale dopo il login, riepiloga la situazione dell'azienda attiva:

  • Conteggio totale di oggetti, locazioni, inventari e categorie.
  • Ripartizione degli oggetti per stato (Operativo, In manutenzione, Fuori servizio, Dismesso).
  • Oggetti non allocati: oggetti la cui quantità non è ancora completamente distribuita su una o più locazioni.
  • Controlli in scadenza: inventari con una verifica programmata nei prossimi 30 giorni, con evidenza di quelli già scaduti.

5. Oggetti

Il cuore dell'app. Un Oggetto rappresenta un bene o materiale da tracciare (attrezzatura, mezzo, dispositivo, ecc.).

Campi principali: nome, descrizione, stato, quantità totale, numero di serie, codice esterno, fornitore, note, categorie.

Stati possibili: Operativo, In manutenzione, Fuori servizio, Dismesso. Quando un oggetto passa a "Fuori servizio" viene inviata automaticamente una notifica push a chi le ha attivate.

Elenco oggetti: - Ricerca testuale libera. - Filtri avanzati per qualsiasi campo (nome, stato, quantità, categoria, ecc.), combinabili tra loro. - Colonne della tabella personalizzabili (si scelgono quali mostrare). - Esportazione dell'elenco filtrato in CSV. - Generazione PDF con codici QR stampabili, per singolo oggetto o per il gruppo filtrato, con linee tratteggiate per il taglio. - Report PDF di tutti gli oggetti dell'azienda con le relative locazioni, con data dell'ultima modifica (pulsante "Scarica report PDF").

Codice QR: ogni oggetto ha un codice QR univoco generato automaticamente, usato per il riconoscimento rapido tramite lo Scanner (sezione 11). Esiste anche un campo separato "Codice esterno" per un eventuale codice a barre già presente sull'oggetto (es. del fornitore): anche questo è riconosciuto dallo Scanner.

Storico: ogni oggetto ha una pagina "Storico" che registra automaticamente ogni evento — creazione, modifica, eliminazione, aggiunta/rimozione categoria, aggiunta/rimozione inventario, aggiunta/rimozione attività, aggiunta/rimozione documento — con data, utente responsabile e dettaglio della modifica. È il registro di audit completo dell'oggetto.

6. Locazioni

Una Locazione rappresenta un luogo fisico dove possono trovarsi gli oggetti (es. sede, magazzino, scaffale, stanza).

  • Le locazioni sono organizzate ad albero gerarchico: una locazione può avere una locazione padre e più locazioni figlie (es. Sede → Magazzino → Scaffale).
  • Ogni locazione mostra il proprio percorso completo (breadcrumb) nella gerarchia.
  • Elenco con esportazione CSV che include il percorso completo.
  • Anche le locazioni possono avere Attività di manutenzione associate (sezione 9).
  • Eliminando una locazione, le sue sotto-locazioni e gli oggetti contenuti non vengono eliminati.

7. Inventari

Un Inventario collega un Oggetto a una Locazione, indicando quanta quantità di quell'oggetto si trova in quella specifica locazione. Un oggetto può essere distribuito su più locazioni contemporaneamente, ma la somma delle quantità nelle locazioni non può superare la quantità totale dell'oggetto.

Ogni inventario tiene traccia di: - Data ultimo controllo: quando è stata verificata l'ultima volta. - Data prossimo controllo: quando andrà verificata di nuovo.

Se la data di prossimo controllo si avvicina o scade, vengono inviate notifiche automatiche (vedi sezione 12). L'elenco inventari supporta filtri ed esportazione CSV.

Nota: l'oggetto associato a un inventario non può essere cambiato dopo la creazione (per cambiarlo occorre eliminare e ricreare l'inventario).

8. Categorie

Le Categorie sono etichette libere assegnabili agli oggetti per classificarli e per poterli poi filtrare rapidamente nell'elenco. Gestione semplice: crea, rinomina, elimina. Da ogni categoria si può accedere direttamente all'elenco degli oggetti a cui è assegnata.

9. Attività (manutenzione)

Le Attività sono annotazioni con data e contenuto testuale libero, usate per registrare interventi di manutenzione o controlli svolti. Possono essere associate sia a un Oggetto sia a una Locazione. Ogni attività registra automaticamente chi l'ha inserita. La creazione di una nuova attività genera una notifica push a chi le ha attivate.

10. Documenti

A ogni Oggetto è possibile allegare Documenti (file), con una descrizione facoltativa. Limite massimo 50 MB per file; i formati eseguibili (potenzialmente pericolosi) non sono ammessi.

11. Scanner QR

Pagina dedicata che usa la fotocamera del dispositivo per inquadrare: - il codice QR generato dall'app per un oggetto, oppure - un codice esterno/a barre già presente sull'oggetto (es. del fornitore).

Se il codice viene riconosciuto, l'app mostra subito un'anteprima dell'oggetto con link diretto alla sua scheda. Se non viene riconosciuto, compare il messaggio "Oggetto non trovato" (occasionalmente, per scherzo, un'animazione simpatica).

12. Notifiche

Due canali indipendenti, attivabili/disattivabili per ciascuna azienda dal Profilo:

  • Email: riepilogo periodico delle scadenze imminenti.
  • Push (richiede l'app installata come PWA, vedi sezione 13, e il permesso notifiche concesso nel browser): avvisi in tempo reale per:
    • un oggetto passa a "Fuori servizio";
    • viene registrata una nuova Attività su un oggetto;
    • un controllo/inventario è in scadenza tra 3 giorni, scade oggi o è scaduto (con indicazione dei giorni di ritardo).

13. Installazione come app e modalità offline

L'app può essere installata sul dispositivo come PWA (Progressive Web App):

  • Su mobile compare un banner/prompt con il pulsante "Installa" per aggiungerla alla schermata home, con un'esperienza simile a un'app nativa.
  • Se la connessione a Internet cade, compare un banner rosso di avviso in cima alla pagina.
  • Se il server non è raggiungibile, l'app mostra una pagina di fallback "Nessuna connessione a Internet".
  • Le pagine già visitate restano parzialmente disponibili anche offline grazie alla cache del browser, ma non è possibile creare o modificare dati senza connessione.

14. Limiti dell'account

Ogni azienda ha un numero massimo configurabile di: - Oggetti creabili. - Locazioni creabili.

Se il limite viene raggiunto, l'app mostra un messaggio di errore e impedisce di crearne altri finché non si libera spazio o non si aumenta il limite (contattare chi gestisce l'abbonamento/piano dell'azienda).

Anche l'uso dell'Assistente AI ha un limite (sezione 15).

15. Assistente AI

Se abilitato per l'azienda, nella barra laterale compare la voce Assistente: una chat che permette di interrogare e modificare i dati dell'azienda attiva scrivendo in linguaggio naturale. Esempi:

  • "Quali oggetti sono in manutenzione?"
  • "Crea la categoria «Utensili» e assegnala al trapano"
  • "Quante unità del proiettore ci sono in magazzino?"

Come funziona - L'assistente lavora solo sui dati dell'azienda attiva e mostra ogni passaggio man mano che avviene (es. "Letti 12 Oggetti"). - Può leggere e cercare Oggetti, Locazioni, Inventari, Categorie, Attività e Persone (e, se la funzionalità è attiva, Addestramenti e Tipi di attività); può consultare Storico e Documenti in sola lettura (i file si caricano dall'interfaccia). Delle Persone vede solo nome, cognome e stato attivo: email, telefono e note non vengono mai inviati all'assistente e si gestiscono solo dall'interfaccia. - Le modifiche (creare, modificare, eliminare) non partono mai da sole: l'assistente mostra una descrizione dell'operazione e attende che si prema Conferma o Annulla. Le eliminazioni rimuovono anche i dati collegati. Le Attività si possono creare ed eliminare, non modificare. - Le conversazioni sono personali (visibili solo a chi le ha create) e si possono eliminare, come i singoli messaggi. Con "Nuova chat" se ne avvia una nuova. - Mentre l'assistente lavora non si può inviare un altro messaggio.

Limiti di utilizzo: ogni azienda ha un budget di utilizzo condiviso tra tutti i suoi utenti, su due finestre: sessione (5 ore) e settimanale. La finestra parte alla prima richiesta e, quando scade, il contatore riparte da zero. Raggiunto un limite l'assistente si blocca e indica quando si potrà riprendere. L'avanzamento è visibile nella pagina "Azienda". Eliminare una conversazione non restituisce l'utilizzo già consumato.

Se qualcosa non va: se l'assistente non è abilitato per l'azienda o non è configurato compare un messaggio di errore; se la richiesta richiede troppi passaggi, conviene spezzarla in richieste più piccole.

16. Persone

Nel gruppo Anagrafiche della barra laterale, la voce Persone raccoglie l'anagrafica delle persone dell'azienda: nome, cognome, email, telefono, note e se la persona è attiva. Le persone non sono utenti dell'app: non hanno un accesso e non ricevono notifiche.

  • Una persona con addestramenti o interventi registrati non si può eliminare: si può invece segnare come non attiva.
  • Se gli Addestramenti sono attivi per l'azienda, la scheda della persona mostra i suoi addestramenti con il totale delle ore e un pulsante per registrarne uno nuovo.

17. Addestramenti

Funzionalità attivabile per azienda dall'amministratore: quando è attiva, nella barra laterale compare il gruppo Addestramenti con due voci.

  • Tipi di attività: l'elenco delle attività di addestramento (es. "Corso sicurezza", "Uso muletto"). Un'unica tabella mostra i tipi aziendali (creati con Nuovo) e quelli dei template scelti (es. "VVF Trentino"), con la colonna Origine filtrabile. I template sono elenchi comuni preparati dall'amministrazione del servizio: l'amministratore dell'azienda li sceglie con Scegli template e ne riceve tutti i tipi, anche quelli aggiunti in seguito; quelli dei template non si modificano dall'azienda. Un tipo usato da almeno un addestramento non si può eliminare: si può archiviare togliendo la spunta "Attivo" (resta sugli addestramenti già registrati ma non si può più scegliere).
  • Addestramenti: ogni registrazione indica la persona, il tipo di attività, la data, le ore svolte (anche decimali, es. 1,5) ed eventuali note. In creazione si possono scegliere più persone insieme (es. tutti i partecipanti a un corso): viene registrato un addestramento per ciascuna, con stessi tipo, data, ore e note; in modifica ogni addestramento riguarda una sola persona. L'elenco si filtra per persona, tipo, data, ore e note e mostra il totale delle ore dei risultati.

Se la funzionalità viene disattivata gli addestramenti restano salvati ma non sono più visibili né modificabili finché non viene riattivata; l'anagrafica Persone resta sempre disponibile.

18. Interventistica

Funzionalità attivabile per azienda dall'amministratore: quando è attiva, nella barra laterale compare il gruppo Interventistica con due voci.

  • Tipologie: la pagina ha due parti.
    • Template: elenchi di tipologie comuni preparati dall'amministrazione del servizio (es. il template "VVF Trentino" con la tipologia "Incendio boschivo"). Solo l'amministratore dell'azienda può sceglierli, con il pulsante Scegli template: spunta i template che l'azienda usa (anche più di uno, es. "VVF Trentino" e "118 Trentino") e preme Salva template. Da quel momento l'azienda può usare tutte le loro tipologie, comprese quelle aggiunte in seguito.
    • Elenco delle tipologie: un'unica tabella con le tipologie dei template scelti e quelle aziendali (create con Nuovo per i casi non coperti dai template, es. "Sopralluogo"). La colonna Origine indica da dove arriva ognuna ("Aziendale" o il nome del template) e si può usare come filtro; quelle dei template non si modificano dall'azienda.

Una tipologia usata da almeno un intervento non si può eliminare: si può archiviare togliendo la spunta "Attivo". Una tipologia archiviata, o di un template non più usato, resta sugli interventi già registrati ma non compare più tra le scelte. - Interventi: ogni intervento indica le persone coinvolte (dall'anagrafica Persone, anche più di una), il responsabile dell'intervento (una persona, obbligatoria, scelta tra quelle coinvolte), richiesto da (obbligatorio, testo libero: propone i nomi già usati negli altri interventi dell'azienda ma si può scrivere qualsiasi nome), la tipologia (scelta tra quelle dei template, raggruppate per template, e quelle aziendali), data e ora di inizio e di fine, il luogo (stato, provincia, comune e indirizzo) e una descrizione. L'elenco si filtra per persona, tipologia, stato, data di inizio, stato, provincia, comune, indirizzo e descrizione.

Ogni intervento nasce come bozza:

  • Salva bozza salva l'intervento senza confermarlo: finché è in bozza può modificarlo o eliminarlo solo chi l'ha creato, oppure un amministratore.
  • Conferma intervento chiede una conferma e poi blocca l'intervento: da quel momento chi l'ha creato non può più modificarlo né eliminarlo, solo un amministratore (dell'azienda o globale) può farlo.

Tutti i membri con accesso alla funzionalità vedono tutti gli interventi, bozze comprese; quelli che non possono modificare si aprono in sola lettura. La scheda mostra chi ha creato l'intervento e, se confermato, chi l'ha confermato e quando.