Punti e negozio

Panoramica

Il sistema a punti assegna punti ai membri per il completamento delle attività. I punti alimentano una classifica facoltativa e un negozio facoltativo dove i membri possono riscattare i punti per premi definiti da Root. Tutti e tre i componenti sono dietro feature flag separati e possono essere attivati in modo indipendente.

Richiede: feature flag points_system (interruttore principale). I flag della classifica e del negozio funzionano solo quando anche points_system è attivo.

Feature flag

Flag	Cosa controlla
`points_system`	Interruttore principale. Attiva l’assegnazione di punti al completamento delle attività.
`show_points_to_users`	Mostra ai membri il proprio saldo punti nella scheda statistica della dashboard e nel loro profilo. Richiede `points_system` attivo.
`leaderboard_enabled`	Mostra una classifica settimanale sulla dashboard che classifica tutti i membri per punti. Quando è disattivato, i membri possono comunque vedere il proprio punteggio ma non quello degli altri.
`store_enabled`	Attiva la voce di navigazione Negozio e il flusso di riscatto.

Due tipi di punti

Ziptask ha due campi di punti indipendenti su ogni attività:

Campo	Scopo	Chi lo imposta
Punti premio	Valuta di gamification — assegnata al membro che completa l’attività. Alimenta la scheda statistica della dashboard, la classifica e il saldo del negozio.	Admin / Root
Punti impegno stimati	Stima del lavoro — rappresenta il peso dello sforzo dell’attività. Usato dalla funzionalità Progetti per calcolare i costi stimati vs. guadagnati. Non ha effetto sui saldi dei membri.	Admin / Root

Entrambi i campi sono limitati dal flag points_system. I Punti premio e i Punti impegno stimati sono del tutto indipendenti — cambiare uno non influisce sull’altro.

Punti (premi)

Come si guadagnano i punti premio

I Punti premio vengono assegnati quando un membro fa passare un’attività da DOING a COMPLETED. Se un’attività COMPLETED viene ripristinata a TODO (da Admin/Root), i punti premio vengono automaticamente stornati.

Rettifiche retroattive dei punti

Admin e Root possono cambiare il valore dei Punti premio su un’attività COMPLETED in qualsiasi momento. La rettifica viene applicata automaticamente:

Aumento — il delta viene immediatamente assegnato al membro che ha svolto il lavoro.
Diminuzione — il delta viene immediatamente detratto dal saldo del membro. La detrazione è limitata a zero: se il membro ha già speso i punti, il saldo non diventerà negativo.

I punti sono sempre attribuiti al membro a cui era assegnata l’attività (chi la esegue). Per le attività che richiedevano l’approvazione, questo è il membro che ha svolto il lavoro, non l’admin che l’ha approvata.

Visibilità dei punti

Quando show_points_to_users è attivo, i membri possono vedere il proprio saldo di punti premio nella scheda statistica della dashboard e nel loro profilo. Quando anche leaderboard_enabled è attivo, tutti possono vedere i totali settimanali di tutti i membri nella classifica.

Cronologia dei punti

Quando points_system è attivo, i membri possono visualizzare un registro completo della propria attività di punti premio dalla pagina del loro profilo (Profilo → scheda Punti). Ogni voce mostra il tipo di azione, il titolo dell’attività o il nome dell’articolo del negozio, i punti guadagnati o spesi e la data. L’elenco è paginato e supporta lo scorrimento infinito.

Permessi — Punti

Azione	User	Admin	Root
Guadagnare punti (completamento attività)	✓	✓	✓
Vedere il proprio totale di punti	✓	✓	✓
Vedere la propria cronologia dei punti	✓	✓	✓
Vedere la classifica (quando attiva)	✓	✓	✓

Negozio

Richiede: points_system + store_enabled entrambi attivi.

Come funziona

Root crea un catalogo di articoli riscattabili, ognuno con un costo in punti. I membri sfogliano il negozio, richiedono i riscatti, e Root li approva o rifiuta.

Flusso di riscatto:

Il membro clicca Riscatta su un articolo del negozio.
I punti vengono detratti immediatamente dal saldo del membro.
Il riscatto viene creato in stato In attesa.
Root rivede i riscatti in attesa e li Approva o li Rifiuta.
Se rifiutato, i punti vengono automaticamente rimborsati.

Stati del riscatto

Stato	Significato
In attesa	In attesa della revisione di Root
Approvato	Concesso da Root; i punti restano detratti
Rifiutato	Negato da Root; i punti automaticamente rimborsati

Permessi — Negozio

Azione	User	Admin	Root
Sfogliare gli articoli del negozio	✓	✓	✓
Riscattare un articolo	✓	✓	✓
Vedere la propria cronologia dei riscatti	✓	✓	✓
Creare / modificare / disattivare articoli	✗	✗	✓
Vedere tutti i riscatti	✗	✗	✓
Approvare / rifiutare i riscatti	✗	✗	✓

Articoli del negozio

Root può creare articoli con un titolo, una descrizione facoltativa e un costo in punti. Gli articoli possono essere disattivati per nasconderli dal negozio senza eliminarli. Non c’è alcun limite di quantità — gli articoli sono illimitati.

Note per l’assistenza

Se i punti di un membro sembrano sbagliati, verifica se sono state effettuate di recente delle transizioni COMPLETED → TODO (quelle stornano i punti automaticamente), oppure se un Admin/Root ha modificato il valore dei Punti premio su un’attività completata (gli aumenti assegnano il delta, le diminuzioni lo detraggono).
Se un membro non riesce a vedere la voce di navigazione Negozio, verifica che sia points_system sia store_enabled siano attivi in Account → Impostazioni.
I riscatti rifiutati rimborsano automaticamente i punti — Root non deve fare nulla di extra dopo aver rifiutato.
Gli articoli del negozio impostati come inattivi sono nascosti ai membri ma restano visibili a Root per la gestione.