Modellare una procedura amministrativa complessa con step, ruoli, fornitori, documenti, offerte, graduatorie, comunicazioni e bacheca pubblica.
Cosa e stato studiato
Sono stati analizzati i passaggi di una procedura di gara: accesso istituzionale, creazione guidata, scelta fornitori, documenti, offerte, valutazione, comunicazioni e trasparenza. Il lavoro ha richiesto di distinguere attori, permessi e superfici pubbliche, evitando che tutto restasse in una sequenza di email e file.
Cosa e stato fatto
E stata realizzata una web app PHP con accesso SPID/CIE, wizard gara, area fornitori, gestione documenti, offerta economica PDF, graduatorie con punteggi, coda email e bacheca trasparenza. Il sistema mette insieme passaggi che normalmente vivono in strumenti separati, rendendo piu leggibile lo stato della procedura.
Come e stato fatto
La soluzione usa PHP custom, MySQL, JavaScript/DataTables, PHPMailer, integrazione SPID/CIE e moduli per generare documenti e graduatorie. Il progetto va raccontato con cautela: le superfici online non sono pubblicamente accessibili e i dati reali non devono essere esposti. Il valore pubblicabile e il metodo su workflow complessi, non la visibilita del sistema in produzione.
Architettura e tecnologie
Come lo stack e stato usato nel progetto
Workflow multi-step e dominio gara
La procedura viene spezzata in step: tipologia, informazioni, documenti, partecipanti e pubblicazione. Questa architettura consente di guidare l'utente amministrativo e di associare ogni dato alla gara corretta, riducendo il rischio di passaggi saltati o informazioni non collegate.
Ruoli, area fornitori e accesso istituzionale
Il sistema distingue area istituzionale, operatori e fornitori. L'accesso SPID/CIE e l'area riservata servono a controllare chi entra e cosa puo fare. La separazione delle superfici permette di gestire documenti e offerte senza confondere lavoro interno, partecipazione fornitore e pubblicazione esterna.
Documenti, offerte e graduatorie
Documenti, presa visione, offerte economiche e graduatorie sono trattati come parti dello stesso processo. La graduatoria non e un foglio separato, ma l'esito di dati raccolti e criteri applicati. Questo rende il flusso piu tracciabile e piu adatto a essere controllato in momenti diversi.
Coda email e bacheca trasparenza
Le comunicazioni ai fornitori e la bacheca pubblica sono state modellate come estensioni del gestionale. La coda email riduce invii manuali, mentre la bacheca evita doppie compilazioni quando le informazioni pubblicabili derivano dalla procedura stessa. La superficie pubblica resta separata dai dati riservati.
Pattern implementativi
Dettagli tecnici che hanno guidato le scelte
Stateful wizard e validazione progressiva
Un wizard di gara non e una form lunga: ogni step deve salvare stato, validare dati e permettere di riprendere il percorso. La validazione progressiva riduce errori tardivi e consente di mantenere coerenza tra informazioni generali, documenti, fornitori e pubblicazione finale.
Upload documentale e perimetri di visibilita
I documenti devono essere associati a gara, fornitore e ruolo corretto. Il pattern tecnico richiede naming, storage, metadati e permessi coerenti, cosi un file non diventa un allegato generico ma una prova collegata a un passaggio della procedura.
Calcolo graduatoria e ripetibilita
La graduatoria deve poter essere ricostruita partendo da criteri e dati salvati. Questo impone di separare input, regole di calcolo ed esito, evitando interventi manuali non tracciati. Il risultato deve essere spiegabile e coerente con documenti e offerte raccolte.
Pubblicazione prudente e anonimizzazione
Il progetto gestisce dati amministrativi e fornitori, quindi il caso studio deve filtrare nomi, documenti, importi e configurazioni operative. La pubblicazione corretta racconta il metodo: workflow, ruoli, documenti e scelte tecniche, senza trasformare il sito in una copia della documentazione interna.
Risultati e apprendimenti
Base storica per procedure di gara e workflow documentali, utile come racconto metodologico su portali amministrativi complessi e pubblicabile solo con contenuti anonimizzati.
- nei workflow amministrativi lo stato del processo conta piu della singola schermata
- documenti e offerte devono restare collegati a ruoli e passaggi
- la pubblicazione del caso deve proteggere dati e contesto reale