36 lines
1.9 KiB
Markdown
36 lines
1.9 KiB
Markdown
# 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](/home/lars/Schreibtisch/Projekte/desktop.kusche.berlin/docs/CONTENT.md)
|
|
- [WEITERENTWICKLUNG.md](/home/lars/Schreibtisch/Projekte/desktop.kusche.berlin/docs/WEITERENTWICKLUNG.md)
|