nexus/Umsetzung Neue UI/02_ORDNERSTRUKTUR_UND_GRUNDREGELN.md

Ordnerstruktur und Grundregeln

Grundsatz

Die Ordnerstruktur soll sich so nah wie sinnvoll an der bestehenden Nexus-Struktur orientieren.

Beibehaltene Strukturidee

• /public/ -> Web Root, globale Assets und Einstieg
• /api/ -> Backend- und API-Endpunkte
• /src/ -> Kernlogik, Services, Utilities
• /config/ -> Umgebungs-Configs
• /modules/<modul>/ -> klassische Module
• /partials/structure/ -> globale Layout-Bausteine
• /partials/landingpages/ -> Seiten oder Views
• /tools/ -> Worker, CLI, Hilfstools
• /debug/ -> Debug-Ausgaben

Neue zusätzliche Bereiche für die Desktop-UI

Empfohlene Ergänzungen:

• /src/Desktop/
  • Window Manager
  • Desktop Registry
  • Skin Resolver
  • Widget Layout Engine
• /public/assets/desktop/
  • globale Desktop-CSS
  • JavaScript für Fenster, Dock, Tray, Desktop-Interaktion
• /partials/desktop/
  • Desktop Shell
  • Window Templates
  • Dock
  • Tray
  • Menu

Optional für die Übergangsphase:

• /Old-Nexus/
  • komplette Altbasis zur Sichtprüfung und als Entwicklungserinnerung
  • nur temporär

Wichtige Regel

Die klassische Modulstruktur bleibt erhalten.

Das bedeutet:

• Module bleiben unter /modules/<modul>/
• der neue Desktop-Layer ist nur die neue Oberfläche
• Module dürfen nicht ungeordnet in den Desktop-Core verschoben werden
• gemeinsame Desktop-Mechaniken liegen nicht in Modulen, sondern im globalen Kern

Trennung

Es gibt drei Ebenen:

1. globales System
2. Desktop-UI-Schicht
3. klassische Module

Was nicht passieren soll

• keine Vermischung von Fenster-Manager-Code mit Modulbusinesslogik
• keine Skin-spezifischen Sonderlösungen in einzelnen Modulen
• keine harte Kopplung zwischen alter Seitenstruktur und neuem Desktop-Verhalten
• keine technische Abhängigkeit zu Old-Nexus/
• keine Includes, Imports, Autoloading-Pfade oder Assets aus Old-Nexus/

Architekturregel

Die neue Oberfläche muss so gebaut sein, dass:

• Module später als Fenster gerendert werden können
• Apps, Widgets und Seitenmodule aus einer gemeinsamen Registry kommen
• Skins ausschließlich Layout, Stil und Interaktionsdetails definieren

Sonderregel für Old-Nexus/

Wenn Old-Nexus/ im neuen Projekt vorhanden ist, dann gilt verbindlich:

• nur lesen und vergleichen
• niemals direkt einbinden
• niemals als Referenzpfad im Produktivcode verwenden
• niemals als Dauerbestandteil der neuen Architektur einplanen
• nach Abschluss der Umsetzung wieder entfernen