adsdad

docs/CONTENT.md

@@ -105,8 +105,10 @@ Aus [README.md](/home/lars/Schreibtisch/Projekte/desktop.kusche.berlin/docs/READ
 - `partials/desktop/` enthaelt Shell-Templates
 - `custom/apps/` bleibt Zielort fuer installierbare Fach-Apps
 - `system/apps/` bleibt Zielort fuer System-Tools
+- `system/shell/` bleibt Zielort fuer globale Shell-Werkzeuge und shell-nahe Desktop-Helfer
 - `temp/nexus-module-import/` ist Rohbasis fuer importierte Nexus-Module
 - Keycloak bleibt das Auth-System
+- das globale Desktop-Debug ist als Shell-Werkzeug unter `system/shell/desktop-debug/` definiert
 
 ### Module
 

docs/README.md

@@ -27,6 +27,7 @@ Zentraler Dokumentationsindex fuer das Projekt.
 - `partials/desktop/` Shell-Template
 - `custom/apps/` Zielort fuer installierbare Fach-Apps
 - `system/apps/` Zielort fuer nicht installierbare System-Tools
+- `system/shell/` Zielort fuer globale Shell-Werkzeuge und shell-nahe Desktop-Helfer
 - `temp/nexus-module-import/` Rohbasis fuer importierte Nexus-Module
 
 ## Fachliche Hinweise
@@ -37,6 +38,7 @@ Zentraler Dokumentationsindex fuer das Projekt.
 - API und Desktop laufen auf demselben Host. Zielpfad ist `(staging.)desktop.kusche.berlin/api/v1/...`.
 - der Theme-Handoff ist in [keycloak-theme-handoff.md](/home/lars/Schreibtisch/Projekte/desktop.kusche.berlin/docs/keycloak-theme-handoff.md) beschrieben.
 - das globale Admin-Debugging ist Teil der Desktop-Shell und wird nicht pro App als eigene Grundfunktion dupliziert
+- die Definition globaler Shell-Werkzeuge liegt unter `system/shell/`; aktuelles Beispiel ist `system/shell/desktop-debug/`
 
 ## Dokumentationsregel
 

docs/Umsetzungsanweisung/02_ORDNERSTRUKTUR_UND_GRUNDREGELN.md

@@ -12,6 +12,7 @@ Die Ordnerstruktur soll sich so nah wie sinnvoll an der bestehenden Nexus-Strukt
 - `/config/` -> Umgebungs-Configs
 - `/custom/apps/<app>/` -> installierbare Fach-Apps
 - `/system/apps/<app>/` -> System-Tools und interne App-Quellen
+- `/system/shell/<tool>/` -> globale Shell-Werkzeuge und shell-nahe Desktop-Helfer
 - `/partials/structure/` -> globale Layout-Bausteine
 - `/partials/landingpages/` -> Seiten oder Views
 - `/tools/` -> Worker, CLI, Hilfstools
@@ -54,6 +55,7 @@ Das bedeutet:
 - Module dürfen nicht ungeordnet in den Desktop-Core verschoben werden
 - gemeinsame Desktop-Mechaniken liegen nicht in Modulen, sondern im globalen Kern
 - gemeinsame Debug-Grundlogik liegt ebenfalls nicht in Modulen, sondern im globalen Desktop-Core
+- globale Shell-Werkzeuge sollen als eigene Einheiten unter `/system/shell/` abgelegt werden
 
 ## Trennung
 

docs/WEITERENTWICKLUNG.md

@@ -58,9 +58,11 @@ Verbindlich ist:
 
 - `custom/apps/<app>/` bleibt Ort fuer installierbare Fach-Apps
 - `system/apps/<app>/` bleibt Ort fuer System-Tools und nicht installierbare App-Quellen
+- `system/shell/<tool>/` bleibt Ort fuer globale Shell-Werkzeuge und shell-nahe Desktop-Helfer
 - globale Desktop-Mechaniken liegen im gemeinsamen Kern
 - globale Modul-Helfer duerfen im gemeinsamen Kern liegen, Fachlogik aber nicht
 - globale Debug-Steuerung fuer Admins liegt im Desktop-Core; Aktivierung erfolgt ueber das gemeinsame Debug-Widget neben der Uhr
+- die Definition globaler Debug- und Shell-Werkzeuge soll in `system/shell/` liegen und nicht lose in `public/` oder verstreut im JS
 - API und Desktop teilen sich im aktuellen Zielbild denselben Host; offizielle Basis ist `/api/v1/...`
 - App, API und Widget einer Fachfunktion muessen dieselben Sperr- und Force-Regeln fuer externe Abrufe nutzen
 - die Trennung `core` / `system_tool` / `module` ist in Metadaten, Startmenue und Benutzer-Setup konsistent zu halten