Merge da Develop a Master

.github/ISSUE_TEMPLATE/issue-vuota.md

@@ -0,0 +1,10 @@
+---
+name: Issue vuota
+about: Issue vuota che non fa parte di nessuna delle altre categorie
+title: "[OTHER] "
+labels: ''
+assignees: ''
+
+---
+
+

.github/ISSUE_TEMPLATE/new-document-section.md → .github/ISSUE_TEMPLATE/nuova-sezione.md

@@ -1,5 +1,5 @@
 ---
-name: New Document Section
+name: Nuova sezione
 about: Nuova sezione da scrivere in un documento
 title: "[WR] Nome sezione - Documento"
 labels: to write

.github/ISSUE_TEMPLATE/nuovo-verbale-o-documento.md

@@ -0,0 +1,16 @@
+---
+name: Nuovo verbale o documento
+about: Nuovo verbale da aggiungere alla repo
+title: "[NEW] Nome verbale o documento"
+labels: to write
+assignees: ''
+
+---
+
+## Nuovo verbale o documento
+
+### Informazioni
+
+**Nome documento:** 
+**Tipo documento:** i/e
+**Data documento:** aaaa/gg/mm

.github/ISSUE_TEMPLATE/document-review.md → .github/ISSUE_TEMPLATE/revisione-documento.md

@@ -1,5 +1,5 @@
 ---
-name: Document Review
+name: Revisione documento
 about: Revisione di un documento e materiale correlato da sistemare
 title: "[REV] Nome Documento - vx.x.x"
 labels: to fix, to review

.github/filesToCompile

@@ -5,4 +5,9 @@ interni/verbali/verbale_4
 interni/verbali/verbale_5
 interni/verbali/verbale_6
 interni/studio_fattibilita
-interni/norme_progetto
+interni/norme_progetto
+esterni/analisi_requisiti
+esterni/piano_progetto
+esterni/piano_qualifica
+esterni/glossario
+esterni/verbali/verbale_8

.gitignore

@@ -8,3 +8,4 @@
 *.aux
 *.out
 *.sublime-workspace
+*.pdf

esterni/analisi_requisiti/main.tex

@@ -12,12 +12,12 @@
 % --------------
 
 \newcommand{\docNome}{ ANALISI DEI REQUISITI }
-\newcommand{\docVersione}{0.0.1}
-\newcommand{\docNomeProgetto}{ v\docVersione }
+\newcommand{\docVersione}{0.0.8}
+\newcommand{\docNomeProgetto}{ ThiReMa Project }
 \newcommand{\docStatus}{in redazione}
 \newcommand{\docUso}{esterno}
 \newcommand{\docDescrizione}{
-	Il documento contiene una analisi formale approfondita di tutti i requisiti richiesti dal progetto.
+	Il documento contiene una analisi formale approfondita di tutti i requisiti e i casi d'uso richiesti dal progetto.
 }
 
 % --------------

esterni/analisi_requisiti/res/frontespizio.tex

@@ -20,7 +20,7 @@
 \vspace{-6em}
 
 \begin{center}
