From ebb506d227cfddad5a05ea176e9af1a1ffe53051 Mon Sep 17 00:00:00 2001 From: 0qln <0qln@proton.me> Date: Tue, 25 Aug 2026 20:17:44 +0200 Subject: [PATCH] chap 4: Konzeption; lookup trade-off table; longtable fix for runaway float loop --- appendix/appendix-tables.tex | 127 +++++++++++++++++------- chapters/conception/authorization.tex | 57 +++++++++-- chapters/conception/document-types.tex | 50 +++++++++- chapters/conception/lookup-decision.tex | 64 ++++++++++-- chapters/conception/lookup-research.tex | 56 ++++++++++- chapters/conception/s3-layout.tex | 65 ++++++++++-- chapters/conception/ui-concept.tex | 38 ++++++- figures/diagrams/auth-sequence.mmd | 26 +++-- figures/diagrams/auth-sequence.pdf | Bin 0 -> 44920 bytes figures/diagrams/lookup-flow.mmd | 24 +++-- figures/diagrams/lookup-flow.pdf | Bin 0 -> 23666 bytes figures/diagrams/s3-layout.mmd | 27 +++-- figures/diagrams/s3-layout.pdf | Bin 0 -> 28389 bytes 13 files changed, 428 insertions(+), 106 deletions(-) create mode 100644 figures/diagrams/auth-sequence.pdf create mode 100644 figures/diagrams/lookup-flow.pdf create mode 100644 figures/diagrams/s3-layout.pdf diff --git a/appendix/appendix-tables.tex b/appendix/appendix-tables.tex index b000c09..ad11a80 100644 --- a/appendix/appendix-tables.tex +++ b/appendix/appendix-tables.tex @@ -1,42 +1,48 @@ -\begin{table}[H] -\centering -\small -\begin{tabularx}{\textwidth}{@{} l X c c l @{}} +\begin{longtable}{@{} l p{62mm} c c l @{}} +\caption{Product Backlog Items des Features 484 „Dokumente"} +\label{tab:backlog} \\ \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 @{}} +\endfirsthead \toprule -\textbf{Anforderung} & \textbf{Kurzbeschreibung} & \textbf{PBI} \\ +\textbf{ID} & \textbf{Titel} & \textbf{Aufwand} & \textbf{Sprint} & \textbf{Status} \\ \midrule +\endhead +\bottomrule +\endfoot +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 & \footnotesize Timebox & --- & Approved \\ +10134 & \emph{Bug:} Suchfunktion wie auf den anderen Seiten & --- & 17.2026 & To Approve \\ +\end{longtable} + +\begin{longtable}{@{} l p{95mm} l @{}} +\caption{Zuordnung der Anforderungen zu den Product Backlog Items} +\label{tab:requirements} \\ +\toprule +\textbf{Anf.} & \textbf{Kurzbeschreibung} & \textbf{PBI} \\ +\midrule +\endfirsthead +\toprule +\textbf{Anf.} & \textbf{Kurzbeschreibung} & \textbf{PBI} \\ +\midrule +\endhead +\bottomrule +\endfoot FA-1 & Dokumentenliste auf \texttt{/documents} & 9295 \\ FA-2 & Mandantentrennung über \texttt{efecte-org-id} & 9295 \\ FA-3 & Rollenbasierter Zugriff, 403 ohne Berechtigung & 9295 \\ @@ -57,8 +63,53 @@ 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 \\ +\end{longtable} + +\begin{longtable}{@{} p{30mm} p{40mm} p{48mm} l @{}} +\caption{Bewertung der Lösungsansätze für den Kundenordner-Lookup} +\label{tab:lookup-tradeoffs} \\ +\toprule +\textbf{Ansatz} & \textbf{Vorteil} & \textbf{Ausschlussgrund} & \textbf{Ergebnis} \\ +\midrule +\endfirsthead +\toprule +\textbf{Ansatz} & \textbf{Vorteil} & \textbf{Ausschlussgrund} & \textbf{Ergebnis} \\ +\midrule +\endhead \bottomrule -\end{tabularx} -\caption{Zuordnung der Anforderungen zu den Product Backlog Items} -\label{tab:requirements} -\end{table} +\endfoot +In-Memory-Cache + & Folgeaufrufe kostenlos + & Pro Instanz eigener Cache; nach Neustart leer; linearer Aufwand bleibt + & verworfen \\ +\addlinespace +Claim im Anmelde\-token + & Aufwand nur je Anmeldung + & Token unveränderlich, wird bei Umbenennung inkonsistent + & verworfen \\ +\addlinespace +Feld in Efecte + & Löst das Problem vollständig + & Zweite Datenhaltung mit Konsistenzrisiko; Nachpflege aller Bestandskunden + & verworfen \\ +\addlinespace +S3 Select + & Serverseitige Filterung + & Filtert Objektinhalte, nicht Metadaten mehrerer Objekte + & ungeeignet \\ +\addlinespace +StorageGRID Search Integration + & Echte Metadatensuche; fachlich sauberste Lösung + & Vom Betreiber nicht angeboten + & nicht verfügbar \\ +\addlinespace +Organisations-ID im Ordnernamen + & Technisch einfachste Lösung + & Zerstört die alphabetische Sortierung nach Kundennamen + & verworfen \\ +\addlinespace +\textbf{Ableitung aus dem Firmennamen} + & Ein Aufruf im Regelfall; keine zweite Datenhaltung; selbstheilend + & Mutierender Anteil im Anfragepfad (Abschnitt~\ref{sec:race-conditions}) + & \textbf{gewählt} \\ +\end{longtable} diff --git a/chapters/conception/authorization.tex b/chapters/conception/authorization.tex index 63b7423..c50fa7d 100644 --- a/chapters/conception/authorization.tex +++ b/chapters/conception/authorization.tex @@ -1,13 +1,52 @@ \section{Autorisierungskonzept} \label{sec:authorization} -% TODO: App-Rolle Documents.Read (Entra ID), Claim efecte:company_id -% Menüpunkt nur sichtbar mit Rolle, Direktzugriff ohne Rolle → 403 (nicht 404) -% Sequence-Diagramm auth-sequence.pdf +Der Dokumentenbereich verarbeitet Vertragsunterlagen, Abrechnungsdaten und Security Assessments. Ein fehlerhafter Zugriff hätte damit unmittelbar die Offenlegung vertraulicher Kundendaten zur Folge. Das Autorisierungskonzept arbeitet deshalb zweistufig: Eine Rollenprüfung entscheidet, \emph{ob} ein Benutzer den Bereich überhaupt betreten darf, und eine Mandantenprüfung entscheidet, \emph{welche} Dokumente er darin sieht. -% \begin{figure}[H] -% \centering -% \includegraphics[width=0.9\textwidth]{figures/diagrams/auth-sequence.pdf} -% \caption{Autorisierungsablauf} -% \label{fig:auth-sequence} -% \end{figure} +\subsection{Authentifizierung und Claims} + +Die Authentifizierung erfolgt wie in der übrigen Houston-Anwendung über Microsoft Entra~ID. Nach erfolgreicher Anmeldung erhält Houston ein Token, das neben der Identität des Benutzers zwei für dieses Projekt wesentliche Angaben enthält: + +\begin{itemize} + \item die \textbf{Efecte-Organisations-ID} des Benutzers, über die seine Zugehörigkeit zu einem Kunden bestimmt wird, + \item den \textbf{Efecte-Firmennamen}, der über den Claim \texttt{efecte:company\_name} bereitgestellt wird. +\end{itemize} + +Beide Werte lagen bereits vor Projektbeginn im Token vor und mussten nicht neu eingeführt werden. Dass der Firmenname verfügbar ist, wurde erst im Rahmen der Recherche zum Kundenordner-Lookup als relevant erkannt — er ermöglicht es, den Ordnernamen ohne zusätzlichen Efecte-Aufruf zu bestimmen (siehe Abschnitt~\ref{sec:lookup-decision}). + +\subsection{Anwendungsrolle Documents.Read} + +Für den Zugriff auf den Dokumentenbereich wurde in Entra~ID die Anwendungsrolle \texttt{Documents.Read} angelegt. In der Feature-Analyse war ausdrücklich geklärt worden, dass keine feingranulareren Berechtigungen unterhalb der Menüpunkt-Ebene erforderlich sind: Ein Benutzer sieht entweder alle Dokumente seiner Organisation oder gar keine. Eine Differenzierung nach Dokumententyp — etwa ein Zugriff auf Monitoring-Reports ohne Zugriff auf Vertragsunterlagen — wurde bewusst nicht vorgesehen. + +Die Rolle wirkt an zwei Stellen. Erstens steuert sie die Sichtbarkeit des Navigationspunkts: Ohne die Rolle erscheint „Dokumente" nicht im Menü. Zweitens schützt sie die Seite selbst gegen den direkten Aufruf über die URL. Die zweite Prüfung ist die eigentlich sicherheitsrelevante; das Ausblenden des Menüpunkts ist reine Benutzerführung und darf nicht als Schutzmaßnahme betrachtet werden. + +\subsection{403 statt 404} + +Ein diskutierter Punkt war die Frage, welche Antwort ein Benutzer ohne Berechtigung beim direkten Aufruf von \texttt{/documents} erhalten soll. Die ursprüngliche Fassung der Anforderung sah eine 404-Antwort vor. Die Überlegung dahinter ist verbreitet: Eine 404-Antwort verrät nicht, dass die Ressource überhaupt existiert, und verhindert damit Rückschlüsse auf vorhandene Funktionen. + +Im Verlauf der Umsetzung wurde die Anforderung auf eine 403-Antwort geändert. Ausschlaggebend waren zwei Argumente. Zum einen ist die Existenz des Dokumentenbereichs kein Geheimnis — es handelt sich um eine allgemein bekannte Funktion des Kundenportals, nicht um eine verborgene Ressource. Der Informationsgewinn eines Angreifers ist damit gleich null. Zum anderen erschwert eine 404-Antwort die Fehlersuche erheblich: Ein Benutzer, dem versehentlich die Rolle fehlt, erhält dieselbe Antwort wie bei einem Tippfehler in der Adresse. Genau dieser Fall trat später im Abnahmetest tatsächlich ein (siehe Abschnitt~\ref{sec:acceptance-testing}) und bestätigte die Entscheidung. + +Der Trade-off lautet also: minimaler, hier praktisch nicht vorhandener Informationsgewinn für einen Angreifer gegen deutlich bessere Diagnostizierbarkeit im Betrieb. Die Entscheidung fiel zugunsten der Diagnostizierbarkeit. + +\subsection{Mandantentrennung} + +Die zweite Stufe stellt sicher, dass ein berechtigter Benutzer ausschließlich die Dokumente seiner eigenen Organisation sieht. Sie beruht vollständig auf dem Ablagekonzept aus Abschnitt~\ref{sec:s3-layout}: Aus der Organisations-ID im Token wird der zugehörige Kundenordner aufgelöst, und sämtliche Abfragen an den Speicher werden auf dieses Präfix eingeschränkt. + +Entscheidend ist dabei, dass die Einschränkung nicht nachträglich auf ein bereits geladenes Ergebnis angewendet wird, sondern bereits Bestandteil der Abfrage ist. Houston lädt zu keinem Zeitpunkt Dokumente fremder Kunden in den Speicher, um sie anschließend herauszufiltern. Ein Fehler in der Darstellungsschicht kann damit nicht zu einer Offenlegung führen. + +Abbildung~\ref{fig:auth-sequence} stellt den vollständigen Ablauf dar. + +\begin{figure}[H] + \centering + \includegraphics[width=\textwidth]{figures/diagrams/auth-sequence.pdf} + \caption{Ablauf von Authentifizierung und Autorisierung} + \label{fig:auth-sequence} +\end{figure} + +\subsection{Absicherung der Einzelzugriffe} + +Die Auflistung ist nicht der einzige Zugriffspfad. Auch der Download einzelner Dokumente, der ZIP-Download, die PDF-Vorschau und die Freigabelinks nehmen jeweils einen Dokumentschlüssel entgegen. Für jeden dieser Pfade gilt dieselbe Regel: Der angeforderte Schlüssel wird gegen das aufgelöste Kundenpräfix geprüft, bevor auf den Speicher zugegriffen wird. + +Zusätzlich wird der übergebene Pfad daraufhin untersucht, ob er Bestandteile enthält, mit denen sich der Kundenordner verlassen ließe. Ohne diese Prüfung könnte ein Benutzer durch Manipulation des Parameters auf fremde Ordner zugreifen, obwohl das Präfix zunächst korrekt gesetzt war. Diese Anforderung (NFA-6) wurde im Approval-Termin ausdrücklich in die Akzeptanzkriterien aufgenommen. + +Die Freigabelinks stellen dabei keine Ausnahme dar: Sie enthalten keine Anmeldeinformationen und gewähren keinen eigenständigen Zugriff. Ein Empfänger, der nicht über die Rolle und die passende Organisationszugehörigkeit verfügt, erhält beim Aufruf dieselbe 403-Antwort wie bei jedem anderen Zugriffsversuch. Der Link dient ausschließlich dazu, innerhalb des berechtigten Personenkreises auf ein bestimmtes Dokument zu verweisen. diff --git a/chapters/conception/document-types.tex b/chapters/conception/document-types.tex index 919bc8c..999cc69 100644 --- a/chapters/conception/document-types.tex +++ b/chapters/conception/document-types.tex @@ -1,7 +1,49 @@ \section{Dokumententypen und Icons} \label{sec:document-types} -% TODO: 7 Typen hardcoded in Houston (PBI 9560/9549): -% Service-Protokoll, Abnahme Dokumente, SLA-Reports, Monitoring Reports, -% Security Assessments, Abrechnungsdaten, Vertragsunterlagen -% Typzuordnung über Unterordnername, Tabelle im Anhang +\subsection{Der Typenkatalog} + +Die sieben Dokumententypen wurden fachlich in der Feature-Beschreibung festgelegt und im Projektverlauf nicht verändert. Sie bilden die Kategorien ab, in denen WorkSimple gegenüber Kunden regelmäßig Unterlagen bereitstellt. Tabelle~\ref{tab:document-types} zeigt den Katalog mit dem jeweiligen Ordnernamen im Speicher. + +\begin{table}[H] +\centering +\begin{tabularx}{\textwidth}{@{} l X @{}} +\toprule +\textbf{Ordnername im S3} & \textbf{Fachliche Bedeutung} \\ +\midrule +\texttt{Service-Protokoll} & Protokolle erbrachter Serviceleistungen \\ +\texttt{Abnahme Dokumente} & Abnahmeprotokolle abgeschlossener Projekte \\ +\texttt{SLA-Reports Ticketbearbeitung} & Auswertungen zur Einhaltung vereinbarter Reaktionszeiten \\ +\texttt{Monitoring Reports} & Periodische Auswertungen aus der Systemüberwachung \\ +\texttt{Security Assessments} & Ergebnisse von Sicherheitsbewertungen \\ +\texttt{Abrechnungsdaten} & Abrechnungsunterlagen, gegliedert nach Monat, Jahr und Service \\ +\texttt{Vertragsunterlagen} & Verträge, Leistungsscheine und zugehörige Dokumente \\ +\bottomrule +\end{tabularx} +\caption{Katalog der Dokumententypen} +\label{tab:document-types} +\end{table} + +\subsection{Feste Kodierung statt Konfiguration} + +Im Approval-Termin stellte \emph{Timo Walter} die Frage, ob die Kategorien konfigurierbar sein sollen und ob im Betrieb weitere Typen hinzukommen können. Die Entscheidung fiel auf eine feste Kodierung in Houston. Dafür sprechen mehrere Überlegungen. + +Der Typenkatalog ist fachlich stabil. Er leitet sich aus den Leistungen ab, die WorkSimple erbringt, und ändert sich allenfalls im Rhythmus von Jahren. Eine Konfigurierbarkeit würde für diesen Änderungsrhythmus eine Verwaltungsoberfläche, ein Speicherformat und eine Migrationsstrategie erfordern — ein Aufwand, der in keinem Verhältnis zum Nutzen steht. + +Hinzu kommt, dass die Typen nicht nur als Beschriftung auftreten. Jeder Typ benötigt ein Icon und eine Übersetzung, und beide müssten bei einem frei konfigurierbaren Katalog ebenfalls hinterlegbar sein. Ein neuer Typ ohne Icon fiele in der Oberfläche unangenehm auf. Die feste Kodierung stellt sicher, dass Ordnername, Anzeigetext und Icon stets gemeinsam gepflegt werden. + +Der Preis dieser Entscheidung ist, dass das Hinzufügen eines Typs eine Codeänderung und ein Release erfordert. Angesichts der erwarteten Änderungshäufigkeit ist das vertretbar. + +\subsection{Verhalten bei unbekannten Ordnern} + +Aus der festen Kodierung ergibt sich unmittelbar die Frage, wie mit Unterordnern umzugehen ist, die nicht im Katalog stehen. Ein Kundenbetreuer könnte in Filestash versehentlich einen Ordner \texttt{Sonstiges} anlegen oder sich beim Namen vertippen. + +Das Konzept sieht vor, dass Dokumente in solchen Ordnern nicht verschwinden. Sie werden angezeigt und erhalten ein neutrales Standard-Icon; lediglich die Typzuordnung entfällt. Die Alternative — solche Dokumente auszublenden — wurde verworfen, weil sie ein stilles Fehlverhalten erzeugen würde: Ein hochgeladenes Dokument wäre für den Kunden unsichtbar, ohne dass dies für den Betreuer erkennbar wäre. + +Zu unterscheiden ist dieser Fall vom Umgang mit unbekannten Ordnern auf der \emph{obersten} Ebene. Dort führt ein fehlendes Marker-Metadatum zum vollständigen Ausschluss (siehe Abschnitt~\ref{sec:s3-layout}). Der Unterschied ist beabsichtigt: Auf oberster Ebene entscheidet die Struktur über die Mandantentrennung, hier gilt im Zweifel Ausschluss. Innerhalb eines Kundenordners ist die Zugehörigkeit dagegen bereits geklärt, und ein unbekannter Unterordner ist lediglich ein Darstellungsproblem. + +\subsection{Übersetzung der Anzeigenamen} + +Die Ordnernamen im Speicher dienen zwei verschiedenen Zielgruppen. Für die Kundenbetreuer, die in Filestash arbeiten, müssen sie lesbar und eindeutig sein. Für den Kunden in Houston sollen sie sich in die Oberfläche einfügen. + +Aus diesem Grund wird der Ordnername nicht unverändert angezeigt, sondern über eine Ressourcendatei auf einen Anzeigetext abgebildet. Dieses Vorgehen entspricht dem in Houston bereits etablierten Muster zur Lokalisierung und erlaubt es, den Anzeigetext zu ändern, ohne die Struktur im Speicher anzufassen — eine Umbenennung dort würde bedeuten, sämtliche betroffenen Objekte umzukopieren. diff --git a/chapters/conception/lookup-decision.tex b/chapters/conception/lookup-decision.tex index 29cd0e7..23b1ed6 100644 --- a/chapters/conception/lookup-decision.tex +++ b/chapters/conception/lookup-decision.tex @@ -1,13 +1,57 @@ -\section{Architekturentscheidung: O(1)-Fast-Path} +\section{Architekturentscheidung: Namensgebung durch Houston} \label{sec:lookup-decision} -% TODO: PBI 10018 — metadatenbasierter Fast-Path -% ResolveCustomerPrefixAsync: Fast-Path → Kollisions-Fast-Path → O(n)-Fallback + Self-Healing-Rename -% Houston als führende Instanz für Ordnerbenennung +\subsection{Die zugrunde liegende Idee} -% \begin{figure}[H] -% \centering -% \includegraphics[width=\textwidth]{figures/diagrams/lookup-flow.pdf} -% \caption{Ablauf \texttt{ResolveCustomerPrefixAsync}} -% \label{fig:lookup-flow} -% \end{figure} +Alle in Abschnitt~\ref{sec:lookup-research} betrachteten Ansätze versuchen, die Zuordnung zwischen Organisations-ID und Ordnername \emph{zusätzlich} irgendwo zu hinterlegen — in einem Cache, in einem Token, in Efecte oder in einer Zuordnungsdatei. Jeder dieser Ansätze führt damit eine zweite Datenhaltung ein, die mit der ersten konsistent gehalten werden muss. + +Die schließlich gewählte Lösung dreht die Fragestellung um. Statt die Zuordnung nachzuschlagen, wird sie \emph{berechenbar} gemacht: Wenn der Ordnername sich deterministisch aus dem Firmennamen ableiten lässt und dieser Firmenname bereits im Anmeldetoken steht, kann Houston den erwarteten Ordnernamen ohne jeden Nachschlagevorgang bestimmen. Aus der Suche wird ein direkter Zugriff. + +Voraussetzung dafür ist, dass die Ordner im Speicher tatsächlich so heißen, wie Houston es erwartet. Genau hier setzt die eigentliche Entscheidung an: \textbf{Houston wird zur führenden Instanz für die Namensgebung der Kundenordner.} Weicht ein Ordner vom erwarteten Namen ab, wird nicht der Erwartungswert angepasst, sondern der Ordner umbenannt. + +Diese Festlegung ist deshalb vertretbar, weil Houston die Ordnerstruktur ohnehin selbst anlegt (FA-13). Wenn die Anwendung neue Kundenordner erzeugt, ist es folgerichtig, dass sie auch deren Benennung verantwortet. Die Kundenbetreuer verlieren dadurch nichts: Der Ordner heißt weiterhin nach dem Kunden, nur eben in einer normalisierten Form. + +\subsection{Ableitung des Ordnernamens} + +Der Firmenname aus dem Token kann nicht unverändert als Ordnername verwendet werden. Er kann Zeichen enthalten, die im Schlüssel problematisch sind, führende oder abschließende Leerzeichen aufweisen oder beliebig lang sein. Er wird deshalb durch eine Normalisierungsfunktion geführt, die im weiteren Verlauf als \emph{Slug} bezeichnet wird. + +Die Normalisierung folgt zwei Leitgedanken. Sie muss \textbf{deterministisch} sein — derselbe Firmenname muss stets denselben Ordnernamen ergeben, sonst funktioniert der direkte Zugriff nicht. Und sie muss das Ergebnis \textbf{lesbar} halten, weil der Ordner in Filestash von Menschen bedient wird. Aus dem zweiten Punkt folgt eine bewusste Abweichung von der üblichen Praxis: Umlaute werden \emph{nicht} ersetzt. Eine Firma „Müller GmbH" erhält den Ordner \texttt{Müller GmbH} und nicht \texttt{Mueller GmbH}, weil der Betreuer sie andernfalls in der alphabetischen Liste an unerwarteter Stelle suchen müsste. Die Zulässigkeit solcher Zeichen in Objektschlüsseln wurde anhand der Herstellerdokumentation geprüft \autocite{aws-s3-naming, ibm-s3-naming}; die Frage war auch Gegenstand des Code-Reviews. + +\subsection{Umgang mit Namenskollisionen} + +Firmennamen sind nicht garantiert eindeutig. Efecte lässt zwei Organisationen mit identischem Namen grundsätzlich zu, und sobald der Ordnername aus dem Firmennamen abgeleitet wird, treffen beide auf denselben Zielnamen. Da eine Verwechslung hier unmittelbar bedeuten würde, dass ein Kunde die Dokumente eines anderen sieht, muss dieser Fall abgedeckt sein. + +Das Konzept löst ihn nach dem Prinzip „wer zuerst kommt, mahlt zuerst": Die erste Organisation, die den Namen beansprucht, erhält ihn. Jede weitere erhält einen Ordner, dem die Organisations-ID in Klammern angehängt wird, also etwa \texttt{Beispielkunde GmbH (77)}. Dieser Name ist eindeutig, bleibt lesbar und sortiert weiterhin unmittelbar neben dem gleichnamigen Ordner. + +Maßgeblich ist dabei eine Sicherheitsregel: Ein Zielname wird nur dann beansprucht, wenn er entweder frei ist oder ausweislich seines Markers bereits der eigenen Organisation gehört. Ein fremder Kundenordner wird unter keinen Umständen überschrieben oder umbenannt. Die Zuordnung entscheidet also immer das Metadatum, niemals der Name — der Name ist nur die Optimierung. + +\subsection{Der resultierende Ablauf} + +Aus diesen Überlegungen ergibt sich ein dreistufiges Verfahren, das in Abbildung~\ref{fig:lookup-flow} dargestellt ist. + +\begin{figure}[H] + \centering + \includegraphics[width=\textwidth]{figures/diagrams/lookup-flow.pdf} + \caption{Auflösung des Kundenordners} + \label{fig:lookup-flow} +\end{figure} + +\begin{enumerate} + \item \textbf{Direktzugriff.} Houston bildet den erwarteten Ordnernamen aus dem Firmennamen und ruft die Metadaten des zugehörigen Markers ab. Existiert er und trägt er die richtige Organisations-ID, ist die Auflösung mit einem einzigen Aufruf abgeschlossen. Dies ist der Regelfall. + \item \textbf{Kollisionsprüfung.} Schlägt der erste Schritt fehl — weil der Marker fehlt oder eine fremde Organisations-ID trägt — wird derselbe Zugriff mit dem um die Organisations-ID ergänzten Namen wiederholt. Damit ist der Kollisionsfall mit zwei Aufrufen abgedeckt. + \item \textbf{Rückfallebene.} Erst wenn auch das nicht greift, kommt das ursprüngliche, lineare Verfahren zum Einsatz. Wird dabei ein Ordner mit passender Organisations-ID gefunden, trägt er offenbar einen abweichenden Namen und wird auf den kanonischen Namen umbenannt. Wird kein Ordner gefunden, existiert der Kunde im Speicher noch nicht und die vollständige Struktur wird angelegt. +\end{enumerate} + +\subsection{Selbstheilung} + +Die entscheidende Eigenschaft dieses Verfahrens liegt im dritten Schritt. Die Rückfallebene beseitigt nicht nur den unmittelbaren Fehlschlag, sondern auch dessen Ursache: Nach der Umbenennung trägt der Ordner den erwarteten Namen, und der nächste Zugriff derselben Organisation wird wieder über den Direktzugriff abgewickelt. + +Der teure Pfad wird damit pro Kunde höchstens einmal durchlaufen. Bestehende Ordner, die vor Einführung des Verfahrens angelegt wurden und beliebige Namen tragen, migrieren sich beim ersten Zugriff des jeweiligen Kunden von selbst. Eine gesonderte Migration ist nicht erforderlich. + +Ebenso wenig erfordert das Verfahren eine zusätzliche Datenhaltung. Es gibt keinen Cache, der invalidiert werden müsste, kein Feld in einem Fremdsystem und keine Zuordnungsdatei. Der Zustand liegt vollständig im Speicher selbst, und die Anwendung ist zu jedem Zeitpunkt in der Lage, aus einem beliebigen Ausgangszustand den Sollzustand herzustellen. + +\subsection{Bewusst offen gelassener Bereich} + +Das Verfahren hat einen Preis, der bei der Entscheidung bekannt war: Die Rückfallebene ist nicht mehr nur lesend. Sie benennt Ordner um und legt sie an — und das im Rahmen einer gewöhnlichen Seitenanfrage. Da Houston in mehreren Instanzen betrieben wird, können zwei solche Anfragen gleichzeitig auf denselben Ordner treffen. + +Dieser Umstand wurde während der Umsetzung erkannt, in seinen Auswirkungen analysiert und als eigenes Backlog Item vom laufenden Pull Request abgegrenzt. Die Entscheidung, die Abgrenzung so vorzunehmen, wurde mit dem Team abgestimmt. Abschnitt~\ref{sec:race-conditions} behandelt die konkreten Fehlerszenarien und die erwogenen Gegenmaßnahmen im Detail. diff --git a/chapters/conception/lookup-research.tex b/chapters/conception/lookup-research.tex index 4317894..a72f09c 100644 --- a/chapters/conception/lookup-research.tex +++ b/chapters/conception/lookup-research.tex @@ -1,8 +1,54 @@ -\section{Problem: Lookup des Kundenordners} +\section{Das Lookup-Problem} \label{sec:lookup-research} -% TODO: PBI 9857 — S3 kann nicht nach Metadaten-Tags suchen → lineares Scannen aller Top-Level-Prefixes -% Trade-off-Matrix der 6 Varianten (In-Memory Cache, Claim, Efecte-Feld, S3 SelectObject, Search Integration, Prefix im Namen) -% \cite{aws-s3-select}, \cite{storagegrid-search-integration} +\subsection{Entstehung} -% Tabelle~\ref{tab:lookup-tradeoffs} im Anhang +Der Document Explorer war zum Zeitpunkt seines Merges am 31.~Juli 2026 funktionsfähig, enthielt aber eine Schwäche, die bereits im Code-Review angesprochen worden war. Um den Kundenordner zu einer Organisations-ID zu finden, listete Houston sämtliche Ordner auf der obersten Ebene des Buckets auf, rief für jeden davon die Metadaten ab und verglich die hinterlegte \texttt{efecte-org-id} mit der des angemeldeten Benutzers. + +Die Ursache liegt in der bereits beschriebenen Eigenschaft von S3: Objekte lassen sich nicht anhand ihrer benutzerdefinierten Metadaten suchen. Die Operation \texttt{ListObjectsV2} liefert Schlüssel, Größe und Änderungszeitpunkt, aber keine benutzerdefinierten Metadaten \autocite{aws-listobjectsv2}. Um an das Marker-Metadatum zu gelangen, ist für jeden Kandidaten ein eigener Aufruf nötig. + +Damit wächst der Aufwand für die Auflösung des Kundenordners linear mit der Anzahl der Kunden — und zwar bei \emph{jedem} Seitenaufruf jedes Benutzers. Bei einer zweistelligen Kundenzahl fällt das kaum auf; bei einigen hundert Kunden bedeutet es einige hundert Netzwerkaufrufe, bevor überhaupt das erste Dokument geladen wird. Das Problem ist also nicht akut, aber strukturell: Es verschlechtert sich mit dem Erfolg des Produkts. + +Aus dieser Erkenntnis entstand am 28.~Juli ein eigenes Backlog Item. Bemerkenswert ist, dass es bewusst nicht als Umsetzungs-, sondern als \emph{Recherche}-Item angelegt wurde. Das Akzeptanzkriterium lautete nicht „das Problem ist behoben", sondern „es ist sich für einen Lösungsansatz entschieden worden". Diese Zuschnitt-Entscheidung trennt die Frage, welche Lösung die richtige ist, von der Frage, wie sie umzusetzen ist — und macht den Rechercheaufwand als eigenständige Leistung sichtbar, statt ihn in einer Implementierungsaufgabe zu verstecken. + +\subsection{Untersuchte Lösungsansätze} + +Im Zuge der Recherche wurden sechs Ansätze betrachtet und mit \emph{Timo Walter} sowie den Ansprechpartnern für die Speicherinfrastruktur diskutiert. Tabelle~\ref{tab:lookup-tradeoffs} im Anhang fasst die Bewertung zusammen; im Folgenden werden die Ansätze und ihre jeweiligen Schwächen erläutert. + +\subsubsection{In-Memory-Cache} + +Der naheliegendste Ansatz ist, das Ergebnis der Auflösung im Arbeitsspeicher der Anwendung zwischenzuspeichern. Der erste Aufruf bleibt teuer, alle folgenden sind kostenlos. + +Der Ansatz behebt das Problem jedoch nur oberflächlich. Houston läuft in mehr als einer Instanz, sodass jede Instanz ihren eigenen Cache aufbauen müsste. Nach jedem Neustart oder jeder Bereitstellung ist der Cache leer, und es entsteht ein Ansturm teurer Auflösungen. Vor allem aber bleibt der zugrunde liegende lineare Aufwand unverändert bestehen — er wird lediglich seltener bezahlt. Ein Cache ist eine Optimierung, keine Lösung. + +\subsubsection{Speicherung im Anmeldetoken} + +Alternativ ließe sich der Ordnername bei der Anmeldung ermitteln und als zusätzlicher Claim im Token ablegen. Gegenüber dem Cache verschiebt das den Aufwand von jedem Seitenaufruf auf jede Anmeldung. + +Auch hier bleibt der lineare Aufwand erhalten. Hinzu kommt ein Konsistenzproblem: Ein Token ist über seine Laufzeit unveränderlich. Wird der Ordner im Speicher umbenannt, während ein Benutzer angemeldet ist, zeigt der Claim auf einen nicht mehr existierenden Ordner, bis das Token erneuert wird. + +\subsubsection{Speicherung als Feld in Efecte} + +Der Ordnername könnte auch als zusätzliches Feld an der Organisation in Efecte gepflegt werden. Houston würde ihn dann gemeinsam mit den übrigen Organisationsdaten laden. + +Dieser Ansatz löst das Problem technisch, führt aber eine neue Abhängigkeit ein und verlagert die Pflege in ein weiteres System. Die Zuordnung zwischen Kunde und Ordner läge damit an zwei Stellen — im Efecte-Feld und im Marker-Metadatum — die auseinanderlaufen können. Zudem müsste das Feld für jeden Bestandskunden nachgepflegt werden. + +\subsubsection{S3 Select} + +Die Operation \texttt{SelectObjectContent} erlaubt es, den \emph{Inhalt} eines Objekts serverseitig per SQL-ähnlicher Abfrage zu filtern \autocite{aws-s3-select}. Denkbar wäre gewesen, eine Zuordnungstabelle als Datei im Bucket abzulegen und den passenden Eintrag serverseitig herauszufiltern. + +Die Freischaltung wurde beantragt und am 7.~August durch den Betreiber bestätigt (siehe Abschnitt~\ref{sec:infrastructure}). Bei genauerer Betrachtung erwies sich der Ansatz jedoch als unpassend: S3 Select filtert Inhalte einzelner Objekte, nicht Metadaten mehrerer Objekte. Eine Zuordnungsdatei wäre eine zusätzliche, manuell oder programmatisch zu pflegende Struktur — mit demselben Konsistenzproblem wie beim Efecte-Feld, nur ohne dessen Werkzeugunterstützung. + +\subsubsection{StorageGRID Search Integration} + +Der Search Integration Service spiegelt Objektmetadaten in einen Elasticsearch-Index und ermöglicht damit genau das, was S3 selbst nicht bietet: eine echte Suche über Metadaten \autocite{storagegrid-search-integration}. Fachlich wäre dies die sauberste Lösung gewesen, da sie das Problem an der Wurzel behebt, ohne eine zweite Datenhaltung einzuführen. + +Die Anfrage über den Betreiber ergab am 17.~August, dass die Funktion derzeit nicht angeboten wird. Damit schied der Ansatz aus. Er wurde in den Ausblick übernommen (siehe Abschnitt~\ref{sec:outlook}). + +\subsubsection{Organisations-ID im Ordnernamen} + +Der technisch einfachste Ansatz wäre gewesen, die Organisations-ID zum Bestandteil des Ordnernamens zu machen — etwa als Präfix \texttt{42\_Beispielkunde GmbH}. Der Lookup reduzierte sich dann auf eine einzige Präfixabfrage. + +Dieser Ansatz scheiterte an einer fachlichen Anforderung. In der Abstimmung mit \emph{Ralf Schulte} wurde deutlich, dass die Kundenbetreuer die Ordner in Filestash nach Kundennamen sortiert vorfinden müssen, um damit arbeiten zu können. Ein vorangestellter Zahlenschlüssel zerstört diese Sortierung. Der Konflikt ist damit klar benannt: Houston autorisiert über die Organisations-ID, die Betreuer arbeiten über den Kundennamen, und der Speicher bietet keinen Mechanismus, zwischen beiden zu vermitteln. + +Die entscheidende Beobachtung war jedoch, dass die Anforderung eine Sortierung nach Kundennamen verlangt — nicht zwingend, dass der Ordnername \emph{ausschließlich} aus dem Kundennamen besteht. Diese Unterscheidung eröffnete den Weg zu der in Abschnitt~\ref{sec:lookup-decision} beschriebenen Lösung. diff --git a/chapters/conception/s3-layout.tex b/chapters/conception/s3-layout.tex index a2f09a5..eef1434 100644 --- a/chapters/conception/s3-layout.tex +++ b/chapters/conception/s3-layout.tex @@ -1,14 +1,59 @@ \section{Ablagekonzept im S3-Speicher} \label{sec:s3-layout} -% TODO: Ordnerbaum (Feature 484): -% Bucket → Kundenordner [meta: efecte_org-id] → Typordner/ → Dokumente -% Typ = Unterordner, nicht Metadatum an der Datei -% Leere Ordner werden nicht angezeigt +Das Ablagekonzept bildet die Grundlage für alle weiteren Entwurfsentscheidungen. Es muss zwei Aufgaben gleichzeitig erfüllen: Es muss festlegen, welche Dokumente zu welchem Kunden gehören, und es muss den fachlichen Typ eines Dokuments abbilden. Beides geschieht ausschließlich über die Struktur im Speicher, ohne eine zusätzliche Datenbank. -% \begin{figure}[H] -% \centering -% \includegraphics[width=0.75\textwidth]{figures/diagrams/s3-layout.pdf} -% \caption{S3-Ablagestruktur} -% \label{fig:s3-layout} -% \end{figure} +\subsection{Präfixe statt Ordner} + +S3 kennt technisch keine Ordner. Jedes Objekt wird über einen Schlüssel adressiert, der als Zeichenkette in einem flachen Namensraum liegt. Die scheinbare Hierarchie entsteht erst beim Auflisten: Übergibt man der Operation \texttt{ListObjectsV2} ein Präfix und ein Trennzeichen, liefert der Dienst nur die Objekte unterhalb dieses Präfixes zurück sowie die gemeinsamen Teilpräfixe der nächsten Ebene \autocite{aws-listobjectsv2}. Ein Schlüssel wie + +\begin{quote} +\texttt{Beispielkunde GmbH/Service-Protokoll/Protokoll-2026-07.pdf} +\end{quote} + +wird in einem Dateibrowser wie Filestash als zweistufige Ordnerhierarchie dargestellt, ist im Speicher jedoch nur eine einzelne Zeichenkette. Diese Eigenschaft ist für das Konzept vorteilhaft, weil sie das Auflisten eines Kundenordners auf eine einzige Präfixabfrage reduziert. Sie hat aber auch eine Konsequenz, die im weiteren Verlauf noch bedeutsam wird: Ein „Ordner" existiert erst dann, wenn mindestens ein Objekt mit dem entsprechenden Präfix vorhanden ist. Ein leerer Ordner lässt sich nur simulieren, indem ein Platzhalterobjekt angelegt wird, dessen Schlüssel auf das Trennzeichen endet. + +Abbildung~\ref{fig:s3-layout} zeigt die resultierende Struktur. + +\begin{figure}[H] + \centering + \includegraphics[width=0.85\textwidth]{figures/diagrams/s3-layout.pdf} + \caption{Ablagestruktur im S3-Speicher} + \label{fig:s3-layout} +\end{figure} + +\subsection{Kundenzuordnung über ein Marker-Objekt} + +Auf der obersten Ebene des Buckets liegt für jeden Kunden genau ein Ordner. Um diesen Ordner einer Organisation zuzuordnen, wird an dem Platzhalterobjekt, das den Ordner repräsentiert, ein benutzerdefiniertes Metadatum \texttt{efecte-org-id} hinterlegt. Dieses Objekt wird im Folgenden als \emph{Marker} bezeichnet. + +Der Marker erfüllt zwei Zwecke gleichzeitig. Erstens sorgt er dafür, dass der Kundenordner auch dann existiert, wenn noch kein einziges Dokument abgelegt wurde — andernfalls wäre ein frisch angelegter Kunde im Speicher unsichtbar. Zweitens trägt er die Information, welcher Organisation der Ordner gehört. Damit ist die Zuordnung an genau einer Stelle hinterlegt und muss nicht an jedem einzelnen Dokument wiederholt werden. + +Die Entscheidung, die Organisations-ID als Metadatum und nicht als Bestandteil des Ordnernamens zu führen, wurde in der Feature-Analyse getroffen (siehe Abschnitt~\ref{sec:feature-analysis}). Sie ist fachlich motiviert: Die Ordner werden von den Kundenbetreuern über Filestash gepflegt, und ein Ordnername wie \texttt{42} oder \texttt{Beispielkunde GmbH (42)} wäre dort schwer zu handhaben. Der lesbare Firmenname bleibt daher der Ordnername, die technische Zuordnung wandert in die Metadaten. + +Genau diese Entscheidung erzeugt allerdings das zentrale technische Problem des Projekts, das in Abschnitt~\ref{sec:lookup-research} behandelt wird: Houston kennt aus dem Authentifizierungstoken die Organisations-ID, muss daraus aber den Ordnernamen ermitteln — und S3 bietet keine Möglichkeit, Objekte nach Metadaten zu durchsuchen. + +\subsection{Typisierung über Unterordner} + +Innerhalb des Kundenordners liegt für jeden der sieben fachlichen Dokumententypen ein Unterordner. Der Typ eines Dokuments ergibt sich daraus, in welchem Unterordner es abgelegt ist. Dokumente, die direkt im Kundenordner liegen, gelten als untypisiert. + +Auch diese Festlegung stammt aus der Feature-Analyse. Die Alternative wäre gewesen, den Typ als Metadatum an jeder einzelnen Datei zu hinterlegen. Der Vergleich beider Ansätze fällt eindeutig aus: + +\begin{itemize} + \item \textbf{Pflegeaufwand:} Ein Metadatum müsste bei jedem Upload manuell gesetzt werden. Filestash bietet hierfür keine komfortable Unterstützung. Das Ablegen in einem Ordner ist dagegen die natürliche Bedienhandlung. + \item \textbf{Abfragbarkeit:} Der Typ ist als Präfixbestandteil unmittelbar aus dem Schlüssel ablesbar. Beim Auflisten fällt er ohne Zusatzkosten mit an. Ein Metadatum müsste dagegen für jedes Objekt einzeln abgerufen werden, da \texttt{ListObjectsV2} benutzerdefinierte Metadaten nicht mitliefert. Bei $n$ Dokumenten wären das $n$ zusätzliche Aufrufe. + \item \textbf{Filterung:} Eine Filterung nach Typ reduziert sich auf eine Präfixabfrage und ist damit serverseitig umsetzbar. +\end{itemize} + +Dem stehen zwei Nachteile gegenüber. Zum einen kann ein Dokument nur genau einen Typ haben, da es nur an einer Stelle liegen kann; eine Mehrfachzuordnung ist ausgeschlossen. Zum anderen erfordert die Typisierung, dass die Ordner überhaupt existieren — was die automatische Anlage der Ordnerstruktur zu einer eigenen Anforderung macht (FA-13). Beide Einschränkungen wurden bewusst in Kauf genommen. + +\subsection{Sichtbarkeitsregeln} + +Für die Darstellung gelten drei Regeln, die sich aus der Feature-Beschreibung ergeben: + +\begin{enumerate} + \item \textbf{Ordner werden nicht als Einträge angezeigt.} Die Liste zeigt ausschließlich Dokumente; die Ordnerstruktur wird über Typ-Icons und Filter abgebildet, nicht über eine navigierbare Hierarchie. Der Benutzer sieht also eine flache Liste aller seiner Dokumente. + \item \textbf{Leere Typordner erscheinen nicht.} Ein Kunde, für den noch keine Monitoring-Reports abgelegt wurden, sieht diesen Typ nicht als leere Kategorie. + \item \textbf{Ordner ohne gültiges Marker-Metadatum werden ignoriert.} Legt jemand versehentlich einen Ordner auf oberster Ebene an, ohne eine Organisations-ID zu hinterlegen, bleibt dieser für alle Kunden unsichtbar. Der Fall wird protokolliert, führt aber nicht zu einem Fehler und niemals zu einem Zugriff. +\end{enumerate} + +Die dritte Regel ist eine Sicherheitsmaßnahme: Sie stellt sicher, dass ein Ordner nur dann für einen Kunden sichtbar wird, wenn seine Zugehörigkeit ausdrücklich hinterlegt ist. Ein fehlendes Metadatum führt zum Ausschluss, nicht zu einer Vermutung. diff --git a/chapters/conception/ui-concept.tex b/chapters/conception/ui-concept.tex index 7ecdd93..b5ea2b2 100644 --- a/chapters/conception/ui-concept.tex +++ b/chapters/conception/ui-concept.tex @@ -1,5 +1,37 @@ -\section{UI-Konzept und Clickdummy} +\section{UI-Konzept} \label{sec:ui-concept} -% TODO: Hanna Ebner, Branch Clickdummy_Dokumente (2026-07-22) -% Listenansicht, Typfilter oben als Buttons, flexible Tabellenspalten +\subsection{Zuarbeit über einen Clickdummy} + +Das Oberflächenkonzept wurde nicht als Mockup in einem Entwurfswerkzeug erstellt, sondern von \emph{Hanna Ebner} als lauffähiger Clickdummy in einem eigenen Branch des Houston-Repositories umgesetzt und am 22.~Juli 2026 am Feature verlinkt. + +Diese Form der Zuarbeit hat gegenüber einem Bildentwurf spürbare Vorteile. Der Clickdummy verwendet die bestehenden Komponenten und Stile der Anwendung, wodurch das Ergebnis von vornherein zum übrigen Portal passt. Fragen zu Abständen, Schriftgrößen oder Farben stellen sich gar nicht erst, weil sie durch das vorhandene Stylesheet beantwortet werden. Zudem ist das Ergebnis unmittelbar bedienbar: Interaktionen wie das Ein- und Ausklappen von Filtern lassen sich ausprobieren, statt sie aus einer statischen Abbildung erschließen zu müssen. Für die Umsetzung bedeutete das, dass der Clickdummy als Referenz für das Markup dienen konnte und in mehreren Product Backlog Items ausdrücklich als solche benannt wurde. + +\subsection{Flache Liste statt navigierbarer Hierarchie} + +Die auffälligste Entwurfsentscheidung ist, dass der Dokumentenbereich trotz seiner Bezeichnung als „Document Explorer" keine navigierbare Ordnerhierarchie darstellt. Der Benutzer sieht eine flache Liste aller seiner Dokumente; die Typzugehörigkeit wird über ein Icon und über Filter ausgedrückt, nicht über ein Hineinnavigieren in Ordner. + +Der Grund liegt im erwarteten Nutzungsverhalten. Ein Kunde sucht in aller Regel ein bestimmtes Dokument — den letzten Monitoring-Report oder einen konkreten Vertrag. Bei einer Hierarchie müsste er zunächst wissen, in welcher Kategorie es abgelegt ist, und sich dorthin durchklicken. Die flache Liste erlaubt es dagegen, unmittelbar zu suchen oder zu filtern. Da die Hierarchie ohnehin nur zwei Ebenen tief ist und die zweite Ebene aus sieben festen Kategorien besteht, wäre der Navigationsaufwand in keinem Verhältnis zum Nutzen gestanden. + +Diese Entscheidung schlug sich auch in der Formulierung der Anforderungen nieder: Die ursprüngliche Beschreibung sprach von Dokumenten als Kacheln, wurde im Verlauf jedoch auf eine Zeilendarstellung in einer Liste geändert. Eine Zeile bietet Platz für Icon, Name, Auswahlbox und Aktionsschaltflächen und lässt sich später um weitere Spalten erweitern. + +\subsection{Aufbau der Seite} + +Die Seite gliedert sich von oben nach unten in vier Bereiche: + +\begin{enumerate} + \item Eine \textbf{Suchleiste} am oberen Rand, über die nach dem Dokumentnamen gesucht wird. + \item Darunter eine Reihe von \textbf{Filterelementen}, je eines pro Dokumententyp, mit denen sich Typen ein- und ausblenden lassen. + \item Die \textbf{Dokumentenliste} als Tabelle. Jede Zeile enthält das Typ-Icon, den Dokumentnamen sowie die Aktionen Herunterladen, Teilen und — bei PDF-Dateien — Vorschau. Eine Auswahlbox am Zeilenanfang dient der Mehrfachauswahl für den ZIP-Download. + \item Am unteren Rand die \textbf{Blätterelemente} zum Wechsel zwischen den Seiten sowie die Auswahl der Seitengröße. +\end{enumerate} + +Die Tabellenstruktur wurde bewusst erweiterbar angelegt. In der Feature-Beschreibung ist ausdrücklich festgehalten, dass weitere Spalten — etwa für eine Vorschau oder zusätzliche Auswahlmöglichkeiten — ergänzt werden können, ohne den Aufbau zu verändern. + +\subsection{Konsistenz zur bestehenden Anwendung} + +Eine durchgängige Vorgabe war, dass sich der Dokumentenbereich wie die übrigen Houston-Seiten bedienen lassen soll (NFA-4). Das betrifft insbesondere die Paginierung, die wie an anderer Stelle eine benutzerseitig wählbare Seitengröße anbietet, und die Suche, die dem gewohnten Verhalten folgen soll. + +Wie genau diese Vorgabe zu verstehen ist, zeigte sich erst im Abnahmetest: Die zunächst umgesetzte Suchleiste blendete nach einer Eingabe eine Schaltfläche zum Leeren des Feldes ein — eine für sich genommen sinnvolle Funktion, die es auf den übrigen Seiten jedoch nicht gibt. Der Unterschied wurde als Fehler gemeldet (siehe Abschnitt~\ref{sec:acceptance-testing}). Das Beispiel verdeutlicht, dass eine Konsistenzanforderung sich nicht vollständig aus einer Beschreibung ableiten lässt, sondern letztlich am Vergleich mit dem Bestand geprüft werden muss. + +Ein zweiter Punkt betrifft das Zusammenspiel von Freigabelinks und Paginierung. Ein Link, der auf ein bestimmtes Dokument verweist, muss auch dann funktionieren, wenn dieses Dokument nicht auf der ersten Seite liegt. Das Konzept sieht deshalb vor, dass der Freigabelink nicht nur das Dokument benennt, sondern beim Weiterleiten auch die passenden Abfrageparameter setzt, sodass die richtige Seite geladen und an die entsprechende Stelle gesprungen wird. diff --git a/figures/diagrams/auth-sequence.mmd b/figures/diagrams/auth-sequence.mmd index a7d7dde..3ac1360 100644 --- a/figures/diagrams/auth-sequence.mmd +++ b/figures/diagrams/auth-sequence.mmd @@ -1,18 +1,22 @@ sequenceDiagram - participant B as Browser + autonumber + actor U as Benutzer participant H as Houston participant AAD as Entra ID participant S3 as S3-Speicher - B->>H: GET /documents - H->>H: Prüfe Claim Documents.Read - alt Keine Rolle - H-->>B: 403 Forbidden + U->>H: GET /documents + H->>AAD: Authentifizierung (OpenID Connect) + AAD-->>H: Token mit Claims:
roles, efecte:company_id,
efecte:company_name + + alt Rolle Documents.Read fehlt + H-->>U: 403 Forbidden
(Menuepunkt bereits ausgeblendet) else Rolle vorhanden - H->>H: Lese efecte:company_id aus Claim - H->>S3: ResolveCustomerPrefixAsync(orgId) - S3-->>H: Kundenordner-Prefix - H->>S3: ListObjectsV2(prefix) - S3-->>H: Objektliste - H-->>B: Documents-Seite + H->>H: orgId, orgName aus Claims lesen + H->>S3: ResolveCustomerPrefixAsync(orgId, orgName) + S3-->>H: Prefix des Kundenordners + H->>S3: ListObjectsV2(prefix, delimiter) + S3-->>H: Objektliste des Kunden + H->>H: Typ je Dokument aus
Unterordner ableiten + H-->>U: Dokumentenliste end diff --git a/figures/diagrams/auth-sequence.pdf b/figures/diagrams/auth-sequence.pdf new file mode 100644 index 0000000000000000000000000000000000000000..f086dc45f306865b3b9d27f939e02d158b5dd527 GIT binary patch literal 44920 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 literal 0 HcmV?d00001 diff --git a/figures/diagrams/lookup-flow.mmd b/figures/diagrams/lookup-flow.mmd index a2dd7ae..9c4e85d 100644 --- a/figures/diagrams/lookup-flow.mmd +++ b/figures/diagrams/lookup-flow.mmd @@ -1,10 +1,16 @@ flowchart TD - A[ResolveCustomerPrefixAsync\norgId, orgName] --> B{Fast-Path:\nGetObjectMetadata\nslug-name/} - B -->|Gefunden & ID passt| Z[✓ Fertig\n1 Request] - B -->|Nicht gefunden oder\nID passt nicht| C{Kollisions-Fast-Path:\nslug-name orgId /} - C -->|Gefunden| Z2[✓ Fertig\n2 Requests] - C -->|Nicht gefunden| D[Fallback: O-n\nListObjectsV2 alle\nTop-Level-Prefixes] - D -->|Ordner mit\npAssender ID gefunden| E[Rename auf\nkanonischen Namen] - E --> Z3[✓ Fertig\nnächster Lookup O-1] - D -->|Kein Ordner| F[Anlegen: Ordner +\nUnterstruktur 9560] - F --> Z4[✓ Fertig\nSeite leer] + A["ResolveCustomerPrefixAsync(orgId, orgName)"] --> B["Fast-Path:
GetObjectMetadata auf
slug(name)/"] + B -->|"Marker vorhanden
und org-id passt"| Z1["Fertig — 1 Request"] + B -->|"fehlt oder
fremde org-id"| C["Kollisions-Fast-Path:
GetObjectMetadata auf
slug(name) (orgId)/"] + C -->|"Marker vorhanden
und org-id passt"| Z2["Fertig — 2 Requests"] + C -->|"nicht gefunden"| D["Fallback O(n):
alle Top-Level-Prefixes
auflisten und über
org-id filtern"] + D -->|"Ordner gefunden"| E["Rename auf
kanonischen Namen"] + E --> Z3["Fertig — nächster
Lookup ist O(1)"] + D -->|"kein Ordner"| F["Kundenordner samt
Typ-Unterordnern anlegen"] + F --> Z4["Fertig — Seite
zeigt leeren Zustand"] + + style Z1 fill:#d5e8d4,stroke:#82b366 + style Z2 fill:#d5e8d4,stroke:#82b366 + style Z3 fill:#fff2cc,stroke:#d6b656 + style Z4 fill:#fff2cc,stroke:#d6b656 + style D fill:#f8cecc,stroke:#b85450 diff --git a/figures/diagrams/lookup-flow.pdf b/figures/diagrams/lookup-flow.pdf new file mode 100644 index 0000000000000000000000000000000000000000..fc30458806b183bbbd612f4cd18f1cf69fa8aabf GIT binary patch literal 23666 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 E0BAa}bN~PV literal 0 HcmV?d00001 diff --git a/figures/diagrams/s3-layout.mmd b/figures/diagrams/s3-layout.mmd index 47ec228..676d6da 100644 --- a/figures/diagrams/s3-layout.mmd +++ b/figures/diagrams/s3-layout.mmd @@ -1,9 +1,22 @@ flowchart TD - B[(S3-Bucket\ndocuments-houston-prod)] - B --> KA["Kunde A/\n[meta: efecte_org-id=42]"] - B --> KB["Kunde B/\n[meta: efecte_org-id=77]"] - KA --> D1[doc1.pdf\nuntyped] + B["Bucket: documents-houston-prod"] + B --> KA["Beispielkunde GmbH/
Marker-Objekt mit
Metadatum efecte-org-id = 42"] + B --> KB["Andere Firma AG/
efecte-org-id = 77"] + + KA --> U1["Uebersicht.pdf
ohne Typ"] KA --> T1["Service-Protokoll/"] - KA --> T2["Vertragsunterlagen/"] - T1 --> D2[bericht-2026-07.pdf] - T2 --> D3[SLA-2026.pdf] + KA --> T2["Monitoring Reports/"] + KA --> T3["Vertragsunterlagen/"] + KA --> T4["... weitere Typordner"] + + T1 --> D1["Protokoll-2026-07.pdf"] + T2 --> D2["Report-Juli.pdf"] + T3 --> D3["Rahmenvertrag.pdf"] + T3 --> D4["Sharepoint-Ablage.url"] + + style KA fill:#dae8fc,stroke:#6c8ebf + style KB fill:#dae8fc,stroke:#6c8ebf + style T1 fill:#fff2cc,stroke:#d6b656 + style T2 fill:#fff2cc,stroke:#d6b656 + style T3 fill:#fff2cc,stroke:#d6b656 + style T4 fill:#fff2cc,stroke:#d6b656 diff --git a/figures/diagrams/s3-layout.pdf b/figures/diagrams/s3-layout.pdf new file mode 100644 index 0000000000000000000000000000000000000000..ee37a38ccfdc9f81b48f8c77ab24e21307cd5369 GIT binary patch literal 28389 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

8W|x^-!84< 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 I`nz!f07zQAlmGw# literal 0 HcmV?d00001