1.1.0-rc1

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

@@ -0,0 +1,96 @@
+# 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:
+
+- offene Bewertungen
+- Sessions mit Zwischenstatus **Abrechenbar**
+- fehlende oder abweichende Teamspace-Werte, wenn Teamspace-Erfassung in TT aktiv ist
+- Prüfpunkte vor dem Abschluss
+- Möglichkeit, den Monat zu schließen oder wieder zu öffnen
+
+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.