71 lines
4.2 KiB
Markdown
71 lines
4.2 KiB
Markdown
# 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
|
|
- 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
|
|
- `Admin Apps` ist als globales `Systemtool` fuer App-Bestand, Widgets und erste Integrations-Einstellungen vorhanden
|
|
- 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
|