8. Pessoas, Pilotos e Licenças¶

📍 Onde fica: Pessoas · Configurações → Pilotos 👤 Quem pode: Administrador, Operacional, Financeiro e Staff de campo. Edição (criar/editar pessoas) é de Administrador/Operacional/Financeiro; Staff de campo vê pessoas e logbook, valida/atualiza licenças. 🔗 Pré-requisito: Dropzone configurada.

💰 Carteira: as informações financeiras (saldo, carteira) só aparecem para Administrador, Operacional e Financeiro. Os demais perfis veem a lista de pessoas e o logbook, mas sem dados de carteira.

Pessoa é qualquer um que entra na operação: atletas, passageiros tandem, instrutores, dobradores, pilotos. Diferente de Usuário (quem faz login — ver Equipe), a Pessoa é quem salta/trabalha e quem tem carteira.

As funções da Pessoa são deduzidas das licenças¶

Um detalhe importante: você não marca manualmente "fulano é instrutor". O sistema atualiza as flags de função da pessoa automaticamente a partir das licenças e habilitações que você registra:

Flag	Vem de
é atleta	Licença de salto válida (A/B/C/D/AI)
é instrutor	Habilitação de instrutor válida (TP/AFF/BBF)
é rigger	Certificação de dobra de reserva
é piloto	Habilitação de piloto válida (PP/PC/PLA)
é dobrador	Marcado quando presta serviço de dobra
é RTA	Elegível a ser Responsável Técnico
é passageiro	Tandem (manual ou via Bookeo)

💡 Por isso, cadastrar a licença certa é o que "libera" a pessoa para ser piloto, RTA, instrutor, etc.

Cadastrar uma pessoa¶

Pessoas → Adicionar.
Dados básicos: nome, apelido (é o que aparece no manifesto), e-mail (obrigatório), telefone, Instagram.
Documento: tipo (CPF ou Passaporte) + número. Quando você seleciona CPF o campo recebe máscara automática 000.000.000-00 e os dígitos são validados (rejeita CPF inválido).
Data de nascimento (formato DD/MM/AAAA, máscara automática enquanto digita).
Contato de emergência (importante!).
Perfil de salto: total de saltos, peso, altura.
Salve.

💡 Deduplicação automática. Ao salvar, o sistema procura pessoas com o mesmo nome (e a mesma data de nascimento, quando informada) e avisa antes de criar uma duplicata. Você pode confirmar "Criar nova mesmo assim" ou cancelar pra editar a pessoa existente. E-mail é único por tenant — o sistema bloqueia duas pessoas com o mesmo e-mail.

Licenças¶

Dentro de cada pessoa, na seção de Licenças, você registra a licença:

Campo	O que é
Emissor	Confederação que emite a licença: CBPq, USPA, ABPq ou Outro (texto livre). É a primeira informação do formulário — ao escolher "Outro", aparece um campo de texto livre para você especificar.
Número da licença	Número CBPq/USPA/etc. — no card de visualização aparece junto do emissor (ex.: `CBPq 77401`).
Categoria	AI / A / B / C / D
Validade	Data de expiração (formato `DD/MM/AAAA`, máscara automática).
CIS / CEM	Números e validades das habilitações
Federação	Associação regional vinculada (ex.: Associação Catarinense de Paraquedismo, FPPa). Texto livre — não confunda com Emissor.
Clube	Clube local de origem.

Operações disponíveis: - Renovar licença. - Upgrade de categoria (AI→A→B→C→D), com histórico de promoções. - Habilitações (endorsements): CIS, CEM, piloto — cada uma com validade própria. - Sincronizar CBPq: importa dados da licença direto da base do CBPq. O Emissor é preenchido automaticamente como CBPq. - Excluir a licença principal (botão de lixeira no card; pede confirmação).

💡 Datas com máscara automática. Todos os campos de data da licença (validade, afiliação, CEM, vigência) aceitam digitação manual no formato DD/MM/AAAA — basta digitar os números, o sistema insere as barras. Você ainda pode usar o ícone de calendário se preferir.

Pilotos¶

📍 Configurações → Pilotos

Esta tela é um atalho para gerenciar quem pilota:

Vincule o piloto a uma Pessoa existente (não dá pra mudar depois).
A pessoa precisa ter habilitação de piloto válida para ser escalada.
Acompanhe validade e status da licença.

⚠️ Sem piloto licenciado cadastrado, você não consegue escalar a decolagem (o piloto é obrigatório para colocar a decolagem em "agendada").

Acesso ao portal do atleta¶

Cada pessoa tem um interruptor de acesso ao portal (portal_access_enabled). Esse toggle individual é o que efetivamente libera o atleta a usar o portal (login, auto-cadastro, OAuth). Lembre que o portal também precisa estar ligado na DZ (Dropzone).

Para liberar: - Pessoas → (pessoa) → habilitar acesso ao portal. - Envie o convite (Convidar). O convite tem validade configurável.

Logbook (histórico de saltos)¶

Cada pessoa tem um logbook com o histórico de saltos — útil para o staff validar os saltos de um atleta (progressão, tipos de salto, aeronaves, atividade por período).

Para abrir: - Pessoas → (menu de ações da pessoa "⋮") → Logbook.

O logbook mostra: - Totais (todos os saltos e do ano) e seletor de ano. - Gráficos: por aeronave, por tipo de salto, saltos por mês e mapa de atividade (heatmap). - Histórico dos saltos com data, load, aeronave, altitude, pessoas no load e quem dobrou (com avaliação, quando houver — somente leitura). - Filtros por tipo, aeronave, local e período.

👤 Disponível para Administrador, Operacional, Financeiro e Staff de campo. O Dobrador acompanha apenas o seu próprio fluxo no portal do dobrador.

Regras importantes¶

Apelido é o nome exibido no manifesto — preencha para nomes longos.
As funções são automáticas a partir das licenças; não tente forçá-las manualmente.
O contato de emergência é dado de segurança — não deixe em branco para atletas.
Passageiros tandem normalmente são criados automaticamente pela reserva (Bookeo) e não têm usuário/login.

✅ Pronto quando¶

[ ] Staff principal cadastrado (instrutores, dobradores).
[ ] Pelo menos um piloto com licença válida.
[ ] Licenças dos atletas regulares registradas.
[ ] Acesso ao portal liberado para quem vai usá-lo.

➡️ Próximo: 9. Equipamentos