# Anleitung

Nutzungs- und Hilfedatei fuer `desktop.kusche.berlin`.

Diese Datei ist fuer spaetere Endnutzerhilfe, interne Einfuehrung und als Basis fuer einen Hilfebereich gedacht.

## Einstieg

Der Desktop besteht aus mehreren Hauptbereichen:

- `Desktop`
  Arbeitsflaeche mit Icons, Fenstern und Infobereich.

- `Startmenue`
  Zugang zu Benutzerfunktionen und installierten Programmen.

- `Infobereich`
  Rechter Seitenbereich fuer eingeblendete Informationskarten.

- `Widget-Bereich`
  Bereich bei Uhr und Systemleiste fuer kleine Mini-Funktionen.

## Startmenue verwenden

Das Startmenue ist in drei Bereiche gegliedert:

1. `User Setting Bereich`
   Hier befinden sich Benutzername, User-Icon, Einstellungen sowie Anmelden oder Abmelden.
2. `Funktion-Bereich`
   Hier werden die Funktionsgruppen ausgewaehlt. Aktuell ist `Programme` die erste Gruppe.
3. `Auswahlbereich`
   Hier erscheinen die Inhalte der aktuell gewaehlten Funktionsgruppe, zum Beispiel installierte Apps.

## Programme oeffnen

- Desktop-Icons koennen direkt geoeffnet werden.
- Im Startmenue lassen sich Programme ueber den `Auswahlbereich` starten.
- Fenster koennen verschoben, minimiert, maximiert und geschlossen werden.
- Programme koennen sowohl globale System-Apps als auch klassische Module sein.

## Einstellungen oeffnen

Die Einstellungen werden aktuell ueber die App `User Self Management` bereitgestellt.

Dort koennen derzeit insbesondere verwaltet werden:

- `Desktop Type` beziehungsweise Skin-Auswahl
- persoenliche Benutzerdaten
- sichtbare Apps
- Inhalte des `Infobereichs`

## Module

Klassische Module liegen unter `modules/<modul>/` und koennen als normale `App` im Desktop erscheinen.

Aktuell gilt:

- der `Mining-Checker` ist das erste echte Modul in dieser Form
- Modul-Businesslogik bleibt im Modul und wird nicht in den Desktop-Core verschoben
- gemeinsame Desktop-Mechaniken wie Fenster, Asset-Einbindung und Zugriffsschutz werden global bereitgestellt

## Benutzerdaten

Aktuell gelten folgende Regeln:

- Standardfelder wie Name, E-Mail, Telefon, Titel und Ort koennen fuer LDAP vorbereitet oder synchronisiert werden.
- `Geburtsdatum` bleibt derzeit lokal gespeichert.
- nicht jedes Profilfeld wird automatisch in LDAP geschrieben.
- Desktop-bezogene Nutzereinstellungen werden in einer eigenen Datenbanktabelle gespeichert.

## Desktop Type und Skins

Das System unterstuetzt derzeit:

- `Apple`
- `Windows`
- `Linux`

Der ausgewaehlte Desktop Type beeinflusst Darstellung und Interaktionsdetails, waehrend die gemeinsame Shell-Logik erhalten bleibt.

## Infobereich

Der `Infobereich` ist der rechte Desktopbereich.

- Inhalte koennen benutzerbezogen ein- oder ausgeblendet werden.
- Aenderungen sollen gespeichert bleiben.
- Der `Infobereich` ist nicht identisch mit dem `Widget-Bereich`.

## Begriffsregel

Fuer sprachliche Konsistenz gilt:

- rechte Desktopseite: `Infobereich`
- Mini-Apps an Uhr/Systemleiste: `Widget-Bereich`
- linke Startmenuespalte: `User Setting Bereich`
- mittlere Startmenuespalte: `Funktion-Bereich`
- rechte Startmenuespalte: `Auswahlbereich`

Die verbindliche zentrale Fassung der Begriffe steht in [CONTENT.md](/home/lars/Schreibtisch/Projekte/desktop.kusche.berlin/docs/CONTENT.md).