Punkte & Shop

Überblick

Das Punktesystem vergibt Mitgliedern Punkte für das Abschließen von Aufgaben. Punkte speisen eine optionale Bestenliste und einen optionalen Shop, in dem Mitglieder Punkte gegen Belohnungen einlösen können, die von Root festgelegt werden. Alle drei Komponenten stehen hinter separaten Feature-Flags und können unabhängig voneinander aktiviert werden.

Voraussetzung: Feature-Flag points_system (Hauptschalter). Die Flags für Bestenliste und Shop haben nur dann eine Wirkung, wenn auch points_system aktiviert ist.

Feature-Flags

Flag	Was es steuert
`points_system`	Hauptschalter. Aktiviert die Punktevergabe beim Abschließen von Aufgaben.
`show_points_to_users`	Zeigt Mitgliedern ihren eigenen Punktestand in der Statistikkarte des Dashboards und in ihrem Profil. Erfordert aktiviertes `points_system`.
`leaderboard_enabled`	Zeigt eine wöchentliche Bestenliste auf dem Dashboard, die alle Mitglieder nach Punkten ordnet. Wenn deaktiviert, sehen Mitglieder weiterhin ihren eigenen Punktestand, aber nicht den anderer.
`store_enabled`	Aktiviert den Shop-Navigationspunkt und den Einlösevorgang.

Zwei Arten von Punkten

Ziptask hat auf jeder Aufgabe zwei unabhängige Punktefelder:

Feld	Zweck	Wer legt es fest
Belohnungspunkte	Gamification-Währung — vergeben an das Mitglied, das die Aufgabe abschließt. Speist die Statistikkarte des Dashboards, die Bestenliste und das Shop-Guthaben.	Admin / Root
Geschätzte Aufwandspunkte	Aufwandsschätzung — steht für das Aufwandsgewicht der Aufgabe. Wird von der Projekte-Funktion genutzt, um geschätzte vs. verdiente Kosten zu berechnen. Hat keine Auswirkung auf die Guthaben der Mitglieder.	Admin / Root

Beide Felder werden durch das Flag points_system gesteuert. Belohnungspunkte und geschätzte Aufwandspunkte sind vollständig unabhängig voneinander — das Ändern des einen wirkt sich nicht auf das andere aus.

Punkte (Belohnungen)

Wie Belohnungspunkte verdient werden

Belohnungspunkte werden vergeben, wenn ein Mitglied eine Aufgabe von DOING auf COMPLETED überführt. Wird eine Aufgabe mit COMPLETED wieder auf TODO zurückgesetzt (durch Admin/Root), werden die Belohnungspunkte automatisch zurückgebucht.

Rückwirkende Punkteanpassungen

Admin und Root können den Wert der Belohnungspunkte einer Aufgabe mit COMPLETED jederzeit ändern. Die Anpassung wird automatisch angewendet:

Erhöhung — die Differenz wird sofort dem Mitglied gutgeschrieben, das die Arbeit erledigt hat.
Verringerung — die Differenz wird sofort vom Guthaben des Mitglieds abgezogen. Der Abzug ist bei null begrenzt: Hat das Mitglied die Punkte bereits ausgegeben, wird das Guthaben nicht negativ.

Punkte werden immer dem Mitglied zugerechnet, dem die Aufgabe zugewiesen war (der Ausführende). Bei Aufgaben, die eine Genehmigung erforderten, ist das das Mitglied, das die Arbeit abgeschlossen hat, nicht der Admin, der genehmigt hat.

Sichtbarkeit der Punkte

Wenn show_points_to_users aktiviert ist, können Mitglieder ihren eigenen Belohnungspunktestand in der Statistikkarte des Dashboards und in ihrem Profil sehen. Wenn zusätzlich leaderboard_enabled aktiviert ist, können alle die wöchentlichen Gesamtwerte aller Mitglieder auf der Bestenliste sehen.

Punkteverlauf

Wenn points_system aktiviert ist, können Mitglieder auf ihrer Profilseite einen vollständigen Prüfpfad ihrer eigenen Belohnungspunkte-Aktivität einsehen (Profil → Reiter „Punkte”). Jeder Eintrag zeigt die Art der Aktion, den Titel der Aufgabe oder den Namen des Shop-Artikels, die verdienten oder ausgegebenen Punkte sowie das Datum. Die Liste ist paginiert und unterstützt unendliches Scrollen.

Berechtigungen — Punkte

Aktion	Benutzer	Admin	Root
Punkte verdienen (Aufgabenabschluss)	✓	✓	✓
Eigenen Punktestand ansehen	✓	✓	✓
Eigenen Punkteverlauf ansehen	✓	✓	✓
Bestenliste ansehen (falls aktiviert)	✓	✓	✓

Shop

Voraussetzung: points_system + store_enabled beide aktiviert.

So funktioniert es

Root erstellt einen Katalog einlösbarer Artikel, jeweils mit einem Punktepreis. Mitglieder durchstöbern den Shop, beantragen Einlösungen, und Root genehmigt oder lehnt sie ab.

Einlöseablauf:

Das Mitglied klickt bei einem Shop-Artikel auf „Einlösen”.
Die Punkte werden sofort vom Guthaben des Mitglieds abgezogen.
Die Einlösung wird im Status Ausstehend erstellt.
Root prüft ausstehende Einlösungen und genehmigt oder lehnt sie ab.
Bei Ablehnung werden die Punkte automatisch zurückerstattet.

Einlösestatus

Status	Bedeutung
Ausstehend	Wartet auf Prüfung durch Root
Genehmigt	Von Root gewährt; Punkte bleiben abgezogen
Abgelehnt	Von Root verweigert; Punkte automatisch zurückerstattet

Berechtigungen — Shop

Aktion	Benutzer	Admin	Root
Shop-Artikel durchstöbern	✓	✓	✓
Einen Artikel einlösen	✓	✓	✓
Eigenen Einlöseverlauf ansehen	✓	✓	✓
Artikel erstellen / bearbeiten / deaktivieren	✗	✗	✓
Alle Einlösungen ansehen	✗	✗	✓
Einlösungen genehmigen / ablehnen	✗	✗	✓

Shop-Artikel

Root kann Artikel mit einem Titel, einer optionalen Beschreibung und einem Punktepreis erstellen. Artikel können deaktiviert werden, um sie im Shop auszublenden, ohne sie zu löschen. Es gibt keine Mengenbegrenzung — Artikel sind unbegrenzt verfügbar.

Support-Hinweise

Wenn die Punkte eines Mitglieds falsch aussehen, prüfe, ob kürzlich COMPLETED → TODO-Übergänge vorgenommen wurden (diese buchen Punkte automatisch zurück) oder ob ein Admin/Root den Wert der Belohnungspunkte einer abgeschlossenen Aufgabe bearbeitet hat (Erhöhungen schreiben die Differenz gut, Verringerungen ziehen sie ab).
Wenn ein Mitglied den Shop-Navigationspunkt nicht sehen kann, stelle sicher, dass sowohl points_system als auch store_enabled unter Konto → Einstellungen aktiviert sind.
Abgelehnte Einlösungen erstatten Punkte automatisch zurück — Root muss nach dem Ablehnen nichts weiter tun.
Auf inaktiv gesetzte Shop-Artikel sind für Mitglieder ausgeblendet, bleiben aber für Root zur Verwaltung sichtbar.