Admin: referidos (negocio)

Programa de referidos (vista operador)

/admin/referrals

Ruta /admin/referrals: reglas y métricas de negocio. Los enlaces de compartir del miembro viven en el espacio de cliente, no en esta pantalla.

Uso

Configura si el programa corre, cuándo cuenta un referido (al registrarse o al pagar), el tipo de recompensa y revisa agregados y cada fila. Es la consola de operaciones; el marketing y el UI del miembro son otros módulos.

Ajustes guardados

  • enabled — interruptor general; si está inactivo, el API no debería generar nuevas recompensas (comprueba el comportamiento exacto en backend).
  • trigger — `registration` (usuario invitado crea cuenta) o `payment` (hito de pago del referido; revisa reglas en API).
  • reward_type — `discount` (vinculado a un `discount` por id) o `custom` (flujo no cupón, según implementación).
  • discount_id — obligatorio en modo descuento; se cargan cupones desde el catálogo de descuentos del admin.

Métricas

  • total — filas de referido en el alcance del listado global.
  • exitosos / pendientes — conteos por status.
  • Tasa de conversión — porcentaje exitosos sobre total, según cálculo del API.

Columnas de tabla

  • id — identificador de fila.
  • referrer — { id, email, full_name } quien invita.
  • referred — { id, email, full_name } invitado.
  • status — pending | successful | failed (fallido: no califica o recompensa denegada).
  • reward_code — opcional { code } si se generó token o cupón.
  • conversion_at — cuándo se marcó el éxito, nulo hasta entonces.
  • created_at — alta del registro de referido.

Listado paginado (p. ej. 20 por página) con total. Tras editar, guarda en una acción: valida que exista descuento si el modo lo exige.