desktop.kusche.berlin

Zentraler Dokumentationsindex fuer das Projekt.

Zentrale Dateien

• CONTENT.md Zentrale Inhaltsbasis mit offiziellen Begriffen, Systemumfang und spaeterer Hilfe-Basis.

• ANLEITUNG.md Nutzungs- und Hilfedatei fuer Bedienung, Orientierung und spaetere Hilfebereiche.

• WEITERENTWICKLUNG.md Regeln fuer Weiterentwicklung, Doku-Pflege, Go's und NoGo's.

• UMSETZUNGSSTATUS.md Laufender Umsetzungsstatus mit Abnahmeregel und Nachweisen.

• 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 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
• das gemeinsame Admin-Debug-Widget 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
• 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