initial scaffold: structure, build setup, chapter stubs, diagrams

2026-08-25 19:04:44 +02:00
parent ea69e2736e
commit 34f1863882
69 changed files with 1042 additions and 0 deletions
@@ -0,0 +1,13 @@
+\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
+
+% \begin{figure}[H]
+%   \centering
+%   \includegraphics[width=0.9\textwidth]{figures/diagrams/auth-sequence.pdf}
+%   \caption{Autorisierungsablauf}
+%   \label{fig:auth-sequence}
+% \end{figure}
@@ -0,0 +1,7 @@
+\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
@@ -0,0 +1,13 @@
+\section{Architekturentscheidung: O(1)-Fast-Path}
+\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
+
+% \begin{figure}[H]
+%   \centering
+%   \includegraphics[width=\textwidth]{figures/diagrams/lookup-flow.pdf}
+%   \caption{Ablauf \texttt{ResolveCustomerPrefixAsync}}
+%   \label{fig:lookup-flow}
+% \end{figure}
@@ -0,0 +1,8 @@
+\section{Problem: Lookup des Kundenordners}
+\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}
+
+% Tabelle~\ref{tab:lookup-tradeoffs} im Anhang
@@ -0,0 +1,14 @@
+\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
+
+% \begin{figure}[H]
+%   \centering
+%   \includegraphics[width=0.75\textwidth]{figures/diagrams/s3-layout.pdf}
+%   \caption{S3-Ablagestruktur}
+%   \label{fig:s3-layout}
+% \end{figure}
@@ -0,0 +1,5 @@
+\section{UI-Konzept und Clickdummy}
+\label{sec:ui-concept}
+
+% TODO: Hanna Ebner, Branch Clickdummy_Dokumente (2026-07-22)
+% Listenansicht, Typfilter oben als Buttons, flexible Tabellenspalten