-    \href{https://www.redroundrobin.site}{www.redroundrobin.site} --- \href{mailto:info@redroundrobin.site}{info@redroundrobin.site}
+    \href{https://www.redroundrobin.site}{www.redroundrobin.site} --- \href{mailto:redroundrobin.site@gmail.com}{redroundrobin.site@gmail.com}
 \end{center}
 
 \vspace{2em}

esterni/analisi_requisiti/res/registro.tex

@@ -11,9 +11,21 @@ \section*{Registro delle modifiche}
 
 	% ----- Modificare da qui -----
 
-	% 0.0.2 & Revisione documento & 24-11-2019 & Nome Cognome & Verificatore \\
+	0.0.8 & Aggiunti diagrammi \S3 & 2020-01-06 & Lorenzo Dei Negri & Redattore \\
 	\hline
-	0.0.1 & Creazione iniziale del documento & 09-12-2019 & Alessandro Tommasin & Redattore \\
+	0.0.7 & Scrittura sezione \S4 & 2020-01-04 & Mariano Sciacco & Redattore \\
+	\hline
+	0.0.6 & Scrittura sezione \S3.9 e \S3.10 & 2020-01-04 & Mariano Sciacco & Redattore \\
+	\hline
+	0.0.5 & Scrittura sezione \S3.4 - \S3.8 & 2020-01-04 & Alessandro Tommasin & Redattore \\
+	\hline
+	0.0.4 & Scrittura sezione \S3.1 - \S3.4 & 2020-01-02 & Alessandro Tommasin & Redattore \\
+	\hline
+	0.0.3 & Scrittura sezione \S2 & 2019-12-20 & Alessandro Tommasin & Redattore \\
+	\hline
+	0.0.2 & Scrittura sezione \S1 & 2019-12-02 & Alessandro Tommasin & Redattore \\
+	\hline
+	0.0.1 & Creazione documento & 2019-12-02 & Mariano Sciacco & Redattore \\
 	\hline
 
 	\end{longtable}

esterni/analisi_requisiti/res/sections/Sez1-Introduzione/Introduzione.tex

@@ -2,8 +2,6 @@ \section{Introduzione}
 	\subsection{Scopo del documento}
 		Lo scopo di questo documento è la candidatura del gruppo RedRoundRobin allo svolgimento del progetto relativo al capitolato C6 - ThiReMa.
 		All'interno di questa analisi è  possibile seguire la classificazione, il tracciamento e la descrizione dettagliata deii requisiti individuati dall'analisi del capitolato scelto.
-	\subsection{Scopo del prodotto}
-		Il capitolato C6 si pone come obiettivo quello di creare una web-application che permette di analizzare grosse moli di dati ricevuti da sensori eterogenei tra loro. Tale applicazione mette a disposizione un'interfaccia che permette di visualizzare alcuni dati di interesse od eventuali correlazioni tra i dati stessi. Infine, per ogni tipologia di dato è possibile assegnarne il monitoraggio ad un particolare ente, ruolo o gruppo.
 	\subsection{Glossario e Documenti esterni}
 		Per evitare possibili ambiguità relative alle terminologie (che andranno indicate in \textsc{maiuscoletto})utilizzate nei vari documenti, verranno utilizzate due simboli:
 		\begin{itemize}

esterni/analisi_requisiti/res/sections/Sez2-AnalisiDelProdotto/AnalisiDelProdotto.tex

@@ -0,0 +1,47 @@
+\section{Analisi del prodotto}
+	\subsection{Scopo del prodotto}
+		Il capitolato C6 si pone come obiettivo quello di creare una /glock{web-application} che permette di analizzare grosse moli di dati ricevuti da sensori eterogenei tra loro. Tale applicazione mette a disposizione un'interfaccia che permette di visualizzare alcuni dati di interesse od eventuali correlazioni tra i dati stessi. Infine, per ogni tipologia di dato è possibile assegnarne il monitoraggio ad un particolare ente, ruolo o gruppo.
+
+	\subsection{Analisi della struttura}
+		La struttura del prodotto sarà divisa in:
+		\begin{itemize}
+			\item \textbf{Interfaccia di gestione}: L'interfaccia di gestione ed interrogazione permetterà agli utenti di seguire l'andamento di uno o più sensori, di controllarli, attivandoli o disattivandoli ed infine, agli utenti con maggiori privilegi, di aggiungere o rimuovere altri utenti o gruppi.
+			Tramite questa interfaccia deve essere possibile inviare dei comandi al giusto gateway tramite un apposito /glock{topic} di Kafka per controllare gli /glock{edge data point}. 
+			L'interfaccia di gestione dovrà dare la possibilità agli utenti di gestire i propri dati (quale ad esempio la password di accesso).
+			\item \textbf{Database}: Si è pensato di utilizzare due tipi di database in base ai dati da memorizzare:
+			\begin{itemize}
+				\item Un database di tipo /glock{Time-Series} per memorizzare i dati temporali ricevuti dai sensori;
+				\item Un database relazionale, per memorizzare i metadati relativi ai sensori (ad esempio il loro censimento) o relativi agli utenti che andranno ad utilizzare l'interfaccia di gestione.
+			\end{itemize}
+
+			\item \textbf{Gateway}: I dispositivi (o edge data point) che invieranno i dati dei loro sensori, non si interfaccerano direttamente con i database o con il cluster Kafka (descritto in seguito) bensì dialogheranno con un /glock{gateway} tramite degli appositi protocolli.
+			Saranno presenti diversi gateway suddivisi per struttura, con almeno un gateway per sede, in modo tale da facilitare l'invididuazione di uno specifico edge data point.
+			Le configurazioni di invio dei dati (quale ad esempio la frequenza di invio) per ogni singolo dispositivo dovranno essere inviate dalla web-app, che tramite un apposito topic di kafka, vengono salvate nell'apposito gateway, che poi si occuperà di filtrare i dati inviati dai dispositivi ed eventualmente trasformarli in formato JSON. 
+
+			\item \textbf{Dispositivo (Edge Data Point)}: I dispositivi dopo essere stati censiti, invieranno dati al proprio gateway, senza essere consci della propria configurazione.
+
+			\item \textbf{Cluster Apache Kafka}: Tramite Kafka e le sue API verranno ricevuti i dati dai sensori, passando da un gateway, verranno manipolati tramite degli stream ed infine salvati nel database e/o mostrati agli utenti che li richiedono. L'interfaccia di gestione ed il database contenente le misurazioni dei sensori si interfacceranno quindi con Kafka e non direttamente tra loro.
+
+		\end{itemize}
+	\subsection{Attori}
+		Gli attori individuati dopo un'attenta analisi del capitolato sono i seguenti:
+		\subsubsection{Attori principali}
+		\begin{itemize}
+			\item \textbf{Utente non autorizzato}: Questa tipologia di utente rappresenta un 
+			vecchio amministratore che ora non ha più alcun privilegio o un utente appartenente ad un ente che poi è stato eliminato. Nello specifico non ha accesso al sito in quanto non avrebbe i permessi necessari per visualizzare alcuna sezione.
+
+			\item \textbf{Utente autorizzato}: Un utente autorizzato ha la possibilità di autenticarsi e quindi di accedere alle varie sezioni del sito. Questo tipo di utente deve appartenere ad uno ed un solo ente, ovvero un gruppo di utenti che hanno il permesso di visualizzare (in forma di tabella o di grafico) le misurazioni dei sensori assegnati a quell'ente.
+			Infine un utente autorizzato può gestire un dispositivo remoto (da notare che un dispositivo può essere assegnato ad uno o più enti).
+
+			\item \textbf{Moderatore ente}: Un moderatore ente ha tutti i permessi di un utente autorizzato e può gestire (visualizzare, rimuovere o aggiungere) i membri del proprio ente. Di questi ultimi può inoltre visualizzare le relative attività (logs).
+			Infine questo attore può impostare dei valori soglia, che quando superati provocano l'invio di avvisi a tutti i membri dell'ente tramite un'apposita sezione nell'interfaccia di gestione. 
+			Possono essere presenti uno o più moderatori ente per ogni singolo ente.
+
+			\item \textbf{Amministratore generale}: L'amministratore generale rappresenta un utente con il più alto livello di privilegi. Questo attore può infatti gestire (modificare, creare e rimuovere) gli enti, i loro membri e i dispositivi a loro assegnati.
+			L'amministratore può inoltre vedere tutte le attività di ogni singolo utente.
+			Possono essere presenti uno o più amministratori generali.
+		\end{itemize}
+		\subsubsection{Attori secondari}
+			Al momento non sono stati trovati degli attori secondari.
+
+

esterni/analisi_requisiti/res/sections/Sez3-CasiDUso/CasiDUso.tex

@@ -1,3 +1,2 @@
 \section{Casi d'uso}
-\yetAnotherSectionNamed{Sez3-CasiDUso/Attori}
-\yetAnotherSectionNamed{Sez3-CasiDUso/ElencoDeiCasi}
+