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
Dobrador	Portal do dobrador	Registrar dobras, ver ganhos e pagamentos
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. O perfil Atleta é liberado automaticamente ao ligar o acesso ao portal na ficha da Pessoa.

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 e funções.
Redefinir senha: gera nova senha para o usuário.
Ativar/Desativar: bloqueia o acesso sem apagar o histórico.
Remover: exclui o membro.

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).

✅ 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