Statistiken & Zeit
Statistiken & Zeit
Diese Seite erklärt, wie TimeCord Zeit misst und gruppiert und welche Automatisierungen die Zahlen sauber halten. Das meiste davon stellst du einmal ein, danach läuft es von allein.
So funktioniert die Zeiterfassung
Eine Sitzung beginnt, wenn sich ein Mitglied einstempelt (über den Einstempeln-Button oder durch einen Admin bzw. eine Automatisierung) und endet, wenn es sich ausstempelt. Jede abgeschlossene Sitzung wird als Start/Ende-Paar gespeichert. Manuelle Anpassungen mit /time oder /timerequest werden separat gespeichert, damit sie Zeit hinzufügen oder abziehen können, ohne die echten Sitzungen zu beeinflussen.
/info, /leaderboard und /export melden alle vier Gesamtwerte: täglich, wöchentlich, monatlich und gesamt.
Zeitzone
Tägliche, wöchentliche und monatliche Gesamtwerte hängen davon ab, wo die Tagesgrenze liegt, deshalb gruppiert TimeCord sie in einer Zeitzone, die du auswählst.
Stelle sie mit
/timezone <IANA name>ein, zum BeispielEurope/BerlinoderAmerica/New_York.Der Standard ist
UTC.
Wenn du dies auf UTC belässt, aber dein Team in einer anderen Zeitzone ist, kann eine Schicht, die kurz nach Mitternacht Ortszeit endet, dem nächsten Tag zugerechnet werden. Stelle deine echte Zeitzone ein, damit tägliche und wöchentliche Gesamtwerte mit dem Kalender deines Teams übereinstimmen.
Wochenstart
Wöchentliche Gesamtwerte müssen wissen, an welchem Tag eine Woche beginnt. Stelle es mit /weekstart <day> ein (Montag bis Sonntag). Das beeinflusst nur, wie wöchentliche Statistiken gruppiert werden; es ändert nicht die erfasste Zeit von irgendjemandem.
Verwarnungen
Verwarnungen, die mit /warn erstellt werden, haben ein Ablaufdatum. Eine Verwarnung ist aktiv, bis ihre Dauer abläuft; danach wird sie nicht mehr gezählt oder angezeigt, und TimeCord entfernt abgelaufene Verwarnungen automatisch im Hintergrund. /info und /warn show zeigen immer nur aktive Verwarnungen an.
Pausen
Ein Mitglied kann seine eigene Sitzung mit /break pause pausieren und mit /break resume fortsetzen. Pausenzeit wird nicht als erfasste Zeit gezählt: beim Fortsetzen wird der Start der Sitzung um die Länge der Pause nach vorne verschoben, und das Ausstempeln während einer laufenden Pause schließt diese ebenfalls aus. Nutze es für die Mittagspause oder eine kurze Besorgung, statt dich ganz aus- und wieder einzustempeln.
Serien und Meilensteine
TimeCord belohnt Beständigkeit. Eine Serie ist die Anzahl aufeinanderfolgender Tage, an denen ein Mitglied mindestens eine Sitzung erfasst hat, gemessen in der Serverzeitzone. Jedes Mitglied hat eine aktuelle und eine längste Serie, beide werden von /streak angezeigt.
Mitglieder verdienen außerdem Meilensteine als einmalige Erfolge:
Erfasste Stunden: 100, 250, 500, 1000, 2500 und 5000 Gesamtstunden.
Serienlänge: 7, 30, 90 und 365 aufeinanderfolgende Tage.
Serien und Meilensteine aktualisieren sich automatisch einmal am Tag (und kurz nach dem Start des Bots), sodass /streak immer aktuell ist, ohne dass etwas eingerichtet werden muss.
Automatisches Ausstempeln (vergessene Schichten)
Leute vergessen, sich auszustempeln. Wenn du das automatische Ausstempeln im Dashboard aktivierst (Settings → General, die Option "abmelden"), schließt TimeCord jede Sitzung, die länger als das von dir festgelegte Limit offen war, erfasst die Zeit bis zu diesem Punkt und entfernt die Im-Dienst-Rolle. So läuft eine vergessene Schicht nicht tagelang weiter.
Automatisches Ausstempeln (wenn ein Mitglied offline geht)
Zusätzlich kann TimeCord ein Mitglied in dem Moment ausstempeln, in dem es in Discord offline geht, damit eine inaktive Sitzung nicht weiter Zeit sammelt. Das ist standardmäßig deaktiviert und erfordert, dass der Bot-Betreiber ihn mit aktivierter Präsenzerfassung betreibt (ein privilegierter Discord-Intent), weil das Lesen des Online-/Offline-Status eine zusätzliche Berechtigung benötigt. Wenn du es möchtest, bitte denjenigen, der den Bot hostet, die Präsenz zu aktivieren; bei einer normalen Einrichtung sorgt das obige Ausstempeln bei vergessenen Schichten für Ordnung.
Verlauf und Langzeitspeicherung
TimeCord behält aktuelle Sitzungen beim Mitglied, damit tägliche, wöchentliche und monatliche Ansichten schnell bleiben, und verschiebt Sitzungen, die älter als ein paar Monate sind, in die Langzeitspeicherung. Deine Gesamtwerte bleiben in beiden Fällen korrekt; nichts geht verloren. /role reset löscht sowohl die aktuelle als auch die gespeicherte Zeit für die ausgewählten Mitglieder.
Audit-Log
Jede administrative Aktion (Einstellen, Kündigen, Verwarnungen, manuelle Zeitänderungen, automatisches Ausstempeln und mehr) wird in ein dauerhaftes Audit-Log geschrieben. Dieses bleibt erhalten, selbst wenn du den Discord-Log-Kanal löschst, sodass es immer eine Aufzeichnung davon gibt, was passiert ist.