Gestione data validita' documenti drive¶
Panoramica¶
Progetto di potenziamento del sistema di gestione documentale su Drive per Ocmis Irrigazione: introduce la validita' temporale dei documenti, filtri avanzati di ricerca e una vista gerarchica per cartelle all'interno dei QrCode. Obiettivo: garantire che l'utente finale consulti sempre la versione corretta dei documenti in base alla data di acquisto della macchina, migliorando al contempo l'esperienza di navigazione.
| Codice | Descrizione |
|---|---|
| ANALISI-1093 | Ticket interno |
| Ver. 1 | Versione documento |
Informazioni generali¶
| Voce | Valore |
|---|---|
| Data creazione | 07/11/2025 |
| Codice interno / Ticket | ANALISI-1093 |
| Cliente | Ocmis Irrigazione Spa |
| Analista di riferimento | Alessandro Luppi |
| Versione del documento | Ver. 1 |
Sommario esecutivo¶
Il cliente necessita di potenziare il sistema di gestione documentale su Drive, introducendo funzionalita' di validita' temporale dei documenti e migliorando le capacita' di ricerca e filtro. Attualmente il sistema non permette di tracciare la validita' temporale dei documenti ne' di organizzare efficacemente la consultazione attraverso filtri avanzati.
Obiettivi principali¶
- Implementare un sistema di gestione della validita' temporale dei documenti
- Migliorare l'esperienza di ricerca e filtro degli utenti
- Organizzare la visualizzazione dei documenti per cartelle all'interno dei QrCode
Risultati attesi¶
- Maggiore controllo sulla validita' e conformita' documentale
- Miglioramento della user experience nella consultazione
Ambito del cliente¶
| Voce | Valore |
|---|---|
| Settore | Manifatturiero (irrigazione) |
| Modello di business | B2B |
| Stakeholder interni coinvolti | Personale gestione Drive |
| Impatti attesi sul business | Maggiore controllo e tracciabilita', miglioramento user experience |
Ambito del progetto¶
Il progetto copre i seguenti interventi:
- Implementazione campi data inizio/fine validita' sui documenti Drive
- Estensione sezione filtri generali con filtro validita'
- Creazione filtri avanzati nella pagina di dettaglio dei QrCode (validita', lingua, tag)
- Implementazione vista per cartelle all'interno dei QrCode
- Interfaccia utente per gestione e visualizzazione date di validita'
BN001 — Gestione Validita' Temporale dei Documenti¶
Descrizione: il cliente necessita di tracciare e gestire la validita' temporale dei documenti presenti su Drive per permettere all'utente di utilizzare la versione corretta dei documenti in base alla data di acquisto della macchina.
Soluzione proposta e impatto: implementare un sistema di metadati che associ a ogni documento una data di inizio e fine validita', permettendo il filtraggio dei file.
FE001.1 — Campi Data Validita' sui Documenti¶
Descrizione: aggiungere sui documenti Drive due nuovi campi: "Data Inizio Validita'" e "Data Fine Validita'" compilabili e modificabili dagli utenti autorizzati.
Soluzione proposta e impatto: estensione del database per memorizzare i metadati di validita' associati a ciascun documento Drive (tramite file ID). Interfaccia di modifica accessibile dalla scheda documento. Gli utenti potranno immediatamente identificare il periodo di validita' di un documento.
Regole di business (BR001.1)¶
| Regola | Descrizione |
|---|---|
| BR001.1.a | La data inizio validita' non puo' essere successiva alla data fine validita' |
| BR001.1.b | Un documento senza data inizio validita' e' considerato valido da sempre |
| BR001.1.c | Un documento senza data fine validita' e' considerato valido indefinitamente |
| BR001.1.d | Solo utenti con permessi di modifica dei file possono modificare le date di validita' |
Requisiti tecnici (R001.1)¶
| Requisito | Descrizione |
|---|---|
| R001.1.a | I metadati devono essere memorizzati in una tabella dedicata del database |
BN002 — Filtri Avanzati e Ricerca Documentale¶
Descrizione: il cliente necessita di potenziare le capacita' di ricerca e filtro per gestire i nuovi campi riguardanti la data di validita'.
Soluzione proposta e impatto: implementare un sistema di filtri avanzati sia nella sezione generale che nella pagina di dettaglio, permettendo ricerche complesse e combinazioni multiple di criteri.
FE002.1 — Filtro Validita' nella Sezione Generale¶
Descrizione: aggiungere alla sezione filtri generali del sistema un nuovo filtro basato sulla validita' temporale dei documenti.
Soluzione proposta e impatto: campo di filtro che permette di selezionare una data di validita' specifica. Gli utenti potranno concentrarsi solo sui documenti rilevanti per il loro contesto temporale.
Regole di business (BR002.1)¶
| Regola | Descrizione |
|---|---|
| BR002.1.a | Il filtro "Validi in data specifica" permette di inserire una data e vedere quali documenti erano/saranno validi in quella data |
| BR002.1.b | Il filtro deve essere combinabile con altri filtri esistenti |
| BR002.1.c | Di default, il filtro non viene applicato |
FE002.2 — Filtri Avanzati nella Pagina Dettaglio QrCode¶
Descrizione: implementare una sezione di filtri avanzati all'interno della pagina che si apre dopo aver aperto un QrCode, includendo: data di validita', lingua del documento e altri tag personalizzati.
Soluzione proposta e impatto: pannello laterale o superiore con filtri a tendina e checkbox per filtrare rapidamente i documenti visualizzati. Permette agli utenti di esplorare grandi collezioni documentali in modo efficiente e contestuale.
Regole di business (BR002.2)¶
| Regola | Descrizione |
|---|---|
| BR002.2.a | I filtri devono essere applicabili in tempo reale senza ricaricare la pagina |
| BR002.2.b | I filtri lingua devono mostrare solo le lingue effettivamente presenti nei documenti della vista corrente |
| BR002.2.c | I filtri tag devono supportare selezione multipla |
| BR002.2.d | Deve essere presente un pulsante "Reset filtri" per rimuovere tutte le selezioni |
Requisiti tecnici (R002.2)¶
| Requisito | Descrizione |
|---|---|
| R002.2.a | Implementazione filtri lato client per performance ottimali |
BN003 — Organizzazione Gerarchica dei Documenti¶
Descrizione: il cliente necessita di visualizzare i documenti organizzati per cartelle quando accede ai QrCode di Drive, mantenendo la struttura gerarchica originale per facilitare la navigazione e il contesto documentale.
Soluzione proposta e impatto: implementare una vista ad albero che rispecchia la struttura delle cartelle Drive. Migliora significativamente l'orientamento dell'utente e il contesto dei documenti.
FE003.1 — Vista Gerarchica per Cartelle¶
Descrizione: creare una visualizzazione ad albero delle cartelle all'interno della pagina di dettaglio dei QrCode, permettendo agli utenti di navigare la struttura come farebbero in Drive.
Soluzione proposta e impatto: interfaccia tree-view con possibilita' di espandere/collassare cartelle, vedere il numero di documenti per cartella, e filtrare all'interno di una specifica cartella. Gli utenti potranno contestualizzare meglio i documenti e navigare piu' naturalmente.
Regole di business (BR003.1)¶
| Regola | Descrizione |
|---|---|
| BR003.1.a | La struttura cartelle deve riflettere esattamente l'organizzazione su Drive |
| BR003.1.b | I filtri applicati devono funzionare anche sulla vista per cartelle |
Formazione e supporto¶
| Voce | Valore |
|---|---|
| Destinatari | Personale che si occupa della gestione di Drive |
| Modalita' | Formazione da remoto |
Deployment e governance¶
Il rilascio avverra' in ambiente alpha per il test interno, seguira' il rilascio su ambiente beta per formazione e testing da parte del cliente. All'accettazione delle modifiche verra' effettuato il rilascio in ambiente di produzione.