Licencias

Ruta del backoffice: backoffice/licenses

Disponible para roles: Administrador del Sistema, Administrador; el Personal de Operaciones puede ver y asignar

Descripción General

Las licencias representan certificaciones y calificaciones que los pilotos obtienen o compran. Sirven como mecanismos de control de acceso — flotas, subflotas, aeronaves, aeropuertos o horarios específicos pueden requerir una licencia, y solo los pilotos que posean una licencia activa tienen permiso para reservar esos recursos.

Campos de Licencia

Campo	Descripción
Nombre	Nombre de visualización de la licencia (por ejemplo, "Certificación ETOPS", "Aproximación ILS CAT III").
Slug	Identificador seguro para URL generado automáticamente.
Descripción	Descripción detallada de lo que certifica la licencia.
Costo (Puntos)	El precio en Puntos que un piloto paga para comprar esta licencia.
Comprable	Interruptor que controla si los pilotos pueden comprar esta licencia ellos mismos. Cuando está deshabilitado, la licencia solo puede ser asignada por el personal.
Activa	Interruptor que controla si la licencia está actualmente en uso. Las licencias inactivas se ocultan de los pilotos.

Estado de Licencia del Piloto

Cada relación piloto-licencia registra lo siguiente:

Campo	Descripción
Estado	Estado actual: activa, expirada o pendiente_renovación.
Emitida El	Marca de tiempo de cuándo se otorgó la licencia por primera vez.
Expira El	Marca de tiempo de cuándo expirará la licencia (si se aplican condiciones de renovación).
Última Renovación	Marca de tiempo de la renovación más reciente.
Emitida Por	El miembro del personal que asignó la licencia (para licencias asignadas por el personal).

Condiciones de Renovación

Las licencias pueden tener condiciones de renovación adjuntas que los pilotos deben satisfacer para mantener su licencia activa. Cada condición se define con:

Campo	Descripción
Tipo	El tipo de condición: flight-hours, flight-count u otros tipos personalizados.
Parámetros	Un objeto JSON que contiene los umbrales o criterios específicos (por ejemplo, {"hours": 50} o {"count": 10, "fleet": "B737"}).
Intervalo (días)	Con qué frecuencia se evalúa la condición (la duración del ciclo de renovación en días).
Descripción	Descripción legible del requisito de renovación.
Activa	Interruptor para habilitar o deshabilitar esta condición específica.

Evaluación de Renovación

Un trabajo en segundo plano diario evalúa todas las licencias con condiciones de renovación activas:

1. Las condiciones de no pago se verifican primero -- el sistema verifica horas de vuelo, cantidad de vuelos u otros requisitos basados en actividad.
2. Las condiciones PAY_POINTS se verifican al final -- los Puntos solo se deducen si todas las demás condiciones han sido cumplidas. Este ordenamiento previene que los pilotos pierdan Puntos en una renovación que fallaría de todos modos debido a requisitos de actividad no cumplidos.
3. Si todas las condiciones pasan, la licencia se renueva y expires_at se extiende.
4. Si alguna condición falla, la licencia transiciona al estado expirada o pendiente_renovación.

Aplicación de Restricciones

Las licencias pueden requerirse para acceder a recursos específicos. Cuando se configura una restricción, los pilotos deben poseer una licencia activa para reservar o volar:

• Flotas -- requerir una licencia para un tipo de flota completo (por ejemplo, todas las variantes del Boeing 737).
• Subflotas -- requerir una licencia para una subflota específica (por ejemplo, solo B737-800).
• Aeronaves -- requerir una licencia para una aeronave individual específica.
• Aeropuertos -- requerir una licencia para salir de o llegar a aeropuertos específicos.
• Horarios -- requerir una licencia para rutas programadas específicas.

Las restricciones se aplican en el momento de la reserva. Si un piloto no posee la licencia activa requerida, la reserva se deniega con un mensaje de error informativo.

Acciones del Personal

Los administradores y el personal autorizado pueden realizar las siguientes acciones:

Acción	Descripción
Crear	Definir un nuevo tipo de licencia con sus campos y condiciones de renovación.
Editar	Modificar las propiedades, costo o condiciones de renovación de una licencia existente.
Eliminar	Eliminar un tipo de licencia completamente (usar con precaución — afecta a todos los titulares).
Asignar a usuario	Otorgar una licencia a un piloto específico, estableciendo su estado como activa.
Revocar de usuario	Retirar una licencia de un piloto específico.
Ver todos los titulares	Ver una lista de todos los pilotos que poseen (o han poseído) una licencia específica, con su estado actual.