suddivisione capitoli readme

README.md

@@ -1,7 +1,18 @@
 # SCRIVANIA DIGITALE
 
-[TOC]
-
+.. toctree::
+
+   ./docs/DEMO.md
+   ./docs/INTRO.md
+   ./docs/ASPETTI_TECNOLOGICI.md
+   ./docs/DIAGRAMMI_DI_FLUSSO.md
+   ./docs/MENU.md
+   ./docs/INTERFACCIA.md
+   ./docs/GESTIONE_DOCUMENTI.md
+
+
+
+
 # DEMO
 
 ```$sh

docs/ASPETTI_TECNOLOGICI.md

@@ -0,0 +1,25 @@
+## ASPETTI TECNOLOGICI
+
+Il software è sviluppato come una web application che può funzionare in modalità standalone, cioè anche senza un application server (es. Tomcat) dedicato.
+
+Il software è stato sviluppato con il framework JHipster, che comprende le seguenti tecnologie:
+
+- **Spring Boot** per IOC e web server
+- **Liquibase** per la persistenza dei dati, l'applicazione può usare diversi DMBS (es. H2 per i tests, PostgreSQL per produzione)
+- **Hibernate** per le cache e le configuazioni distribuite; l'applicazione può avere diverse istanze per la ridondanza e gestione del carico
+- **AngularJS** per le interfacce
+- **Activiti** per la gestione dei processi
+- **Spring Cloud Config** per la confiurazione esternalizzata
+- **Sprint Storage Cloud** per la gestione dei documenti
+
+Le funzionalità sviluppato a supporto dell'esecuzione dei processi amministrativi sono:
+
+- **Gestione dell'autenticazione** che può avvenire attraverso utenze locali all'applicazione, attraverso LDAP oppure attraverso ulteriori gestori di utenze (es. ACE, da aggiungere ad-hoc)
+- **Gestione delle autorizzazioni** sia in locale che attraverse gestori esterni (es. ACE)
+- **Gestione dei metadati** per ogni processo, compresi gli allegati, e la cronologia dettagliata (chi ha fatto cosa e quando)
+- **Gestione dei compiti e delle visibilità** dei flussi amministrativi
+- **Notifiche email** sia predefinite (es. "hai un nuovo compito") che personalizzate (es. "Il tuo compito è in attesa da X giorni")
+- **Gestione Firma Digitale** interna ai flussi amministrativi (richiede sign-server esterno)
+- **Comunicazione con altre applicazioni** attraverso interfacce REST (altre applicazioni possono eseguire compiti in Scrivania ed eventi in Scrivania possono chiamare REST di altre applicazioni)
+- **Azioni custom** per ogni tipo di evento (da sviluppare ad hoc)
+- **Generazione report e statistiche** in .pdf e in .csv

docs/DEMO.md

@@ -0,0 +1,11 @@
+# DEMO
+
+```$sh
+./run.sh
+```
+
+oppure
+
+```$sh
+mvn clean install spring-boot:run -Pprod -DskipTests -Dspring.profiles.active=native,showcase,test,swagger
+```

docs/DIAGRAMMI_DI_FLUSSO.md

@@ -0,0 +1,22 @@
+# DIAGRAMMA DI FLUSSO
+
+ ![Flusso OIV](./screenshots/Flusso_OIV.jpg)
+
+Figura 1 - esempio di diagramma di flusso
+
+
+
+
+# FASI DEL FLUSSO
+
+In genere un flusso può essere suddiviso in sottoflussi. Ad esempio il flusso "Acquisti" può essere principalmente suddiviso in 5 macro-fasi che corrispondono ai Documenti Principali che dovranno essere gestiti all'interno del procedimento:
+
+1. PRE DETERMINA
+2. DECISIONE A CONTRATTARE
+3. PROVVEDIMENTO DI AGGIUDICAZIONE
+4. CONTRATTO FUORI MEPA
+5. STIPULA MEPA
+6. REVOCA PROCEDURA
+
+ ![Flusso_OIV](./screenshots/18_Fasi_del_Flusso.jpg)
+Figura 18 - Fasi del Flusso

docs/GESTIONE_DOCUMENTI.md

@@ -0,0 +1,76 @@
+
+# GESTIONE DOCUMENTI
+
+![documenti scrivania](./screenshots/documenti_scrivania.JPG)
+
+
+
+## Documenti tipo 1 - Documenti tipizzati gestiti Interamente da Sistema
+
+Sono quei documenti "definiti" che vengono gestiti da Scrivania Digitale. Questi documenti vengono modificati, approvati, firmati e protocollati all'interno dell'applicazione. Il sistema prevede anche la gestione di default dei metadati associati (es. pubblicabile in Trasparenza / Urp)
+
+ ![Flusso OIV](./screenshots/12_Caricamento_Documenti_Tipologia_1.jpg)
+Figura 12 – Caricamento Documenti Tipologia 1
+
+## Documenti tipo 2 - Documenti tipizzati caricati nel Sistema
+
+Sono documenti "definiti" che vengono caricati in Scrivania Digitale. Questi documenti vengono caricati all'interno dell'applicazione ma non vengono firmati e protocollati all'interno dell'applicazione. Parametri come il protocollo possono essere inseriti all'atto del caricamento.
+
+ ![Flusso OIV](./screenshots/13_Caricamento_Documenti_Tipologia_2.jpg)
+Figura 13 - Caricamento Documenti Tipologia 2
+
+## Documenti tipo 3 - Documenti Allegati
+
+Sono quei documenti "non definiti" che vengono caricati in Scrivania Digitale. Per questi documenti deve essere specificato il "Tipo Documento" e tutti i metadati gestiti nei documenti di quel determinato flusso.
+
+ ![Flusso OIV](./screenshots/14_Caricamento_Documenti_Tipologia_3.jpg)
+Figura 14 - Caricamento Documenti Tipologia 3
+
+Documenti di questo tipo possono essere caricati extra-flusso da utenti con ruoli speciali mediante apposita interfaccia nei dettagli del flusso.
+
+## Gestione della "etichette" in un flusso
+
+Durante l'esecuzione dei vari Task del Flusso ciascun documento può essere etichettato con informazioni utili come ad esempio quello della pubblicazione sul portale dell'ente "**pubblicabile in trasparenza**" o "**pubblicabile URP**".  La gestione di queste etichette dipende dalle specifiche di ogni flusso. Possiamo riportare un esempio della gestione di queste 2 etichette per il flusso "Acquisti":
+
+- Per i documenti di tipo 1 e 2 viene gestita dal sistema.
+- Per gli allegati (tipo 3) è settata da chi inserisce il documento; modificabile da altri utenti durante la gestione del proprio task (selezionando il bottone modifica).
+
+Quando il sistema completa alcune fasi determinate, i documenti "pubblicabili in trasparenza" o "pubblicabili URP" saranno effettivamente resi rispettivamente disponibili per la pubblicazione in trasparenza e in URP. Le rispettive etichette cambieranno in "**PubblicatoTrasparenza**" o "**PubblicatoURP**".
+
+ ![Flusso OIV](./screenshots/15_etichette_sui_documenti.jpg)
+Figura 15 - etichette sui documenti
+
+## Gestione delle etichette - extra flusso
+
+Ruoli che hanno permessi particolari possono in qualsiasi momento cambiare lo stato di pubblicazione di un documento. Per modificare i documenti basta andare sui dettagli del flusso e cliccare la "rotellina" relativa al documento che si vuole modificare come indicato in Figura 16
+
+ ![Flusso OIV](./screenshots/16_gestione_documenti_extra_flusso.jpg)
+Figura 16 - gestione documenti extra flusso
+
+## Gestione della pubblicazione - parametri di Protocollo (data e nr)
+
+- Per i documenti di tipo 1 il protocollo viene inserito manualmente nei compiti (task) appositi. Al completamento con successo del Compito il documento verrà etichettato con l'etichetta "Protocollato"
+- Per i documenti di tipo 2 e 3 sono settati da chi inserisce il documento modificabile da altri utenti durante la gestione del proprio task (selezionando il bottone modifica) e solo da ruoli specifici in qualsiasi momento). Al completamento con successo del Compito il documento verrà etichettato con l'etichetta "Protocollo (nr protocollo)"
+
+È importante inserire sempre il numero di protocollo, perché è uno di quei parametri che può essere usato nel pannello Ricerca. Il risultato indicherà il flusso che possiede quel documento. Dai dettagli del flusso sarà possibile recuperare tutti i dati necessari e scaricare il file.
+
+## Modifica Documenti
+
+I documenti inseriti posso essere modificabili nel task (se il task lo prevede), o nella schermata dettagli dai ruoli a cui è stato dato il permesso di cambiarli. Potranno essere cambiati tutti i metadati e caricato un nuovo file in sostituzione del vecchio (nuova versione del documento) come già descritto nel paragrafo Gestione Documenti a meno che che il file non sia stato già firmato e protocollato (Documenti tipo 4)
+
+## Documenti tipo 4 - Documenti Firmati e Protocollati all'interno di Scrivania Digitale
+
+Sono quei documenti del tipo 1 che sono già stati firmati e protocollati all'interno dell'applicazione. Questi Documenti non possono essere modificati semplicemente. Utenti identificati come responsabili per quel specifico flusso e struttura hanno la possibilità di effettuare un cambiamento:
+
+1. Per "**Rettifica**" per cui:
+     - Verrà caricato un nuovo file di rettifica firmato e protocollato esternamente
+     - Verrà inserito il suo nr di protocollo
+     - Verranno copiati gli altri metadati dal documento principale
+2. Per "**Sostituzione**" in quei casi di per cui:
+     - Verrà caricato un nuovo file di rettifica firmato e protocollato esternamente in sostituzione del precedente (sarà una nuova versione dello stesso file)
+     - Verrà inserito il suo nr di protocollo
+     - Verranno copiati gli altri metadati dal documento principale
+     - Verrà inserita la "motivazione della sostituzione"
+
+ ![Flusso OIV](./screenshots/17_Documenti_tipo_4.jpg)
+

docs/INTERFACCIA.md

@@ -0,0 +1,85 @@
+
+# INTERFACCIA
+
+Nella presente sezione sono definiti gli elementi di base che costituiscono l'interfaccia utente **.**
+
+## Maschera di inserimento dati
+
+La maschera di inserimento dati fornisce all'utente l'interfaccia per poter immettere gli input in maniera corretta e guidata. Ci sono diverse tipologie di campi di inserimento (documento, testo, area di testo, data, ecc..) ognuna specifica per un diverso tipo di dato. In Figura 2 viene riportato un esempio di maschera di inserimento dati relativa al Task " Avvio Flusso .
+
+ ![2-avvio flusso](./screenshots/2_avvio_flusso.jpg)
+Figura 2- maschera di inserimento dati relativa al Task " Avvio Flusso"
+
+## TIPOLOGIE DI INPUT
+
+### Nota Informativa
+
+La nota informativa corrisponde al set di informazioni che viene visualizzato all'utente come aiuto nella comprensione del compito che deve svolgere.
+
+ ![Flusso OIV](./screenshots/9 – nota informativa.jpg)
+Figura 9 – nota informativa
+
+### Testo
+
+Il testo è un comune campo di input a cui è associata un'etichetta.
+
+ ![3-Testo](./screenshots/3_testo.jpg)
+Figura 3 - Testo
+
+### Area di Testo
+
+Le aree di testo consentono di inserire una descrizione più lunghe, che può essere distribuita su più righe.
+
+Un apposito parametro permette allo sviluppatore di definire il numero massimo di righe (default = 3 righe).
+
+ ![Flusso OIV](./screenshots/4_Area_di_Testo.jpg)
+Figura 4 - Area di Testo
+
+### Opzioni Scelta multipla
+
+TODO: Inserire immagine
+
+### Opzioni Scelta con Pulsante
+
+Alcuni parametri possono essere selezionati tramite pulsante, come nel caso delle priorità
+
+ ![Flusso OIV](./screenshots/5_opzioni_scelta_con_bottoni.jpg)
+Figura 5 - opzioni scelta con bottoni
+
+### Opzioni Scelta con menù ad albero
+
+Alcuni parametri possono essere selezionati tramite menù ad albero.
+
+ ![Flusso OIV](./screenshots/6_opzioni_scelta_con_menu_ad_albero.jpg)
+Figura 6 - opzioni scelta con menù ad albero
+
+
+
+### Selezione tramite campo di testo con funzione di autocompletamento
+
+L'input di alcuni campi può essere effettuato tramite campo di testo con funzione di autocompletamento, che permette di selezionare una delle voci visualizzate automaticamente durante la digitazione. Un esempio classico è quello della scelta del nominativo di un utente (Figura 7 - Selezione tramite funzione di autocompletamento).
+
+ ![Flusso OIV](./screenshots/7_Selezione_tramite_funzione_di_autocompletamento.jpg)
+Figura 7 - Selezione tramite funzione di autocompletamento
+
+### Pulsante Azione
+
+I pulsanti Azione permettono di selezionare l'azione desiderata e determinare così la prosecuzione del flusso.
+
+ ![Flusso OIV](./screenshots/8_azioni_scelta.jpg)
+Figura 8 – azioni scelta
+
+
+### Set Multipli di Dati
+
+Alcune entità associate ad un compito sono caratterizzate da un set di dati (es. l'entità "impegno" è caratterizzata da un identificativo, un esercizio, una GAE, etc.).  Nel caso sia necessario inserire più entità dello stesso tipo associate al medesimo compito (es. più impegni per la medesima procedura di acquisto), è possibile cliccare sul pulsante verde con il segno (+) (Figura 10) per far apparire nella maschera un nuovo set di campi identico al precedente.
+
+ ![Flusso OIV](./screenshots/10_Set_Multipli_di_Dati.jpg)
+Figura 10 - Set Multipli di Dati
+
+Il risultato di questo inserimento è visibile in Figura 11 – visualizzazione set multiplo di dati
+
+
+
+ ![Flusso OIV](./screenshots/11_visualizzazione_set_multiplo_di_dati.jpg)
+Figura 11 – visualizzazione set multiplo di dati

docs/INTRO.md

@@ -0,0 +1,44 @@
+# INTRODUZIONE
+
+Il presente manuale è una guida all'utilizzo di "Scrivania Digitale" come piattaforma per flussi di lavoro informatizzati - un'applicazione con interfaccia web che permette di definire ed eseguire flussi di lavoro che comportano l'assegnazione di compiti a diversi attori e la raccolta di informazioni e documentazione relativi alle attività amministrative.
+
+Per Flusso (workflow) si intende l'automazione di un processo (procedure amministrative dell’ente). Un Flusso è costituito da una serie di attività elementari: compiti (task), eventualmente cicliche o alternative, da eseguire per ottenere un preciso risultato.
+
+
+
+# LA SCRIVANIA DIGITALE
+
+La "Scrivania Digitale" è un’applicazione web che permette la gestione dei flussi Documentali all’interno di un Ente, di un'azienda  o di una qualsiasi realtà strutturata di medie e grandi dimensioni.
+
+La "Scrivania Digitale" ha come obiettivo principale quello di guidare gli utenti predisposti nella gestione dei vari  procedimenti amministrativi. In particolare è stata predisposta per:
+
+- **Dematerializzare** (dematerializzazione del cartaceo)
+- **Semplificare** (firma leggera, firma digitale, reingegnerizzazione)
+- **Velocizzare** (smistamento ed assegnazione in automatico dei compiti ai diversi attori coinvolti);
+- **Organizzare** (ogni utente ha la lista dei propri compiti)
+- **Proteggere** (Migliora la protezione delle informazioni: permessi utenti)
+- **Tracciare** (tracciamento delle attività con possibilità di monitoraggio dello stato di avanzamento)
+- **Informare** (notifiche)
+- **Armonizzare** (armonizzazione delle modalità operative di espletamento del procedimento amministrativo da parte delle diverse strutture)
+- **Ottimizzare** (ottimizzazione dei processi amministrativi)
+- **Facilitare** adempimento agli obblighi Normativi (es. per Acquisti adempimento automatico degli obblighi di trasparenza.)
+- **Guidare** (guida e limita l’utente nelle azioni fornendo una maggior aderenza ai processi )
+- **Supervisionare** (la ricerca dei flussi permette avere sotto controllo i processi)
+
+Esistono 2 versioni di scrivania digitale, una versione "stand alone" ed una versione integrata.
+
+
+
+## VERSIONE STAND ALONE
+
+La versione "Stand Alone" di Scrivania Digitale è una versione che tende ad utilizzare quanto più possibile risorse interne rispetto ad applicazioni aggiuntive. Ad esempio non si appoggia a nessun Repository Documentale esterno per i documenti che vengono inseriti nel DB o nel filesystem locale. Utilizza un sistema interno per la profilazione, l'autenticazione e la gestione delle utenze e dei ruoli assegnati. 
+
+![versione stand alone](./screenshots/versione_stand_alone.JPG)
+
+
+
+## VERSIONE INTEGRATA	
+
+La versione "Integrata" di Scrivania Digitale è una versione che tende ad integrare quanto più possibile risorse e applicazioni esterne sia open source e commerciali quali: un repository documentale esterno (es. Alfresco, Azure, ...), un sistema di firma remota (es. ARSS Aruba Sign Server); Questa versione è predisposta anche per integrarsi con applicazioni realizzate internamente come l'Anagrafica Centralizzata, e altre applicazioni che possono collegarsi direttamente a flussi specifici. Tali applicazioni avanno una propria gestione interna dei dati e si avvarranno di Scrivania per la parte amministrativa (es. firma digitale). 
+
+![versione integrata](./screenshots/versione_integrata.JPG)