Pontos e Loja

Visão geral

O sistema de pontos concede pontos aos membros por concluírem itens de tarefa. Os pontos alimentam um ranking opcional e uma loja opcional onde os membros podem resgatar pontos por recompensas definidas pelo Root. Os três componentes ficam por trás de feature flags separadas e podem ser ativados de forma independente.

Requer: feature flag points_system (interruptor principal). As flags de ranking e de loja só fazem algo quando points_system também está ativada.

Feature flags

Flag	O que controla
`points_system`	Interruptor principal. Ativa a concessão de pontos na conclusão de tarefas.
`show_points_to_users`	Mostra aos membros o próprio saldo de pontos no cartão de estatística do painel e no perfil deles. Requer `points_system` ativada.
`leaderboard_enabled`	Mostra um ranking semanal no painel classificando todos os membros por pontos. Quando desativado, os membros ainda veem a própria pontuação, mas não a dos outros.
`store_enabled`	Ativa o item de navegação Loja e o fluxo de resgate.

Dois tipos de pontos

O Ziptask tem dois campos de pontos independentes em todo item de tarefa:

Campo	Finalidade	Quem define
Pontos de recompensa	Moeda de gamificação — concedida ao membro que conclui o item. Alimenta o cartão de estatística do painel, o ranking e o saldo da loja.	Admin / Root
Pontos de esforço estimado	Estimativa de trabalho — representa o peso de esforço do item. Usado pelo recurso Projetos para calcular custos estimados vs. ganhos. Não tem efeito nos saldos dos membros.	Admin / Root

Ambos os campos são restritos pela flag points_system. Os Pontos de recompensa e os Pontos de esforço estimado são totalmente independentes — alterar um não afeta o outro.

Pontos (recompensas)

Como os pontos de recompensa são ganhos

Os Pontos de recompensa são concedidos quando um membro faz a transição de um item de tarefa de DOING para COMPLETED. Se um item COMPLETED for redefinido para TODO (por Admin/Root), os pontos de recompensa são revertidos automaticamente.

Ajustes retroativos de pontos

Admin e Root podem alterar o valor de Pontos de recompensa em um item COMPLETED a qualquer momento. O ajuste é aplicado automaticamente:

Aumento — a diferença é imediatamente concedida ao membro que fez o trabalho.
Redução — a diferença é imediatamente deduzida do saldo do membro. A dedução tem piso em zero: se o membro já gastou os pontos, o saldo não fica negativo.

Os pontos são sempre atribuídos ao membro que estava atribuído ao item (quem fez). Para itens que exigiam aprovação, esse é o membro que concluiu o trabalho, não o admin que aprovou.

Visibilidade dos pontos

Quando show_points_to_users está ativada, os membros podem ver o próprio saldo de pontos de recompensa no cartão de estatística do painel e no perfil. Quando leaderboard_enabled também está ativada, todos podem ver os totais semanais de todos os membros no ranking.

Histórico de pontos

Quando points_system está ativada, os membros podem ver uma trilha completa de auditoria da própria atividade de pontos de recompensa na página de perfil (Perfil → aba Pontos). Cada entrada mostra o tipo de ação, o título do item de tarefa ou o nome do item da loja, os pontos ganhos ou gastos e a data. A lista é paginada e suporta rolagem infinita.

Permissões — Pontos

Ação	Usuário	Admin	Root
Ganhar pontos (conclusão de tarefa)	✓	✓	✓
Ver o próprio total de pontos	✓	✓	✓
Ver o próprio histórico de pontos	✓	✓	✓
Ver o ranking (quando ativado)	✓	✓	✓

Loja

Requer: points_system + store_enabled ambas ativadas.

Como funciona

O Root cria um catálogo de itens resgatáveis, cada um com um custo em pontos. Os membros navegam pela loja, solicitam resgates, e o Root os aprova ou rejeita.

Fluxo de resgate:

O membro clica em Resgatar em um item da loja.
Os pontos são deduzidos do saldo do membro imediatamente.
O resgate é criado no status Pendente.
O Root revisa os resgates pendentes e Aprova ou Rejeita.
Se rejeitado, os pontos são reembolsados automaticamente.

Status de resgate

Status	Significado
Pendente	Aguardando revisão do Root
Aprovado	Concedido pelo Root; os pontos permanecem deduzidos
Rejeitado	Negado pelo Root; os pontos são reembolsados automaticamente

Permissões — Loja

Ação	Usuário	Admin	Root
Navegar pelos itens da loja	✓	✓	✓
Resgatar um item	✓	✓	✓
Ver o próprio histórico de resgates	✓	✓	✓
Criar / editar / desativar itens	✗	✗	✓
Ver todos os resgates	✗	✗	✓
Aprovar / rejeitar resgates	✗	✗	✓

Itens da loja

O Root pode criar itens com um título, uma descrição opcional e um custo em pontos. Os itens podem ser desativados para escondê-los da loja sem excluí-los. Não há limite de quantidade — os itens são ilimitados.

Notas de suporte

Se os pontos de um membro parecem errados, verifique se houve transições COMPLETED → TODO recentemente (essas revertem os pontos automaticamente), ou se um Admin/Root editou o valor de Pontos de recompensa em um item concluído (aumentos concedem a diferença, reduções a deduzem).
Se um membro não consegue ver o item de navegação Loja, verifique se as duas flags points_system e store_enabled estão ativadas em Conta → Configurações.
Os resgates rejeitados reembolsam os pontos automaticamente — o Root não precisa fazer nada a mais depois de rejeitar.
Os itens da loja definidos como inativos ficam ocultos para os membros, mas permanecem visíveis para o Root para gerenciamento.