Evaluación de Acceso a Cabina

Cuando alguien intenta abrir una cabina (por kiosk o por acceso móvil), el sistema evalúa su derecho de acceso y devuelve un resultado. Esta página describe cómo se toma esa decisión; el flujo de uso del kiosk y los mensajes al usuario están en Cabinas, kiosk y acceso móvil.

Resultados posibles

Resultado	Significado
`GRANTED`	Acceso concedido.
`DENIED_EXPIRED`	Suscripción con vigencia vencida.
`DENIED_NOT_FOUND`	No se encontró suscripción ni compra.
`DENIED_INACTIVE`	Suscripción suspendida o inactiva.
`DENIED_VERIFICATION_FAILED`	Falló la verificación de identidad (fecha de nacimiento).
`DENIED_NO_CABIN_ACCESS`	El plan no incluye acceso de cabina.
`DENIED_CABIN_LIMIT_REACHED`	Se agotó el cupo mensual del plan.
`DENIED_NOT_STARTED`	Suscripción aún en carencia (no ha iniciado).

Cómo se decide

La evaluación recorre el derecho de acceso según el plan, y siempre deja como último recurso las compras de acceso no consumidas.

graph TD
    A[Intento de acceso] --> B{¿Tiene plan?}
    B -->|No| P{¿Compra no consumida?}
    B -->|Sí| C{Tipo de plan}
    C -->|Ilimitado| G[GRANTED]
    C -->|Cero accesos| P
    C -->|Con cupo mensual| D{¿Reingreso dentro<br/>de la ventana de gracia?}
    D -->|Sí| G
    D -->|No| E{¿Usos del mes<br/>menores al cupo?}
    E -->|Sí| G
    E -->|No| P
    P -->|Sí| G
    P -->|No| R[DENIED_NO_CABIN_ACCESS /<br/>DENIED_CABIN_LIMIT_REACHED /<br/>DENIED_NOT_FOUND]

Tipo de plan	Regla
Sin plan	Solo concede si hay una compra de acceso no consumida.
Ilimitado (cupo nulo)	Siempre concede.
Cero accesos	No usa el plan; concede solo con una compra no consumida.
Cupo mensual (> 0)	Concede si los usos del mes son menores al cupo; si se agotó, intenta con una compra no consumida.

Ventana de gracia

Un reingreso dentro de N minutos del último acceso concedido es gratuito: no consume cupo. Para el conteo mensual, los accesos separados por menos de la ventana de gracia se colapsan en un solo acceso. El valor N viene de la configuración del inquilino (cabin_access_grace_minutes, por defecto 30 minutos). Ver Configuración y pruebas.

Carencia (período de espera)

Una suscripción recién creada queda en carencia durante unos días antes de poder usar la cabina por plan. El inicio (StartsAt) se fija en la fecha de pago más waiting_period_days (por defecto 3). Mientras hoy sea anterior al inicio, el acceso por plan se niega con DENIED_NOT_STARTED e indica desde cuándo será válido. Las compras de acceso (extras o de no suscriptor) sí funcionan durante la carencia.

Consumo y meses reembolsables

Cuando se consume una compra, se marca como consumida y, si está ligada a un pago, se incrementa el consumed_qty de ese pago. Ese consumo es lo que determina cuántos meses quedan reembolsables:

Los meses futuros siempre son reembolsables.
El ciclo en curso solo es reembolsable si no hubo uso de cabina en él.
Una suscripción SUSPENDED_EXPIRED tiene 0 meses reembolsables.

Esta es la base de las reglas de Notas de crédito.

Alcance: cédula vs cuenta

Origen	Resolución
No suscriptor	Las compras se resuelven por cédula únicamente.
Suscriptor / extra	Primero busca extras ligados a la cuenta; si no hay, recae en compras por cédula.

El conteo mensual y la ventana de gracia siempre se calculan por cédula, sin importar el estado de la cuenta.

Casos esperados en pruebas

Un plan ilimitado concede acceso siempre.
Un plan con cupo niega con DENIED_CABIN_LIMIT_REACHED al agotarse, salvo que exista una compra no consumida.
Un reingreso dentro de la ventana de gracia no consume cupo.
Una suscripción en carencia niega por plan con DENIED_NOT_STARTED, pero una compra sí abre.
Un uso de cabina en el ciclo en curso lo vuelve no reembolsable.