repair

Umsetzung Neue UI/START_HIER.md

@@ -0,0 +1,62 @@
+# Start Hier
+
+Diese Datei ist der Einstieg für die Umsetzung der neuen Desktop-Oberfläche in `desktop.kusche.berlin`.
+
+## Ziel
+
+Nexus soll als neue Oberfläche nicht mehr wie eine klassische Website aufgebaut sein, sondern wie ein Desktop-System:
+
+- Desktop-Shell als Hauptoberfläche
+- Fenster für Apps und Widgets
+- Skin-System für `Windows`, `Apple`, `Linux`
+- persönliche Dashboards
+- öffentliches Home-Dashboard für nicht eingeloggte Nutzer
+- globale Verwaltung für Widgets, Integrationen, Suchmaschinen und Apps
+
+Die bestehenden klassischen Module aus Nexus sollen später in diese neue Oberfläche überführt werden, aber die Umsetzung erfolgt ausschließlich im neuen Projekt.
+
+## Reihenfolge der Dokumente
+
+Bitte diese Dateien in genau dieser Reihenfolge lesen:
+
+1. `START_HIER.md`
+2. `01_ZIELBILD_DESKTOP_UI.md`
+3. `02_ORDNERSTRUKTUR_UND_GRUNDREGELN.md`
+4. `03_MIGRATION_BESTEHENDE_MODULE.md`
+5. `04_UMSETZUNGSPLAN_V1.md`
+6. `05_KEYCLOAK_LOGIN_UND_DESKTOP_LOGIN.md`
+7. `06_STARTPROMPT_NEUE_SESSION.md`
+
+## Wichtig
+
+- Die bestehende Ordnerlogik aus Nexus soll grundsätzlich beibehalten werden.
+- Die Umsetzung erfolgt **nicht** mehr im alten Nexus-Projekt.
+- Die bestehenden Module aus Nexus dienen als Basis und Referenz, sollen aber in `desktop.kusche.berlin` separat weiterentwickelt werden.
+- Der neue UI-Layer ist eine neue Anwendungsschicht, kein Theme-Umbau des alten Systems.
+
+## Erwartetes Vorgehen im neuen Projekt
+
+- zuerst Architektur und Shell anlegen
+- dann Desktop-Grundsystem bauen
+- dann globale Verwaltungsseiten
+- dann klassische Module schrittweise in die neue Shell einhängen
+
+## Basisübernahme aus Nexus
+
+Im neuen Projekt sollte ein temporärer Import-Ordner angelegt werden, zum Beispiel:
+
+- `temp/nexus-module-import/`
+
+Dorthin werden die bestehenden Module aus Nexus zunächst nur kopiert, damit die Basis verfügbar ist. Die eigentliche Anpassung erfolgt danach separat im neuen Projekt.
+
+## Old-Nexus
+
+Zusätzlich kann im neuen Projekt ein Ordner `Old-Nexus/` liegen, in dem das alte System vollständig enthalten ist.
+
+Wichtige Regel:
+
+- `Old-Nexus/` dient ausschließlich als menschliche Referenz und Erinnerung an die alte Entwicklung
+- dort dürfen Beispiele, frühere Funktionen, Strukturen oder Hilfslogik nachgesehen werden
+- `Old-Nexus/` darf aber niemals als technische Laufzeit- oder Build-Abhängigkeit verwendet werden
+- es dürfen keine Includes, keine Imports, keine Asset-Referenzen, keine Pfadverweise und keine direkte Code-Nutzung auf `Old-Nexus/` zeigen
+- der Ordner ist nur temporär und wird nach der Umsetzung wieder gelöscht