# 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