diff --git a/KSS-Dokumentation/Doku_Microservice_Warenwirtschaft/Doku_Microservice_Warenwirtschaft_MLabusch_MMuller.tex b/KSS-Dokumentation/Doku_Microservice_Warenwirtschaft/Doku_Microservice_Warenwirtschaft_MLabusch_MMuller.tex index 4f6b0bd..f15847c 100644 --- a/KSS-Dokumentation/Doku_Microservice_Warenwirtschaft/Doku_Microservice_Warenwirtschaft_MLabusch_MMuller.tex +++ b/KSS-Dokumentation/Doku_Microservice_Warenwirtschaft/Doku_Microservice_Warenwirtschaft_MLabusch_MMuller.tex @@ -29,13 +29,15 @@ \input{./Kapitel/DokStruktur} \newpage \input{./Kapitel/Anforderungen} \newpage \input{./Kapitel/Struktur} \newpage +\input{./Kapitel/Implementierungsregeln}\newpage \input{./Kapitel/Testfalle} \newpage \clearpage \appendix \phantomsection -\addcontentsline{toc}{section}{\appendixname} +\addcontentsline{toc}{section}{\appendixname} +\input{./Kapitel/GettingStarted} \newpage \input{./Kapitel/Handout} \newpage \input{./Kapitel/Testprotokoll} diff --git a/KSS-Dokumentation/Doku_Microservice_Warenwirtschaft/Kapitel/DokStruktur.tex b/KSS-Dokumentation/Doku_Microservice_Warenwirtschaft/Kapitel/DokStruktur.tex index e0edf4f..8600966 100644 --- a/KSS-Dokumentation/Doku_Microservice_Warenwirtschaft/Kapitel/DokStruktur.tex +++ b/KSS-Dokumentation/Doku_Microservice_Warenwirtschaft/Kapitel/DokStruktur.tex @@ -2,4 +2,4 @@ \label{sec: Dokumentationsstruktur} Für die Dokumentation des Microservice Warenwirtschaft wurden eine Kombination aus zwei Dokumenten gewählt. Zum einen beschreibt ein Handout auf einer Seite die Funktionen des Admin-Frontends für den Benutzer. Diese sehr kurze Dokumentenform wurde gewählt, da Benutzer häufig nicht gewillt sind, umfangreiche Anleitungen zu lesen um eine Anwendung nutzen zu können. Vielmehr wollen sie schnell einen Überblick der Kernfunktionalitäten erhalten. Zu diesem Zweck arbeitet das Handout mit einem aufbereiteten Screenshot des Admin-Frontends und einer Beschreibung der Funktionen in Stichpunkten. \par -Auf der anderen Seite muss der Microservie auch für Entwickler dokumentiert sein, hierfür wurde diese Dokumentation angelegt. Sie beginn anstelle eines Abstract mit einem Steckbrief des Microservice, der dessen grundlegende Struktur und Funktionalität kurz beschreibt. In dem eigentlichen Dokument werden dann zunächst die Anforderungen an den Microservice beschrieben, da ihre Umsetzung das primäre Ziel der Entwicklung ist. Weiter werden der Microservice und seine Code-Struktur detaillierter beschrieben sowie die gewählten Blackbox-Testfälle dokumentiert. Der Anhang dieser Dokumentation umfasst das Handout des Admin-Frontends sowie ein beispielhaftes Testprotokoll. Auf Details wir ein Abkürzungs- oder Literaturverzeichnis wurde in dieser Dokumention bewusst verzichtet, um sie kurz zu halten. Zitate und Verweise werden hier in Form von Fußnoten integriert. \ No newline at end of file +Auf der anderen Seite muss der Microservie auch für Entwickler dokumentiert sein, hierfür wurde diese Dokumentation angelegt. Sie beginn anstelle eines Abstract mit einem Steckbrief des Microservice, der dessen grundlegende Struktur und Funktionalität kurz beschreibt. In dem eigentlichen Dokument werden dann zunächst die Anforderungen an den Microservice beschrieben, da ihre Umsetzung das primäre Ziel der Entwicklung ist. Weiter werden der Microservice mit seinem Aufbau, den Schnittstellen und der Anpassung des gegebenen Monolithen beschrieben. Es folgt die Dokumentation von Implementierungsregeln und der gewählten Blackbox-Testfälle. Der Anhang dieser Dokumentation umfasst einen Anleitung für den Start des Microservice, das Handout des Admin-Frontends sowie ein beispielhaftes Testprotokoll. Auf Details wir ein Abkürzungs- oder Literaturverzeichnis wurde in dieser Dokumention bewusst verzichtet, um sie kurz zu halten. Zitate und Verweise werden hier in Form von Fußnoten integriert. \ No newline at end of file diff --git a/KSS-Dokumentation/Doku_Microservice_Warenwirtschaft/Kapitel/GettingStarted.tex b/KSS-Dokumentation/Doku_Microservice_Warenwirtschaft/Kapitel/GettingStarted.tex new file mode 100644 index 0000000..c1526f3 --- /dev/null +++ b/KSS-Dokumentation/Doku_Microservice_Warenwirtschaft/Kapitel/GettingStarted.tex @@ -0,0 +1,2 @@ +\section{Getting Started} +\label{sec: Getting Started} diff --git a/KSS-Dokumentation/Doku_Microservice_Warenwirtschaft/Kapitel/Implementierungsregeln.tex b/KSS-Dokumentation/Doku_Microservice_Warenwirtschaft/Kapitel/Implementierungsregeln.tex new file mode 100644 index 0000000..7b9d4df --- /dev/null +++ b/KSS-Dokumentation/Doku_Microservice_Warenwirtschaft/Kapitel/Implementierungsregeln.tex @@ -0,0 +1,2 @@ +\section{Implementierungsregeln} +\label{sec: Implementierungsregeln} diff --git a/KSS-Dokumentation/Doku_Microservice_Warenwirtschaft/Kapitel/Struktur.tex b/KSS-Dokumentation/Doku_Microservice_Warenwirtschaft/Kapitel/Struktur.tex index 587b814..b48ea6d 100644 --- a/KSS-Dokumentation/Doku_Microservice_Warenwirtschaft/Kapitel/Struktur.tex +++ b/KSS-Dokumentation/Doku_Microservice_Warenwirtschaft/Kapitel/Struktur.tex @@ -1,5 +1,5 @@ -\section{Struktur des Microservice} -\label{sec: Struktur des Microservice} +\section{Architektur des Microservice} +\label{sec: Architektur des Microservice} \begin{figure}[H] \begin{center} @@ -15,6 +15,9 @@ \item \textcolor{red}{ToDo: kurze Beschreibung der Programmstruktur und genauere Beschreibung der Einzelteile in Unterkapiteln} \end{itemize} +\subsection{Schnittstellen} +\label{subsec: Schnittstellen} + \subsection{Presentation Layer} \label{subsec: Presentation Layer}