Puntos y Tienda

Descripción general

El sistema de puntos otorga puntos a los miembros por completar tareas. Los puntos alimentan una clasificación opcional y una tienda opcional donde los miembros pueden canjear puntos por recompensas definidas por Root. Los tres componentes están detrás de feature flags separados y pueden activarse de forma independiente.

Requiere: el feature flag points_system (interruptor principal). Los flags de la clasificación y la tienda solo tienen efecto cuando points_system también está activado.

Feature flags

Flag	Qué controla
`points_system`	Interruptor principal. Activa la concesión de puntos al completar una tarea.
`show_points_to_users`	Muestra a los miembros su propio saldo de puntos en la tarjeta de estadísticas del inicio y en su perfil. Requiere `points_system` activado.
`leaderboard_enabled`	Muestra una clasificación semanal en el inicio que ordena a todos los miembros por puntos. Cuando está desactivado, los miembros pueden ver su propia puntuación pero no la de los demás.
`store_enabled`	Activa el elemento de navegación Tienda y el flujo de canje.

Dos tipos de puntos

Ziptask tiene dos campos de puntos independientes en cada tarea:

Campo	Propósito	Quién lo define
Puntos de recompensa	Moneda de gamificación: se otorgan al miembro que completa la tarea. Impulsan la tarjeta de estadísticas del inicio, la clasificación y el saldo de la tienda.	Admin / Root
Puntos de esfuerzo estimados	Estimación de trabajo: representan el peso del esfuerzo de la tarea. Los usa la función de Proyectos para calcular los costos estimados frente a los ganados. No afecta los saldos de los miembros.	Admin / Root

Ambos campos están controlados por el flag points_system. Los Puntos de recompensa y los Puntos de esfuerzo estimados son totalmente independientes: cambiar uno no afecta al otro.

Puntos (recompensas)

Cómo se ganan los puntos de recompensa

Los Puntos de recompensa se otorgan cuando un miembro pasa una tarea de DOING a COMPLETED. Si una tarea COMPLETED se reinicia a TODO (por Admin/Root), los puntos de recompensa se revierten automáticamente.

Ajustes retroactivos de puntos

Admin y Root pueden cambiar el valor de Puntos de recompensa de una tarea COMPLETED en cualquier momento. El ajuste se aplica automáticamente:

Aumento: la diferencia se otorga de inmediato al miembro que hizo el trabajo.
Disminución: la diferencia se deduce de inmediato del saldo del miembro. La deducción tiene un piso de cero: si el miembro ya gastó los puntos, el saldo no quedará en negativo.

Los puntos siempre se atribuyen al miembro que tenía asignada la tarea (quien la ejecuta). Para las tareas que requerían aprobación, este es el miembro que completó el trabajo, no el administrador que lo aprobó.

Visibilidad de los puntos

Cuando show_points_to_users está activado, los miembros pueden ver su propio saldo de puntos de recompensa en la tarjeta de estadísticas del inicio y en su perfil. Cuando leaderboard_enabled también está activado, todos pueden ver los totales semanales de todos los miembros en la clasificación.

Historial de puntos

Cuando points_system está activado, los miembros pueden ver un registro completo de auditoría de su propia actividad de puntos de recompensa desde su página de perfil (Perfil → pestaña Puntos). Cada entrada muestra el tipo de acción, el título de la tarea o el nombre del artículo de la tienda, los puntos ganados o gastados y la fecha. La lista está paginada y admite desplazamiento infinito.

Permisos — Puntos

Acción	Usuario	Admin	Root
Ganar puntos (completar tareas)	✓	✓	✓
Ver el total de puntos propio	✓	✓	✓
Ver el historial de puntos propio	✓	✓	✓
Ver la clasificación (cuando está activada)	✓	✓	✓

Tienda

Requiere: points_system + store_enabled, ambos activados.

Cómo funciona

Root crea un catálogo de artículos canjeables, cada uno con un costo en puntos. Los miembros exploran la tienda, solicitan canjes, y Root los aprueba o los rechaza.

Flujo de canje:

El miembro toca Canjear en un artículo de la tienda.
Los puntos se deducen del saldo del miembro de inmediato.
El canje se crea en estado Pendiente.
Root revisa los canjes pendientes y los Aprueba o los Rechaza.
Si se rechaza, los puntos se reembolsan automáticamente.

Estados de canje

Estado	Significado
Pendiente	En espera de la revisión de Root
Aprobado	Concedido por Root; los puntos siguen deducidos
Rechazado	Denegado por Root; los puntos se reembolsan automáticamente

Permisos — Tienda

Acción	Usuario	Admin	Root
Explorar los artículos de la tienda	✓	✓	✓
Canjear un artículo	✓	✓	✓
Ver el historial de canjes propio	✓	✓	✓
Crear / editar / desactivar artículos	✗	✗	✓
Ver todos los canjes	✗	✗	✓
Aprobar / rechazar canjes	✗	✗	✓

Artículos de la tienda

Root puede crear artículos con un título, una descripción opcional y un costo en puntos. Los artículos se pueden desactivar para ocultarlos de la tienda sin eliminarlos. No hay límite de cantidad: los artículos son ilimitados.

Notas de soporte

Si los puntos de un miembro parecen incorrectos, verifica si se hicieron recientemente transiciones de COMPLETED → TODO (esas revierten puntos automáticamente), o si un Admin/Root editó el valor de Puntos de recompensa de una tarea completada (los aumentos otorgan la diferencia, las disminuciones la deducen).
Si un miembro no ve el elemento de navegación Tienda, verifica que points_system y store_enabled estén ambos activados en Cuenta → Configuración.
Los canjes rechazados reembolsan los puntos automáticamente: Root no necesita hacer nada adicional después de rechazar.
Los artículos de la tienda marcados como inactivos se ocultan de los miembros, pero permanecen visibles para Root para su gestión.