# desktop.kusche.berlin

Zentraler Dokumentationsindex fuer das Projekt.

## Zentrale Dateien

- [CONTENT.md](/home/lars/Schreibtisch/Projekte/desktop.kusche.berlin/docs/CONTENT.md)
  Zentrale Inhaltsbasis mit offiziellen Begriffen, Systemumfang und spaeterer Hilfe-Basis.

- [ANLEITUNG.md](/home/lars/Schreibtisch/Projekte/desktop.kusche.berlin/docs/ANLEITUNG.md)
  Nutzungs- und Hilfedatei fuer Bedienung, Orientierung und spaetere Hilfebereiche.

- [WEITERENTWICKLUNG.md](/home/lars/Schreibtisch/Projekte/desktop.kusche.berlin/docs/WEITERENTWICKLUNG.md)
  Regeln fuer Weiterentwicklung, Doku-Pflege, Go's und NoGo's.

- [UMSETZUNGSSTATUS.md](/home/lars/Schreibtisch/Projekte/desktop.kusche.berlin/docs/UMSETZUNGSSTATUS.md)
  Laufender Umsetzungsstatus mit Abnahmeregel und Nachweisen.

- [Umsetzungsanweisung/START_HIER.md](/home/lars/Schreibtisch/Projekte/desktop.kusche.berlin/docs/Umsetzungsanweisung/START_HIER.md)
  Einstieg in die fachlichen Umsetzungsanweisungen und deren Reihenfolge.

## Technische Projektstruktur

- `public/` Web-Root mit Desktop-Shell auf `/`
- `src/Desktop/` zentrale Desktop-Mechaniken
- `src/ModulesCore/` gemeinsame Helfer fuer Modul-Discovery, Modul-HTTP und wiederverwendbare Modul-Anbindung
- `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
- `system/addons/` Zielort fuer optionale System-Erweiterungen und Integrationen
- `temp/nexus-module-import/` Rohbasis fuer importierte Nexus-Module
- `config/gitea.php` Basis fuer serverseitige Gitea-API-Anbindung wie Deploy-Status im Tray

## Fachliche Hinweise

- `Old-Nexus/` wird nicht technisch eingebunden.
- Skins `Windows`, `Apple`, `Linux` laufen auf einer gemeinsamen Shell.
- Keycloak bleibt das Auth-System.
- 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

Wichtige Informationen duerfen nicht nur in Unterordnern oder Einzeldateien stehen.

Es gilt:

- wichtige Inhalte aus Unterordner-`README.md`-Dateien werden zentral in `docs/CONTENT.md` gespiegelt
- Nutzungswissen wird in `docs/ANLEITUNG.md` gepflegt
- Entwicklungsregeln werden in `docs/WEITERENTWICKLUNG.md` gepflegt

Aktuell wichtig:

- der Mining-Checker ist als echte Desktop-App unter `custom/apps/mining-checker/` angebunden
- der Waehrungs-Checker ist als Desktop-App unter `custom/apps/fx-rates/` angebunden
- der Salesforce Translation Import ist als Desktop-App unter `custom/apps/salesforce-translation-import/` angebunden
- der Boersenchecker ist als importierte Desktop-App unter `custom/apps/boersenchecker/` angebunden
- Modul-Assets koennen ueber einen gemeinsamen Auslieferungsweg aus dem Modul selbst geladen werden
- die API bleibt vorerst auf demselben Host und wird nicht auf `api.desktop.kusche.berlin` ausgelagert
- die gemeinsame Admin-Debug-Tray-Funktion neben der Uhr ist der Standard fuer Live-Debugging in Desktop und Native-Apps
- der Waehrungs-Checker stellt zusaetzlich ein Desktop-Widget fuer manuelle Kursaktualisierung bereit
- der Gitea-Deploy-Status liegt als optionales Addon unter `system/addons/gitea-deploy-status/` und wird serverseitig ueber `config/gitea.php` angebunden
- `Admin Apps` ist als globales `Systemtool` fuer App-Bestand, Widgets und erste Integrations-Einstellungen vorhanden
- LDAP-Gruppenberechtigungen fuer Apps werden zentral ueber die Desktop-App-Verwaltung gepflegt
- das Oeffnen des Waehrungs-Checkers darf keinen externen Kursabruf ausloesen; Refreshes laufen nur nach Altersregel oder mit `force`
- `Systemtools` und installierbare `Module` werden getrennt behandelt; Systemtools sind nicht Teil der Benutzer-Installationsauswahl
- das `Cron Tool` ist als globales Systemtool vorhanden und sammelt Modul-Cronjobs automatisch ueber Manifest-Metadaten
- Widgets und Cron-Endpunkte sollen von Modulen bevorzugt direkt in `module.json` beschrieben werden