1.1.0-rc1

docs/confluence/04-dashboard-statistiken-und-widgets.md

@@ -0,0 +1,95 @@
+# Dashboard, Statistiken und Widgets
+
+Diese Seite beschreibt die Kontroll- und Auswertungsflächen in TicketTracker.
+
+## Dashboard
+
+Das Dashboard ist das Tagescockpit. Es zeigt, ob heute oder in der aktuellen Arbeitslage noch etwas offen ist.
+
+Typische Hinweise:
+
+- offene Session-Bewertungen
+- Sessions im Zwischenstatus **Abrechenbar**
+- heutige oder überfällige ToDos
+- fällige Wiedervorlagen
+- fehlende Teamspace-Tageswerte, wenn Teamspace-Erfassung in TT aktiv ist
+- Projektbudget-Hinweise
+- Nacharbeit für heutige Tickets
+
+Widgets können je nach Konfiguration angeordnet und genutzt werden. Favoriten und persönliche Notizen unterstützen die tägliche Arbeit.
+
+## Teamspace-Verhalten im Dashboard
+
+Der Profil-Schalter **Teamspace-Zeiten in TT erfassen** beeinflusst die Dashboard-Logik.
+
+Wenn aktiv:
+
+- Dashboard kann fehlende Teamspace-Tageswerte anzeigen.
+- Nacharbeitslisten können Teamspace-Differenzen berücksichtigen.
+- Projektverbrauch basiert auf TT-Teamspace-Tageswerten plus manuellen Projektstunden.
+
+Wenn deaktiviert:
+
+- Teamspace-Erfassung wird als ausgeschaltet angezeigt.
+- Monatsprüfung läuft statusbasiert.
+- Teamspace-Differenzhinweise werden ausgeblendet.
+- Projekt-Istwerte kommen aus Teamspace.
+
+## Statistiken
+
+Die Statistikseite betrachtet einen Monat.
+
+Sie zeigt unter anderem:
+
+- abgerechnete Zeit
+- abrechenbare Zwischenstände
+- nicht abrechenbare Zeit
+- offene Sessions
+- Organisationen mit Aufwand
+- Tickets mit Aufwand
+- Projektbudget-Hinweise
+- manuelle und fixe Sessions
+- Teamspace-Abgleich, wenn Teamspace-Erfassung in TT aktiv ist
+- Teamspace als Ist-Quelle, wenn die Erfassung in TT deaktiviert ist
+
+## Abgerechnet, abrechenbar und offen
+
+Für statistische Auswertungen gilt:
+
+- **Abgerechnet** zählt in die abgerechnete Session-Zeit.
+- **Abrechenbar** ist ein Zwischenstatus und bleibt offen für den Monatsabschluss.
+- **Nicht abrechenbar** ist final, zählt aber nicht als abgerechnete Zeit.
+- **Offen** blockiert den Monatsabschluss.
+
+## Teamspace-Abgleich in Statistiken
+
+Wenn Teamspace-Erfassung in TT aktiv ist, vergleicht TicketTracker:
+
+`Teamspace-Zeit minus abgerechnete Session-Zeit`
+
+Bedeutung:
+
+- Positive Differenz: In Teamspace steht mehr Zeit als abgerechnet wurde.
+- Negative Differenz: In Teamspace steht weniger Zeit als abgerechnet wurde.
+- Null: Teamspace und abgerechnete Session-Zeit sind ausgeglichen.
+
+Wenn Teamspace-Erfassung deaktiviert ist, werden Differenzspalten, Differenzbadges und Teamspace-Linien ausgeblendet oder angepasst. Die Statistik zeigt dann Teamspace als Ist-Quelle und prüft primär die Session-Status.
+
+## Teamspace-Monatsabgleich aus dem Sync
+
+Zusätzlich zum Tageswert-Abgleich kann der Zammad-Sync echte Teamspace-Monatszeiten abrufen. Diese Daten kommen aus Teamspace `/api/time` und verwenden `amountBillable` der Projektzeitbuchungen.
+
+Der Sync speichert die Werte als Monats-Snapshot pro Benutzer und Teamspace-Projekt-Eintrag. Dadurch wird sichtbar, ob der in TicketTracker gepflegte Monatswert zu den echten Teamspace-Buchungen passt und bei welchem Projekt die Abweichung liegt.
+
+Der Monatsabgleich ist besonders hilfreich, wenn mehrere Teamspace-Projekte an einem Ticket hängen oder wenn Teamspace-Zeiten direkt auf Unterpositionen gebucht wurden. Diese Unterpositionszeiten werden dem passenden Teamspace-Projekt-Eintrag zugerechnet.
+
+In der Monatsübersicht wird der gespeicherte Snapshot direkt am Ticket ausgegeben: TS-Monatswert, Differenz und die betroffenen Haupt- oder Unterpositionen. So ist nicht nur sichtbar, dass eine Abweichung existiert, sondern auch, auf welcher Teamspace-Position die Zeit gebucht wurde.
+
+## Projektbudget-Hinweise
+
+Projektbudget-Hinweise basieren auf den aktuellen Projektregeln:
+
+- Budget kommt aus Teamspace.
+- Ist kommt entweder aus TT-Teamspace-Tageswerten plus manuellen Projektstunden oder aus Teamspace, abhängig vom Profil-Schalter.
+- Überschreitungen werden als Warnung angezeigt.
+- Stückpositionen werden gesondert bewertet und nicht als Stundenbudget behandelt.