Licenças

Caminho no backoffice: backoffice/licenses

Disponível para funções: Administrador do Sistema, Administrador; Equipe de Operações pode visualizar e atribuir

Visão Geral

Licenças representam certificações e qualificações que pilotos obtêm ou compram. Elas servem como mecanismos de controle de acesso -- frotas, subfrotas, aeronaves, aeroportos ou horários específicos podem exigir uma licença, e apenas pilotos que possuem uma licença ativa são autorizados a reservar esses recursos.

Campos da Licença

Campo	Descrição
Nome	Nome de exibição da licença (ex.: "Certificação ETOPS", "Aproximação ILS CAT III").
Slug	Identificador seguro para URL gerado automaticamente.
Descrição	Descrição detalhada do que a licença certifica.
Custo (Pontos)	O preço em Pontos que um piloto paga para comprar esta licença.
Comprável	Indicador que controla se pilotos podem comprar esta licença por conta própria. Quando desabilitado, a licença só pode ser atribuída pela equipe.
Ativo	Indicador que controla se a licença está atualmente em uso. Licenças inativas são ocultadas dos pilotos.

Status da Licença do Piloto

Cada relacionamento piloto-licença rastreia o seguinte:

Campo	Descrição
Status	Estado atual: ativa, expirada ou pendente_renovação.
Emitida Em	Data/hora de quando a licença foi concedida pela primeira vez.
Expira Em	Data/hora de quando a licença expirará (se condições de renovação se aplicam).
Última Renovação Em	Data/hora da renovação mais recente.
Emitida Por	O membro da equipe que atribuiu a licença (para licenças atribuídas pela equipe).

Condições de Renovação

Licenças podem ter condições de renovação vinculadas que pilotos devem satisfazer para manter sua licença ativa. Cada condição é definida com:

Campo	Descrição
Tipo	O tipo de condição: flight-hours, flight-count ou outros tipos personalizados.
Parâmetros	Um objeto JSON contendo os limites ou critérios específicos (ex.: {"hours": 50} ou {"count": 10, "fleet": "B737"}).
Intervalo (dias)	Com que frequência a condição é avaliada (o comprimento do ciclo de renovação em dias).
Descrição	Descrição legível do requisito de renovação.
Ativo	Indicador para habilitar ou desabilitar esta condição específica.

Avaliação de Renovação

Um trabalho em segundo plano diário avalia todas as licenças com condições de renovação ativas:

1. Condições que não envolvem pagamento são verificadas primeiro -- o sistema verifica horas de voo, contagens de voo ou outros requisitos baseados em atividade.
2. Condições PAY_POINTS são verificadas por último -- Pontos são deduzidos apenas se todas as outras condições foram atendidas. Esta ordenação evita que pilotos percam Pontos em uma renovação que falharia de qualquer forma devido a requisitos de atividade não atendidos.
3. Se todas as condições passarem, a licença é renovada e expires_at é estendido.
4. Se qualquer condição falhar, a licença transita para o status expirada ou pendente_renovação.

Aplicação de Restrições

Licenças podem ser exigidas para acesso a recursos específicos. Quando uma restrição é configurada, pilotos devem possuir uma licença ativa para reservar ou voar:

• Frotas -- exigir uma licença para um tipo de frota inteiro (ex.: todas as variantes Boeing 737).
• Subfrotas -- exigir uma licença para uma subfrota específica (ex.: apenas B737-800).
• Aeronaves -- exigir uma licença para uma aeronave individual específica.
• Aeroportos -- exigir uma licença para partir de ou chegar a aeroportos específicos.
• Horários -- exigir uma licença para rotas programadas específicas.

Restrições são aplicadas no momento da reserva. Se um piloto não possuir a licença ativa exigida, a reserva é negada com uma mensagem de erro informativa.

Ações da Equipe

Administradores e equipe autorizada podem realizar as seguintes ações:

Ação	Descrição
Criar	Definir um novo tipo de licença com seus campos e condições de renovação.
Editar	Modificar propriedades, custo ou condições de renovação de uma licença existente.
Excluir	Remover um tipo de licença inteiramente (use com cautela -- afeta todos os detentores).
Atribuir a usuário	Conceder uma licença a um piloto específico, definindo seu status como ativa.
Revogar de usuário	Remover uma licença de um piloto específico.
Ver todos os detentores	Ver uma lista de todos os pilotos que possuem (ou possuíram) uma licença específica, com seu status atual.