Files
tickettracker/docs/confluence/04-dashboard-statistiken-und-widgets.md
2026-10-13 10:43:53 +02:00

96 lines
3.9 KiB
Markdown

# 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.