diff --git a/appendix/appendix-tables.tex b/appendix/appendix-tables.tex index 7ecd1db..b000c09 100644 --- a/appendix/appendix-tables.tex +++ b/appendix/appendix-tables.tex @@ -1,2 +1,64 @@ -% TODO: Zeitplan Soll/Ist, Backlog (PBI-Tabelle), PR-Übersicht, -% Anforderungsmatrix, Dokumententypen↔Ordner↔Icon, Lookup-Trade-offs, Beteiligte +\begin{table}[H] +\centering +\small +\begin{tabularx}{\textwidth}{@{} l X c c l @{}} +\toprule +\textbf{ID} & \textbf{Titel} & \textbf{Aufwand} & \textbf{Sprint} & \textbf{Status} \\ +\midrule +9295 & Document Explorer & 8 & 15.2026 & Dev Completed \\ +9549 & Icon Typen UI & 3 & 15.2026 & Test Completed \\ +9298 & Suchfunktion im Document Explorer & 3 & 15.2026 & Test Completed \\ +9299 & Einzelne Dokumente herunterladen & 3 & 15.2026 & Dev Completed \\ +9296 & Mehrere Dokumente als ZIP runterladen & 5 & 15.2026 & Dev Completed \\ +9300 & PDF Modal Previewer & 3 & 15.2026 & Dev Completed \\ +9294 & Document Link previews UI & 5 & 15.2026 & Test Completed \\ +9301 & Support für URL-Dateien & 5 & 15.2026 & Dev Completed \\ +\addlinespace +9749 & Nach Dokumenttypen filtern & 2 & 16.2026 & Dev Completed \\ +9731 & Pagination im Document Explorer & 3 & 16.2026 & Dev Completed \\ +9857 & Recherche: Anfrage Objects nach S3 optimieren & --- & 16.2026 & Dev Completed \\ +9560 & Automatische Anlage der Ordnerstruktur & 3 & 16.2026 & Committed \\ +10018 & Kundenordner-Lookup über Efecte-Namen & 3 & 16.2026 & Committed \\ +\addlinespace +10070 & Race Conditions im Kundenordner-Lookup & \multicolumn{1}{c}{\footnotesize Timebox} & --- & Approved \\ +10134 & \emph{Bug:} Suchfunktion wie auf den anderen Seiten & --- & 17.2026 & To Approve \\ +\bottomrule +\end{tabularx} +\caption{Product Backlog Items des Features 484 „Dokumente"} +\label{tab:backlog} +\end{table} + +\vfill + +\begin{table}[H] +\centering +\small +\begin{tabularx}{\textwidth}{@{} l X l @{}} +\toprule +\textbf{Anforderung} & \textbf{Kurzbeschreibung} & \textbf{PBI} \\ +\midrule +FA-1 & Dokumentenliste auf \texttt{/documents} & 9295 \\ +FA-2 & Mandantentrennung über \texttt{efecte-org-id} & 9295 \\ +FA-3 & Rollenbasierter Zugriff, 403 ohne Berechtigung & 9295 \\ +FA-4 & Typisierung und Icons & 9549 \\ +FA-5 & Serverseitige Suche nach Titel & 9298 \\ +FA-6 & Filter nach Dokumententyp & 9749 \\ +FA-7 & Paginierung mit wählbarer Seitengröße & 9731 \\ +FA-8 & Einzeldownload über Pre-Signed URL & 9299 \\ +FA-9 & ZIP-Download mehrerer Dokumente & 9296 \\ +FA-10 & PDF-Vorschau im Modal & 9300 \\ +FA-11 & Share-Links mit OpenGraph-Vorschau & 9294 \\ +FA-12 & Unterstützung von \texttt{.url}-Dateien & 9301 \\ +FA-13 & Automatische Anlage der Ordnerstruktur & 9560 \\ +\addlinespace +NFA-1 & Skalierbarkeit des Kundenordner-Lookups & 9857, 10018 \\ +NFA-2 & Verständliche Fehlerbehandlung & 9295 \\ +NFA-3 & Leerer Zustand bei fehlenden Dokumenten & 9295 \\ +NFA-4 & Konsistenz zur bestehenden Oberfläche & 9731, 10134 \\ +NFA-5 & Testbarkeit mit gemocktem \texttt{IAmazonS3} & 10018 \\ +NFA-6 & Pfadsicherheit beim Download & 9299 \\ +\bottomrule +\end{tabularx} +\caption{Zuordnung der Anforderungen zu den Product Backlog Items} +\label{tab:requirements} +\end{table} diff --git a/chapters/overview/initial-situation.tex b/chapters/overview/initial-situation.tex index a20c310..aff47b4 100644 --- a/chapters/overview/initial-situation.tex +++ b/chapters/overview/initial-situation.tex @@ -1,15 +1,12 @@ \section{Ausgangssituation} \label{sec:initial-situation} -\section{Ausgangssituation} -\label{sec:initial-situation} - Die Idee, Kunden über Houston Zugang zu ihren Dokumenten zu ermöglichen, besteht seit November 2023: \emph{Nicole Kimmel} legte damals das Feature~484 „Dokumente" mit zwei Stichpunkten an — „Vertrag, Betriebshandbuch, Feinkonzepte an zentraler Stelle abgelegt" und „Rechnungen einsehbar". Diese Notiz blieb über zweieinhalb Jahre nahezu unverändert im Backlog und spiegelt die damaligen Bedürfnisse wider, ohne einen konkreten Lösungsansatz zu beschreiben. -Zum Zeitpunkt des Projektbeginns im Sommer 2026 gab es keinen strukturierten Prozess, über den Kunden selbstständig auf ihre Dokumente zugreifen konnten. Verträge, Berichte und ähnliche Unterlagen wurden punktuell per E‑Mail oder über Dateiablagen bereitgestellt. Daraus ergaben sich mehrere Probleme: +Zum Zeitpunkt des Projektbeginns im Sommer 2026 gab es keinen strukturierten Prozess, über den Kunden selbstständig auf ihre Dokumente zugreifen konnten. Verträge, Berichte und ähnliche Unterlagen wurden punktuell per E-Mail oder über Dateiablagen bereitgestellt. Daraus ergaben sich mehrere Probleme: \begin{itemize} - \item \textbf{Fehlende Zentralisierung:} Dokumente lagen verteilt in E‑Mails, Dateiablagen und lokalen Verzeichnissen ohne einheitlichen Zugangspunkt. + \item \textbf{Fehlende Zentralisierung:} Dokumente lagen verteilt in E-Mails, Dateiablagen und lokalen Verzeichnissen ohne einheitlichen Zugangspunkt. \item \textbf{Kein Self-Service für Kunden:} Kunden mussten Dokumente aktiv anfordern, anstatt sie eigenständig abrufen zu können. \item \textbf{Kein strukturierter Überblick:} Eine Übersicht nach Dokumententypen oder zeitlichem Verlauf war nicht vorhanden. \item \textbf{Kein sicherer, mandantengetrennter Zugriff:} Es existierte kein technischer Mechanismus, der sicherstellte, dass ein Kunde ausschließlich seine eigenen Dokumente einsehen konnte. diff --git a/chapters/overview/participants.tex b/chapters/overview/participants.tex index c9c667c..4b15918 100644 --- a/chapters/overview/participants.tex +++ b/chapters/overview/participants.tex @@ -1,6 +1,3 @@ -\section{Beteiligte und Rollen} -\label{sec:participants} - \section{Projektbeteiligte} \label{sec:participants} diff --git a/chapters/overview/project-description.tex b/chapters/overview/project-description.tex index 666a9b3..020419a 100644 --- a/chapters/overview/project-description.tex +++ b/chapters/overview/project-description.tex @@ -1,12 +1,9 @@ \section{Projektbeschreibung} \label{sec:project-description} -\section{Projektbeschreibung} -\label{sec:project-description} - Das Projekt \emph{Houston Dokumente} hat zum Ziel, Kunden im Kundenportal Houston einen zentralen Bereich bereitzustellen, in dem sie ihre Dokumente einsehen und herunterladen können. Die Dokumente werden in einem S3-Speichersystem abgelegt und gepflegt; den Kunden werden sie über eine neue Houston-Seite zugänglich gemacht. -Bisher existierte kein einheitlicher, zentraler Zugangspunkt für kundenbezogene Dokumente wie Verträge, Berichte oder Protokolle. Diese wurden punktuell per E‑Mail oder Dateiablage bereitgestellt und waren für Kunden nicht selbstständig abrufbar. Die neue Dokumentenseite in Houston löst diese Situation ab: Mitarbeiter pflegen die Dokumente über ein internes Dateiverwaltungswerkzeug direkt im S3-Speicher, Kunden können sie anschließend strukturiert abrufen. +Bisher existierte kein einheitlicher, zentraler Zugangspunkt für kundenbezogene Dokumente wie Verträge, Berichte oder Protokolle. Diese wurden punktuell per E-Mail oder Dateiablage bereitgestellt und waren für Kunden nicht selbstständig abrufbar. Die neue Dokumentenseite in Houston löst diese Situation ab: Mitarbeiter pflegen die Dokumente über ein internes Dateiverwaltungswerkzeug direkt im S3-Speicher, Kunden können sie anschließend strukturiert abrufen. Der Dokumentenbereich unterscheidet sieben fachlich definierte Dokumententypen — darunter Service-Protokolle, SLA-Reports, Monitoring Reports und Vertragsunterlagen — und gliedert die Anzeige anhand dieser Typen. Darüber hinaus umfasst das Projekt eine Suchfunktion, Filter nach Dokumententyp, Paginierung, einen PDF-Viewer, den Download einzelner Dateien sowie das Herunterladen mehrerer Dokumente als ZIP-Archiv. Zusätzlich werden sogenannte URL-Dateien unterstützt, mit denen beliebige Webadressen — etwa Links zu Teams-Kanälen oder SharePoint-Seiten — in der Dokumentenliste verknüpft werden können. diff --git a/chapters/overview/project-scope.tex b/chapters/overview/project-scope.tex index edeaa23..880ea36 100644 --- a/chapters/overview/project-scope.tex +++ b/chapters/overview/project-scope.tex @@ -1,9 +1,6 @@ \section{Projektabgrenzung} \label{sec:project-scope} -\section{Projektabgrenzung} -\label{sec:project-scope} - Folgende Punkte sind explizit \emph{nicht} Bestandteil des Projekts: \begin{itemize} diff --git a/chapters/overview/system-landscape.tex b/chapters/overview/system-landscape.tex index c72ffe2..dab8dce 100644 --- a/chapters/overview/system-landscape.tex +++ b/chapters/overview/system-landscape.tex @@ -1,9 +1,6 @@ \section{Systemlandschaft} \label{sec:system-landscape} -\section{Systemlandschaft} -\label{sec:system-landscape} - Der Dokumentenbereich ist in die bestehende Systemlandschaft von WorkSimple eingebettet. Abbildung~\ref{fig:system-context} zeigt den Systemkontext und das Zusammenspiel der beteiligten Systeme. \begin{figure}[H] diff --git a/chapters/overview/target-situation.tex b/chapters/overview/target-situation.tex index d4192e3..fe0929a 100644 --- a/chapters/overview/target-situation.tex +++ b/chapters/overview/target-situation.tex @@ -1,9 +1,6 @@ \section{Zielsituation} \label{sec:target-situation} -\section{Zielsituation} -\label{sec:target-situation} - Mit der Fertigstellung des Dokumentenbereichs erhalten Kunden im Kundenportal Houston erstmals einen strukturierten, selbstständig nutzbaren Zugang zu ihren Dokumenten. Die Zielsituation zeichnet sich durch eine zentrale Ablage im S3-Speicher und eine mandantengetrennte Darstellung in Houston aus. Der Dokumentenbereich bietet folgende zentrale Funktionen: diff --git a/chapters/planning/backlog.tex b/chapters/planning/backlog.tex index b6ecaeb..a88ecd4 100644 --- a/chapters/planning/backlog.tex +++ b/chapters/planning/backlog.tex @@ -1,14 +1,27 @@ -\section{Backlog-Schnitt und Schätzung} +\section{Backlog und Entwicklungsprozess} \label{sec:backlog} -% TODO: 14 PBIs + 1 Bug unter Feature 484 -% Prozess: DoR, DoD, Approval-Team, Sprints 15–17.2026 -% Siehe Tabelle~\ref{tab:backlog} im Anhang +\subsection{Entwicklungsprozess} -% Gantt: -% \begin{figure}[H] -% \centering -% \includegraphics[width=\textwidth]{figures/diagrams/gantt-plan.pdf} -% \caption{Zeitplanung über Sprints 15–17.2026} -% \label{fig:gantt} -% \end{figure} +Die Softwareentwicklung bei der Unicorn Development erfolgt nach einem agilen Prozess mit zweiwöchigen Sprints, verwaltet in Azure DevOps. Jedes Work Item durchläuft dabei einen definierten Zustandsautomaten, der in Abbildung~\ref{fig:ado-workflow} dargestellt ist. + +\begin{figure}[H] + \centering + \includegraphics[width=0.55\textwidth]{figures/diagrams/ado-workflow.pdf} + \caption{Zustände eines Work Items in Azure DevOps} + \label{fig:ado-workflow} +\end{figure} + +Ein neu angelegtes Item befindet sich zunächst im Zustand \texttt{New}. Sobald Beschreibung und Akzeptanzkriterien vollständig sind, wird es zur Freigabe eingereicht (\texttt{To Approve}). Im Approval-Termin prüft das Team, ob das Item der \emph{Definition of Ready} genügt, stellt Rückfragen und schätzt den Aufwand in Story Points. Erst danach gilt es als \texttt{Approved} und kann in einen Sprint gezogen werden (\texttt{Committed}). Nach erfolgreichem Merge des zugehörigen Pull Requests wechselt das Item nach \texttt{Dev Completed}; die fachliche Abnahme überführt es schließlich nach \texttt{Test Completed}. + +Dieser Prozess erwies sich im Projektverlauf als wirksam: Die Rückfragen im Approval-Termin — insbesondere durch \emph{Timo Walter} — deckten mehrfach Lücken in den Akzeptanzkriterien auf, etwa zur Frage, wann und wie oft die Ordnerstruktur geprüft wird, oder ob Namensbeschränkungen für Kundenordner zu berücksichtigen sind. + +\subsection{Schnitt der Product Backlog Items} + +Der Backlog-Schnitt erfolgte in zwei Phasen. Am 18.~Juni 2026 — unmittelbar nach der Feature-Analyse — wurden die acht Items der Kernfunktionalität angelegt. Sie orientieren sich direkt an der Gliederung der Feature-Beschreibung: Der Document Explorer bildet die Basis, die im Abschnitt \emph{Feature-Creep} genannten Punkte (Suche, Einzeldownload, ZIP-Download, PDF-Modal, URL-Dateien) wurden jeweils zu eigenen Items. Am 7.~Juli 2026 kam das Item zur Typisierung über Icons hinzu, am 8.~Juli das Item zur automatischen Ordneranlage. + +Eine zweite Gruppe von Items entstand erst während der Umsetzung. Am 22.~Juli ergänzte die UI-Zuarbeit die Anforderungen um Paginierung und Typfilter. Am 28.~Juli wurde die Recherche zur Optimierung der S3-Abfrage angelegt, deren Ergebnis am 12.~August in das Item zum Kundenordner-Lookup mündete. Am 17.~August kam schließlich das Item zu den Race Conditions hinzu (siehe Abschnitt~\ref{sec:race-conditions}). + +Insgesamt hängen 14 Product Backlog Items und ein Bug am Feature. Die vollständige Übersicht mit Aufwandsschätzung, Sprint und Status findet sich in Tabelle~\ref{tab:backlog} im Anhang. Die geschätzten Aufwände summieren sich auf 46 Story Points, verteilt auf 35 Punkte in Sprint~15.2026 und 11 Punkte in Sprint~16.2026. + +Bemerkenswert ist die Aufteilung: Die im Voraus geschnittenen Items betreffen ausschließlich fachliche Funktionen. Sämtliche nachgeschobenen Items der zweiten Gruppe entstanden aus technischen Problemen, die erst bei der Implementierung sichtbar wurden — ein Muster, das in Abschnitt~\ref{sec:reflection} aufgegriffen wird. diff --git a/chapters/planning/feature-analysis.tex b/chapters/planning/feature-analysis.tex index 2e4b1d6..ed49eaa 100644 --- a/chapters/planning/feature-analysis.tex +++ b/chapters/planning/feature-analysis.tex @@ -1,7 +1,15 @@ \section{Feature-Analyse} \label{sec:feature-analysis} -% TODO: 18.06.2026 — 4 Rückfragen von Linus an Thomas, Antworten im selben Ticket (Feature 484 Rev 17–32) -% - Autorisierung via Metadatum: ja -% - Filestash als externe Website (kein Custom-UI): ja -% - ... +Das Feature~484 „Dokumente" existierte seit November 2023 als zweizeilige Bedarfsnotiz im Backlog. Am 10.~Juni 2026 arbeitete \emph{Thomas Drewermann} es in mehreren aufeinanderfolgenden Bearbeitungen zu einer vollständigen Feature-Beschreibung aus. Dabei entstanden die Entscheidung für einen S3-Speicher als Ablage, die Festlegung auf Filestash als internes Verwaltungswerkzeug, der Katalog der sieben Dokumententypen sowie die Abschnitte \emph{Feature-Creep} und \emph{Out of Scope}. + +Am 18.~Juni 2026 führte ich eine Feature-Analyse durch, um die verbliebenen Unklarheiten vor dem Backlog-Schnitt zu beseitigen. Vier Rückfragen wurden als Kommentare am Work Item gestellt und noch am selben Tag beantwortet. Drei davon entschieden Architekturfragen: + +\begin{enumerate} + \item \textbf{Autorisierung über Metadaten:} Auf die Frage, ob die Efecte-Organisations-ID als Metadatum am Kundenordner gespeichert und die Berechtigung darüber aufgelöst werden könne, lautete die Antwort \emph{ja}. Damit war das Autorisierungskonzept festgelegt (siehe Abschnitt~\ref{sec:authorization}). + \item \textbf{Filestash als externes Werkzeug:} Es wurde bestätigt, dass Filestash unverändert als Verwaltungsoberfläche genutzt wird und \emph{nicht} als Referenz für einen Nachbau in Houston dient. Damit beschränkte sich der Implementierungsaufwand auf die Kundensicht. + \item \textbf{Typisierung über Ordner statt Metadaten:} Auf die Frage, ob der Dokumententyp als Metafeld an der Datei vermerkt werden solle, lautete die Antwort \emph{nein, Ordner}. Der Typ wird also über den Unterordner bestimmt, in dem das Dokument liegt. + \item \textbf{Bedeutung der URL-Dateien:} Die vierte Frage klärte, dass mit der Verlinkung zu Teams oder SharePoint gemeint ist, \emph{externe} Ressourcen in den Dokumentenbereich einzubetten — und nicht umgekehrt Houston-Dokumente nach außen zu teilen. Daraus entstand das Product Backlog Item zur Unterstützung von \texttt{.url}-Dateien. +\end{enumerate} + +Die dritte Entscheidung erwies sich im weiteren Verlauf als die folgenreichste. Die Abbildung des Typs über die Ordnerstruktur macht die Filterung nach Typ günstig, da sie sich auf ein Präfix-Listing reduziert. Sie erzwingt jedoch, dass die Ordnerstruktur für jeden Kunden vorhanden ist, und macht damit die automatische Anlage der Ordner zu einer eigenen Anforderung. Zugleich erschwert sie die typübergreifende Suche, da hierfür mehrere Präfixe durchlaufen werden müssen. diff --git a/chapters/planning/infrastructure.tex b/chapters/planning/infrastructure.tex index 8958388..0ec8df0 100644 --- a/chapters/planning/infrastructure.tex +++ b/chapters/planning/infrastructure.tex @@ -1,15 +1,34 @@ -\section{Infrastrukturbeschaffung} +\section{Beschaffung der S3-Infrastruktur} \label{sec:infrastructure} -% TODO: Service Requests an Maschinenraum (2026-07-22), Provisionierung durch Advanced Unibyte, -% 3 Buckets (DEV/TEST/PROD), Credentials in Passbolt (2026-07-27) -% Anfrage S3 Select (2026-07-30), Aktivierung durch AU (2026-08-07) -% Search Integration: von AU nicht bereitgestellt (2026-08-17) +Der für das Projekt benötigte S3-Speicher stand zu Projektbeginn nicht zur Verfügung und musste über den internen Service-Desk-Prozess beantragt werden. Da der Speicher nicht von WorkSimple selbst, sondern von Advanced Unibyte betrieben wird, war die Beschaffung mit einem mehrstufigen Abstimmungsweg verbunden. Abbildung~\ref{fig:timeline-infra} zeigt den zeitlichen Verlauf. -% Timeline-Diagramm: -% \begin{figure}[H] -% \centering -% \includegraphics[width=\textwidth]{figures/diagrams/timeline-infra.pdf} -% \caption{Chronologie der Infrastrukturbeschaffung} -% \label{fig:timeline-infra} -% \end{figure} +\begin{figure}[H] + \centering + \includegraphics[width=\textwidth]{figures/diagrams/timeline-infra.pdf} + \caption{Chronologie der Infrastrukturbeschaffung} + \label{fig:timeline-infra} +\end{figure} + +\subsection{Bereitstellung der Buckets} + +Am 22.~Juli 2026 stellte ich den Service Request „Houston DEV S3 Documents Speicher" an das interne Infrastruktur-Team. Der Request wurde am 23.~Juli \emph{Alexander Wagner} zugewiesen und am 27.~Juli abgeschlossen: Advanced Unibyte hatte die Buckets angelegt, die Zugangsdaten wurden im Passwortmanager Passbolt hinterlegt. Insgesamt wurden drei Buckets bereitgestellt — je einer für die Entwicklungs-, Test- und Produktivumgebung. + +Vom Antrag bis zur Verfügbarkeit vergingen fünf Arbeitstage. Da der Document Explorer als erstes Item ohnehin erst am 27.~Juli in die Umsetzung ging, entstand hieraus keine Verzögerung. + +\subsection{Freischaltung zusätzlicher Funktionen} + +Deutlich aufwendiger gestaltete sich die Klärung, welche S3-Funktionen die StorageGRID-Installation tatsächlich unterstützt. Im Rahmen der Recherche zur Optimierung des Kundenordner-Lookups (siehe Abschnitt~\ref{sec:lookup-research}) kamen zwei Funktionen als mögliche Lösungen in Betracht: + +\begin{itemize} + \item \textbf{S3 Select} (\texttt{SelectObjectContent}) erlaubt es, Inhalte einzelner Objekte serverseitig per SQL-ähnlicher Abfrage zu filtern \autocite{aws-s3-select, storagegrid-s3-select}. + \item Der \textbf{Search Integration Service} von StorageGRID spiegelt Objektmetadaten in einen Elasticsearch-Index und ermöglicht dadurch eine echte Suche über Metadaten \autocite{storagegrid-search-integration}. +\end{itemize} + +Am 30.~Juli beantragte ich die Freischaltung beider Funktionen. Da hierfür der Betreiber einbezogen werden musste, kontaktierte \emph{Lennart Meinert} am 4.~August Advanced Unibyte. Am 6.~August benannte er die drei betroffenen Buckets, am 7.~August bestätigte Advanced Unibyte die Aktivierung von S3 Select für alle drei Umgebungen. + +Für den Search Integration Service fiel die Antwort anders aus: Am 17.~August teilte Advanced Unibyte mit, dass diese Funktion derzeit nicht angeboten werde; das Thema wurde intern an den dortigen Product Owner eskaliert. Am 21.~August schlug Advanced Unibyte ein Folgegespräch vor. Da zu diesem Zeitpunkt bereits eine Lösung ohne serverseitige Suche gefunden und umgesetzt war (siehe Abschnitt~\ref{sec:lookup-decision}), wurde der Service Request geschlossen und das Thema in den Ausblick verschoben. + +\subsection{Bewertung} + +Zwischen dem ersten Antrag und der abschließenden Klärung lagen vier Wochen. Diese Vorlaufzeit war zu Projektbeginn nicht eingeplant und beeinflusste die Architekturentscheidung unmittelbar: Ein Lösungsansatz, der auf einer erst noch zu beschaffenden Fremdleistung beruht, ist innerhalb eines Projektzeitraums von wenigen Wochen nicht belastbar. Die schließlich gewählte Lösung kommt daher ohne Erweiterung der Speicherfunktionen aus. diff --git a/chapters/planning/onboarding.tex b/chapters/planning/onboarding.tex index 8c85a3b..fa90d08 100644 --- a/chapters/planning/onboarding.tex +++ b/chapters/planning/onboarding.tex @@ -1,5 +1,18 @@ \section{Einarbeitung} \label{sec:onboarding} -% TODO: S3-API, AWS SDK für .NET, StorageGRID-Dokumentation -% Quellen: note-1785344962361 (S3-Recherche mit Timo), note-1785413874041 +Vor Beginn der Implementierung war eine Einarbeitung in die für das Projekt relevanten Technologien erforderlich. Im Zentrum stand dabei der S3-Objektspeicher, mit dem im bisherigen Verlauf des Praktikums noch nicht gearbeitet worden war. + +\subsection{S3 als Objektspeicher} + +S3 (\emph{Simple Storage Service}) ist kein klassisches Dateisystem, sondern ein Objektspeicher. Objekte werden über einen flachen Schlüsselraum adressiert; eine Ordnerhierarchie existiert technisch nicht. Was in Werkzeugen wie Filestash als Ordner dargestellt wird, ist lediglich ein Präfix im Objektschlüssel, das in Verbindung mit einem Trennzeichen (\texttt{Delimiter}) beim Auflisten hierarchisch interpretiert wird \autocite{aws-listobjectsv2}. Diese Eigenschaft prägt das gesamte Ablagekonzept (siehe Abschnitt~\ref{sec:s3-layout}) und war für mehrere spätere Architekturentscheidungen ausschlaggebend. + +Eine zweite wesentliche Erkenntnis betrifft die Abfragemöglichkeiten: An Objekten können zwar benutzerdefinierte Metadaten hinterlegt werden, S3 bietet jedoch \emph{keine} Möglichkeit, Objekte anhand dieser Metadaten zu suchen. Ein Lookup nach einem Metadatenwert erfordert daher das Auflisten aller in Frage kommenden Objekte und eine anschließende clientseitige Filterung. Dieses Detail wurde erst im Verlauf der Implementierung zum zentralen technischen Problem des Projekts (siehe Abschnitt~\ref{sec:lookup-research}). + +\subsection{AWS SDK für .NET} + +Der Zugriff auf den S3-Speicher erfolgt aus Houston heraus über das AWS SDK für .NET. Zentrale Schnittstelle ist \texttt{IAmazonS3}, über die sämtliche Operationen (\texttt{ListObjectsV2}, \texttt{GetObject}, \texttt{PutObject}, \texttt{CopyObject}, \texttt{DeleteObjects}) ausgeführt werden. Da \texttt{IAmazonS3} eine Schnittstelle ist, lässt sie sich in Unit-Tests durch ein Mock ersetzen, was für die spätere Testabdeckung des Kundenordner-Lookups entscheidend war (siehe Abschnitt~\ref{sec:unit-tests}). + +\subsection{NetApp StorageGRID} + +Der eingesetzte Speicher wird nicht bei Amazon betrieben, sondern von Advanced Unibyte auf Basis von NetApp StorageGRID bereitgestellt. StorageGRID ist S3-kompatibel, implementiert die S3-API jedoch nicht vollständig. Welche Funktionen tatsächlich verfügbar sind, hängt von der Konfiguration der Installation ab und musste im Einzelfall geklärt werden. Diese Einschränkung betraf im Projektverlauf sowohl \texttt{SelectObjectContent} \autocite{storagegrid-s3-select} als auch den \emph{Search Integration Service} \autocite{storagegrid-search-integration} und führte zu den in Abschnitt~\ref{sec:infrastructure} beschriebenen Abstimmungen. diff --git a/chapters/planning/requirements.tex b/chapters/planning/requirements.tex index d701af1..41e2ff4 100644 --- a/chapters/planning/requirements.tex +++ b/chapters/planning/requirements.tex @@ -1,5 +1,33 @@ -\section{Anforderungserhebung} +\section{Anforderungen} \label{sec:requirements} -% TODO: Funktionale und nichtfunktionale Anforderungen aus den PBI-ACs -% Tabelle: Anforderungsmatrix (funktional / nichtfunktional → PBI) +Aus der Feature-Beschreibung und der Analyse ergaben sich die folgenden Anforderungen. Die funktionalen Anforderungen wurden anschließend in Product Backlog Items überführt; die vollständige Zuordnung findet sich in Tabelle~\ref{tab:requirements} im Anhang. + +\subsection{Funktionale Anforderungen} + +\begin{itemize} + \item \textbf{FA-1 — Dokumentenliste:} Auf der Seite \texttt{/documents} werden alle Dokumente der Organisation des angemeldeten Benutzers als Liste dargestellt. Ordner selbst werden nicht als Einträge angezeigt; leere Typordner erscheinen nicht. + \item \textbf{FA-2 — Mandantentrennung:} Ein Benutzer sieht ausschließlich Dokumente, die im Ordner seiner Organisation liegen. Die Zuordnung erfolgt über die \texttt{efecte-org-id} am Kundenordner. + \item \textbf{FA-3 — Rollenbasierter Zugriff:} Der Navigationspunkt ist nur bei vorhandener Rollenberechtigung sichtbar. Ein direkter Aufruf ohne Berechtigung führt zu einer 403-Antwort. + \item \textbf{FA-4 — Typisierung und Icons:} Jedes Dokument wird mit einem Icon dargestellt, das aus dem Unterordner abgeleitet wird. Unbekannte Typen erhalten ein Standard-Icon. + \item \textbf{FA-5 — Suche:} Dokumente können serverseitig nach ihrem Titel durchsucht werden, inklusive Teiltreffern. Ein leeres Suchfeld zeigt wieder die vollständige Liste. + \item \textbf{FA-6 — Typfilter:} Unterhalb der Suchleiste kann je Dokumententyp ein Element zum Ein- und Ausblenden ausgewählt werden. + \item \textbf{FA-7 — Paginierung:} Die Liste wird seitenweise dargestellt; die Seitengröße ist durch den Benutzer festlegbar, analog zu den übrigen Houston-Seiten. + \item \textbf{FA-8 — Einzeldownload:} Jeder Eintrag besitzt einen Download-Button. Der Download erfolgt über eine zeitlich begrenzte Pre-Signed URL \autocite{aws-presigned-urls} unter Beibehaltung des ursprünglichen Dateinamens. + \item \textbf{FA-9 — ZIP-Download:} Mehrere Dokumente können über Auswahlboxen markiert und gemeinsam als ZIP-Archiv heruntergeladen werden. Die Ordnerstruktur des Archivs entspricht der S3-Struktur; das Archiv wird erst beim Klick erzeugt. + \item \textbf{FA-10 — PDF-Vorschau:} PDF-Dokumente können in einem Modal angezeigt werden, ohne zuvor heruntergeladen zu werden. Für Nicht-PDF-Dateien wird keine Vorschau geöffnet. + \item \textbf{FA-11 — Share-Links:} Für jedes Dokument kann ein Freigabelink erzeugt werden, dessen Zielseite OpenGraph-Meta-Tags für eine Linkvorschau bereitstellt und anschließend auf den Document Explorer weiterleitet. + \item \textbf{FA-12 — URL-Dateien:} Im Speicher abgelegte \texttt{.url}-Dateien werden nach dem INI-Format ausgewertet und leiten beim Anklicken auf die hinterlegte Adresse weiter. Ist keine gültige URL erkennbar, wird die Datei wie eine normale Datei behandelt. + \item \textbf{FA-13 — Automatische Ordneranlage:} Beim Aufruf der Dokumentenseite wird die vollständige Typordnerstruktur für die Organisation angelegt, sofern sie noch nicht existiert. +\end{itemize} + +\subsection{Nichtfunktionale Anforderungen} + +\begin{itemize} + \item \textbf{NFA-1 — Skalierbarkeit des Lookups:} Die Auflösung des Kundenordners darf nicht linear mit der Anzahl der Kunden wachsen. Im Normalfall soll ein einzelner Aufruf genügen. + \item \textbf{NFA-2 — Fehlerbehandlung:} Können Dokumente nicht geladen werden, wird eine verständliche Fehlermeldung angezeigt. Eine stillschweigend leere Seite ist nicht zulässig. + \item \textbf{NFA-3 — Leerer Zustand:} Existieren für einen berechtigten Benutzer keine Dokumente, wird ein entsprechender Hinweis angezeigt. + \item \textbf{NFA-4 — Konsistenz zur bestehenden Oberfläche:} Suche, Paginierung und Bedienelemente orientieren sich an den übrigen Houston-Seiten. + \item \textbf{NFA-5 — Testbarkeit:} Die Logik zur Auflösung des Kundenordners ist durch Unit-Tests mit einem gemockten \texttt{IAmazonS3} abgedeckt. + \item \textbf{NFA-6 — Pfadsicherheit:} Beim Download wird geprüft, dass der angeforderte Schlüssel innerhalb des Kundenordners liegt; Pfadanteile zum Verlassen des Ordners werden abgewiesen. +\end{itemize} diff --git a/chapters/planning/schedule.tex b/chapters/planning/schedule.tex index 29c7bd6..ad2bb0e 100644 --- a/chapters/planning/schedule.tex +++ b/chapters/planning/schedule.tex @@ -1,4 +1,17 @@ \section{Zeit- und Aufwandsplanung} \label{sec:schedule} -% TODO: Sprints 15–17.2026, Aufwandsschätzungen (Story Points), 24 Manntage / 192 h gesamt +Für das Praktikum sind 24 Manntage beziehungsweise 192 Arbeitsstunden vorgesehen. Der Projektzeitraum erstreckt sich von der Themenfindung Ende Mai 2026 bis zur Abgabe der Dokumentation. Die Umsetzung verteilt sich auf die Sprints 15.2026 bis 17.2026. Abbildung~\ref{fig:gantt} zeigt die geplante zeitliche Verteilung. + +\begin{figure}[H] + \centering + \includegraphics[width=\textwidth]{figures/diagrams/gantt-plan.pdf} + \caption{Zeitplanung des Projekts} + \label{fig:gantt} +\end{figure} + +Die Planung gliedert sich in vier Phasen. Die \textbf{Analyse- und Konzeptionsphase} (Ende Mai bis Anfang Juli) umfasste die Themenfindung mit \emph{Sarah Hinzmann} und \emph{Thomas Drewermann}, die Feature-Analyse sowie den Schnitt und die Freigabe der Product Backlog Items. Die \textbf{Implementierungsphase} begann am 27.~Juli mit dem ersten Pull Request und erstreckte sich über die Sprints 15 und 16. Parallel dazu lief die \textbf{Qualitätssicherung} in Form fortlaufender Code-Reviews; der Abnahmetest begann am 13.~August. Die \textbf{Abschlussphase} umfasst Release, Dokumentation und Präsentation. + +Eine Besonderheit der Planung ist die Abhängigkeit von der Infrastrukturbereitstellung: Der Document Explorer konnte erst umgesetzt werden, nachdem der S3-Speicher zur Verfügung stand. Diese Abhängigkeit wurde bereits im Approval-Termin am 8.~Juli durch \emph{Stephan Janßen} als Voraussetzung am Item vermerkt. Der tatsächliche Vorlauf für die Beschaffung wird im folgenden Abschnitt beschrieben. + +Der Soll-Ist-Vergleich der Zeitplanung findet sich in Abschnitt~\ref{sec:target-comparison}. diff --git a/figures/diagrams/ado-workflow.pdf b/figures/diagrams/ado-workflow.pdf new file mode 100644 index 0000000..f38e851 Binary files /dev/null and b/figures/diagrams/ado-workflow.pdf differ diff --git a/figures/diagrams/gantt-plan.pdf b/figures/diagrams/gantt-plan.pdf new file mode 100644 index 0000000..224a8b7 --- /dev/null +++ b/figures/diagrams/gantt-plan.pdf @@ -0,0 +1,1166 @@ +%PDF-1.4 +% +1 0 obj +<> +endobj +3 0 obj +<> +endobj +4 0 obj +<> +endobj +6 0 obj +<> +endobj +7 0 obj +<> +/Font <>>> +/BBox [0 0 167 848] +/StructParents 1 +/Group <> +/Filter /FlateDecode +/Length 162>> stream +x=] +@ sɮ*}PJm/ȗ0ɋ`l%i2+0Lī5`I71*92N=)^63,2ݖ +> +/Font <>>> +/BBox [0 0 167 848] +/StructParents 2 +/Group <> +/Filter /FlateDecode +/Length 162>> stream +x= +@) ;i ^ta EfZ009%R*j&)-8]tZܩ'cx>?2YTEURH-$N$>X$o(c,ffm9܍jGےe/ +endstream +endobj +9 0 obj +<> +/Font <>>> +/BBox [0 0 167 848] +/StructParents 3 +/Group <> +/Filter /FlateDecode +/Length 161>> stream +xM +@F)pwfmq' 7"?\%9J3J\bᘕG`+LzĢ#c-ԑ2X㐏>?<}iTeyYPI-$N$be%1H)Xfg F UMA_b/ +endstream +endobj +10 0 obj +<> +/Font <>>> +/BBox [0 0 167 848] +/StructParents 4 +/Group <> +/Filter /FlateDecode +/Length 162>> stream +x= +@F)pwfus' 7"?V%3ySX0+9Q;Z8fe,x]t`,"X]I5C^_<}YTEURI-o$˝HbeSޒ~Y,[3 oa$N mI?e/ +endstream +endobj +11 0 obj +<> +/Font <>>> +/BBox [0 0 167 848] +/StructParents 5 +/Group <> +/Filter /FlateDecode +/Length 162>> stream +x= +0 EIkс:كi@0ƜQA 'K7%ڂ(J"cVbW5`)nUik񠞔V]?y;,u +(+Gd! #YD+f-1b,ǝfqjOW[G?c> +/Font <>>> +/BBox [0 0 167 848] +/StructParents 6 +/Group <> +/Filter /FlateDecode +/Length 162>> stream +x= +@) ;i B$]BBdǮ 7sgMFIl`ڧEʬba"j`y$0~(IXk7ޯ/gaA> +/Font <>>> +/BBox [0 0 167 848] +/StructParents 7 +/Group <> +/Filter /FlateDecode +/Length 161>> stream +xM +@F)pY@' 7"?\%9%FXY#.U8fc8خ +@qbёUŝz2ku ~ɒOG?Oˌ,XEUR)>($N$b[ޒ~YYcoT{:Sݖbr/ +endstream +endobj +14 0 obj +<> +/Font <>>> +/BBox [0 0 167 848] +/StructParents 8 +/Group <> +/Filter /FlateDecode +/Length 161>> stream +xM +P  xܴxѤ YdqT"϶F"R*f&D~$^l[ciax/ Rŝ:2jkx>n>, {*T8 + +a+r'h$)cexfm.p7]j,}f/ +endstream +endobj +15 0 obj +<> +/Font <>>> +/BBox [0 0 167 848] +/StructParents 9 +/Group <> +/Filter /FlateDecode +/Length 161>> stream +x=] +@ snW+>C۽AXZ/-B`d$oJRj2+0L0'𠞔Z]?Ǽ y}y=e L#ϋ“>9H❝X2fqb7=2 o}q9jOWے~\E/ +endstream +endobj +16 0 obj +<> +/Font <>>> +/BBox [0 0 166 848] +/StructParents 10 +/Group <> +/Filter /FlateDecode +/Length 161>> stream +x=] +@ sɮ[+>C۽AXZ/-B`d$oJR*%Aq&v VG'𠞔Z]?Ǽ y}y=e L#ϋ“>9H❝X2fqb7=2 o}q'9jOWے~_m/ +endstream +endobj +17 0 obj +<> +/Font <>>> +/BBox [0 0 167 848] +/StructParents 11 +/Group <> +/Filter /FlateDecode +/Length 161>> stream +x=] +0s +P67(XX%if7Y%ƁX)58 qL+#fsxPO`c߆2Y\EURIo$NbixK,D8f7_lߩt-\/ +endstream +endobj +18 0 obj +<> +endobj +19 0 obj +<> +endobj +20 0 obj +<>>> +/BBox [0 0 2335 75] +/Group <> +/Length 79>> stream +q +3.125 0 0 3.125 0 -150 cm +.4 .4 1 RG .4 .4 1 rg +/G18 gs +0 48 746.5 24 re +f +Q + +endstream +endobj +21 0 obj +<>>> +/BBox [0 0 2335 75] +/Group <> +/Length 79>> stream +q +3.125 0 0 3.125 0 -225 cm +.4 .4 1 RG .4 .4 1 rg +/G18 gs +0 72 746.5 24 re +f +Q + +endstream +endobj +22 0 obj +<>>> +/BBox [0 0 2335 75] +/Group <> +/Length 74>> stream +q +3.125 0 0 3.125 0 -300 cm +1 1 1 RG 1 1 1 rg +/G3 gs +0 96 746.5 24 re +f +Q + +endstream +endobj +23 0 obj +<>>> +/BBox [0 0 2335 75] +/Group <> +/Length 75>> stream +q +3.125 0 0 3.125 0 -375 cm +1 1 1 RG 1 1 1 rg +/G3 gs +0 120 746.5 24 re +f +Q + +endstream +endobj +24 0 obj +<>>> +/BBox [0 0 2335 75] +/Group <> +/Length 80>> stream +q +3.125 0 0 3.125 0 -750 cm +.4 .4 1 RG .4 .4 1 rg +/G18 gs +0 240 746.5 24 re +f +Q + +endstream +endobj +25 0 obj +<>>> +/BBox [0 0 2335 75] +/Group <> +/Length 75>> stream +q +3.125 0 0 3.125 0 -450 cm +1 1 1 RG 1 1 1 rg +/G3 gs +0 144 746.5 24 re +f +Q + +endstream +endobj +26 0 obj +<>>> +/BBox [0 0 2335 75] +/Group <> +/Length 83>> stream +q +3.125 0 0 3.125 0 -600 cm +1 .9569 0 RG 1 .9569 0 rg +/G3 gs +0 192 746.5 24 re +f +Q + +endstream +endobj +27 0 obj +<>>> +/BBox [0 0 2335 75] +/Group <> +/Length 83>> stream +q +3.125 0 0 3.125 0 -525 cm +1 .9569 0 RG 1 .9569 0 rg +/G3 gs +0 168 746.5 24 re +f +Q + +endstream +endobj +28 0 obj +<>>> +/BBox [0 0 2335 75] +/Group <> +/Length 75>> stream +q +3.125 0 0 3.125 0 -675 cm +1 1 1 RG 1 1 1 rg +/G3 gs +0 216 746.5 24 re +f +Q + +endstream +endobj +29 0 obj +<>>> +/BBox [0 0 2335 75] +/Group <> +/Length 80>> stream +q +3.125 0 0 3.125 0 -825 cm +.4 .4 1 RG .4 .4 1 rg +/G18 gs +0 264 746.5 24 re +f +Q + +endstream +endobj +30 0 obj +<> +endobj +31 0 obj +<> stream +x\n}^$L mXq?8]5qb,-žT:zgO1uyW'6&y?Ssxǟwoݽzu_:[R)~ھ߾~dL_.B +ٳwn\3vcuoagל۳]o~lDt돻.~#1C//C.0CGŘ+K:ҡcZw!K:H >-/\;d1KI~C#zA|b 2ɕ ;&]W/H]0ߒJ;w4Y#~kzmZ8Bs-Bn>)ƖQlT]!VjEt>S[@zrZCFѹjvO1 +;Mjr-;Jh]s)U"֡JE๓8O*ޕ6(Jk+K~_c72P>4)OW`QwwoE^ke$ +6P0&IHxW &E]8`* X+M>M ^!wV4G7mС*:T{> CYtV`|H3{ki; B[UW_eK9qW掵TI+ +P5n&(`(m0f:A 6l ScȗXA4" 2D#tQnՇRW}Hv!aM=) 'X4j!"sʞ";X iXF :߬s $5fǛ=[dRcrE05QXr +ŷ+lt@7me8F3,Y<4[-8 D#NB+1Fl+P翡_E~U8lLhAiGRhVf21X3/ᛠh 2$b{wۜMR$LsZK䵤VS0`pьGd֑ u6$-H'ha^c7d!l 7c%~?<H}'P:mĆ`EEʢlmY*0 .LbM3޺?P( +W,f Zց䅕00Ke[F\MGad?j "_reذjʸDHZwrՊ fscpb% ȍQ1](8Yb4?2C4?s4ӗ EWK 3APb6`յZh3 (Į$*aN`((PxYe8(haFuơU1aZQn:*0Jn3#lQD^sS̐)3qUjRV XʤJФKjAp]-uӮSݍғڽ6eExFvϷh׫ =vv0>Yxgqg:v=YvY>TMw׹arn-B8n-_o-B"W}E~̶" rh鸭I"p  .06^xԽ:8.& F  =PqU6+#!s:{p7mL1:,@b +P U)Eŧ:~DHȝ͝j0B" +dU? +J^9 S"FoxB kvqJsw~wԿԿ٘֠S4vg_Cn]._>X׬>[s@V;VLwί Ӊf<uZLrP'IN) +{W_ۉpfD%Wwj!F_P+rqHvs>gzO{a {zOSv}a|щx Ubҽ(+Z3xϾO#?e:ewnVK^x +^񞒺1%zƝ|ޝN>ٚH8R$qysA߷g. Utf"H}fr ꇔk|f>Hx?I3ֳ\Jd YZq>; )?+q˷cף1{~TxS5ڒuu97|'^OK~{?p-%m^/NU& s1_ $e|_`W ٟs 8p~ Ŕ/uK8Yqy]mnBs:f1L1_l>S<^۾HԺzV$ѓ6 X.0*ksַߞˢ]0%wq +endstream +endobj +2 0 obj +<> +/XObject <> +/Font <>>> +/MediaBox [0 0 612 792] +/Contents 31 0 R +/StructParents 0 +/Tabs /S +/Parent 32 0 R>> +endobj +32 0 obj +<> +endobj +38 0 obj +<>>> +endobj +37 0 obj +<> +endobj +40 0 obj +<>>> +endobj +39 0 obj +<> +endobj +42 0 obj +<>>> +endobj +41 0 obj +<> +endobj +44 0 obj +<>>> +endobj +43 0 obj +<> +endobj +46 0 obj +<>>> +endobj +45 0 obj +<> +endobj +48 0 obj +<>>> +endobj +47 0 obj +<> +endobj +50 0 obj +<>>> +endobj +49 0 obj +<> +endobj +52 0 obj +<>>> +endobj +51 0 obj +<> +endobj +54 0 obj +<>>> +endobj +53 0 obj +<> +endobj +56 0 obj +<>>> +endobj +55 0 obj +<> +endobj +58 0 obj +<>>> +endobj +57 0 obj +<> +endobj +60 0 obj +<> +endobj +59 0 obj +<> +endobj +62 0 obj +<> +endobj +61 0 obj +<> +endobj +64 0 obj +<> +endobj +63 0 obj +<> +endobj +66 0 obj +<> +endobj +65 0 obj +<> +endobj +68 0 obj +<> +endobj +67 0 obj +<> +endobj +70 0 obj +<> +endobj +69 0 obj +<> +endobj +72 0 obj +<> +endobj +71 0 obj +<> +endobj +74 0 obj +<> +endobj +73 0 obj +<> +endobj +76 0 obj +<> +endobj +75 0 obj +<> +endobj +78 0 obj +<> +endobj +77 0 obj +<> +endobj +80 0 obj +<> +endobj +79 0 obj +<> +endobj +82 0 obj +<> +endobj +81 0 obj +<> +endobj +84 0 obj +<> +endobj +83 0 obj +<> +endobj +86 0 obj +<> +endobj +85 0 obj +<> +endobj +88 0 obj +<> +endobj +87 0 obj +<> +endobj +90 0 obj +<> +endobj +89 0 obj +<> +endobj +36 0 obj +<> +endobj +35 0 obj +<> +endobj +34 0 obj +<> +endobj +91 0 obj +[36 0 R 60 0 R 62 0 R 64 0 R 66 0 R 68 0 R 70 0 R 72 0 R 74 0 R 76 0 R 78 0 R 80 0 R 82 0 R 84 0 R 86 0 R 88 0 R 90 0 R] +endobj +92 0 obj +[38 0 R] +endobj +93 0 obj +[40 0 R] +endobj +94 0 obj +[42 0 R] +endobj +95 0 obj +[44 0 R] +endobj +96 0 obj +[46 0 R] +endobj +97 0 obj +[48 0 R] +endobj +98 0 obj +[50 0 R] +endobj +99 0 obj +[52 0 R] +endobj +100 0 obj +[54 0 R] +endobj +101 0 obj +[56 0 R] +endobj +102 0 obj +[58 0 R] +endobj +103 0 obj +<> +endobj +33 0 obj +<> +endobj +104 0 obj +<> +/StructTreeRoot 33 0 R +/ViewerPreferences <> +/Lang (en-US)>> +endobj +105 0 obj +<> stream +x} xhUgLL&, 4Kb0 +Ȁ!!DI&"((n B"_W]ūWH{3 }}CzNWթsN:u'tP&ݺf1NeT3}znV0yjp +Na޵^=~(@9UX+`̟?۠)>ڛ\hிvʏW_j%{kj7>X0Vo5s;\6}JPt$W  h Ò_Hq02)JҔt=t3FMX$+rv3 +CX829yG!npp0(K (сG 6]։{;:Q=,zQ4}(8UwҟpS{O1"s?/?(r8q!EEwJOSuo+k1O.=QzI駗?[}Jo:E_m#/3=?Vo㭦" ;ރ +޷}a(±cFC#/1|X%C/ßKA4jR242=F *}LOcجB_QTTz@geRD=BF쁎 +|G{'9#.|XO,yuc}\R 7z2=z +7FfebF=7f:+՚11LH+Ta(9[ +IJ±N79N$#1BY z3h5h@[嫪L FRx` |c|,#d +Ijɤ~Jw7SЍ#V-rbb!BU?;ZwAy@C44/k,n%w;Y3 }t< LmFˣS*_[zKo-[zKo-/U zE/f*]PGmO fPTcc<:㓸It 1X@ B {٘@3S 5ϼOHu xwQuCP'Q2GAiA54A$P 5LC,e4 Xs{=[( z[bQQ)5!}v<@$uyL3ѾgE=]l߶zA&ށ58Ż8M[{i5x (i²JB#`0'< ^V'W>6#YfIh-H^iMv{.ɤEL +0ACTpG21+DuСkmV/˵Z~|J6[ݗ:QwnuwơI?k榢̀0>~l_`.k op쀁~heWfRoDc4E +E+# X޵<*ZX_ZF6oސʕa־H/Ϥ~ڰc>m+_ƟW5lmY^|E}g_ڸ&OҩL`&o2; ìY:o>II!6baSM1rUyyy!mtLE$&u~.>%+Sy{ρw=㖆\aO։8a}{敏dY5 P0?*6H0H5Z@_1ŒrCb!*.kk)5U) J+5f}AY!Ue+>Rv}s~ɻ߿sоK_ܸj閇.ۀN"Ix=?s?OϨ8iѾ[4ÀJZTjUmDC?LcVNZ(ih)攊9L]7#iFZoFc6 c0vVDhUQ^W1ZXE_B+>tLw[7GpMŇŭۻ=6 mW\3K[IgIfSf`)U*8vn6CELҠaer]١TjRղ'M|" NҾt*<ڮFZ]q{2iE k& q ~·zJt zKPI.KV jޅ!yBEB_! B GBՉkbLU 'nX%K]g&UUXٽisŪԃ."iGE6˓,L +験S0_#ǰ/G<ߋ?3P}"Oq̧LHI#=za5ɬ+"z=P;Ҍ3/pWy y(xCu-mb#O>zdLçG6Y7H6PgX]+KYVD4ɐ#]v`,4=+Q^饑m *ۓ1wZYe&֩T4;uށ8Pvy_t\/&,nHWnqjwH>M?=8mzyix>pu>DN.ii!'韘wn-|6al.sx6]%z-Z77G8ji㩈,LH*"TT1}hDYXYb>Cdx*0zPiΦeG;r>B)ZQf)%*+"h` k`Md)kFҳN=F֬n]{1)֚?I\0@ل)tޠTHFŀ!u utF&1 ]JO_y.W)ޱU`ƒgynyQe'ZXzIӍl6,uܪeQI;+Q}s~HYpj@mecc܏~lcjjO ='{YXoH1h(S|JOkRJjByr7~՛W/:ߌvש줿#OOrMz<|!p3P94βrB[,fve5Qmg*²j5 G6B <䧤ArCyhcNw<됮fz*n}hF#woMyi%OSQ9C2 +:tɪ( $%!tNGw:ӱ#ғk#2/pB.?9PɓIk`ec~b #$%QT (:t7^gt2}b|yC@N|ɽǃ M|*h +#q,>p}Bmޠ"6'nwbXĨNu⢋)G/ĢPĚx~(ryR|ٳO7ݾ|3?>8`_LA-|{lb*5yϙEVnS5aI8bfhus:z6Bo{G'#v*A#z{}gԪb;/cϵG턷c@|QL9 +vy>@0Z2߰[KŠw߲U%|#%ύ#߲av咝)< *]rӤH$7ǥ-:?tpDgE8bQCEO.E!:bD.\ܞ\mZRwkϾq,3ROOn\zⴵ)%q PN)_PwbȮsWWzǧ/V= w(?j4 +OV…#Оm)(iOFnO>OkdT0rN>crRsBKMxҺ-- +$ WjO½˘K~/eo®狉B4T1zڊ09 +NMKEuWq)6LIݮ>@~ӓcиs=쫀@(h`?OBJMF:iNB%]*8GDc +8~(Wmڸv9!p{8IbwS)(Ti +VB!{ΔTY&uRj-p/*dK5+޽?~W똣*)Nܔz#?04XO3\6̀A+8#rv|aS [?p)w RQ0JKVU*% IL|2k$ 8\jx7|K&u tlOɍ60A@fx&w 5,,8+Ӟ ve,khDJPRmr˦F `N!4]_E0&9OܪRv9%?dtN`jul~vR"6^d\m#Z}rj7 ;בɇ2bg]s]t[uK:)Pɏ0TjHQ8]&ؘpfjͅ O׸ ;lO]N]茺fx3pB=gf5WEmlINe\s}uyΜDTCA 6(3rVPP"23pԁa:;R}=~ׇW>ີ>+~)~^4R)񳎷WFW"pJ2FJ%"_^7Cؔxvd`[&Mu# Aslx÷fqhUK9baBk*ψ|#mP`o`fŪgZp`HV.%OQ}#Y_;WNOt *~MҁL.8p0u8 6C&B&ĎLlh&gb(  $߱UU$@Ff'\ _ػTlVÖ嗿w]_KmM뗎돁͏\6q>,]k)^^)=㧩L&XO,^iU(pDWx2I6QoʄYzФIY_Z ZV_ю)m+o~`(}_Y:>F2~|CJ q9MmU6!ђoYK|Ĉ~a}N=u~So;K@pG0*X^G*-1RaAMDJtfԣHm8׆SlXd!6L͆ /6|نl 7pUXbCֆ em _o ke֞.dqdq l8Kk/m>f56!F>A]rFeYFO seņgevIyɋ04r6zIRvؕfnT Gy9ցUtH9t;|с-|ā= >`6ɏ;pWtS8V<8viv8=v8Innnn=yp,p`[Wv` 2;*-]ůl Eg/H>:&cО߁1˷BAs_JĨ\,8KFw)y1:v8Ms;cܥ) +|էvN +藨17(h 4Q"@CNCdP.|Qx#P8]=cJKk$ +endstream +endobj +106 0 obj +<> +endobj +107 0 obj +<> +/W [0 [750 0 0 277.83203] 9 [666.99219] 11 16 333.00781 17 [277.83203] 19 28 556.15234 36 37 666.99219 38 39 722.16797 40 [666.99219 610.83984 0 0 277.83203 0 0 556.15234 833.00781 0 777.83203 666.99219 777.83203 722.16797 666.99219] 55 61 610.83984 68 69 556.15234 71 72 556.15234 73 [277.83203 556.15234 556.15234 222.16797] 79 [222.16797 833.00781] 81 83 556.15234 85 [333.00781] 87 [277.83203 556.15234 0 722.16797] 166 2015 556.15234] +/DW 500>> +endobj +108 0 obj +<> stream +x]n0E +/Em^E*3Pbq<.=^^>kpLkaV@?&o +zlfUQce% ovy;oye^}_8.X:oތ=mwWmPKJ`K"IYeGtX<BՁTJ娂*@f)XU\)O>y.cW#5V{l%*) )e|'2 E$C`0%'"{pR0 RX=@;^ꫵ`^zӼV +endstream +endobj +5 0 obj +<> +endobj +xref +0 109 +0000000000 65535 f +0000000015 00000 n +0000012867 00000 n +0000000280 00000 n +0000000317 00000 n +0000031253 00000 n +0000000397 00000 n +0000000435 00000 n +0000000899 00000 n +0000001363 00000 n +0000001826 00000 n +0000002291 00000 n +0000002756 00000 n +0000003221 00000 n +0000003685 00000 n +0000004149 00000 n +0000004613 00000 n +0000005078 00000 n +0000005543 00000 n +0000005585 00000 n +0000005624 00000 n +0000005939 00000 n +0000006254 00000 n +0000006562 00000 n +0000006871 00000 n +0000007187 00000 n +0000007496 00000 n +0000007813 00000 n +0000008130 00000 n +0000008439 00000 n +0000008755 00000 n +0000008832 00000 n +0000013379 00000 n +0000018825 00000 n +0000018165 00000 n +0000018093 00000 n +0000017825 00000 n +0000013544 00000 n +0000013435 00000 n +0000013725 00000 n +0000013616 00000 n +0000013906 00000 n +0000013797 00000 n +0000014088 00000 n +0000013978 00000 n +0000014270 00000 n +0000014160 00000 n +0000014452 00000 n +0000014342 00000 n +0000014634 00000 n +0000014524 00000 n +0000014816 00000 n +0000014706 00000 n +0000014998 00000 n +0000014888 00000 n +0000015180 00000 n +0000015070 00000 n +0000015362 00000 n +0000015252 00000 n +0000015511 00000 n +0000015434 00000 n +0000015660 00000 n +0000015583 00000 n +0000015809 00000 n +0000015732 00000 n +0000015958 00000 n +0000015881 00000 n +0000016107 00000 n +0000016030 00000 n +0000016256 00000 n +0000016179 00000 n +0000016405 00000 n +0000016328 00000 n +0000016554 00000 n +0000016477 00000 n +0000016703 00000 n +0000016626 00000 n +0000016853 00000 n +0000016775 00000 n +0000017003 00000 n +0000016925 00000 n +0000017153 00000 n +0000017075 00000 n +0000017303 00000 n +0000017225 00000 n +0000017453 00000 n +0000017375 00000 n +0000017603 00000 n +0000017525 00000 n +0000017753 00000 n +0000017675 00000 n +0000018250 00000 n +0000018387 00000 n +0000018412 00000 n +0000018437 00000 n +0000018462 00000 n +0000018487 00000 n +0000018512 00000 n +0000018537 00000 n +0000018562 00000 n +0000018587 00000 n +0000018613 00000 n +0000018639 00000 n +0000018665 00000 n +0000018919 00000 n +0000019119 00000 n +0000029919 00000 n +0000030170 00000 n +0000030826 00000 n +trailer +<> +startxref +31401 +%%EOF diff --git a/figures/diagrams/timeline-infra.pdf b/figures/diagrams/timeline-infra.pdf new file mode 100644 index 0000000..644f72b Binary files /dev/null and b/figures/diagrams/timeline-infra.pdf differ diff --git a/figures/worksimple/Icon.png b/figures/worksimple/Icon.png new file mode 100644 index 0000000..98c413d Binary files /dev/null and b/figures/worksimple/Icon.png differ diff --git a/figures/worksimple/Logo_Normal.png b/figures/worksimple/Logo_Normal.png new file mode 100644 index 0000000..1b555b8 Binary files /dev/null and b/figures/worksimple/Logo_Normal.png differ diff --git a/figures/worksimple/Logo_SW.png b/figures/worksimple/Logo_SW.png new file mode 100644 index 0000000..1e367f6 Binary files /dev/null and b/figures/worksimple/Logo_SW.png differ