diff --git a/README.md b/README.md index 9395ffb..68c45e6 100644 --- a/README.md +++ b/README.md @@ -4,6 +4,12 @@ Repository per raccogliere la documentazione del progetto di Ingegneria del soft > Gruppo 6 +## + +- [WAY OF WORKING](way_of_working.md) +- [STRUTTURA DEI DOCUMENTI](struttura_documenti.md) + + ### Membri del gruppo - Giuseppe Vito Bitetti @@ -14,16 +20,6 @@ Repository per raccogliere la documentazione del progetto di Ingegneria del soft - Alessandro Tommasin - Giovanni Vidotto -## Seminari di approfondimento - -- 22 novembre C5: Stalker (1C150) -- 26 novembre C4: Predire in Grafana (1AD100) -- 29 novembre C3: NaturalAPI (1BC50) -- 02 dicembre C1: Autonomous Highlights (1C150) -- 05 dicembre C6: ThiReMa (1C150) - -> C2 Etherless è solo tramite videoconferenza e su richiesta - ## Prima scadenza > 21 Gennaio 2020 - RR (da consegnare già per il 14 Gennaio 2020 al prof.) diff --git a/esterni/analisi_requisiti/main.pdf b/esterni/analisi_requisiti/main.pdf new file mode 100644 index 0000000..8ab227b Binary files /dev/null and b/esterni/analisi_requisiti/main.pdf differ diff --git a/esterni/analisi_requisiti/main.tex b/esterni/analisi_requisiti/main.tex new file mode 100644 index 0000000..081ddb2 --- /dev/null +++ b/esterni/analisi_requisiti/main.tex @@ -0,0 +1,92 @@ +% --------------------------- +% [ Analisi dei requisiti ] +% ---------------------- +% Red Round Robin +% Progetto di SWE (2019-20) +% Template by Maxelweb +% --------------------------- + +% Configurazione primaria del documento + +% -------------- + +\newcommand{\docNome}{ ANALISI DEI REQUISITI } +\newcommand{\docVersione}{0.0.1} +\newcommand{\docNomeProgetto}{ v\docVersione } +\newcommand{\docStatus}{in redazione} +\newcommand{\docUso}{esterno} +\newcommand{\docDescrizione}{ + Il documento contiene una analisi formale approfondita di tutti i requisiti richiesti dal progetto. +} + +% -------------- + +\newcommand{\docDestinatari}{ + nome cognome \\& + nome cognome +} +\newcommand{\docRedattori}{ + nome cognome \\& + nome cognome +} +\newcommand{\docVerificatori}{ + nome cognome \\& + nome cognome +} +\newcommand{\docApprovazione}{ + nome cognome +} + +% ----- NON MODIFICARE SOTTO QUESTA RIGA ----- + +% --------------------------- +% Configurazioni +% --------------------------- + +\documentclass[11pt,a4paper,table]{article} + +\input{res/configurazione} + +% --------------------------- +% Dati frontespizio +% --------------------------- + +\title{\hr \huge \textsc{\docNome} \\ + \vspace{11pt} \large \textsc{\docNomeProgetto} \hr} + +\author{} % Non toccare +\date{} % Non toccare + +% --------------------------- +% Composizione del documento +% --------------------------- + +\begin{document} + +% Frontespizio + +\pagenumbering{gobble} +\DeactivateBG +\include{res/frontespizio} + +% Registro delle modifiche + +\newpage +\ActivateBG +\pagenumbering{arabic} +\include{res/registro} + +% Tabella dei contenuti + +\newpage +\tableofcontents + +% Sezioni + +\newpage +\input{res/sezioni} + +\end{document} + + +% EOF \ No newline at end of file diff --git a/esterni/analisi_requisiti/res/configurazione.tex b/esterni/analisi_requisiti/res/configurazione.tex new file mode 100644 index 0000000..eda42a9 --- /dev/null +++ b/esterni/analisi_requisiti/res/configurazione.tex @@ -0,0 +1,145 @@ + +% Configurazione delle dipendenze e dei package + + +\usepackage{geometry} +\usepackage{graphicx} +\usepackage[T1]{fontenc} +\usepackage[utf8]{inputenc} +\usepackage{charter} +\usepackage{eurosym} +\usepackage[italian]{babel} +\usepackage{float} +\usepackage{subcaption} +\usepackage{wrapfig} +\usepackage{fancyhdr} +\usepackage{lastpage} +\usepackage{amsfonts} +\usepackage{fancyvrb} +\usepackage{background} +\usepackage{xcolor} +\usepackage{hyperref} +\usepackage{listings} +\usepackage{longtable} +\usepackage{colortbl} +\usepackage{tikz} + + +% Impostazioni pagina e margini + +\geometry{ + margin=1.0in, + top=19.2mm, % NON TOCCARE + bottom=30mm, + left=20mm, + right=20mm +} + +% Definizione colori + +\definecolor{footer-gray}{HTML}{808080} +\definecolor{light-gray}{gray}{0.6} +\definecolor{light-grayer}{gray}{0.75} +\definecolor{lighter-grayer}{gray}{0.85} +\definecolor{lightest-grayest}{gray}{0.94} +\definecolor{codegreen}{rgb}{0,0.4,0.2} +\definecolor{codegray}{rgb}{0.5,0.5,0.5} +\definecolor{codepurple}{rgb}{0.58,0,0.82} +\definecolor{backcolour}{rgb}{0.95,0.95,0.96} + + +% Impostazione header e footer + +\pagestyle{fancy} +\setlength\headheight{33pt} +\renewcommand{\headrulewidth}{0pt} +\fancyhead{} +\lhead{\includegraphics[height=10mm]{res/images/logo.png}} +\rhead{\raisebox{1.4\height}{\leftmark}} + + +\renewcommand{\footrulewidth}{0.1pt} +\fancyfoot{} +\lfoot{ \textcolor{footer-gray}{\docNome - v\docVersione} } + +\renewcommand{\footrule}{\hbox to\headwidth{\color{light-grayer}\leaders\hrule height \footrulewidth\hfill}} +\rfoot{ \textcolor{footer-gray}{Pagina \thepage \hspace{1pt} di \pageref*{LastPage}} } + +% Grandezza paragrafi e spaziatura frasi + +\setlength{\parindent}{1.8em} +\setlength{\parskip}{1.2em} +\renewcommand{\baselinestretch}{1.1} + +% Colori link + +\hypersetup{ + colorlinks, + linkcolor=[HTML]{404040}, + citecolor={blue!50!black}, + urlcolor={red!50!black} +} +\PassOptionsToPackage{hyphens}{url}\usepackage{hyperref} + +% Equivalente a
+ +\newcommand{\hr}{\par\vspace{-.1\ht\strutbox}\noindent\hrulefill\par} + +% Tabelle e tabulazione + +\setlength{\tabcolsep}{10pt} +\renewcommand{\arraystretch}{1.4} + +% Unicode per simbolo euro + +\DeclareUnicodeCharacter{20AC}{\euro} + +% Configurazione sfondo + +\newcommand\DeactivateBG{\backgroundsetup{contents={}}} +\newcommand\ActivateBG{ \backgroundsetup{ + scale=1.0, + color=black, + opacity=1.0, + angle=0, + contents={% + \includegraphics[height=297mm]{res/images/background.png} + }% +}} + +% Codice e snippet + +\renewcommand{\lstlistingname}{Snippet} +\renewcommand{\lstlistlistingname}{Lista di \lstlistingname s} + + +\lstdefinestyle{chungusHighlight}{ + frame=tb, + backgroundcolor=\color{backcolour}, + commentstyle=\color{codegreen}, + keywordstyle=\color{magenta}\textbf, + numberstyle=\color{codegray}, + stringstyle=\color{codepurple}, + basicstyle={\ttfamily}, + breakatwhitespace=false, + breaklines=true, + captionpos=b, + keepspaces=true, + numbers=left, + numbersep=5pt, + showspaces=false, + showstringspaces=false, + showtabs=false, + numbers=none, + tabsize=2 +} + +\lstset{style=chungusHighlight} + + +% Comando per aggiungere le pagine di ogni sezione + +\newcommand{\yetAnotherSectionNamed}[1]{% + \newpage + \input{res/sections/#1} +}% diff --git a/esterni/analisi_requisiti/res/frontespizio.tex b/esterni/analisi_requisiti/res/frontespizio.tex new file mode 100644 index 0000000..3664bf5 --- /dev/null +++ b/esterni/analisi_requisiti/res/frontespizio.tex @@ -0,0 +1,56 @@ + +% FRONTESPIZIO + +% Logo aziendale + +\begin{figure}[t!] + \centering + \includegraphics[height=10em]{res/images/logo.png} +\end{figure} + + +% Titolo principale + +\maketitle +\thispagestyle{empty} + + +% Riferimenti email e sito web + +\vspace{-6em} + +\begin{center} + \href{https://www.redroundrobin.site}{www.redroundrobin.site} --- \href{mailto:info@redroundrobin.site}{info@redroundrobin.site} +\end{center} + +\vspace{2em} + +% Informazioni documento + +\begin{table}[ht] + \begin{center} + \label{tab:Informazioni_Documento} + \begin{tabular}{r|l} + \multicolumn{2}{c}{ \textsc{Informazioni sul documento} } \\ + \hline + \textbf{Versione} & \docVersione \\ + \textbf{Uso} & \docUso \\ + \textbf{Stato} & \docStatus \\ + \textbf{Destinatari} & \docDestinatari \\ + \textbf{Redattori} & \docRedattori \\ + \textbf{Verificatori} & \docVerificatori \\ + \textbf{Approvazione} & \docApprovazione \\ + \end{tabular} + \end{center} +\end{table} + + +% Descrizione del documento + +\vspace{0em} + +\begin{center} + \textbf{Descrizione}\\ + \docDescrizione +\end{center} + diff --git a/esterni/analisi_requisiti/res/images/background.png b/esterni/analisi_requisiti/res/images/background.png new file mode 100644 index 0000000..9dcca68 Binary files /dev/null and b/esterni/analisi_requisiti/res/images/background.png differ diff --git a/esterni/analisi_requisiti/res/images/logo.png b/esterni/analisi_requisiti/res/images/logo.png new file mode 100644 index 0000000..32071fe Binary files /dev/null and b/esterni/analisi_requisiti/res/images/logo.png differ diff --git a/esterni/analisi_requisiti/res/registro.tex b/esterni/analisi_requisiti/res/registro.tex new file mode 100644 index 0000000..11d9f96 --- /dev/null +++ b/esterni/analisi_requisiti/res/registro.tex @@ -0,0 +1,20 @@ +\section*{Registro delle modifiche} + +\begin{center} + \rowcolors{2}{lightest-grayest}{white} + \begin{longtable}{|c|c|c|c|c|} + \hline + \rowcolor{lighter-grayer} + \textbf{Versione} & \textbf{Descrizione} & \textbf{Data} & \textbf{Autore} & \textbf{Ruolo} \\ + \hline + \endfirsthead + + % ----- Modificare da qui ----- + + % 0.0.2 & Revisione documento & 24-11-2019 & Nome Cognome & Verificatore \\ + \hline + 0.0.1 & Creazione iniziale del documento & 02-12-2019 & Mariano Sciacco & Redattore \\ + \hline + + \end{longtable} +\end{center} \ No newline at end of file diff --git a/esterni/analisi_requisiti/res/sections/introduzione.tex b/esterni/analisi_requisiti/res/sections/introduzione.tex new file mode 100644 index 0000000..32c3925 --- /dev/null +++ b/esterni/analisi_requisiti/res/sections/introduzione.tex @@ -0,0 +1,2 @@ +\section{Introduzione} + diff --git a/esterni/analisi_requisiti/res/sezioni.tex b/esterni/analisi_requisiti/res/sezioni.tex new file mode 100644 index 0000000..3b6fe24 --- /dev/null +++ b/esterni/analisi_requisiti/res/sezioni.tex @@ -0,0 +1,7 @@ +% ----------------------- +% Sezioni da inserire +% ----------------------- +% Pro tip: usare il comando \yetAnotherSectionNamed{nome_file} + + +\yetAnotherSectionNamed{introduzione} diff --git a/esterni/piano_progetto/main.pdf b/esterni/piano_progetto/main.pdf new file mode 100644 index 0000000..9d4151e Binary files /dev/null and b/esterni/piano_progetto/main.pdf differ diff --git a/esterni/piano_progetto/main.tex b/esterni/piano_progetto/main.tex new file mode 100644 index 0000000..921fec5 --- /dev/null +++ b/esterni/piano_progetto/main.tex @@ -0,0 +1,92 @@ +% --------------------------- +% [ Piano di Progetto ] +% ---------------------- +% Red Round Robin +% Progetto di SWE (2019-20) +% Template by Maxelweb +% --------------------------- + +% Configurazione primaria del documento + +% -------------- + +\newcommand{\docNome}{ PIANO DI PROGETTO } +\newcommand{\docVersione}{0.0.1} +\newcommand{\docNomeProgetto}{ v\docVersione } +\newcommand{\docStatus}{in redazione} +\newcommand{\docUso}{esterno} +\newcommand{\docDescrizione}{ + Il documento contiene il piano di progetto... +} + +% -------------- + +\newcommand{\docDestinatari}{ + nome cognome \\& + nome cognome +} +\newcommand{\docRedattori}{ + nome cognome \\& + nome cognome +} +\newcommand{\docVerificatori}{ + nome cognome \\& + nome cognome +} +\newcommand{\docApprovazione}{ + nome cognome +} + +% ----- NON MODIFICARE SOTTO QUESTA RIGA ----- + +% --------------------------- +% Configurazioni +% --------------------------- + +\documentclass[11pt,a4paper,table]{article} + +\input{res/configurazione} + +% --------------------------- +% Dati frontespizio +% --------------------------- + +\title{\hr \huge \textsc{\docNome} \\ + \vspace{11pt} \large \textsc{\docNomeProgetto} \hr} + +\author{} % Non toccare +\date{} % Non toccare + +% --------------------------- +% Composizione del documento +% --------------------------- + +\begin{document} + +% Frontespizio + +\pagenumbering{gobble} +\DeactivateBG +\include{res/frontespizio} + +% Registro delle modifiche + +\newpage +\ActivateBG +\pagenumbering{arabic} +\include{res/registro} + +% Tabella dei contenuti + +\newpage +\tableofcontents + +% Sezioni + +\newpage +\input{res/sezioni} + +\end{document} + + +% EOF \ No newline at end of file diff --git a/esterni/piano_progetto/res/configurazione.tex b/esterni/piano_progetto/res/configurazione.tex new file mode 100644 index 0000000..eda42a9 --- /dev/null +++ b/esterni/piano_progetto/res/configurazione.tex @@ -0,0 +1,145 @@ + +% Configurazione delle dipendenze e dei package + + +\usepackage{geometry} +\usepackage{graphicx} +\usepackage[T1]{fontenc} +\usepackage[utf8]{inputenc} +\usepackage{charter} +\usepackage{eurosym} +\usepackage[italian]{babel} +\usepackage{float} +\usepackage{subcaption} +\usepackage{wrapfig} +\usepackage{fancyhdr} +\usepackage{lastpage} +\usepackage{amsfonts} +\usepackage{fancyvrb} +\usepackage{background} +\usepackage{xcolor} +\usepackage{hyperref} +\usepackage{listings} +\usepackage{longtable} +\usepackage{colortbl} +\usepackage{tikz} + + +% Impostazioni pagina e margini + +\geometry{ + margin=1.0in, + top=19.2mm, % NON TOCCARE + bottom=30mm, + left=20mm, + right=20mm +} + +% Definizione colori + +\definecolor{footer-gray}{HTML}{808080} +\definecolor{light-gray}{gray}{0.6} +\definecolor{light-grayer}{gray}{0.75} +\definecolor{lighter-grayer}{gray}{0.85} +\definecolor{lightest-grayest}{gray}{0.94} +\definecolor{codegreen}{rgb}{0,0.4,0.2} +\definecolor{codegray}{rgb}{0.5,0.5,0.5} +\definecolor{codepurple}{rgb}{0.58,0,0.82} +\definecolor{backcolour}{rgb}{0.95,0.95,0.96} + + +% Impostazione header e footer + +\pagestyle{fancy} +\setlength\headheight{33pt} +\renewcommand{\headrulewidth}{0pt} +\fancyhead{} +\lhead{\includegraphics[height=10mm]{res/images/logo.png}} +\rhead{\raisebox{1.4\height}{\leftmark}} + + +\renewcommand{\footrulewidth}{0.1pt} +\fancyfoot{} +\lfoot{ \textcolor{footer-gray}{\docNome - v\docVersione} } + +\renewcommand{\footrule}{\hbox to\headwidth{\color{light-grayer}\leaders\hrule height \footrulewidth\hfill}} +\rfoot{ \textcolor{footer-gray}{Pagina \thepage \hspace{1pt} di \pageref*{LastPage}} } + +% Grandezza paragrafi e spaziatura frasi + +\setlength{\parindent}{1.8em} +\setlength{\parskip}{1.2em} +\renewcommand{\baselinestretch}{1.1} + +% Colori link + +\hypersetup{ + colorlinks, + linkcolor=[HTML]{404040}, + citecolor={blue!50!black}, + urlcolor={red!50!black} +} +\PassOptionsToPackage{hyphens}{url}\usepackage{hyperref} + +% Equivalente a
+ +\newcommand{\hr}{\par\vspace{-.1\ht\strutbox}\noindent\hrulefill\par} + +% Tabelle e tabulazione + +\setlength{\tabcolsep}{10pt} +\renewcommand{\arraystretch}{1.4} + +% Unicode per simbolo euro + +\DeclareUnicodeCharacter{20AC}{\euro} + +% Configurazione sfondo + +\newcommand\DeactivateBG{\backgroundsetup{contents={}}} +\newcommand\ActivateBG{ \backgroundsetup{ + scale=1.0, + color=black, + opacity=1.0, + angle=0, + contents={% + \includegraphics[height=297mm]{res/images/background.png} + }% +}} + +% Codice e snippet + +\renewcommand{\lstlistingname}{Snippet} +\renewcommand{\lstlistlistingname}{Lista di \lstlistingname s} + + +\lstdefinestyle{chungusHighlight}{ + frame=tb, + backgroundcolor=\color{backcolour}, + commentstyle=\color{codegreen}, + keywordstyle=\color{magenta}\textbf, + numberstyle=\color{codegray}, + stringstyle=\color{codepurple}, + basicstyle={\ttfamily}, + breakatwhitespace=false, + breaklines=true, + captionpos=b, + keepspaces=true, + numbers=left, + numbersep=5pt, + showspaces=false, + showstringspaces=false, + showtabs=false, + numbers=none, + tabsize=2 +} + +\lstset{style=chungusHighlight} + + +% Comando per aggiungere le pagine di ogni sezione + +\newcommand{\yetAnotherSectionNamed}[1]{% + \newpage + \input{res/sections/#1} +}% diff --git a/esterni/piano_progetto/res/frontespizio.tex b/esterni/piano_progetto/res/frontespizio.tex new file mode 100644 index 0000000..3664bf5 --- /dev/null +++ b/esterni/piano_progetto/res/frontespizio.tex @@ -0,0 +1,56 @@ + +% FRONTESPIZIO + +% Logo aziendale + +\begin{figure}[t!] + \centering + \includegraphics[height=10em]{res/images/logo.png} +\end{figure} + + +% Titolo principale + +\maketitle +\thispagestyle{empty} + + +% Riferimenti email e sito web + +\vspace{-6em} + +\begin{center} + \href{https://www.redroundrobin.site}{www.redroundrobin.site} --- \href{mailto:info@redroundrobin.site}{info@redroundrobin.site} +\end{center} + +\vspace{2em} + +% Informazioni documento + +\begin{table}[ht] + \begin{center} + \label{tab:Informazioni_Documento} + \begin{tabular}{r|l} + \multicolumn{2}{c}{ \textsc{Informazioni sul documento} } \\ + \hline + \textbf{Versione} & \docVersione \\ + \textbf{Uso} & \docUso \\ + \textbf{Stato} & \docStatus \\ + \textbf{Destinatari} & \docDestinatari \\ + \textbf{Redattori} & \docRedattori \\ + \textbf{Verificatori} & \docVerificatori \\ + \textbf{Approvazione} & \docApprovazione \\ + \end{tabular} + \end{center} +\end{table} + + +% Descrizione del documento + +\vspace{0em} + +\begin{center} + \textbf{Descrizione}\\ + \docDescrizione +\end{center} + diff --git a/esterni/piano_progetto/res/images/background.png b/esterni/piano_progetto/res/images/background.png new file mode 100644 index 0000000..9dcca68 Binary files /dev/null and b/esterni/piano_progetto/res/images/background.png differ diff --git a/esterni/piano_progetto/res/images/logo.png b/esterni/piano_progetto/res/images/logo.png new file mode 100644 index 0000000..32071fe Binary files /dev/null and b/esterni/piano_progetto/res/images/logo.png differ diff --git a/esterni/piano_progetto/res/registro.tex b/esterni/piano_progetto/res/registro.tex new file mode 100644 index 0000000..11d9f96 --- /dev/null +++ b/esterni/piano_progetto/res/registro.tex @@ -0,0 +1,20 @@ +\section*{Registro delle modifiche} + +\begin{center} + \rowcolors{2}{lightest-grayest}{white} + \begin{longtable}{|c|c|c|c|c|} + \hline + \rowcolor{lighter-grayer} + \textbf{Versione} & \textbf{Descrizione} & \textbf{Data} & \textbf{Autore} & \textbf{Ruolo} \\ + \hline + \endfirsthead + + % ----- Modificare da qui ----- + + % 0.0.2 & Revisione documento & 24-11-2019 & Nome Cognome & Verificatore \\ + \hline + 0.0.1 & Creazione iniziale del documento & 02-12-2019 & Mariano Sciacco & Redattore \\ + \hline + + \end{longtable} +\end{center} \ No newline at end of file diff --git a/esterni/piano_progetto/res/sections/introduzione.tex b/esterni/piano_progetto/res/sections/introduzione.tex new file mode 100644 index 0000000..32c3925 --- /dev/null +++ b/esterni/piano_progetto/res/sections/introduzione.tex @@ -0,0 +1,2 @@ +\section{Introduzione} + diff --git a/esterni/piano_progetto/res/sezioni.tex b/esterni/piano_progetto/res/sezioni.tex new file mode 100644 index 0000000..3b6fe24 --- /dev/null +++ b/esterni/piano_progetto/res/sezioni.tex @@ -0,0 +1,7 @@ +% ----------------------- +% Sezioni da inserire +% ----------------------- +% Pro tip: usare il comando \yetAnotherSectionNamed{nome_file} + + +\yetAnotherSectionNamed{introduzione} diff --git a/esterni/piano_qualifica/main.pdf b/esterni/piano_qualifica/main.pdf new file mode 100644 index 0000000..737f086 Binary files /dev/null and b/esterni/piano_qualifica/main.pdf differ diff --git a/esterni/piano_qualifica/main.tex b/esterni/piano_qualifica/main.tex new file mode 100644 index 0000000..a2155bb --- /dev/null +++ b/esterni/piano_qualifica/main.tex @@ -0,0 +1,92 @@ +% --------------------------- +% [ Piano di qualifica ] +% ---------------------- +% Red Round Robin +% Progetto di SWE (2019-20) +% Template by Maxelweb +% --------------------------- + +% Configurazione primaria del documento + +% -------------- + +\newcommand{\docNome}{ PIANO DI QUALIFICA } +\newcommand{\docVersione}{0.0.1} +\newcommand{\docNomeProgetto}{ v\docVersione } +\newcommand{\docStatus}{in redazione} +\newcommand{\docUso}{esterno} +\newcommand{\docDescrizione}{ + Il documento contiene un piano di qualifica ... +} + +% -------------- + +\newcommand{\docDestinatari}{ + nome cognome \\& + nome cognome +} +\newcommand{\docRedattori}{ + nome cognome \\& + nome cognome +} +\newcommand{\docVerificatori}{ + nome cognome \\& + nome cognome +} +\newcommand{\docApprovazione}{ + nome cognome +} + +% ----- NON MODIFICARE SOTTO QUESTA RIGA ----- + +% --------------------------- +% Configurazioni +% --------------------------- + +\documentclass[11pt,a4paper,table]{article} + +\input{res/configurazione} + +% --------------------------- +% Dati frontespizio +% --------------------------- + +\title{\hr \huge \textsc{\docNome} \\ + \vspace{11pt} \large \textsc{\docNomeProgetto} \hr} + +\author{} % Non toccare +\date{} % Non toccare + +% --------------------------- +% Composizione del documento +% --------------------------- + +\begin{document} + +% Frontespizio + +\pagenumbering{gobble} +\DeactivateBG +\include{res/frontespizio} + +% Registro delle modifiche + +\newpage +\ActivateBG +\pagenumbering{arabic} +\include{res/registro} + +% Tabella dei contenuti + +\newpage +\tableofcontents + +% Sezioni + +\newpage +\input{res/sezioni} + +\end{document} + + +% EOF \ No newline at end of file diff --git a/esterni/piano_qualifica/res/configurazione.tex b/esterni/piano_qualifica/res/configurazione.tex new file mode 100644 index 0000000..eda42a9 --- /dev/null +++ b/esterni/piano_qualifica/res/configurazione.tex @@ -0,0 +1,145 @@ + +% Configurazione delle dipendenze e dei package + + +\usepackage{geometry} +\usepackage{graphicx} +\usepackage[T1]{fontenc} +\usepackage[utf8]{inputenc} +\usepackage{charter} +\usepackage{eurosym} +\usepackage[italian]{babel} +\usepackage{float} +\usepackage{subcaption} +\usepackage{wrapfig} +\usepackage{fancyhdr} +\usepackage{lastpage} +\usepackage{amsfonts} +\usepackage{fancyvrb} +\usepackage{background} +\usepackage{xcolor} +\usepackage{hyperref} +\usepackage{listings} +\usepackage{longtable} +\usepackage{colortbl} +\usepackage{tikz} + + +% Impostazioni pagina e margini + +\geometry{ + margin=1.0in, + top=19.2mm, % NON TOCCARE + bottom=30mm, + left=20mm, + right=20mm +} + +% Definizione colori + +\definecolor{footer-gray}{HTML}{808080} +\definecolor{light-gray}{gray}{0.6} +\definecolor{light-grayer}{gray}{0.75} +\definecolor{lighter-grayer}{gray}{0.85} +\definecolor{lightest-grayest}{gray}{0.94} +\definecolor{codegreen}{rgb}{0,0.4,0.2} +\definecolor{codegray}{rgb}{0.5,0.5,0.5} +\definecolor{codepurple}{rgb}{0.58,0,0.82} +\definecolor{backcolour}{rgb}{0.95,0.95,0.96} + + +% Impostazione header e footer + +\pagestyle{fancy} +\setlength\headheight{33pt} +\renewcommand{\headrulewidth}{0pt} +\fancyhead{} +\lhead{\includegraphics[height=10mm]{res/images/logo.png}} +\rhead{\raisebox{1.4\height}{\leftmark}} + + +\renewcommand{\footrulewidth}{0.1pt} +\fancyfoot{} +\lfoot{ \textcolor{footer-gray}{\docNome - v\docVersione} } + +\renewcommand{\footrule}{\hbox to\headwidth{\color{light-grayer}\leaders\hrule height \footrulewidth\hfill}} +\rfoot{ \textcolor{footer-gray}{Pagina \thepage \hspace{1pt} di \pageref*{LastPage}} } + +% Grandezza paragrafi e spaziatura frasi + +\setlength{\parindent}{1.8em} +\setlength{\parskip}{1.2em} +\renewcommand{\baselinestretch}{1.1} + +% Colori link + +\hypersetup{ + colorlinks, + linkcolor=[HTML]{404040}, + citecolor={blue!50!black}, + urlcolor={red!50!black} +} +\PassOptionsToPackage{hyphens}{url}\usepackage{hyperref} + +% Equivalente a
+ +\newcommand{\hr}{\par\vspace{-.1\ht\strutbox}\noindent\hrulefill\par} + +% Tabelle e tabulazione + +\setlength{\tabcolsep}{10pt} +\renewcommand{\arraystretch}{1.4} + +% Unicode per simbolo euro + +\DeclareUnicodeCharacter{20AC}{\euro} + +% Configurazione sfondo + +\newcommand\DeactivateBG{\backgroundsetup{contents={}}} +\newcommand\ActivateBG{ \backgroundsetup{ + scale=1.0, + color=black, + opacity=1.0, + angle=0, + contents={% + \includegraphics[height=297mm]{res/images/background.png} + }% +}} + +% Codice e snippet + +\renewcommand{\lstlistingname}{Snippet} +\renewcommand{\lstlistlistingname}{Lista di \lstlistingname s} + + +\lstdefinestyle{chungusHighlight}{ + frame=tb, + backgroundcolor=\color{backcolour}, + commentstyle=\color{codegreen}, + keywordstyle=\color{magenta}\textbf, + numberstyle=\color{codegray}, + stringstyle=\color{codepurple}, + basicstyle={\ttfamily}, + breakatwhitespace=false, + breaklines=true, + captionpos=b, + keepspaces=true, + numbers=left, + numbersep=5pt, + showspaces=false, + showstringspaces=false, + showtabs=false, + numbers=none, + tabsize=2 +} + +\lstset{style=chungusHighlight} + + +% Comando per aggiungere le pagine di ogni sezione + +\newcommand{\yetAnotherSectionNamed}[1]{% + \newpage + \input{res/sections/#1} +}% diff --git a/esterni/piano_qualifica/res/frontespizio.tex b/esterni/piano_qualifica/res/frontespizio.tex new file mode 100644 index 0000000..3664bf5 --- /dev/null +++ b/esterni/piano_qualifica/res/frontespizio.tex @@ -0,0 +1,56 @@ + +% FRONTESPIZIO + +% Logo aziendale + +\begin{figure}[t!] + \centering + \includegraphics[height=10em]{res/images/logo.png} +\end{figure} + + +% Titolo principale + +\maketitle +\thispagestyle{empty} + + +% Riferimenti email e sito web + +\vspace{-6em} + +\begin{center} + \href{https://www.redroundrobin.site}{www.redroundrobin.site} --- \href{mailto:info@redroundrobin.site}{info@redroundrobin.site} +\end{center} + +\vspace{2em} + +% Informazioni documento + +\begin{table}[ht] + \begin{center} + \label{tab:Informazioni_Documento} + \begin{tabular}{r|l} + \multicolumn{2}{c}{ \textsc{Informazioni sul documento} } \\ + \hline + \textbf{Versione} & \docVersione \\ + \textbf{Uso} & \docUso \\ + \textbf{Stato} & \docStatus \\ + \textbf{Destinatari} & \docDestinatari \\ + \textbf{Redattori} & \docRedattori \\ + \textbf{Verificatori} & \docVerificatori \\ + \textbf{Approvazione} & \docApprovazione \\ + \end{tabular} + \end{center} +\end{table} + + +% Descrizione del documento + +\vspace{0em} + +\begin{center} + \textbf{Descrizione}\\ + \docDescrizione +\end{center} + diff --git a/esterni/piano_qualifica/res/images/background.png b/esterni/piano_qualifica/res/images/background.png new file mode 100644 index 0000000..9dcca68 Binary files /dev/null and b/esterni/piano_qualifica/res/images/background.png differ diff --git a/esterni/piano_qualifica/res/images/logo.png b/esterni/piano_qualifica/res/images/logo.png new file mode 100644 index 0000000..32071fe Binary files /dev/null and b/esterni/piano_qualifica/res/images/logo.png differ diff --git a/esterni/piano_qualifica/res/registro.tex b/esterni/piano_qualifica/res/registro.tex new file mode 100644 index 0000000..11d9f96 --- /dev/null +++ b/esterni/piano_qualifica/res/registro.tex @@ -0,0 +1,20 @@ +\section*{Registro delle modifiche} + +\begin{center} + \rowcolors{2}{lightest-grayest}{white} + \begin{longtable}{|c|c|c|c|c|} + \hline + \rowcolor{lighter-grayer} + \textbf{Versione} & \textbf{Descrizione} & \textbf{Data} & \textbf{Autore} & \textbf{Ruolo} \\ + \hline + \endfirsthead + + % ----- Modificare da qui ----- + + % 0.0.2 & Revisione documento & 24-11-2019 & Nome Cognome & Verificatore \\ + \hline + 0.0.1 & Creazione iniziale del documento & 02-12-2019 & Mariano Sciacco & Redattore \\ + \hline + + \end{longtable} +\end{center} \ No newline at end of file diff --git a/esterni/piano_qualifica/res/sections/introduzione.tex b/esterni/piano_qualifica/res/sections/introduzione.tex new file mode 100644 index 0000000..32c3925 --- /dev/null +++ b/esterni/piano_qualifica/res/sections/introduzione.tex @@ -0,0 +1,2 @@ +\section{Introduzione} + diff --git a/esterni/piano_qualifica/res/sezioni.tex b/esterni/piano_qualifica/res/sezioni.tex new file mode 100644 index 0000000..3b6fe24 --- /dev/null +++ b/esterni/piano_qualifica/res/sezioni.tex @@ -0,0 +1,7 @@ +% ----------------------- +% Sezioni da inserire +% ----------------------- +% Pro tip: usare il comando \yetAnotherSectionNamed{nome_file} + + +\yetAnotherSectionNamed{introduzione} diff --git a/interni/norme_progetto/main.pdf b/interni/norme_progetto/main.pdf new file mode 100644 index 0000000..cc5b4c8 Binary files /dev/null and b/interni/norme_progetto/main.pdf differ diff --git a/interni/norme_progetto/main.tex b/interni/norme_progetto/main.tex new file mode 100644 index 0000000..7458919 --- /dev/null +++ b/interni/norme_progetto/main.tex @@ -0,0 +1,92 @@ +% --------------------------- +% [ Norme di Progetto ] +% ---------------------- +% Red Round Robin +% Progetto di SWE (2019-20) +% Template by Maxelweb +% --------------------------- + +% Configurazione primaria del documento + +% -------------- + +\newcommand{\docNome}{ NORME DI PROGETTO } +\newcommand{\docVersione}{0.0.1} +\newcommand{\docNomeProgetto}{ v\docVersione } +\newcommand{\docStatus}{in redazione} +\newcommand{\docUso}{interno} +\newcommand{\docDescrizione}{ + Il documento contiene tutta la normativa di progetto relativa al \textit{way of working}, dalle convenzioni formali nei documenti allo stile di programmazione del software. +} + +% -------------- + +\newcommand{\docDestinatari}{ + nome cognome \\& + nome cognome +} +\newcommand{\docRedattori}{ + nome cognome \\& + nome cognome +} +\newcommand{\docVerificatori}{ + nome cognome \\& + nome cognome +} +\newcommand{\docApprovazione}{ + nome cognome +} + +% ----- NON MODIFICARE SOTTO QUESTA RIGA ----- + +% --------------------------- +% Configurazioni +% --------------------------- + +\documentclass[11pt,a4paper,table]{article} + +\input{res/configurazione} + +% --------------------------- +% Dati frontespizio +% --------------------------- + +\title{\hr \huge \textsc{\docNome} \\ + \vspace{11pt} \large \textsc{\docNomeProgetto} \hr} + +\author{} % Non toccare +\date{} % Non toccare + +% --------------------------- +% Composizione del documento +% --------------------------- + +\begin{document} + +% Frontespizio + +\pagenumbering{gobble} +\DeactivateBG +\include{res/frontespizio} + +% Registro delle modifiche + +\newpage +\ActivateBG +\pagenumbering{arabic} +\include{res/registro} + +% Tabella dei contenuti + +\newpage +\tableofcontents + +% Sezioni + +\newpage +\input{res/sezioni} + +\end{document} + + +% EOF \ No newline at end of file diff --git a/interni/norme_progetto/res/configurazione.tex b/interni/norme_progetto/res/configurazione.tex new file mode 100644 index 0000000..eda42a9 --- /dev/null +++ b/interni/norme_progetto/res/configurazione.tex @@ -0,0 +1,145 @@ + +% Configurazione delle dipendenze e dei package + + +\usepackage{geometry} +\usepackage{graphicx} +\usepackage[T1]{fontenc} +\usepackage[utf8]{inputenc} +\usepackage{charter} +\usepackage{eurosym} +\usepackage[italian]{babel} +\usepackage{float} +\usepackage{subcaption} +\usepackage{wrapfig} +\usepackage{fancyhdr} +\usepackage{lastpage} +\usepackage{amsfonts} +\usepackage{fancyvrb} +\usepackage{background} +\usepackage{xcolor} +\usepackage{hyperref} +\usepackage{listings} +\usepackage{longtable} +\usepackage{colortbl} +\usepackage{tikz} + + +% Impostazioni pagina e margini + +\geometry{ + margin=1.0in, + top=19.2mm, % NON TOCCARE + bottom=30mm, + left=20mm, + right=20mm +} + +% Definizione colori + +\definecolor{footer-gray}{HTML}{808080} +\definecolor{light-gray}{gray}{0.6} +\definecolor{light-grayer}{gray}{0.75} +\definecolor{lighter-grayer}{gray}{0.85} +\definecolor{lightest-grayest}{gray}{0.94} +\definecolor{codegreen}{rgb}{0,0.4,0.2} +\definecolor{codegray}{rgb}{0.5,0.5,0.5} +\definecolor{codepurple}{rgb}{0.58,0,0.82} +\definecolor{backcolour}{rgb}{0.95,0.95,0.96} + + +% Impostazione header e footer + +\pagestyle{fancy} +\setlength\headheight{33pt} +\renewcommand{\headrulewidth}{0pt} +\fancyhead{} +\lhead{\includegraphics[height=10mm]{res/images/logo.png}} +\rhead{\raisebox{1.4\height}{\leftmark}} + + +\renewcommand{\footrulewidth}{0.1pt} +\fancyfoot{} +\lfoot{ \textcolor{footer-gray}{\docNome - v\docVersione} } + +\renewcommand{\footrule}{\hbox to\headwidth{\color{light-grayer}\leaders\hrule height \footrulewidth\hfill}} +\rfoot{ \textcolor{footer-gray}{Pagina \thepage \hspace{1pt} di \pageref*{LastPage}} } + +% Grandezza paragrafi e spaziatura frasi + +\setlength{\parindent}{1.8em} +\setlength{\parskip}{1.2em} +\renewcommand{\baselinestretch}{1.1} + +% Colori link + +\hypersetup{ + colorlinks, + linkcolor=[HTML]{404040}, + citecolor={blue!50!black}, + urlcolor={red!50!black} +} +\PassOptionsToPackage{hyphens}{url}\usepackage{hyperref} + +% Equivalente a
+ +\newcommand{\hr}{\par\vspace{-.1\ht\strutbox}\noindent\hrulefill\par} + +% Tabelle e tabulazione + +\setlength{\tabcolsep}{10pt} +\renewcommand{\arraystretch}{1.4} + +% Unicode per simbolo euro + +\DeclareUnicodeCharacter{20AC}{\euro} + +% Configurazione sfondo + +\newcommand\DeactivateBG{\backgroundsetup{contents={}}} +\newcommand\ActivateBG{ \backgroundsetup{ + scale=1.0, + color=black, + opacity=1.0, + angle=0, + contents={% + \includegraphics[height=297mm]{res/images/background.png} + }% +}} + +% Codice e snippet + +\renewcommand{\lstlistingname}{Snippet} +\renewcommand{\lstlistlistingname}{Lista di \lstlistingname s} + + +\lstdefinestyle{chungusHighlight}{ + frame=tb, + backgroundcolor=\color{backcolour}, + commentstyle=\color{codegreen}, + keywordstyle=\color{magenta}\textbf, + numberstyle=\color{codegray}, + stringstyle=\color{codepurple}, + basicstyle={\ttfamily}, + breakatwhitespace=false, + breaklines=true, + captionpos=b, + keepspaces=true, + numbers=left, + numbersep=5pt, + showspaces=false, + showstringspaces=false, + showtabs=false, + numbers=none, + tabsize=2 +} + +\lstset{style=chungusHighlight} + + +% Comando per aggiungere le pagine di ogni sezione + +\newcommand{\yetAnotherSectionNamed}[1]{% + \newpage + \input{res/sections/#1} +}% diff --git a/interni/norme_progetto/res/frontespizio.tex b/interni/norme_progetto/res/frontespizio.tex new file mode 100644 index 0000000..3664bf5 --- /dev/null +++ b/interni/norme_progetto/res/frontespizio.tex @@ -0,0 +1,56 @@ + +% FRONTESPIZIO + +% Logo aziendale + +\begin{figure}[t!] + \centering + \includegraphics[height=10em]{res/images/logo.png} +\end{figure} + + +% Titolo principale + +\maketitle +\thispagestyle{empty} + + +% Riferimenti email e sito web + +\vspace{-6em} + +\begin{center} + \href{https://www.redroundrobin.site}{www.redroundrobin.site} --- \href{mailto:info@redroundrobin.site}{info@redroundrobin.site} +\end{center} + +\vspace{2em} + +% Informazioni documento + +\begin{table}[ht] + \begin{center} + \label{tab:Informazioni_Documento} + \begin{tabular}{r|l} + \multicolumn{2}{c}{ \textsc{Informazioni sul documento} } \\ + \hline + \textbf{Versione} & \docVersione \\ + \textbf{Uso} & \docUso \\ + \textbf{Stato} & \docStatus \\ + \textbf{Destinatari} & \docDestinatari \\ + \textbf{Redattori} & \docRedattori \\ + \textbf{Verificatori} & \docVerificatori \\ + \textbf{Approvazione} & \docApprovazione \\ + \end{tabular} + \end{center} +\end{table} + + +% Descrizione del documento + +\vspace{0em} + +\begin{center} + \textbf{Descrizione}\\ + \docDescrizione +\end{center} + diff --git a/interni/norme_progetto/res/images/background.png b/interni/norme_progetto/res/images/background.png new file mode 100644 index 0000000..9dcca68 Binary files /dev/null and b/interni/norme_progetto/res/images/background.png differ diff --git a/interni/norme_progetto/res/images/logo.png b/interni/norme_progetto/res/images/logo.png new file mode 100644 index 0000000..32071fe Binary files /dev/null and b/interni/norme_progetto/res/images/logo.png differ diff --git a/interni/norme_progetto/res/registro.tex b/interni/norme_progetto/res/registro.tex new file mode 100644 index 0000000..11d9f96 --- /dev/null +++ b/interni/norme_progetto/res/registro.tex @@ -0,0 +1,20 @@ +\section*{Registro delle modifiche} + +\begin{center} + \rowcolors{2}{lightest-grayest}{white} + \begin{longtable}{|c|c|c|c|c|} + \hline + \rowcolor{lighter-grayer} + \textbf{Versione} & \textbf{Descrizione} & \textbf{Data} & \textbf{Autore} & \textbf{Ruolo} \\ + \hline + \endfirsthead + + % ----- Modificare da qui ----- + + % 0.0.2 & Revisione documento & 24-11-2019 & Nome Cognome & Verificatore \\ + \hline + 0.0.1 & Creazione iniziale del documento & 02-12-2019 & Mariano Sciacco & Redattore \\ + \hline + + \end{longtable} +\end{center} \ No newline at end of file diff --git a/interni/norme_progetto/res/sections/Sez1-Introduzione/introduzione.tex b/interni/norme_progetto/res/sections/Sez1-Introduzione/introduzione.tex new file mode 100644 index 0000000..caf5456 --- /dev/null +++ b/interni/norme_progetto/res/sections/Sez1-Introduzione/introduzione.tex @@ -0,0 +1,14 @@ +\section{Introduzione} + \subsection{Scopo del documento} + + \subsection{Scopo del prodotto} + + \subsection{Glossario} + + \subsection{Riferimenti} + + \paragraph{Riferimenti normativi} + + \paragraph{Riferimenti informativi} + + diff --git a/interni/norme_progetto/res/sections/Sez2-ProcessiPrimari/Fornitura.tex b/interni/norme_progetto/res/sections/Sez2-ProcessiPrimari/Fornitura.tex new file mode 100644 index 0000000..cc2aaf2 --- /dev/null +++ b/interni/norme_progetto/res/sections/Sez2-ProcessiPrimari/Fornitura.tex @@ -0,0 +1,18 @@ + +\subsection{Fornitura} + + \subsubsection{Scopo} + + \subsubsection{Aspettative} + + \subsubsection{Descrizione} + + \subsubsection{Attività} + + \paragraph{Studio di fattibillità} + + \paragraph{Piano di progetto} + + \paragraph{Piano di qualifica} + + \subsubsection{Strumenti} diff --git a/interni/norme_progetto/res/sections/Sez2-ProcessiPrimari/Sviluppo.tex b/interni/norme_progetto/res/sections/Sez2-ProcessiPrimari/Sviluppo.tex new file mode 100644 index 0000000..35770f6 --- /dev/null +++ b/interni/norme_progetto/res/sections/Sez2-ProcessiPrimari/Sviluppo.tex @@ -0,0 +1,16 @@ +\subsection{Sviluppo} + \subsubsection{Scopo} + + \subsubsection{Aspettative} + + \subsubsection{Descrizione} + + \subsubsection{Attività} + + \paragraph{Analisi dei requisiti} + + \paragraph{Progettazione} + + \paragraph*{Codifica} + + \subsubsection{Strumenti} \ No newline at end of file diff --git a/interni/norme_progetto/res/sections/Sez2-ProcessiPrimari/processiPrimari.tex b/interni/norme_progetto/res/sections/Sez2-ProcessiPrimari/processiPrimari.tex new file mode 100644 index 0000000..c67a8e3 --- /dev/null +++ b/interni/norme_progetto/res/sections/Sez2-ProcessiPrimari/processiPrimari.tex @@ -0,0 +1,4 @@ +\section{Processi Primari} + +\yetAnotherSectionNamed{Sez2-ProcessiPrimari/Fornitura} +\yetAnotherSectionNamed{Sez2-ProcessiPrimari/Sviluppo} \ No newline at end of file diff --git a/interni/norme_progetto/res/sections/Sez3-ProcessiSupporto/Documentazione.tex b/interni/norme_progetto/res/sections/Sez3-ProcessiSupporto/Documentazione.tex new file mode 100644 index 0000000..8b69823 --- /dev/null +++ b/interni/norme_progetto/res/sections/Sez3-ProcessiSupporto/Documentazione.tex @@ -0,0 +1,42 @@ +\subsection{Documentazione} + + \subsubsection{Scopo} + + \subsubsection{Aspettative} + + \subsubsection{Descrizione} + + \subsubsection{Ciclo di vita} + + \subsubsection{Template LaTeX} + + \subsubsection{Struttura dei documenti} + \paragraph{Frontespizio} + \paragraph{Registro modifiche} + \paragraph{Indice} + \paragraph{Contenuto principale} + \paragraph{note a piè di pagina} + + \subsubsection{Classificazione dei documenti} + \paragraph{Documenti ufficiosi} + \paragraph{Documenti ufficiali} + \paragraph{Verbali} + \paragraph{Glossario} + \paragraph{Lettere} + + \subsubsection{Norme tipografiche} + \paragraph{Convenzioni sui nomi dei file} + \paragraph{Glossario} + \paragraph{Stile del testo} + \paragraph{Elenchi puntati} + \paragraph{Formati comuni} + \paragraph{Sigle} + + \subsubsection{Elementi grafici} + \paragraph{Tabelle} + \paragraph{Immagini} + \paragraph{Diagrammi UML} + + \subsubsection{Strumenti} + \paragraph{LaTeX} + \paragraph{TexStudio, TexMaker e TexLive con IDE} \ No newline at end of file diff --git a/interni/norme_progetto/res/sections/Sez3-ProcessiSupporto/GaranziaQualita.tex b/interni/norme_progetto/res/sections/Sez3-ProcessiSupporto/GaranziaQualita.tex new file mode 100644 index 0000000..a8ed3e2 --- /dev/null +++ b/interni/norme_progetto/res/sections/Sez3-ProcessiSupporto/GaranziaQualita.tex @@ -0,0 +1,10 @@ +\subsection{Garanzia della qualità} + + \subsubsection{Scopo} + \subsubsection{Aspettative} + \subsubsection{Descrizione} + \subsubsection{Controllo qualità prodotto} + \subsubsection{Controllo qualità di processo} + \subsubsection{Classificazioni metriche} + \subsubsection{Strumenti} + diff --git a/interni/norme_progetto/res/sections/Sez3-ProcessiSupporto/GestConfigurazione.tex b/interni/norme_progetto/res/sections/Sez3-ProcessiSupporto/GestConfigurazione.tex new file mode 100644 index 0000000..b97f0d6 --- /dev/null +++ b/interni/norme_progetto/res/sections/Sez3-ProcessiSupporto/GestConfigurazione.tex @@ -0,0 +1,15 @@ +\subsection{Gestione della configurazione} + + \subsubsection{Scopo} + \subsubsection{Versionamento} + \paragraph{Codice di versionamento} + \paragraph{Tecnologie} + \paragraph{Repository} + \begin{itemize} + \item Struttura + \item Utilizzo di git + \item Tipi di file e .gitignore + \end{itemize} + \paragraph{Gestione delle modifiche} + + \ No newline at end of file diff --git a/interni/norme_progetto/res/sections/Sez3-ProcessiSupporto/Validazione.tex b/interni/norme_progetto/res/sections/Sez3-ProcessiSupporto/Validazione.tex new file mode 100644 index 0000000..6543a1d --- /dev/null +++ b/interni/norme_progetto/res/sections/Sez3-ProcessiSupporto/Validazione.tex @@ -0,0 +1,7 @@ +\subsection{Validazione} + + \subsubsection{Scopo} + \subsubsection{Aspettative} + \subsubsection{Descrizione} + \subsubsection{Attività} + \ No newline at end of file diff --git a/interni/norme_progetto/res/sections/Sez3-ProcessiSupporto/Verifica.tex b/interni/norme_progetto/res/sections/Sez3-ProcessiSupporto/Verifica.tex new file mode 100644 index 0000000..a6ae746 --- /dev/null +++ b/interni/norme_progetto/res/sections/Sez3-ProcessiSupporto/Verifica.tex @@ -0,0 +1,17 @@ +\subsection{Verifica} + + \subsubsection{Scopo} + \subsubsection{Aspettative} + \subsubsection{Descrizione} + \subsubsection{Attività} + \paragraph{Analisi statica e dinamica} + \paragraph{Test} + \subparagraph*{Test di unità} + \subparagraph*{Test di integrazione} + \subparagraph*{Test di sistema} + \subparagraph*{Test di non regressione} + \subparagraph*{Test di accettazione} + + \subsubsection{Strumenti} + \paragraph{Verifica ortografica} + \ No newline at end of file diff --git a/interni/norme_progetto/res/sections/Sez3-ProcessiSupporto/processiSupporto.tex b/interni/norme_progetto/res/sections/Sez3-ProcessiSupporto/processiSupporto.tex new file mode 100644 index 0000000..6e73f7b --- /dev/null +++ b/interni/norme_progetto/res/sections/Sez3-ProcessiSupporto/processiSupporto.tex @@ -0,0 +1,7 @@ +\section{Processi di supporto} + +\yetAnotherSectionNamed{Sez3-ProcessiSupporto/Documentazione} +\yetAnotherSectionNamed{Sez3-ProcessiSupporto/GestConfigurazione} +\yetAnotherSectionNamed{Sez3-ProcessiSupporto/GaranziaQualita} +\yetAnotherSectionNamed{Sez3-ProcessiSupporto/Verifica} +\yetAnotherSectionNamed{Sez3-ProcessiSupporto/Validazione} \ No newline at end of file diff --git a/interni/norme_progetto/res/sections/Sez4-ProcessiOrganizzativi/FormazionePersonale.tex b/interni/norme_progetto/res/sections/Sez4-ProcessiOrganizzativi/FormazionePersonale.tex new file mode 100644 index 0000000..8570421 --- /dev/null +++ b/interni/norme_progetto/res/sections/Sez4-ProcessiOrganizzativi/FormazionePersonale.tex @@ -0,0 +1,11 @@ +\subsection{Formazione del personale} + +\subsubsection{Scopo} + + \subsubsection{Descrizione} + + \subsubsection{Guida sui linguaggi di programmazione} + + \subsubsection{Guida sugli strumenti di programmazione} + + \subsubsection{Corsi formativi aggiuntivi} \ No newline at end of file diff --git a/interni/norme_progetto/res/sections/Sez4-ProcessiOrganizzativi/GestProcessi.tex b/interni/norme_progetto/res/sections/Sez4-ProcessiOrganizzativi/GestProcessi.tex new file mode 100644 index 0000000..b537704 --- /dev/null +++ b/interni/norme_progetto/res/sections/Sez4-ProcessiOrganizzativi/GestProcessi.tex @@ -0,0 +1,22 @@ +\subsection{Gestione dei processi} + + \subsubsection{Scopo} + + \subsubsection{Descrizione} + + \subsubsection{Ruoli di progetto} + \paragraph{Responsabile di progetto} + \paragraph{Amministratore di progetto} + \paragraph{Analista} + \paragraph{Progettista} + \paragraph{Programmatore} + \paragraph{Verificatore} + + + \subsubsection{Procedure} + \paragraph{Gestione delle comunicazioni} + \paragraph{Gestione degli incontri} + \paragraph{Gestione degli strumenti di coordinamento} + \paragraph{Gestione dei rischi} + + \subsubsection{Strumenti} \ No newline at end of file diff --git a/interni/norme_progetto/res/sections/Sez4-ProcessiOrganizzativi/processiOrganizzativi.tex b/interni/norme_progetto/res/sections/Sez4-ProcessiOrganizzativi/processiOrganizzativi.tex new file mode 100644 index 0000000..507bed3 --- /dev/null +++ b/interni/norme_progetto/res/sections/Sez4-ProcessiOrganizzativi/processiOrganizzativi.tex @@ -0,0 +1,5 @@ +\section{Processi organizzativi} + +\yetAnotherSectionNamed{Sez4-ProcessiOrganizzativi/GestProcessi} +\yetAnotherSectionNamed{Sez4-ProcessiOrganizzativi/FormazionePersonale} + \ No newline at end of file diff --git a/interni/norme_progetto/res/sezioni.tex b/interni/norme_progetto/res/sezioni.tex new file mode 100644 index 0000000..9c9f490 --- /dev/null +++ b/interni/norme_progetto/res/sezioni.tex @@ -0,0 +1,10 @@ +% ----------------------- +% Sezioni da inserire +% ----------------------- +% Pro tip: usare il comando \yetAnotherSectionNamed{nome_file} + + +\yetAnotherSectionNamed{Sez1-Introduzione/introduzione} +\yetAnotherSectionNamed{Sez2-ProcessiPrimari/processiPrimari} +\yetAnotherSectionNamed{Sez3-ProcessiSupporto/processiSupporto} +\yetAnotherSectionNamed{Sez4-ProcessiOrganizzativi/processiOrganizzativi} diff --git a/interni/studio_fattibilita/main.pdf b/interni/studio_fattibilita/main.pdf index b163799..d0b3b3f 100644 Binary files a/interni/studio_fattibilita/main.pdf and b/interni/studio_fattibilita/main.pdf differ diff --git a/interni/studio_fattibilita/main.tex b/interni/studio_fattibilita/main.tex index 5f93b3c..bc13389 100644 --- a/interni/studio_fattibilita/main.tex +++ b/interni/studio_fattibilita/main.tex @@ -10,9 +10,9 @@ % -------------- -\newcommand{\docNome}{ Studio di fattibilità } -\newcommand{\docNomeProgetto}{ NOME DEL PROGETTO } -\newcommand{\docVersione}{0.0.0} +\newcommand{\docNome}{ STUDIO DI FATTIBILITA' } +\newcommand{\docVersione}{0.0.1} +\newcommand{\docNomeProgetto}{ v\docVersione } \newcommand{\docStatus}{in redazione} \newcommand{\docUso}{interno} \newcommand{\docDescrizione}{ diff --git a/interni/studio_fattibilita/res/configurazione.tex b/interni/studio_fattibilita/res/configurazione.tex index 42ac140..eda42a9 100644 --- a/interni/studio_fattibilita/res/configurazione.tex +++ b/interni/studio_fattibilita/res/configurazione.tex @@ -1,9 +1,12 @@ % Configurazione delle dipendenze e dei package + \usepackage{geometry} \usepackage{graphicx} +\usepackage[T1]{fontenc} \usepackage[utf8]{inputenc} +\usepackage{charter} \usepackage{eurosym} \usepackage[italian]{babel} \usepackage{float} @@ -20,8 +23,7 @@ \usepackage{longtable} \usepackage{colortbl} \usepackage{tikz} -\usepackage{lipsum} -\usepackage[T1]{fontenc} + % Impostazioni pagina e margini diff --git a/interni/studio_fattibilita/res/registro.tex b/interni/studio_fattibilita/res/registro.tex index b5ca7fb..11d9f96 100644 --- a/interni/studio_fattibilita/res/registro.tex +++ b/interni/studio_fattibilita/res/registro.tex @@ -11,9 +11,9 @@ \section*{Registro delle modifiche} % ----- Modificare da qui ----- - 0.0.2 & Revisione documento & 24/11/2019 & Nome Cognome & Verificatore \\ + % 0.0.2 & Revisione documento & 24-11-2019 & Nome Cognome & Verificatore \\ \hline - 0.0.1 & Creazione documento & 23/11/2019 & Nome Cognome & Redattore \\ + 0.0.1 & Creazione iniziale del documento & 02-12-2019 & Mariano Sciacco & Redattore \\ \hline \end{longtable} diff --git a/interni/studio_fattibilita/res/sections/section3part1.tex b/interni/studio_fattibilita/res/sections/CapitolatoC1.tex similarity index 100% rename from interni/studio_fattibilita/res/sections/section3part1.tex rename to interni/studio_fattibilita/res/sections/CapitolatoC1.tex diff --git a/interni/studio_fattibilita/res/sections/section3part2.tex b/interni/studio_fattibilita/res/sections/CapitolatoC2.tex similarity index 100% rename from interni/studio_fattibilita/res/sections/section3part2.tex rename to interni/studio_fattibilita/res/sections/CapitolatoC2.tex diff --git a/interni/studio_fattibilita/res/sections/section3part3.tex b/interni/studio_fattibilita/res/sections/CapitolatoC3.tex similarity index 100% rename from interni/studio_fattibilita/res/sections/section3part3.tex rename to interni/studio_fattibilita/res/sections/CapitolatoC3.tex diff --git a/interni/studio_fattibilita/res/sections/CapitolatoC4.tex b/interni/studio_fattibilita/res/sections/CapitolatoC4.tex new file mode 100644 index 0000000..8bd2e92 --- /dev/null +++ b/interni/studio_fattibilita/res/sections/CapitolatoC4.tex @@ -0,0 +1,48 @@ + +\subsection{Capitolato 4 - Predire in Grafana} + + \subsubsection{Informazioni generali} + \begin{itemize} %enumerate per elenco puntato numerato + \item \textbf{Nome:} Predire in Grafana - Monitoraggio predittivo per DevOps + \item \textbf{Proponente:} Zucchetti SPA + \item \textbf{Link:} https://www.math.unipd.it/~tullio/IS-1/2019/Progetto/C4.pdf + \end{itemize} + + \subsubsection{Descrizione capitolato} + La società Zucchetti, per eseguire il monitoraggio dei propri sistemi, ha scelto Grafana, un prodotto open source estendibile tramite plug-in. + Il capitolato chiede la realizzazione di un plug-in, da integrare a Grafana stessa, che effettuino delle previsioni sul flusso dei dati raccolti al fine di monitorare il corretto funzionamento del sistema e consigliare eventuali interventi alla linea di produzione del software tramite allarmi o segnalazioni. + + \subsubsection{Finalità del progetto} + É richiesto lo sviluppo di due plug-in per Grafana che siano in grado di predirre un possibile stato dell'imminente futuro della macchina. La predizioni devo essere effettuate tramite Regressione Lineare o Support Vector Machine. + La Regressione Lineare consente di analizzare dati uniformi ed é molto utile se i dati hanno un dominio continuo e una dispersione uniforme (omoschedastici) con andamento lineare. Per avere una predizione valida si deve guardare la dispersione del grafo dei residui, nel quale una dspersione uniforme é indice di una LR corretta ed attendibile. + I SVM sono algoritmi di classificazione per dati con dominio discreto e sono scalabili su spazi di dati molto grandi. Essi consistono nell'effettuare trasformazioni dello spazio dati per trovare un predizione che sia in grado di separare i dati in varie classi. + L'addestramento degli algoritmi di machine learning viene effettuato in un ambiente separato ed isolato da grafana tramite suit di generazione dati come JMeter che consente di creare dati compatibili. A fine addestramento i predittori necessitano di essere salvati in file JSON per poi essere associati al flusso dati di grafana. Una volta ottenute le previsioni sui dati essi dovranno essere resi disponibili al sistema di creazione di grafici di Grafana ed essere visualizzati sulla dashboard. + + Come obbiettivi opzionali viene richiesto di dare la possibilità di definire \"alert\" in base a soglie raggiunte dalle previsioni; di dare la possibilità di effettuare trasformazioni sulle misure i modo da ottenere regressioni non lineare (es. logaritmiche o esponenziali); di consentire l'apprendimento constante tramite i dati raccolti dall'agente JMX. Viene richiesto, inoltre, di fornire anche i dati di bontà dei predittori. Per SVM sono \"Precision\", che consiste nel rapporto tra i dati veri predetti veri e i dati falsi predetti veri(veri trovati\/falsi positivi); e \"Recall\", che il rapporto tra i veri valutati veri ed i veri non valutati tali; invece per LR si fà riferimento al coefficente \"R\textsuperscript{2}\" che rappresenta il rapporto tra gli errori rispetto alla retta e gli errori rispetto alla media del codominio dei dati. + + + \subsubsection{Tecnologie interessate} + \begin{itemize} + \item \textbf{Support Vector Machines (SVM):} modello di classificazione basata su trasformazioni dello spazio dei dati; + \item \textbf{Regressione Lineare (RL):} modello di predizione basa sulla differenza dei quadrati che genera una predizione lineare del tipo \[y=ax+b\]; + \item \textbf{JMX:} agente installato sulle macchine che raccoglie i dati necessari alle predizioni; + \item \textbf{JMeter:} suit di generazione di dati virtuali per l'addestramento; + \item \textbf{JavaScript:} linguaggio non tipizzato orientato ad oggetti sia client side (JS, JQuery) che server side (AJAX, Node.JS). + \end{itemize} + + \subsubsection{Aspetti positivi:} + \begin{itemize} + \item L’azienda, consapevole del fatto che gli algoritmi di Machine Learning non fanno parte del corso di studi della laurea triennale, è disponibile alla formazione ed alla fornitura di questi tipi di algoritmi; + \item I requisiti obbligatori del capitolato sono basilari dando la possibilità di ampliare notevolmente il progetto con i requisiti opzionali; + \item Uso di un linguaggio flessibile, all'avanguardia e richiesto sul mercato. + \end{itemize} + + \subsubsection{Criticità:} + \begin{itemize} + \item Integrare un sistema già esistente con consequente innalzamento delle ore di documentazione sul sistema, oltre che sulle tecnologie; + \item Le tecnologie di Machine Learning non sono ancora ben chiare al gruppo; + \item Necessita uno studio approfondito della documentazione di vare suit e programmi per poter avere un'idea più concreta del progetto. + \end{itemize} + + \subsubsection{Conclusioni:} + Il capitolato ha stimolato un discreto interesse nel gruppo, nonostante le sue criticità, dal momento che si usano tecnologie importanti e consente di acquisire conoscenze spendibili nel mondo reale. Il gruppo ha espresso un giudizio ...todo..... nei confronti di questo capitolato. diff --git a/interni/studio_fattibilita/res/sections/section1part2.tex b/interni/studio_fattibilita/res/sections/CapitolatoC5.tex similarity index 100% rename from interni/studio_fattibilita/res/sections/section1part2.tex rename to interni/studio_fattibilita/res/sections/CapitolatoC5.tex diff --git a/interni/studio_fattibilita/res/sections/section1part3.tex b/interni/studio_fattibilita/res/sections/CapitolatoC6.tex similarity index 65% rename from interni/studio_fattibilita/res/sections/section1part3.tex rename to interni/studio_fattibilita/res/sections/CapitolatoC6.tex index dbc1997..48fdc63 100644 --- a/interni/studio_fattibilita/res/sections/section1part3.tex +++ b/interni/studio_fattibilita/res/sections/CapitolatoC6.tex @@ -12,34 +12,39 @@ \subsection{Capitolato 6 - ThiReMa} I dati messi a disposizione dal database centralizzato dovranno essere suddivisi in due macro-categorie: dati operativi e fattori influenzanti. \subsubsection{Finalità del progetto} - Creare una web-application, che permetta di valutare la correlazione tra dati operativi (misure) e i fattori influenzanti. Tale applicazione si potrà focalizzare nella definizione di uno o più algoritmi per la successiva analisi dei dati al fine di essere in grado di effettuare delle previsioni sull’andamento dei dati stessi ed offrire, ad esempio, dei servizi manutenzione predittiva. - Per ogni tipologia di informazioni rilevate dovrà anche essere possibile assegnare il monitoraggio ad un particolare ente. + Creare una web-application, che permetta di valutare la correlazione tra dati operativi (misure) e i fattori influenzanti. Tale applicazione si potrà focalizzare nella definizione di uno o più algoritmi per la successiva analisi dei dati al fine di essere in grado di effettuare delle previsioni sull’andamento dei dati stessi ed offrire, ad esempio, dei servizi di manutenzione predittiva. + Per ogni tipologia di informazioni rilevate dovrà anche essere possibile assegnare il monitoraggio ad un particolare ente. Analizzando un determinato sensore, in base ai dati ricevuti, si può prevedere un deterioramento complessivo tale da generare una necessaria azione di manutenzione preventiva. La web-application dovrà essere suddivisa in 3 macro-sezioni: \begin{itemize} - \item Censimento dei sensori e dei relativi dati. - \item Modulo di analisi di correlazione. + \item Censimento dei sensori e dei relativi dati; + \item Modulo di analisi di correlazione; \item Modulo di monitoraggio per ente. \end{itemize} \subsubsection{Tecnologie interessate} \begin{itemize} - \item \textbf{Apache Kafka:} Piattaforma open source di stream processing scritta in Java sviluppata da Apache Software Foundation. Il progetto mira a creare una piattaforma a bassa latenza ed alta velocità per la gestione di feed dati in tempo reale. - \item \textbf{Java:} Linguaggio di programmazione ad alto livello orientato agli oggetti e a tipizzazione statica. + \item \textbf{Apache Kafka:} Piattaforma open source di stream processing scritta in Java sviluppata da Apache Software Foundation. Il progetto mira a creare una piattaforma a bassa latenza ed alta velocità per la gestione di feed dati in tempo reale; + \item \textbf{API Producer, Consumer, Connect e Streams:} API consigliate per la produzione di componenti custom per Kafka; + \item \textbf{PostgreSQL, TimescaleDB, ClickHouse:} Implementazioni database suggerite per contenere i dati relativi alle misurazioni, agli utenti e le loro informazioni di autorizzazione; + \item \textbf{Docker:} Tecnologia di containerizzazione che consente la creazione e l'utilizzo di container Linux. Nel progetto risulterebbe utile per l'instanziazione di tutti i componenti; + \item \textbf{Java:} Linguaggio di programmazione ad alto livello orientato agli oggetti e a tipizzazione statica; \item \textbf{Bootstrap:} Raccolta di strumenti open source per la creazione di siti e applicazioni per il Web. Essa contiene modelli di progettazione basati su HTML e CSS, sia per la tipografia, che per le varie componenti dell'interfaccia, come moduli, pulsanti e navigazione, così come alcune estensioni opzionali di JavaScript. \end{itemize} \subsubsection{Aspetti positivi:} \begin{itemize} - \item Tecnologie già in parte conosciute dal gruppo con la possibilità di ampliarne le conoscenze. + \item Tecnologie già in parte conosciute dal gruppo con la possibilità di ampliarne le conoscenze; + \item L'azienda mette a disposizione figure di diverso livello per rispondere alle varie esigenze del gruppo e per facilitare la creazione di ambienti di sviluppo e test \item Consistente set di dati su cui testare l'applicativo. \end{itemize} \subsubsection{Criticità:} \begin{itemize} - \item Protocolli proprietari, la documentazione su di essi potrebbe essere limitata. + \item Protocolli proprietari, la documentazione su di essi potrebbe essere limitata; + \item Il capitolato richiede un'analisi dei dati più avanzata rispetto agli altri. \end{itemize} \subsubsection{Conclusioni:} - Il capitolato ha suscitato l'interesse del gruppo, dando la possibilità di ampliare tecnlogie gia in parte conosciute. C'è stato inoltre molto entusiasmo per la tipologia di web-application da sviluppare. + Il capitolato ha suscitato l'interesse del gruppo, dando la possibilità di ampliare tecnologie già in parte conosciute ed al contempo molto attuali, quali IoT e Big Data. C'è stato inoltre molto entusiasmo per la tipologia di web-application da sviluppare. diff --git a/interni/studio_fattibilita/res/sections/section2.tex b/interni/studio_fattibilita/res/sections/CapitolatoScelto.tex similarity index 100% rename from interni/studio_fattibilita/res/sections/section2.tex rename to interni/studio_fattibilita/res/sections/CapitolatoScelto.tex diff --git a/interni/studio_fattibilita/res/sections/section1.tex b/interni/studio_fattibilita/res/sections/Introduzione.tex similarity index 100% rename from interni/studio_fattibilita/res/sections/section1.tex rename to interni/studio_fattibilita/res/sections/Introduzione.tex diff --git a/interni/studio_fattibilita/res/sections/section1part1.tex b/interni/studio_fattibilita/res/sections/section1part1.tex deleted file mode 100644 index 2e98644..0000000 --- a/interni/studio_fattibilita/res/sections/section1part1.tex +++ /dev/null @@ -1,41 +0,0 @@ - -\subsection{Capitolato 4 - Predire in Grafana} - - \subsubsection{Informazioni generali} - \begin{itemize} %enumerate per elenco puntato numerato - \item \textbf{Nome:} Predire in Grafana - Monitoraggio predittivo per DevOps - \item \textbf{Proponente:} Zucchetti SPA - \item \textbf{Link:} https://www.math.unipd.it/~tullio/IS-1/2019/Progetto/C4.pdf - \end{itemize} - - \subsubsection{Descrizione capitolato} - La società Zucchetti, per eseguire il monitoraggio dei propri sistemi, ha scelto Grafana, un prodotto open source estendibile tramite plug-in. - Il capitolato chiede la realizzazione di un plug-in, da integrare a Grafana stessa, che effettuino delle previsioni sul flusso dei dati raccolti al fine di monitorare il corretto funzionamento del sistema e consigliare eventuali interventi alla linea di produzione del software tramite allarmi o segnalazioni. - - \subsubsection{Finalità del progetto} - È richiesto lo sviluppo di un plug-in Grafana che, dopo aver letto da un file json la definizione di calcoli da applicare ed essere e stati associati ad alcuni nodi della rete, producano dei valori che possano essere aggiunti al flusso del monitoraggio come se fossero dati rilevati sul campo. - La definizione dei calcori dovrà essere effetuata tramite Support Vector Machines o Regressione Lineare. L’addestramento delle SVM e della RL dovranno essere effetuati in una applicazione apposita a cui verranno forniti i dati di test o alternativamente direttamente in Grafana quando non sono necessari dati aggiuntivi per l’addestramento. - Una volta ottenuti i dati ed effetuata la previsione su di essi dovranno essere resi disponibili al sistema di creazione di grafici di Grafana ed essere visualizzati sulla dashboard. - - \subsubsection{Tecnologie interessate} - \begin{itemize} - \item \textbf{Support Vector Machines (SVM):} Modello di apprendimento supervisionato associati ad algoritmi di apprendimento per la regressione e la classificazione. - \item \textbf{Regressione Lineare (RL):} Modello di apprendimento supervisionato associati ad algoritmi di apprendimento per la regressione. - \item \textbf{JavaScript:} Linguaggio di scripting orientato agli oggetti ed agli eventi. - \end{itemize} - - \subsubsection{Aspetti positivi:} - \begin{itemize} - \item L'azienda, consapevole del fatto che gli algoritmi di Machine Learning non fanno parte del corso di studi della laurea triennale, è disponibile alla formazione su questo tipo di algoritmi. - \item I requisiti obbligatori del capitolato sono tuttosommato non troppo esigenti dando la possibilità di ampliare notevolmente il progetto con i requisiti opzionali. - \end{itemize} - - \subsubsection{Criticità:} - \begin{itemize} - \item Integrare un sistema già esistente. - \item Le tecnologie di Machine Learning non hanno suscitato interesse nel gruppo. - \end{itemize} - - \subsubsection{Conclusioni:} - Il capitolato non è riuscito a stimolare l'interesse del gruppo dal momento che si tratta di ampliare un sistema già esistente con un plug-in e per le tecnologie che verranno apprese in corso d'opera. - Il gruppo ha espresso quindi un gudizione negativo nel confronto di questo capitolato. \ No newline at end of file diff --git a/interni/studio_fattibilita/res/sezioni.tex b/interni/studio_fattibilita/res/sezioni.tex index 9e718c1..92cdf9c 100644 --- a/interni/studio_fattibilita/res/sezioni.tex +++ b/interni/studio_fattibilita/res/sezioni.tex @@ -1,8 +1,8 @@ -\yetAnotherSectionNamed{section1} -\yetAnotherSectionNamed{section2} -\yetAnotherSectionNamed{section3part1} -\yetAnotherSectionNamed{section3part2} -\yetAnotherSectionNamed{section3part3} -\yetAnotherSectionNamed{section1part1} -\yetAnotherSectionNamed{section1part2} -\yetAnotherSectionNamed{section1part3} \ No newline at end of file +\yetAnotherSectionNamed{Introduzione} +\yetAnotherSectionNamed{CapitolatoScelto} +\yetAnotherSectionNamed{CapitolatoC1} +\yetAnotherSectionNamed{CapitolatoC2} +\yetAnotherSectionNamed{capitolatoC3} +\yetAnotherSectionNamed{CapitolatoC4} +\yetAnotherSectionNamed{CapitolatoC5} +\yetAnotherSectionNamed{CapitolatoC6} \ No newline at end of file diff --git a/notes/2019-12-03-riunione-4.md b/notes/2019-12-03-riunione-4.md new file mode 100644 index 0000000..8dc7cdc --- /dev/null +++ b/notes/2019-12-03-riunione-4.md @@ -0,0 +1,27 @@ +# Riunione #4 + +Quarta riunione informale del gruppo (pre-progettazione) + +### Ordine del giorno + +- [x] 1) Inizio stesura della struttura di tutti i documenti +- [x] 2) Assegnazione dei compiti e suddivisione dei ruoli per tutti i documenti (ognuno tocca almeno tutti i documenti) +- [x] 3) Raccolta e analisi più approfondita delle norme di progetto +- [ ] 4) Configurazione del way of working per quanto riguarda la documentazione, con regole precise da seguire nella repo +- [ ] 5) Varie ed eventuali + + +### Luogo e ora + +- Lum250 +- Ore 14:00, 3 dicembre 2019 + +> __Conclusione:__ ore 18:00 + +- Segretario --> Nicolò Frison + +## Verbale + +> **Nota:** Tutti presenti. + + diff --git a/notes/NoteNormeDiProgetto.md b/notes/NoteNormeDiProgetto.md new file mode 100644 index 0000000..cd5ccba --- /dev/null +++ b/notes/NoteNormeDiProgetto.md @@ -0,0 +1,46 @@ +# Norme di progetto + +Questa é una raccolta di nomre di progetto discusse nella riunione del 26-11-2019 + +#### Stile e struttura dei documenti +- **formato delle date:** europeo (gg-mm-yyyy); +- prefazione indicizzata con numeri romani; +- contenuto indixizzato con i numeri arabi (il numero totale delle pagine conta solo le pagine di contenuto); +- **versione:** 3 numeri separati da 2 punti (vX.X.X): + - la prima cifra rappresenta una major release; + - la seconda cifra rappresenta la verifica del documento; + - la terza rappresenta il versionamento interno. +- **glossario:** la parola é in maiuscoletto con una "g" in pedice, é un documento separato; +- **reference documento esterno:** la parola é in maiuscoletto con una "d" in pedice; +- un file per ogni section, compito del verificatore verificarne la coerenza del contenuto; +- **definizioni:** parola in grassetto, due punti inclusi ed attaccati alla parola; +- titoli section in grassetto; +- **corsivo:** per i termini tecnici; +- elenchi non numerati con il cerchio pieno, sub-elenco con trattino; +- ogni sentenza dell'elenco é in minuscolo con il punto e virgola alla fine, fatta eccezione dell'ultima frase che va con il punto; +- elenchi ordinati con indice "flessibilie" (aka o numeri o lettere, fate vobis) in minuscolo con il punto (es. a. 1. ); +- descrivere le varie automation utilizzate, eg. CI, CD, TDD etc.; +- in alto a sx della pagina il logo; +- in alto a dx della pagina la sezione corrente; +- in basso a sx della pagina il nome del documento con versione; +- in basso a dx della pagina il numero della pagina. + +#### Stile del codice +- Es. di stile: +``` cpp +if () { + //code CHE SCHIFO +} else { + //code +} +void function () { + //code +} +``` +- tab da 4 spazi linux; +- ultimo standard per la sintassi del codice a seconda del linguaggio; +- camelcase su JS; +- camelcase per i nomi file. + +gg wp ez +### ~uwu~ diff --git a/notes/ReportPianoDiProgetto.pdf b/notes/ReportPianoDiProgetto.pdf index cc2d4b6..9619bb4 100644 Binary files a/notes/ReportPianoDiProgetto.pdf and b/notes/ReportPianoDiProgetto.pdf differ diff --git a/notes/ReportPianoDiQualifica.pdf b/notes/ReportPianoDiQualifica.pdf index ee40a4f..1e22eb5 100644 Binary files a/notes/ReportPianoDiQualifica.pdf and b/notes/ReportPianoDiQualifica.pdf differ diff --git a/notes/Report_Capitolato6.pdf b/notes/Report_Capitolato6.pdf new file mode 100644 index 0000000..6aaf635 Binary files /dev/null and b/notes/Report_Capitolato6.pdf differ diff --git a/notes/Struttura analisi dei requisiti.txt b/notes/Struttura analisi dei requisiti.txt new file mode 100644 index 0000000..f0d08c0 --- /dev/null +++ b/notes/Struttura analisi dei requisiti.txt @@ -0,0 +1,33 @@ +1 Introduzione + 1.1 Scopo del documento + 1.2 Scopo del prodotto + 1.3 Glossario + 1.4 Riferimenti + 1.4.1 Normativi + 1.4.2 Informativi + +2 Descrizione generale + 2.1 Obiettivi del prodotto + 2.2 Funzioni del prodotto + 2.3 Caratteristiche degli utenti + 2.4 Macro architetture del progetto + 2.4.1 Back end + 2.4.2 Front end + 2.5 Vincoli generali + +3 Casi d'uso + 3.1 Attori dei casi d'uso + 3.1.1 Attori primari + 3.1.2 Attori secondari + 3.2 Elenco dei casi d'uso + [Vari casi d'uso] + +4 Requisiti + 4.1 Requisiti funzionali + 4.2 Requisiti di qualità + 4.3 Requisiti di vincolo + 4.4 Requisiti prestazionali + 4.5 Tracciamento + 4.5.1 Fonte- Requisiti + 4.5.2 Requisito - Fonti + 4.6 Considerazioni \ No newline at end of file diff --git a/notes/Struttura norme di progetto.txt b/notes/Struttura norme di progetto.txt new file mode 100644 index 0000000..3981b0f --- /dev/null +++ b/notes/Struttura norme di progetto.txt @@ -0,0 +1,111 @@ +1 Introduzione + 1.1 Scopo del documento + 1.2 Scopo del prodotto + 1.3 Glossario + 1.4 Riferimenti + 1.4.1 Riferimenti normativi + 1.4.2 Riferimenti informativi + +2 Processi primari + 2.1 Fornitura + 2.1.1 Scopo + 2.1.2 Aspettative + 2.1.3 Descrizione + 2.1.4 Attività + 2.1.4.1 Studio di fattibilità + 2.1.4.2 Piano di progetto + 2.1.4.3 Piano di qualifica + 2.1.5 Strumenti + [strumenti utilizzati] + 2.2 Sviluppo + 2.2.1 Scopo + 2.2.2 Aspettative + 2.2.3 Descrizione + 2.2.4 Attività + 2.2.4.1 Analisi dei requisiti + 2.2.4.2 Progettazione + 2.2.4.3 Codifica + 2.2.5 Strumenti + [strumenti utilizzati] + + Le norme non considerano la qualità 8lab + +3 Processi di supporto + 3.1 Documentazione + 3.1.1 Scopo + 3.1.2 Aspettative + 3.1.3 Descrizione + 3.1.4 Ciclo di vita del documento + 3.1.5 Template + 3.1.6 Strutture dei documenti + Prima pagina + Registro modifiche + Indice + Contenuto principale + Verbali + Note a piè di pagina + 3.1.7 Norme tipografiche + Convenzioni sui nomi dei file + Glossario + Stile del testo + Elenchi puntati + Formati comuni + Sigle + 3.1.8 Elementi grafici + Tabelle + Immagini + Diagrammi UML + 3.1.9 Strumenti + Latex + Tex studio + 3.2 Gestione della configurazione + 3.2.1 Scopo + 3.2.2 Versionamento + Codice di versionamento del documento + Tecnologie + Repository + Struttura dei repository + Tipi di file e .gitignore + utilizzo di git + gestione delle modifiche + 3.3 Gestione delle qualità + 3.3.1 Scopo + 3.3.2 Aspettative + 3.3.3 Descrizione + 3.3.4 Attività + 3.3.5 Strumenti + 3.4 Verifica + 3.4.1 Scopo + 3.4.2 Aspettative + 3.4.3 Descrizione + 3.4.4 Attività + Analisi + Test + 3.4.5 Strumenti + Verifica ortografica + Validazione w3c + 3.5 Validazione + 3.5.1 Scopo + 3.5.2 Attività + +4 Processi organizzativi + 4.1 Gestione organizzativa + 4.1.1 Scopo + 4.1.2 Aspettative + 4.1.3 Descrizione + 4.1.4 Ruoli di progetto + Responsabile di progetto + Amministratore di progetto + Analista + Progettista + Programmatore + Verificatore + 4.1.5 Procedure + Gestione delle comunicazioni + Gestione degli incontri + Gesitone degli strumenti di coordinamento + Gestione dei rischi + 4.1.6 Strumenti + + Potrebbero includere formazione 8lab + \ No newline at end of file diff --git a/seminari/C1 - Highlights.md b/seminari/C1 - Highlights.md new file mode 100644 index 0000000..5f83f95 --- /dev/null +++ b/seminari/C1 - Highlights.md @@ -0,0 +1,75 @@ +# C1 - Highlights + + +Upload del video, mappatura del video e successivo transocoding. + +Va bene anche esports. + +- __Sage maker__ input di serie di modelli, dare un insieme di video con degli esempi di cosa succede e capire cosa succedere +- __Dynamo DB__ database per salvare i dati relativi al training + + +AWS --> concetto di regione sul mondo e avaiability zone + +#### S3 + +--> Inserire un oggetto (file) in modo altamente scalabile (le cartelle sono anch'esse oggetti) + +- Alta disponibilità +- Durabilità del 99,9999999% +- Costo bassissimo +- Registra caricamento / rimozione del file per le lambda functions --> event driven development +- Versionamento dei file +- Per ogni evoluzione / versione --> evento apposito per (ad esempio) cancellare versioni successive + + +#### Dynamo DB + +- Costo e funzionalità basate sulle performance +- Full managed +- Operazioni al secondo +- No SQL (documento JSON) +- Molto buono per eventi di singola tabella + +Performance per l'uso della chiave primaria, basse invece per dinamiche di interrogazioni simil join tra le tabelle. + + +Nei NOSQL, replicazione del dato più che relazione. + + +#### AWS Lambda + +Creiamo piccole funzioni di codice che vengono caricate su AWS e si pagano per la singola operazione (cpu usata, ecc.). +Scalare quasi all'infinito, performance maggiori, problemi solo alla singola funzione e non al resto. + +- Stateless, ma con Dynamo DB si può salvare lo stato dell'elaborazione. +- Python o Node (MEGLIO PYTHON !!!) +- Cognito (servizio gestito di autenticazione twitter, google, ecc.) + +Monitoraggio sulle lambda (ram e CPU) per capirne l'ottimizzazione delle funzioni. + + + +### Machine learning + +--> E' qualcosa che insegnamo non che programmiamo [cit. Zero12 2019] + +Dati variabili, non sempre dati strutturati. + +- Informazioni video da analizzare / mappare +- Ripetibilità e velocità durante il cambiamento dei dati + +Supervised learning <-- Machine learning --> Unsupervised learning + +- Diamo dei suggerimenti / labels ai dati e ricavarne il modello di fondo +- Classificazione + +- Bacino di circa 1000 video per andare bene + +#### Validation + +Creare un data set, taggarne il 70% di tutto il dataset e fare la validazione al 30% dei dati rimanente. + +Alternativamente: +- __cross validation__ faccio la validazione su tre step differenti +- __multi layer validation__ 60% di training, 20% di validazione, 20% di test diff --git a/struttura_documenti.md b/struttura_documenti.md new file mode 100644 index 0000000..c2dea2d --- /dev/null +++ b/struttura_documenti.md @@ -0,0 +1,191 @@ +# Struttura dei documenti + +## Studio di fattibilità + +1. Introduzione + - Scopo del documento + - Glossario + - Riferimenti + - Normativi + - Informativi + +2. Valutazione capitolato scelto + - Info generali + - Descrizione capitolato + - Finalità del Progetto + - Tecnologie e Linguaggi di Programmazione + - Aspetti positivi + - Criticità e Fattori di Rischio + - Conclusioni + +3. Valutazione capitolati rimanenti (C1 ... C6) + - Info generali + - Descrizione capitolato + - Finalità del Progetto + - Tecnologie e Linguaggi di Programmazione + - Aspetti positivi + - Criticità e Fattori di Rischio + - Conclusioni + +4. Valutazioni finali (cosa ci ha spinto alla scelta) + + +### Timeline ruoli + +- [x] Alessandro --> Stesura Introduzione, C1, C2, C3 (conclusioni mancanti) +- [x] Giovanni --> Stesura C4, C5, C6 (bozza conclusioni) +- [x] Giuseppe --> Redazione C4, C5 +- [x] Alessandro --> Redazione C6 (parole glossario) +- [ ] Mariano --> Stesura valutazioni finali +- [ ] Lorenzo e Foued --> Revisione totale +- [ ] ??? --> Approvazione + + + +## Norme di progetto + +1. Introduzione + - Scopo del documento + - Scopo del prodotto + - Glossario + - Riferimenti + - Normativi + - Informativi + +2. Processi primari (cfr. ISO 12207) + - Fornitura + - Scopo + - Aspettative + - Descrizione + - Attività + - Studio di fattibilità (riportare descr. documento, idem per altri) + - Piano di progetto + - Piano di qualifica + - Strumenti (strumenti utilizzati) + - Sviluppo + - Scopo + - Aspettative + - Descrizione + - Attività + - Analisi dei requisiti + - Progettazione + - Codifica (subsubsubsubsubsection senza numero) + - Strumenti (strumenti utilizzati) + +> Le norme non considerano la qualità 8lab + +3. Processi di supporto + - Documentazione + - Scopo + - Aspettative + - Descrizione + - Ciclo di vita + - Template LaTeX + - Strutture dei documenti + - Frontespizio + - Registro modifiche + - Indice + - Contenuto principale + - Note a piè di pagina + - Classificazione dei documenti (?, chiedere a Tullio) + - Documenti ufficiosi + - Documenti ufficiale + - Verbali + - Glossario + - Lettere + - Norme tipografiche + - Convenzioni sui nomi dei file + - Glossario + - Stile del testo + - Elenchi puntati + - Formati comuni + - Sigle + - Elementi grafici + - Tabelle + - Immagini + - Diagrammi UML + - Strumenti + - Latex + - TexStudio, TexMaker e TexLive con IDE + - Gestione della configurazione + - Scopo + - Versionamento + - Codice di versionamento + - Tecnologie + - Repository (elenco in basso) + - Struttura + - Utilizzo di git + - Tipi di file e .gitignore + - Gestione delle modifiche + - Garanzia della qualità + - Scopo + - Aspettative + - Descrizione + - Controllo qualità di prodotto + - Controllo qualità di processo + - Classificazione metriche + - Strumenti (? --> es. code coverage) + - Verifica + - Scopo + - Aspettative + - Descrizione + - Attività + - Analisi (statica, dinamica) + - Test (--> elenco di unità, integrazione, sistema, regressione, accettazione) + - Strumenti + - Verifica ortografica + - (strumenti usati in base al capitolato scelto) + + - Validazione + - Scopo + - Aspettative + - Descrizione + - Attività + +4. Processi organizzativi (?) + - Gestione dei processi + - Scopo + - Descrizione + - Ruoli di progetto + - Responsabile di progetto + - Amministratore di progetto + - Analista + - Progettista + - Programmatore + - Verificatore + - Procedure + - Gestione delle comunicazioni + - Gestione degli incontri + - Gestione degli strumenti di coordinamento + - Gestione dei rischi + - Strumenti + + - Formazione del personale + - Scopo + - Descrizione + - Guida sui linguaggi di programmazione + - Guida sugli strumenti di programmazione + - Corsi formativi aggiuntivi (dipende se esiste) + +> Potrebbero includere formazione 8lab + +> Da aggiungere, metriche + + +### Timeline ruoli + +- [ ] Alessandro --> Stesura 1.x Introduzione +- [ ] Foued --> Stesura 2.x Fornitura +- [ ] Giovanni --> Stesura 2.x Sviluppo + 4.x Formazione +- [ ] Giuseppe --> Stesura 3.x Documentazione +- [ ] Nicolò --> Stesura 3.x Verifica e Validazione +- [ ] Mariano --> Stesura 3.x TUTTO IL RESTO +- [ ] Lorenzo --> Stesura 4.x Gestione dei processi +- [ ] Mariano e Giuseppe --> Revisione +- [ ] Alessandro e Nicolò --> Revisione +- [ ] Giovanni --> Approvazione + + +## Verbali + +- [ ] Mariano --> Stesura dei verbali dal markdown al LaTeX \ No newline at end of file diff --git a/template/documenti/main.pdf b/template/documenti/main.pdf new file mode 100644 index 0000000..e631701 Binary files /dev/null and b/template/documenti/main.pdf differ diff --git a/template/documenti/main.tex b/template/documenti/main.tex new file mode 100644 index 0000000..3db3087 --- /dev/null +++ b/template/documenti/main.tex @@ -0,0 +1,92 @@ +% --------------------------- +% [ NOME DOCUMENTO ] +% ---------------------- +% Red Round Robin +% Progetto di SWE (2019-20) +% Template by Maxelweb +% --------------------------- + +% Configurazione primaria del documento + +% -------------- + +\newcommand{\docNome}{ NOME DEL DOCUMENTO } +\newcommand{\docNomeProgetto}{ NOME DEL PROGETTO } +\newcommand{\docVersione}{0.0.0} +\newcommand{\docStatus}{in redazione / approvato} +\newcommand{\docUso}{interno / esterno} +\newcommand{\docDescrizione}{ + Breve descrizione del documento +} + +% -------------- + +\newcommand{\docDestinatari}{ + nome cognome \\& + nome cognome +} +\newcommand{\docRedattori}{ + nome cognome \\& + nome cognome +} +\newcommand{\docVerificatori}{ + nome cognome \\& + nome cognome +} +\newcommand{\docApprovazione}{ + nome cognome +} + +% ----- NON MODIFICARE SOTTO QUESTA RIGA ----- + +% --------------------------- +% Configurazioni +% --------------------------- + +\documentclass[11pt,a4paper,table]{article} + +\input{res/configurazione} + +% --------------------------- +% Dati frontespizio +% --------------------------- + +\title{\hr \huge \textsc{\docNome} \\ + \vspace{11pt} \large \textsc{\docNomeProgetto} \hr} + +\author{} % Non toccare +\date{} % Non toccare + +% --------------------------- +% Composizione del documento +% --------------------------- + +\begin{document} + +% Frontespizio + +\pagenumbering{gobble} +\DeactivateBG +\include{res/frontespizio} + +% Registro delle modifiche + +\newpage +\ActivateBG +\pagenumbering{arabic} +\include{res/registro} + +% Tabella dei contenuti + +\newpage +\tableofcontents + +% Sezioni + +\newpage +\input{res/sezioni} + +\end{document} + + +% EOF \ No newline at end of file diff --git a/template/documenti/res/configurazione.tex b/template/documenti/res/configurazione.tex new file mode 100644 index 0000000..7835697 --- /dev/null +++ b/template/documenti/res/configurazione.tex @@ -0,0 +1,146 @@ + +% Configurazione delle dipendenze e dei package + + +\usepackage{geometry} +\usepackage{graphicx} +\usepackage[T1]{fontenc} +\usepackage[utf8]{inputenc} +\usepackage{charter} +\usepackage{eurosym} +\usepackage[italian]{babel} +\usepackage{float} +\usepackage{subcaption} +\usepackage{wrapfig} +\usepackage{fancyhdr} +\usepackage{lastpage} +\usepackage{amsfonts} +\usepackage{fancyvrb} +\usepackage{background} +\usepackage{xcolor} +\usepackage{hyperref} +\usepackage{listings} +\usepackage{longtable} +\usepackage{colortbl} +\usepackage{tikz} +\usepackage{lipsum} + + +% Impostazioni pagina e margini + +\geometry{ + margin=1.0in, + top=19.2mm, % NON TOCCARE + bottom=30mm, + left=20mm, + right=20mm +} + +% Definizione colori + +\definecolor{footer-gray}{HTML}{808080} +\definecolor{light-gray}{gray}{0.6} +\definecolor{light-grayer}{gray}{0.75} +\definecolor{lighter-grayer}{gray}{0.85} +\definecolor{lightest-grayest}{gray}{0.94} +\definecolor{codegreen}{rgb}{0,0.4,0.2} +\definecolor{codegray}{rgb}{0.5,0.5,0.5} +\definecolor{codepurple}{rgb}{0.58,0,0.82} +\definecolor{backcolour}{rgb}{0.95,0.95,0.96} + + +% Impostazione header e footer + +\pagestyle{fancy} +\setlength\headheight{33pt} +\renewcommand{\headrulewidth}{0pt} +\fancyhead{} +\lhead{\includegraphics[height=10mm]{res/images/logo.png}} +\rhead{\raisebox{1.4\height}{\leftmark}} + + +\renewcommand{\footrulewidth}{0.1pt} +\fancyfoot{} +\lfoot{ \textcolor{footer-gray}{\docNome - v\docVersione} } + +\renewcommand{\footrule}{\hbox to\headwidth{\color{light-grayer}\leaders\hrule height \footrulewidth\hfill}} +\rfoot{ \textcolor{footer-gray}{Pagina \thepage \hspace{1pt} di \pageref*{LastPage}} } + +% Grandezza paragrafi e spaziatura frasi + +\setlength{\parindent}{1.8em} +\setlength{\parskip}{1.2em} +\renewcommand{\baselinestretch}{1.1} + +% Colori link + +\hypersetup{ + colorlinks, + linkcolor=[HTML]{404040}, + citecolor={blue!50!black}, + urlcolor={red!50!black} +} +\PassOptionsToPackage{hyphens}{url}\usepackage{hyperref} + +% Equivalente a
+ +\newcommand{\hr}{\par\vspace{-.1\ht\strutbox}\noindent\hrulefill\par} + +% Tabelle e tabulazione + +\setlength{\tabcolsep}{10pt} +\renewcommand{\arraystretch}{1.4} + +% Unicode per simbolo euro + +\DeclareUnicodeCharacter{20AC}{\euro} + +% Configurazione sfondo + +\newcommand\DeactivateBG{\backgroundsetup{contents={}}} +\newcommand\ActivateBG{ \backgroundsetup{ + scale=1.0, + color=black, + opacity=1.0, + angle=0, + contents={% + \includegraphics[height=297mm]{res/images/background.png} + }% +}} + +% Codice e snippet + +\renewcommand{\lstlistingname}{Snippet} +\renewcommand{\lstlistlistingname}{Lista di \lstlistingname s} + + +\lstdefinestyle{chungusHighlight}{ + frame=tb, + backgroundcolor=\color{backcolour}, + commentstyle=\color{codegreen}, + keywordstyle=\color{magenta}\textbf, + numberstyle=\color{codegray}, + stringstyle=\color{codepurple}, + basicstyle={\ttfamily}, + breakatwhitespace=false, + breaklines=true, + captionpos=b, + keepspaces=true, + numbers=left, + numbersep=5pt, + showspaces=false, + showstringspaces=false, + showtabs=false, + numbers=none, + tabsize=2 +} + +\lstset{style=chungusHighlight} + + +% Comando per aggiungere le pagine di ogni sezione + +\newcommand{\yetAnotherSectionNamed}[1]{% + \newpage + \input{res/sections/#1} +}% diff --git a/template/documenti/res/frontespizio.tex b/template/documenti/res/frontespizio.tex new file mode 100644 index 0000000..3664bf5 --- /dev/null +++ b/template/documenti/res/frontespizio.tex @@ -0,0 +1,56 @@ + +% FRONTESPIZIO + +% Logo aziendale + +\begin{figure}[t!] + \centering + \includegraphics[height=10em]{res/images/logo.png} +\end{figure} + + +% Titolo principale + +\maketitle +\thispagestyle{empty} + + +% Riferimenti email e sito web + +\vspace{-6em} + +\begin{center} + \href{https://www.redroundrobin.site}{www.redroundrobin.site} --- \href{mailto:info@redroundrobin.site}{info@redroundrobin.site} +\end{center} + +\vspace{2em} + +% Informazioni documento + +\begin{table}[ht] + \begin{center} + \label{tab:Informazioni_Documento} + \begin{tabular}{r|l} + \multicolumn{2}{c}{ \textsc{Informazioni sul documento} } \\ + \hline + \textbf{Versione} & \docVersione \\ + \textbf{Uso} & \docUso \\ + \textbf{Stato} & \docStatus \\ + \textbf{Destinatari} & \docDestinatari \\ + \textbf{Redattori} & \docRedattori \\ + \textbf{Verificatori} & \docVerificatori \\ + \textbf{Approvazione} & \docApprovazione \\ + \end{tabular} + \end{center} +\end{table} + + +% Descrizione del documento + +\vspace{0em} + +\begin{center} + \textbf{Descrizione}\\ + \docDescrizione +\end{center} + diff --git a/template/documenti/res/images/background.png b/template/documenti/res/images/background.png new file mode 100644 index 0000000..9dcca68 Binary files /dev/null and b/template/documenti/res/images/background.png differ diff --git a/template/documenti/res/images/logo.png b/template/documenti/res/images/logo.png new file mode 100644 index 0000000..32071fe Binary files /dev/null and b/template/documenti/res/images/logo.png differ diff --git a/template/documenti/res/registro.tex b/template/documenti/res/registro.tex new file mode 100644 index 0000000..3659281 --- /dev/null +++ b/template/documenti/res/registro.tex @@ -0,0 +1,20 @@ +\section*{Registro delle modifiche} + +\begin{center} + \rowcolors{2}{lightest-grayest}{white} + \begin{longtable}{|c|c|c|c|c|} + \hline + \rowcolor{lighter-grayer} + \textbf{Versione} & \textbf{Descrizione} & \textbf{Data} & \textbf{Autore} & \textbf{Ruolo} \\ + \hline + \endfirsthead + + % ----- Modificare da qui ----- + + 0.0.2 & Revisione documento & 24-11-2019 & Nome Cognome & Verificatore \\ + \hline + 0.0.1 & Creazione documento & 23-11-2019 & Nome Cognome & Redattore \\ + \hline + + \end{longtable} +\end{center} \ No newline at end of file diff --git a/template/documenti/res/sections/introduzione.tex b/template/documenti/res/sections/introduzione.tex new file mode 100644 index 0000000..3894917 --- /dev/null +++ b/template/documenti/res/sections/introduzione.tex @@ -0,0 +1,40 @@ +\section{Introduzione} + +\subsection{Hello world} + +Come va la vita? Non bene se stiamo facendo SWE. + +\begin{itemize} + \item Ciao 1 + \item Ciao 2 + \item Ciao 3 +\end{itemize} + +\lipsum[3-5] + + +\begin{itemize} + \item Ciao2 + \begin{itemize} + \item Ciao2 + \begin{itemize} + \item ciaone + \begin{itemize} + \item ciaone2 + \end{itemize} + \end{itemize} + \end{itemize} +\end{itemize} + + +\section{Pinco Pallo col suo Pallone} + +\begin{enumerate} + \item ciao + \begin{enumerate} + \item ciaone + \begin{enumerate} + \item ciaoooooneeee + \end{enumerate} + \end{enumerate} +\end{enumerate} \ No newline at end of file diff --git a/template/documenti/res/sezioni.tex b/template/documenti/res/sezioni.tex new file mode 100644 index 0000000..3b6fe24 --- /dev/null +++ b/template/documenti/res/sezioni.tex @@ -0,0 +1,7 @@ +% ----------------------- +% Sezioni da inserire +% ----------------------- +% Pro tip: usare il comando \yetAnotherSectionNamed{nome_file} + + +\yetAnotherSectionNamed{introduzione} diff --git a/template/templateGlossario/glossario.txt b/template/templateGlossario/glossario.txt new file mode 100644 index 0000000..a29f91f --- /dev/null +++ b/template/templateGlossario/glossario.txt @@ -0,0 +1,12 @@ +Prendere da esempio il glossario di 8Lab. In particolare capire come +va scritto il template per ottenere quella tableofcontent e come centrare +il nome di ogni sezione (es. "Lettera A") prima di iniziare a definire i termini relativi. +Per la definizione di ogni termine, basta fare: + +\textbf{termineDaDefinire} \\ \\ +definizione del termine + +\textbf{termineDaDefinire} \\ \\ +definizione del termine + +... and so on. diff --git a/template/templateLettera/prototipoLettere.pdf b/template/templateLettera/prototipoLettere.pdf new file mode 100644 index 0000000..3936eaa Binary files /dev/null and b/template/templateLettera/prototipoLettere.pdf differ diff --git a/template/templateLettera/prototipoLettere.tex b/template/templateLettera/prototipoLettere.tex new file mode 100644 index 0000000..8de3050 --- /dev/null +++ b/template/templateLettera/prototipoLettere.tex @@ -0,0 +1,55 @@ +\documentclass[12pt]{letter} +\usepackage[utf8]{inputenc} +\usepackage{graphicx} + +\signature{Mariano Sciacco \\ + \textit{Responsabile di Progetto}} +\address{ Via Trieste 63 \\ Padova \\ PD 35121, Italia} + + +\begin{letter} +{ + Prof. Vardanega Tullio \\ + Prof. Cardin Riccardo +} + +\begin{document} + + \begin{figure} + \centering + \includegraphics[scale=0.17]{../res/images/logo} + \end{figure} + +\opening{Carissimi,} + +Con la presente si comunica che il gruppo +\textit{Red Round Robin} intende comunicarLe il proprio +impegno nel realizzare il seguente prodotto da Lei +commissionato: + +\textbf{Quale capitolato scegliamo, regà?} + +proposto dall'azienda \textit{Swag for life}. In allegato +le forniamo tutti i documenti della nostra offerta: + +\begin{itemize} + \item \textit{Analisi dei Requisiti v1.0.0}; + \item \textit{Glossario v1.0.0}; + \item \textit{Norme di Progetto v1.0.0}; + \item \textit{Studio di Fattibilità v1.0.0}; + \item \textit{elenco di ogni verbale v1.0.0}. +\end{itemize} + +\newpage + +Come descritto nel documento Piano di Progetto v1.0.0, +il gruppo ha preso l'impegno di consegnare il +prodotto richiesto entro il 2019-05-17, ovvero la prima data fissata per la Revisione di Accettazione, preventivando costi per un importo totale di 15.132,00euri. Rimaniamo a Sua completa disposizione per qualsiasi chiarimento. + +\closing{Cordialmente,} +\vspace{10mm} + + +\end{letter} + +\end{document} \ No newline at end of file diff --git a/template/templateVerbali/verbali.txt b/template/templateVerbali/verbali.txt new file mode 100644 index 0000000..b424185 --- /dev/null +++ b/template/templateVerbali/verbali.txt @@ -0,0 +1,7 @@ +Il template di Mariano va più che bene per redigere i verbali, a meno di aggiungere una tabella alla fine +di ognuno, in una pagina nuova con sezione "\section{Riepilogo Tracciamenti}" come titolo, in cui ogni riga +rappresenta una scelta presa in quell'incontro. Ogni riga ha 2 colonne: "Codice" e "Decisione presa". +Per indicizzare una "Decisione presa", La relativa cella "Codice" ha il seguente formato: VX_N.D, dove: + - X: assume il valore "I" o "E" a seconda che il verbale sia rispettivamente interno o esterno; + - N: rappresenta il numero del verbale (1= primo verbale, 2= secondo verbale and so on); + - D: rappresenta il numero della decisione presa in quel verbale. diff --git a/template/verbali/main.pdf b/template/verbali/main.pdf new file mode 100644 index 0000000..32107a3 Binary files /dev/null and b/template/verbali/main.pdf differ diff --git a/template/verbali/main.tex b/template/verbali/main.tex new file mode 100644 index 0000000..acdb099 --- /dev/null +++ b/template/verbali/main.tex @@ -0,0 +1,81 @@ +% --------------------------- +% [ Verbale ] +% ---------------------- +% Red Round Robin +% Progetto di SWE (2019-20) +% Template by Maxelweb +% --------------------------- + +% Configurazione primaria del documento + +% -------------- + +\newcommand{\docNome}{ VERBALE RIUNIONE \#1 } +\newcommand{\docVersione}{0.0.1} +\newcommand{\docNomeProgetto}{ 01 gennaio 1970 } +\newcommand{\docStatus}{in redazione} +\newcommand{\docUso}{interno} + +% -------------- + +\newcommand{\docRedattori}{ + nome cognome \\& + nome cognome +} +\newcommand{\docVerificatori}{ + nome cognome \\& + nome cognome +} +\newcommand{\docApprovazione}{ + nome cognome +} + +% ----- NON MODIFICARE SOTTO QUESTA RIGA ----- + +% --------------------------- +% Configurazioni +% --------------------------- + +\documentclass[11pt,a4paper,table]{article} + +\input{res/configurazione} + +% --------------------------- +% Dati frontespizio +% --------------------------- + +\title{\hr \huge \textsc{\docNome} \\ + \vspace{11pt} \large \textsc{\docNomeProgetto} \hr} + +\author{} % Non toccare +\date{} % Non toccare + +% --------------------------- +% Composizione del documento +% --------------------------- + +\begin{document} + +% Frontespizio + +\pagenumbering{gobble} +\DeactivateBG +\include{res/frontespizio} + +% Registro delle modifiche + +\newpage +\ActivateBG +\pagenumbering{Roman} +\include{res/registro} + + +% Contenuto + +\newpage +\input{res/contenuto} + +\end{document} + + +% EOF \ No newline at end of file diff --git a/template/verbali/res/configurazione.tex b/template/verbali/res/configurazione.tex new file mode 100644 index 0000000..eda42a9 --- /dev/null +++ b/template/verbali/res/configurazione.tex @@ -0,0 +1,145 @@ + +% Configurazione delle dipendenze e dei package + + +\usepackage{geometry} +\usepackage{graphicx} +\usepackage[T1]{fontenc} +\usepackage[utf8]{inputenc} +\usepackage{charter} +\usepackage{eurosym} +\usepackage[italian]{babel} +\usepackage{float} +\usepackage{subcaption} +\usepackage{wrapfig} +\usepackage{fancyhdr} +\usepackage{lastpage} +\usepackage{amsfonts} +\usepackage{fancyvrb} +\usepackage{background} +\usepackage{xcolor} +\usepackage{hyperref} +\usepackage{listings} +\usepackage{longtable} +\usepackage{colortbl} +\usepackage{tikz} + + +% Impostazioni pagina e margini + +\geometry{ + margin=1.0in, + top=19.2mm, % NON TOCCARE + bottom=30mm, + left=20mm, + right=20mm +} + +% Definizione colori + +\definecolor{footer-gray}{HTML}{808080} +\definecolor{light-gray}{gray}{0.6} +\definecolor{light-grayer}{gray}{0.75} +\definecolor{lighter-grayer}{gray}{0.85} +\definecolor{lightest-grayest}{gray}{0.94} +\definecolor{codegreen}{rgb}{0,0.4,0.2} +\definecolor{codegray}{rgb}{0.5,0.5,0.5} +\definecolor{codepurple}{rgb}{0.58,0,0.82} +\definecolor{backcolour}{rgb}{0.95,0.95,0.96} + + +% Impostazione header e footer + +\pagestyle{fancy} +\setlength\headheight{33pt} +\renewcommand{\headrulewidth}{0pt} +\fancyhead{} +\lhead{\includegraphics[height=10mm]{res/images/logo.png}} +\rhead{\raisebox{1.4\height}{\leftmark}} + + +\renewcommand{\footrulewidth}{0.1pt} +\fancyfoot{} +\lfoot{ \textcolor{footer-gray}{\docNome - v\docVersione} } + +\renewcommand{\footrule}{\hbox to\headwidth{\color{light-grayer}\leaders\hrule height \footrulewidth\hfill}} +\rfoot{ \textcolor{footer-gray}{Pagina \thepage \hspace{1pt} di \pageref*{LastPage}} } + +% Grandezza paragrafi e spaziatura frasi + +\setlength{\parindent}{1.8em} +\setlength{\parskip}{1.2em} +\renewcommand{\baselinestretch}{1.1} + +% Colori link + +\hypersetup{ + colorlinks, + linkcolor=[HTML]{404040}, + citecolor={blue!50!black}, + urlcolor={red!50!black} +} +\PassOptionsToPackage{hyphens}{url}\usepackage{hyperref} + +% Equivalente a
+ +\newcommand{\hr}{\par\vspace{-.1\ht\strutbox}\noindent\hrulefill\par} + +% Tabelle e tabulazione + +\setlength{\tabcolsep}{10pt} +\renewcommand{\arraystretch}{1.4} + +% Unicode per simbolo euro + +\DeclareUnicodeCharacter{20AC}{\euro} + +% Configurazione sfondo + +\newcommand\DeactivateBG{\backgroundsetup{contents={}}} +\newcommand\ActivateBG{ \backgroundsetup{ + scale=1.0, + color=black, + opacity=1.0, + angle=0, + contents={% + \includegraphics[height=297mm]{res/images/background.png} + }% +}} + +% Codice e snippet + +\renewcommand{\lstlistingname}{Snippet} +\renewcommand{\lstlistlistingname}{Lista di \lstlistingname s} + + +\lstdefinestyle{chungusHighlight}{ + frame=tb, + backgroundcolor=\color{backcolour}, + commentstyle=\color{codegreen}, + keywordstyle=\color{magenta}\textbf, + numberstyle=\color{codegray}, + stringstyle=\color{codepurple}, + basicstyle={\ttfamily}, + breakatwhitespace=false, + breaklines=true, + captionpos=b, + keepspaces=true, + numbers=left, + numbersep=5pt, + showspaces=false, + showstringspaces=false, + showtabs=false, + numbers=none, + tabsize=2 +} + +\lstset{style=chungusHighlight} + + +% Comando per aggiungere le pagine di ogni sezione + +\newcommand{\yetAnotherSectionNamed}[1]{% + \newpage + \input{res/sections/#1} +}% diff --git a/template/verbali/res/contenuto.tex b/template/verbali/res/contenuto.tex new file mode 100644 index 0000000..2821020 --- /dev/null +++ b/template/verbali/res/contenuto.tex @@ -0,0 +1,9 @@ +\section{Introduzione} + +\subsection{Ordine del giorno} + +\subsection{Luogo e data dell'incontro} + +\section{Svolgimento} + +\subsection{Punto ordine del giorno} \ No newline at end of file diff --git a/template/verbali/res/frontespizio.tex b/template/verbali/res/frontespizio.tex new file mode 100644 index 0000000..911b1b2 --- /dev/null +++ b/template/verbali/res/frontespizio.tex @@ -0,0 +1,47 @@ + +% FRONTESPIZIO + +% Logo aziendale + +\begin{figure}[t!] + \centering + \includegraphics[height=10em]{res/images/logo.png} +\end{figure} + + +% Titolo principale + +\maketitle +\thispagestyle{empty} + + +% Riferimenti email e sito web + +\vspace{-6em} + +\begin{center} + \href{https://www.redroundrobin.site}{www.redroundrobin.site} --- \href{mailto:info@redroundrobin.site}{info@redroundrobin.site} +\end{center} + +\vspace{3em} + +% Informazioni documento + +\begin{table}[ht] + \begin{center} + \label{tab:Informazioni_Documento} + \begin{tabular}{r|l} + \multicolumn{2}{c}{ \textsc{Informazioni sul documento} } \\ + \hline + \textbf{Versione} & \docVersione \\ + \textbf{Uso} & \docUso \\ + \textbf{Stato} & \docStatus \\ + \textbf{Redattori} & \docRedattori \\ + \textbf{Verificatori} & \docVerificatori \\ + \textbf{Approvazione} & \docApprovazione \\ + \end{tabular} + \end{center} +\end{table} + + + diff --git a/template/verbali/res/images/background.png b/template/verbali/res/images/background.png new file mode 100644 index 0000000..9dcca68 Binary files /dev/null and b/template/verbali/res/images/background.png differ diff --git a/template/verbali/res/images/logo.png b/template/verbali/res/images/logo.png new file mode 100644 index 0000000..32071fe Binary files /dev/null and b/template/verbali/res/images/logo.png differ diff --git a/template/verbali/res/registro.tex b/template/verbali/res/registro.tex new file mode 100644 index 0000000..11d9f96 --- /dev/null +++ b/template/verbali/res/registro.tex @@ -0,0 +1,20 @@ +\section*{Registro delle modifiche} + +\begin{center} + \rowcolors{2}{lightest-grayest}{white} + \begin{longtable}{|c|c|c|c|c|} + \hline + \rowcolor{lighter-grayer} + \textbf{Versione} & \textbf{Descrizione} & \textbf{Data} & \textbf{Autore} & \textbf{Ruolo} \\ + \hline + \endfirsthead + + % ----- Modificare da qui ----- + + % 0.0.2 & Revisione documento & 24-11-2019 & Nome Cognome & Verificatore \\ + \hline + 0.0.1 & Creazione iniziale del documento & 02-12-2019 & Mariano Sciacco & Redattore \\ + \hline + + \end{longtable} +\end{center} \ No newline at end of file diff --git a/way_of_working.md b/way_of_working.md new file mode 100644 index 0000000..eba1de0 --- /dev/null +++ b/way_of_working.md @@ -0,0 +1,28 @@ +# Way of working generale + +### Workflow di Github + +- Release branch: __master__ +- Develop e fix branch: __develop__ +- Feature branches (base __develop__): __feature/nomeFeature__ + +> Ciascuna feature viene eliminata automaticamente dopo il pull request +> __develop__ è protetto dalla cancellazione + +> Ad ogni pull request ci sarà la CI di controllo della formattazione del codice (ritorno a capo, tab, ecc.) + + +### Progetti delle repository + +- Un progetto per ogni revisione. +- Ciascun progetto avrà più milestone. +- A ciascuna milestone cerchiamo di ruotare i ruoli. + + +### Comunicazioni + +- __Slack__: utilizzare i canali con il relativo documento. +- __Telegram e Google Calendar__: comunicazioni relative agli incontri. +- __Issue tracking system (github)__: commenti sulle issue e uso dei cancelletti per riferire ad ogni commit una issue (ricordarsi il CLOSE). + +