tickettracker/docs/confluence/01-zeiterfassung-sessions-monatsabschluss.md

Zeiterfassung, Sessions und Monatsabschluss

Diese Seite beschreibt die tägliche Erfassung, Bewertung und Monatsprüfung in TicketTracker.

Timer

Benutzer starten einen Timer über eine Ticketnummer. Es können mehrere Timer vorbereitet sein, aber immer nur einer läuft aktiv. Wird ein anderer Timer gestartet, pausiert TicketTracker die übrigen Timer automatisch.

Beim Beenden werden Tätigkeit, Zeit, Ticket, Organisation, Art und optional Bewertung gespeichert. Wenn die Zammad-Notiz im Profil aktiv ist, kann TicketTracker beim Speichern einen internen Zammad-Article erzeugen.

Sessions nachtragen

Vergessene Arbeit kann manuell als Session nachgetragen werden. Dabei werden erfasst:

• Datum
• Start und Ende
• Ticket
• Organisation
• Art, zum Beispiel Support oder Consulting
• Tätigkeit
• Bewertung
• optional interne Zammad-Notiz

Nachgetragene Sessions laufen genauso in Statistiken, Ticketansichten und Monatsabschluss ein wie per Timer erzeugte Sessions.

Session-Bewertungen

Jede Session kann einen dieser Zustände haben:

• Offen
• Abrechenbar
• Abgerechnet
• Nicht abrechenbar

Nur Abgerechnet und Nicht abrechenbar gelten als final. Abrechenbar ist ein Zwischenstatus und blockiert weiterhin den Monatsabschluss.

Ein erneuter Klick auf den bereits gesetzten Status nimmt die Bewertung wieder zurück und macht die Session offen.

Ticketdetailansicht

In der Ticketdetailansicht werden Sessions nach Tagen gruppiert. Dort werden Sessions bewertet, bearbeitet, gelöscht und aufgeklappt.

Pro Tag sieht man unter anderem:

• Summe abgerechneter Session-Zeit
• Summe abrechenbarer Session-Zeit
• Summe nicht abrechenbarer Session-Zeit
• offene Session-Zeit
• Teamspace-Tageswert, falls die Teamspace-Erfassung in TT aktiv ist

Die Tageswerte sind pro Benutzer und Projekt/Teamspace-Eintrag gespeichert. Sie sind nicht an einzelne Sessions gebunden.

Teamspace-Tageswerte

Wenn im Profil Teamspace-Zeiten in TT erfassen aktiv ist, kann der Benutzer in der Ticketdetailansicht Teamspace-Tageswerte pflegen.

Die Eingabe erfolgt in Stunden, zum Beispiel:

• 1
• 1,5
• 2.25
• 0,75

Der Wert wird nicht während der Eingabe gespeichert. Sobald sich der Wert ändert, erscheint ein Speichern-Button. Ein leeres Feld entfernt den gespeicherten Teamspace-Wert für diesen Tag.

Wenn mehrere Teamspace-Projekte an einem Ticket hängen, wird der Tageswert pro Teamspace-Projekt-Eintrag geführt.

Wenn die Teamspace-Erfassung im Profil deaktiviert ist, sind diese Eingaben ausgeblendet und auch serverseitig gesperrt.

Monatsabschluss

Der Monatsabschluss ist die zentrale Kontrollseite für einen Benutzer und Monat.

Sie zeigt unter anderem:

• eine nach Ticket zusammengefuehrte Pruefliste
• offene Bewertungen und Sessions mit Zwischenstatus Abrechenbar
• fehlende oder abweichende Teamspace-Werte als farbige, spaltenweise ausgerichtete Badges; die Tagesdetails stehen am jeweiligen Tag im Ticketdetail
• Prüfpunkte vor dem Abschluss
• Möglichkeit, den Monat zu schließen oder wieder zu öffnen

Jedes Ticket erscheint in der Pruefliste nur einmal. Monatsabweichungen, offene Bewertungen und betroffene Tage werden innerhalb dieses Eintrags gebuendelt; Hinweise zum gleichen Tag stehen in einer gemeinsamen Tageszeile.

Ein TT-Teamspace-Tageswert ist nur konsistent, wenn fuer dasselbe Ticket und denselben Tag mindestens eine Session den Status Abgerechnet hat. Bei ausschliesslich abrechenbaren, nicht abrechenbaren oder unbewerteten Sessions wird der hinterlegte Wert als Fehler ausgewiesen; ein zusaetzlicher Unterschied zur TS-API bleibt ebenfalls sichtbar.

Ein abgeschlossener Monat ist gegen versehentliche Änderungen geschützt. Wird eine Session in einem abgeschlossenen Zeitraum geändert, muss der Zeitraum vorher wieder geöffnet werden.

Regeln bei deaktivierter Teamspace-Erfassung

Der Profil-Schalter Teamspace-Zeiten in TT erfassen ist userbezogen.

Wenn er ausgeschaltet ist:

• Teamspace-Tageswerte können nicht in TicketTracker gepflegt werden.
• Manuelle Projektstunden sind nicht editierbar.
• Monatsprüfung und Widgets prüfen nur Session-Status.
• Teamspace-Differenzen werden nicht angezeigt.
• Projekt-Istwerte kommen aus Teamspace.

Das ist für Benutzer gedacht, die keine Teamspace-Zeiten in TicketTracker nachpflegen, sondern Teamspace als führende Ist-Quelle verwenden.