Main update

modules/README.md

@@ -13,9 +13,44 @@ Ein Desktop-Modul kann zusaetzlich diese Projektdateien besitzen:
 - `api/` fuer modulinterne HTTP-Endpunkte
 - `assets/` fuer modulnahe CSS- und JS-Dateien
 - `docs/README.md` fuer modulspezifische Hinweise, API und Sonderregeln
+- `module.json` fuer Setup, Desktop-Freigabe, Widget-Funktionen und Cron-Endpunkte
 
 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.
 
+## Trennung zwischen Systemtools und Modulen
+
+- `Systemtools` sind globale Verwaltungs- und Setup-Apps und nicht installierbar
+- aktuelle Beispiele: `User Management`, `User Self Management`, `Cron Tool`
+- `Module` sind installierbare Fachanwendungen
+- aktuelle Beispiele: `Mining-Checker`, `Waehrungs-Checker`, `Boersenchecker`, `Pi-hole`
+
+Diese Trennung wird ueber App-Metadaten gesteuert:
+
+- `app_scope`
+  - `core`
+  - `system_tool`
+  - `module`
+- `installable`
+  - `false` fuer Core- und Systemtools
+  - `true` fuer installierbare Module
+
+## Modul-Metadaten in `module.json`
+
+Module sollen ihre Desktop-Faehigkeiten zentral in `module.json` beschreiben.
+
+Wichtige Bausteine:
+
+- `desktop`
+  - `available`
+  - `show_on_desktop`
+  - `show_in_start_menu`
+- `widgets`
+  - beschreibt Widget-Funktionen, die nur fuer installierte Module verfuegbar sind
+- `cron_jobs`
+  - beschreibt Cron-Endpunkte fuer die zentrale Cron-Verwaltung
+
+Die Desktop-Shell liest diese Angaben automatisch ein. Neue Modul-Crons und Widgets muessen deshalb nicht zusaetzlich in einer separaten globalen Liste nachgetragen werden, solange sie sauber im Manifest beschrieben sind.
+
 ## Globale Desktop-Standards fuer Module
 
 - gemeinsame Desktop-Mechaniken wie Fenster, Tray, globale Persistenz und Debug-Infrastruktur liegen im Desktop-Core