Niveles de fidelidad

El sistema de niveles de fidelidad recompensa a los clientes habituales con descuentos automaticos basados en su actividad acumulada. A medida que los miembros usan el cafe (gastando dinero, iniciando sesion, comprando paquetes o realizando pedidos) ganan puntos de fidelidad. Cuando sus puntos totales superan el umbral de un nivel, avanzan a un nivel superior y reciben un mayor descuento en los precios de las sesiones.

Estructura de niveles

Cada nivel de fidelidad se define por cuatro campos:

Los niveles se ordenan por su valor de threshold_points. Un miembro pertenece al nivel mas alto para el cual cumple el umbral de puntos.

Descuentos en puntos base (BPS)

Los descuentos se expresan en puntos base (BPS) en lugar de porcentajes para evitar errores de redondeo de punto flotante en los calculos financieros. Un punto base equivale al 0.01%, o una centesima de porcentaje.

Valores de descuento comunes:

Cuando un miembro con descuento de nivel inicia una sesion, el motor de precios reduce la tarifa por hora base segun el discount_bps del nivel antes de calcular los costos de los segmentos.

Eventos de fidelidad

Los miembros ganan puntos a traves de eventos de fidelidad. Cada evento registra un cambio de puntos y la actividad que lo activo:

Cada registro de evento de fidelidad incluye:

• points_delta: La cantidad de puntos ganados (positivo) o perdidos (negativo) de este evento.
• amount_minor: El monto monetario asociado al evento (en unidades menores de moneda), si aplica.
• minutes_delta: La cantidad de minutos asociados al evento, si aplica.
• source_entity / source_entity_id: Una referencia a la sesion, pedido o transaccion que genero el evento.
• event_at: La marca de tiempo de cuando ocurrio el evento.

Progresion de niveles

La progresion de niveles funciona de la siguiente manera:

1. Un miembro realiza una actividad (sesion, compra, inicio de sesion, etc.).
2. El sistema crea un evento de fidelidad con el points_delta correspondiente.
3. Los puntos totales del miembro se recalculan como la suma de todos los valores points_delta de sus eventos de fidelidad.
4. El sistema verifica si el nuevo total cumple el umbral para un nivel superior.
5. Si el miembro califica para un nuevo nivel, su campo tier se actualiza y el nuevo descuento toma efecto en su proxima sesion.

La asignacion de niveles tambien puede establecerse manualmente por un administrador, anulando el calculo automatico.

Como los descuentos de nivel aplican a los precios de sesion

Cuando el motor de precios calcula el costo de un segmento de sesion para un miembro:

1. El precio por hora base se determina por la franja de precios activa.
2. Si el miembro tiene un nivel con valor de discount_bps, el precio base se reduce: precio_descontado = precio_base * (10000 - discount_bps) / 10000.
3. Adicionalmente, los descuentos individuales a nivel de miembro (member_discount_bps en el registro del miembro) se aplican si estan presentes.
4. La tarifa descontada final se usa para calcular el costo del segmento.

Los descuentos de nivel y los descuentos a nivel de miembro pueden acumularse, dando al miembro el beneficio combinado de ambos.

Crear y gestionar niveles

Para crear un nuevo nivel:

1. Navegue a Configuracion y abra la seccion de Precios (o el area dedicada de gestion de niveles).
2. Haga clic en Agregar nivel.
3. Ingrese el codigo (unico, en minusculas), nombre (etiqueta visible), puntos de umbral y descuento BPS.
4. Guarde el nivel.

Para editar un nivel existente, seleccionelo de la lista y modifique cualquiera de sus campos. Los cambios en el discount_bps de un nivel toman efecto en todos los miembros actualmente asignados a ese nivel, comenzando con su proxima sesion.

Para eliminar un nivel, quitelo de la lista. Los miembros que estaban asignados al nivel eliminado retrocederan al siguiente nivel inferior para el cual califiquen basandose en sus puntos.

Ejemplo de configuracion de niveles

Una configuracion tipica de tres niveles podria verse asi:

En esta configuracion, un nuevo miembro comienza en Bronce (sin descuento). Despues de acumular 500 puntos por visitas, gastos y pedidos, automaticamente sube a Plata con un descuento del 5%. A los 2000 puntos alcanza Oro (10%) y a los 5000 puntos logra el estatus VIP (15%).