3. Equipe e Usuários¶

📍 Onde fica: Configurações → Equipe / Usuários 👤 Quem pode: Administrador (total) e Operacional (gerencia membros, exceto conceder o perfil Administrador) 🔗 Pré-requisito: Dropzone configurada.

Aqui você convida quem vai acessar o sistema e define o que cada um pode fazer através das funções (roles).

Conceito-chave: Usuário ≠ Pessoa¶

O Airo separa duas coisas que costumam se confundir:

Usuário = quem faz login (tem e-mail e senha). Cadastrado aqui em Equipe.
Pessoa = quem salta ou trabalha na operação (atleta, passageiro, instrutor, dobrador...). Cadastrada em Pessoas.

Um usuário pode estar ligado a uma pessoa (ex.: um instrutor que também acessa o sistema), mas não precisa. E uma pessoa (ex.: um passageiro tandem) normalmente não tem usuário.

💡 Ao adicionar um membro com o perfil Dobrador, o sistema cria/vincula automaticamente uma Pessoa e marca a flag de dobrador. Veja a regra em Regras de Negócio.

Perfil de acesso ≠ o que a pessoa é¶

Outra distinção importante:

Perfil de acesso (esta tela) = o que o usuário pode fazer no sistema (que telas abre, o que edita).
Classificação da pessoa (piloto, instrutor, tandem, videomaker, rigger…) = o que a pessoa é na operação, derivada das licenças (ver Pessoas). Serve para filtrar/listar e escalar — não dá acesso ao sistema.

Ou seja: um tandem pilot freelance é "piloto/instrutor" (classificação), mas para ver a própria carteira ele só precisa do perfil Atleta — não recebe acesso de campo ao admin.

Perfis de acesso disponíveis¶

Perfil	App	O que libera
Administrador	Admin (total)	Controle total: configurações da DZ, equipe, financeiro, operação, catálogos
Operacional	Admin	Operação do dia a dia (manifesto, decolagens, reservas), pessoas, catálogos, contas e equipe — não configura a DZ nem concede o perfil Administrador
Financeiro	Admin (foco $)	Carteiras/contas, produtos e preços, organizações; vê manifesto e catálogos sem alterar
Staff de campo	Admin (consulta)	Vê pessoas e manifesto, vê o logbook, valida/atualiza licenças e aprova equipamentos — não edita pessoas nem gerencia a operação
RTA	Admin (relatórios)	Relatórios técnicos (CBPq) e consulta da operação — sem poderes de gestão
Dobrador	Portal do Dobrador	Registrar dobras, ver ganhos e pagamentos
Aeronauta	Portal do Aeronauta	Piloto ou dono de avião: decolagens, atividade e combustível das suas aeronaves
Abastecedor	Portal do Combustível	Registrar abastecimentos no pátio (por decolagem ou avulso)
Atleta	Portal do atleta	Manifesto do dia, logbook, carteira, perfil

Um usuário pode ter vários perfis ao mesmo tempo — o acesso é a soma de todos. Os perfis Atleta, Aeronauta e Abastecedor também podem ser liberados pela ficha da Pessoa (toggles de acesso a portal) — conceder por aqui ou por lá dá no mesmo, os dois lados ficam sincronizados.

Passo a passo¶

Convidar um membro¶

Configurações → Equipe / Usuários.
Clique em Adicionar / Convidar.
Informe o e-mail. Enquanto você digita, o Airo procura:
Se já existe Usuário com esse e-mail (em qualquer DZ) — preenche o nome automaticamente e desabilita a edição.
Se já existe Pessoa com esse e-mail na sua DZ — pré-seleciona ela no autocomplete de "Pessoa vinculada" (e preenche o nome se ainda estiver vazio). Você ainda pode trocar manualmente.
Informe o nome (caso não tenha sido preenchido).
Selecione as funções. 💡 Clique no ícone ⓘ ao lado de "Funções" para abrir o comparador de perfis — mostra, lado a lado, o que cada perfil libera por área (Pessoas, Operação, Reservas, Financeiro, Equipamentos, Catálogos, Configurações, Equipe) com chips de "Gerencia / Visualiza / Aprova".
Envie o convite.

🔗 Auto-vínculo de Pessoa. Se o convidado já está cadastrado como Pessoa no tenant (ex.: atleta virando staff), o sistema reaproveita a Pessoa existente em vez de criar uma duplicata — apenas aplica as flags da função (packer/instructor/...). Funciona automaticamente mesmo se você não selecionar nada no autocomplete; basta que o e-mail bata.

