Files
nexus/Umsetzung Neue UI/START_HIER.md
Lars Gebhardt-Kusche 6b0ffd7aeb
All checks were successful
Deploy / deploy-staging (push) Successful in 12s
Deploy / deploy-production (push) Has been skipped
repair
2026-06-07 02:41:08 +02:00

63 lines
2.5 KiB
Markdown

# 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