docs: massive restructuring of documentation, development guides and agent playbooks

2026-06-15 12:54:38 +02:00
parent e4988b4397
commit ce63303b2c
686 changed files with 45423 additions and 319 deletions
@@ -0,0 +1,38 @@
+# Curator Journal: POC-Fix & Portable Distribution
+
+**Datum:** 30. April 2026
+**Agenten:** 🏗️ [Lead Architect], 🧹 [Curator]
+
+## 🎯 Status Quo
+
+Status: 🚀 BEREIT FÜR HARDWARE-TEST
+
+Nach der Kritik am unzureichenden `run`-Hinweis wurde der Build-Prozess für den POC auf eine portable Lösung umgestellt.
+
+## 🏗️ Wichtigste Änderungen
+
+* **Build-Strategie:** Wechsel von `packageDistribution` (benötigt OS-Tools wie dpkg) zu `createDistributable`.
+* **Portabilität:** Die App wird nun als entpacktes Image (`app`-Ordner) bereitgestellt, das direkt vom USB-Stick auf
+  dem Zielsystem (Zora-Hardware) ausgeführt werden kann.
+* **Desktop-Chat:** Implementierung eines Veranstaltungs-Chats (MVP) mit Footer-Integration und Navigation.
+* **Docker-Fix:** Behebung des Syntaxfehlers in `dc-gui.yaml`.
+* **Dokumentation:** Der Guide `docs/06_Frontend/Guides/POC_INITIALISIERUNG.md` wurde komplett überarbeitet und
+  beantwortet nun alle offenen Fragen zu Docker, Gradle und dem Transfer-Prozess.
+
+## 📝 Entscheidungen
+
+1. **Kein System-Packaging für POC:** Um die Hardware-Abhängigkeiten des Build-Systems zu umgehen, nutzen wir die
+   Portable-Variante.
+2. **Direkt-Transfer:** Das `app`-Verzeichnis wird 1:1 kopiert.
+3. **Chat als Navigation-Stub:** Die Chat-UI ist als MVP vorhanden, um die Usability im Feldtest zu prüfen (
+   Online-Gefühl).
+
+## 🚀 Nächste Schritte
+
+1. **Hardware-POC:** Durchführung des Tests auf der Ziel-Hardware durch den User.
+2. **Chat-Test:** Verifikation der Chat-Erreichbarkeit über die FooterBar.
+3. **Feedback-Loop:** Auswertung der `init_device.aes` Datei und der Netzwerk-Erkennung.
+
+---
+**🚫 Anti-Halluzinations-Protokoll:** Der `createDistributable` Task wurde erfolgreich verifiziert (BUILD SUCCESSFUL).
+Der Pfad zum Artefakt wurde im Guide korrekt hinterlegt.