O que o convidado recebe por email¶

Usuário novo (não tinha conta no Airo): recebe um email com boas-vindas, um botão de Entrar e a senha temporária. No primeiro login o sistema obriga a trocar a senha.
Usuário já existente (já tinha conta em outra DZ): recebe um email informativo — "Você foi adicionado(a) à equipe da {DZ}". Ele segue usando a senha atual e basta selecionar essa DZ depois do login.

Em ambos os casos a tela do admin também exibe as credenciais (com botão "Copiar senha") como fallback — se o email não chegar, você compartilha manualmente.

📧 O envio depende do serviço de email estar habilitado em produção (EMAIL_ENABLED=true + fila SQS configurada — ver Integrações e Portais). Se o serviço estiver desligado, o Airo segue criando a conta normalmente e só registra a tentativa de envio no log.

Gerenciar membros existentes¶

Abas: filtre por todos / staff / atleta / bloqueados.
Editar: alterar nome, funções e o Acesso do Dobrador (permanente ou temporário — ver abaixo).
Redefinir senha: gera nova senha para o usuário.
Ativar/Desativar: bloqueia o acesso sem apagar o histórico.
Remover: exclui o membro.

Acesso temporário (janelas de datas)¶

Para quem vem fazer freelance na DZ — o dobrador ou staff de campo chamado para um fim de semana de operação grande — não precisa convidar e depois lembrar de desativar. No formulário do membro, com o perfil Dobrador marcado, o bloco Acesso do Dobrador tem duas opções:

Permanente (padrão): comportamento normal, o membro sempre tem acesso.
Temporário (perfil Dobrador): o membro só "existe" para a DZ nas janelas de acesso cadastradas. Cada janela é um período De / Até (datas inclusivas) com uma observação opcional ("Boogie de setembro"). Preencha as datas e clique em Adicionar janela para colocá-la na lista (se esquecer, o Salvar inclui a janela preenchida automaticamente). Cadastre quantas janelas precisar — se a pessoa volta em outro momento, adicione outra. Para estender uma passagem, edite a data final.

Regras da janela:

A data final é obrigatória e não pode ser anterior à inicial.
Janelas do mesmo membro não se sobrepõem (o sistema recusa).
Janelas no passado são permitidas — ficam como registro de quem esteve na DZ.
Trocar de temporário para permanente mantém as janelas gravadas (ficam sem efeito).
O bloco só aparece quando o perfil Dobrador está marcado, e nunca junto de Administrador, Operacional ou Financeiro — esses são sempre permanentes.
O modo temporário é do perfil Dobrador: as janelas valem para o que é da DZ no Portal do Dobrador (manifesto, dobras, valores). Um membro com mais de um perfil continua temporário — por exemplo, o dobrador freelancer que também é Parceiro (dono de equipamento de aluguel) — e os outros perfis não são afetados: o Portal do Parceiro, a carteira e o histórico seguem disponíveis em qualquer data.

Na lista da equipe, o selo do perfil Dobrador passa a mostrar o modo e a janela vigente ou a próxima — Dobrador · Temporário · 03/09 – 07/09 — ou sem janela ativa. Os outros perfis do mesmo membro aparecem normalmente.

O que muda para o membro temporário fora das datas está descrito em Portal do Dobrador e em Regras de Negócio.

Regras importantes¶

Administrador e Operacional acessam esta tela. Só o Administrador pode conceder, alterar ou remover o perfil Administrador de alguém — assim o Operacional não consegue se autopromover.
Desativar um usuário não apaga o histórico dele (transações, decolagens) — apenas tira o acesso.
Quem pilota é definido pela licença de piloto na ficha da Pessoa (classificação), não por um perfil de acesso — ver Pilotos.
O acesso é por ação: alguns perfis veem uma tela mas não podem alterar (ex.: Financeiro vê o manifesto mas não edita; Staff vê pessoas mas não edita).
Acesso temporário compara sempre a data da decolagem/manifesto com as janelas do membro, nunca o "agora". Fora das janelas o membro continua entrando no sistema e vendo o próprio histórico e a carteira — só perde o que é da DZ (manifesto, marcação de dobra, valores e preços).

✅ Pronto quando¶

[ ] Administradores principais convidados.
[ ] Operacional/financeiro convidados conforme a equipe.
[ ] Funções revisadas (princípio do menor privilégio).

➡️ Próximo: 4. Organizações