docs(frontend): add detailed offline-first architecture and web setup documentation

Added documentation to outline the Offline-First strategy for the KMP frontend, emphasizing the use of SQLDelight with cross-platform storage. Also included guidance for setting up Web targets, covering OPFS integration and Web Worker usage. Updated ADRs with decisions for SQLDelight and Koin adoption.
2026-01-13 15:59:25 +01:00
parent 8362a8b11d
commit bf8facfa66
10 changed files with 359 additions and 62 deletions
@@ -0,0 +1,25 @@
+# Journal: Initiale Projektanalyse durch den Curator
+
+*   **Datum:** 2026-01-13
+*   **Autor:** Documentation & Knowledge Curator
+*   **Thema:** Erste Bestandsaufnahme der Dokumentations-Strategie und -Prozesse.
+
+## Zusammenfassung
+
+Diese Session diente der initialen Analyse des Projekts aus Sicht des Knowledge Curators. Die Analyse basiert auf den Agenten-Definitionen und dem Curator-Playbook.
+
+## Erkenntnisse
+
+Die strategische Grundlage für die Dokumentation im Projekt "Meldestelle" ist hervorragend.
+
+*   **Positiv:**
+    *   Das Prinzip "Docs-as-Code" mit `docs/` als Single Source of Truth ist etabliert.
+    *   Alle Agenten-Rollen haben klar definierte Dokumentationspflichten.
+    *   Die Artefakt-Typen (ADR, Reference, How-to, Journal) sind klar definiert.
+    *   Die Curator-Rolle selbst ist als Mechanismus zur Sicherung von Wissen verankert.
+
+## Offene Punkte & Nächste Schritte
+
+1.  **Validierung der Praxis:** Die aktuelle Analyse ist rein strategisch. Es muss geprüft werden, wie konsequent die Regeln bereits im Projektalltag umgesetzt werden.
+2.  **Analyse bestehender Artefakte:** Eine Durchsicht der Verzeichnisse `docs/01_Architecture/adr/`, `docs/04_Backend/Services/` etc. ist notwendig, um den Reifegrad der bestehenden Dokumentation zu bewerten.
+3.  **Zugriff auf Projektstruktur:** Für eine tiefere Analyse ist eine Übersicht über die gesamte Verzeichnisstruktur des Projekts erforderlich.
@@ -0,0 +1,29 @@
+# Journal: Auftrag zur Tiefenanalyse & Anforderung der Projektstruktur
+
+* **Datum:** 2026-01-13
+* **Autor:** Documentation & Knowledge Curator
+* **Thema:** Follow-Up zur initialen Analyse und Auftrag zur Überprüfung der Dokumentations-Praxis.
+
+## Zusammenfassung
+
+Aufbauend auf der [initialen Analyse vom 13.01.2026](2026-01-13_initial-curator-analysis.md) wurde heute der Auftrag
+erteilt, eine Tiefenanalyse des Projekts durchzuführen.
+
+Folgende Punkte sollen geprüft werden:
+
+1. Konsistenz der Regelumsetzung im Projektalltag ("Jede Session endet mit einem Artefakt").
+2. Analyse und Bewertung bestehender Artefakte in `docs/`.
+3. Gesamtanalyse der Projektstruktur.
+
+## Offene Punkte & Nächste Schritte
+
+**Blocker:** Für die Durchführung der Analyse ist eine Übersicht der aktuellen Verzeichnisstruktur des gesamten Projekts
+zwingend erforderlich. Ohne diese "Landkarte" kann keine sinnvolle Bewertung der Artefakte und ihrer Vollständigkeit
+stattfinden.
+
+**Nächster Schritt:**
+
+* **Anforderung:** Bereitstellung der Projektstruktur, idealerweise durch die Ausgabe eines Befehls wie `tree -L 3` für
+  das gesamte Repository.
+* Sobald die Struktur vorliegt, wird die eigentliche Analyse in der nächsten Session durchgeführt und das Ergebnis in
+  einem passenden Artefakt festgehalten.