desktop/modules/README.md

Module

Klassische Module bleiben in diesem Projekt unter modules/<modul>/.

Die neue Desktop-Shell ist nur die UI-Schicht. Modul-Businesslogik wird nicht in den Desktop-Core verschoben.

Aktuelle Modulstruktur

Ein Desktop-Modul kann zusaetzlich diese Projektdateien besitzen:

• desktop.php fuer die Desktop-App-Metadaten und Asset-Definitionen
• pages/ fuer Standalone-Seiten oder iframe/native Einstiegspunkte
• api/ fuer modulinterne HTTP-Endpunkte
• assets/ fuer modulnahe CSS- und JS-Dateien
• docs/README.md fuer modulspezifische Hinweise, API und Sonderregeln

Module-Assets werden in diesem Projekt nicht direkt aus public/assets/apps/... dupliziert, sondern ueber den generischen Endpoint /module-assets/index.php aus dem jeweiligen Modul ausgeliefert.

Globale Desktop-Standards fuer Module

• gemeinsame Desktop-Mechaniken wie Fenster, Tray, globale Persistenz und Debug-Infrastruktur liegen im Desktop-Core
• Module und andere Apps sollen keine eigene Grund-Debug-Oberflaeche im Stil eines separaten globalen Debuggers bauen
• fuer Debugging im Desktop gilt das zentrale Admin-Debug-Widget neben der Uhr mit eigenem Debug-Fenster als Standard
• Debug-Events aus Modulen sollen in den gemeinsamen Desktop-Debug-Bus geschrieben werden, damit sie im globalen Debug-Fenster sichtbar sind
• wenn das globale Debug-Fenster geschlossen ist, sollen Module kein dauerhaft aktives Live-Debugging erzwingen
• app-spezifische Debug-Darstellungen sind nur zulaessig, wenn sie fachliche Zusatzinformationen zeigen, die ueber den globalen Stream hinausgehen

Pflegehinweis

Diese Datei muss gepflegt bleiben, wenn sich Modulstruktur oder Modulregeln aendern.

Wichtige Inhalte aus dieser Datei muessen ebenfalls zentral gepflegt werden in:

• CONTENT.md
• WEITERENTWICKLUNG.md