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:

START_HIER.md
01_ZIELBILD_DESKTOP_UI.md
02_ORDNERSTRUKTUR_UND_GRUNDREGELN.md
03_MIGRATION_BESTEHENDE_MODULE.md
04_UMSETZUNGSPLAN_V1.md
05_KEYCLOAK_LOGIN_UND_DESKTOP_LOGIN.md
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

2.5 KiB Raw Blame History