10. Integrações e Portais¶

📍 Onde fica: Configurações → Dropzone (Bookeo e portais) 👤 Quem pode: Administrador 🔗 Pré-requisito: Produtos criados (para mapear produtos do Bookeo).

Última etapa do onboarding: conectar a DZ ao Bookeo (reservas) e abrir os portais para atletas e dobradores.

Integração Bookeo (reservas)¶

O Bookeo é a plataforma de reservas online. O Airo sincroniza as reservas e os participantes automaticamente.

Configuração¶

No bloco Bookeo das configurações da Dropzone:

Campo	O que é
Bookeo habilitado	Interruptor geral
API Key / Secret Key	Credenciais da sua conta Bookeo
Mapeamento de produtos	Liga cada produto do Bookeo a um Produto do Airo
Campos personalizados	Códigos dos campos de peso, altura e Instagram no Bookeo
Parte da empresa (company party)	A identidade da própria DZ (carteira "da casa")
Data inicial para sincronização	Cutoff: reservas com data agendada anterior são ignoradas. Deixe vazio para puxar tudo

🗓️ Por que existe a data inicial: se você só vai começar a operar pelo Airo a partir de uma data X, agendamentos antigos do Bookeo (já realizados ou cancelados fora do sistema) não devem virar reservas e créditos retroativos. Defina a data X aqui e tudo que estiver agendado antes é pulado pelo sync.

Como funciona¶

No manifesto, use Sincronizar Bookeo para puxar as reservas da data.
O Airo cria/atualiza as reservas e os participantes (passageiros).
Cada produto do Bookeo é resolvido para o Produto do Airo pelo mapeamento.
O depósito pago no Bookeo é importado e cai como crédito na carteira do passageiro.
Os telefones dos participantes são normalizados para o formato internacional E.164 (+5511999999999) — usando o País padrão (telefone) da DZ (ver 1. Configurar a Dropzone) quando o Bookeo entrega o número sem DDI.

⚠️ Mapeie os produtos antes de sincronizar. Sem o mapeamento, a reserva chega sem produto e não cobra corretamente.

💼 Identificação no extrato. Lançamentos criados pelo Bookeo aparecem na carteira com o autor Integração Bookeo Sync (Nome do admin) — ou seja, indica que veio da integração e quem disparou o sync. Útil pra auditoria.

CBPq (lookup de licenças)¶

Na ficha de uma pessoa, o botão Sincronizar CBPq importa dados da licença direto da base do CBPq (nome, número, categoria, validade, federação, clube, habilitações).

O campo Emissor da licença é preenchido automaticamente como CBPq quando o sync é executado.
Atualizações posteriores no CBPq podem ser re-importadas a qualquer momento.
Veja Pessoas, Pilotos e Licenças para detalhes do que cada campo significa.

🌐 Requisito de rede: a sincronização com o Bookeo (e o login Google) precisam de acesso à internet de saída. Em produção serverless isso tem implicações de infra — ver CLAUDE.md (seção Deployment).

Portal do Atleta¶

O atleta acessa seu próprio manifesto, carteira, logbook e perfil.

Dois níveis de liga/desliga: 1. Na DZ (Configurações → Dropzone): portal habilitado, modo de registro (só convite / aberto), auto check-in, seções visíveis (carteira/logbook/manifesto), validade do convite. 2. Por pessoa (Pessoas → (pessoa)): acesso ao portal habilitado + envio de convite.

Os dois precisam estar ligados. Detalhes do uso em Portais do Atleta e do Dobrador.

Portal do Dobrador¶

O dobrador registra dobras, vê seus ganhos e acompanha pagamentos dos atletas.

Configuração na DZ (Configurações → Dropzone): - Portal do dobrador habilitado. - Preço padrão de dobra (sugestão ao registrar dobra manual). - Gatilho de lançamento automático: gera a dobra quando a decolagem fica pousou ou decolou. - Mostrar dobras pagas pela DZ: exibe os créditos de dobra embutidos nos produtos.

Para a pessoa ser dobradora, ela precisa ter a função dobrador (e/ou prestar serviço de dobra). Veja o uso em Dobra e Dobradores.

Portal do Aeronauta¶

Portal só de consulta para quem pilota e/ou é dono de aeronave. Reúne, por período, os números da operação — sem que o aeronauta precise mexer em nada.

O que ele mostra:

Como piloto lançador (voos que a pessoa pilotou): decolagens, tandems lançados, paraquedistas a bordo e tempo de voo (das marcações de decolagem e pouso).
Como dono de aeronave (aeronaves da pessoa): ocupação paga vs total, composição por tipo de salto, combustível (litros no dia e por abastecimento) e o repasse (R$) devido pela DZ.

Regra do financeiro: os valores em reais aparecem apenas nas aeronaves que a pessoa é dona. Aeronaves que ela só pilota mostram os números operacionais, sem o financeiro.

Como o sistema reconhece o "dono": de duas formas —

Posse direta: a aeronave (em Configurações → Aeronaves) tem como dono a própria pessoa.
Posse pela empresa: a aeronave tem como dono uma organização (ex.: a empresa de aviação), e a pessoa está vinculada a essa organização no cadastro dela. É o mesmo vínculo que já dá acesso à carteira da empresa. Assim, um piloto (pessoa física) vê as aeronaves da empresa (pessoa jurídica) como próprias, com o financeiro.

Como o financeiro só aparece para quem tem o acesso ao Portal do Aeronauta ligado, vincular alguém à empresa apenas para roteamento de repasse não expõe o repasse das aeronaves.

Como liberar o acesso: em Pessoas, edite a pessoa e ligue "Acesso ao Portal do Aeronauta". Não depende de ela ser atleta — um dono que não voa também pode ter acesso. Ao ligar, o sistema prepara o login (a pessoa entra por e‑mail/Google como nos outros portais).

O aeronauta abre o portal pela URL /aeronauta (ou pelo menu do usuário, se também tiver outros acessos).

Portal do Combustível¶

Portal dedicado, feito para o celular, para a pessoa que abastece os aviões no pátio — a função Abastecedor. Quem tem essa função acessa o Portal do Combustível e registra os litros em dois toques, sem precisar entrar no sistema da administração. Faz par com o módulo Combustível: tudo o que o abastecedor lança aparece no painel do posto e entra no fechamento do mês normalmente.

A tela "Hoje":

No topo, o card do tanque com o saldo em litros e o total utilizado no dia ("Hoje: N L") — o portal nunca mostra valores (custos ou preços), só litros. Com mais de um tanque, a tela mostra só o tanque principal; o botão "Ver todos os tanques" (lista com um tanque por linha: saldo, capacidade, % do tanque e consumo do dia) abre a lista completa.
Navegação ‹ hoje › para trocar o dia.
A lista das decolagens do dia, cada uma com o avião, a hora e o estado: ícone âmbar quando a decolagem está marcada como "precisa abastecer", check verde com os litros quando já foi abastecida.

Registrar em dois toques: toca na decolagem → abre a planilha com um campo gigante de litros (o consumo médio do avião aparece como dica) → Registrar N L. A data e hora já vêm preenchidas com o horário da decolagem menos 3 minutos (o avião é abastecido pouco antes de decolar) e podem ser ajustadas; dá para incluir o Horímetro com "Adicionar horímetro".

⛽ Qual tanque? Se a DZ tem mais de um tanque, o operador é obrigado a escolher de qual tanque saiu o combustível — não vem nada pré-selecionado, justamente para ninguém lançar no tanque errado. Com um único tanque, não há o que escolher: já vem definido.

Abastecimento avulso (sem decolagem): pelo botão flutuante, escolha o avião — ou "Sem aeronave", quando o avião não está no cadastro ou só interessa registrar os litros —, os litros e a data e hora (com minutos) em que o abastecimento aconteceu — já vem preenchida com o momento atual, mas pode ser ajustada. Nos abastecimentos por decolagem a hora é a da própria decolagem. Em qualquer abastecimento dá para adicionar uma observação (opcional). Um lançamento sem aeronave aparece como "Sem aeronave" na lista do dia; quem define quem paga é o administrador, pela ação Atribuir a pessoa/empresa no módulo Combustível.

Lançamentos do dia e correção: a seção "Lançamentos do dia" mostra todos os abastecimentos do dia — inclusive avulsos e os lançados por outros operadores ou pelo manifesto — com o nome de quem lançou cada um. A edição continua restrita aos próprios registros recentes (até 36 horas). Correções maiores — lançamentos antigos ou de outra pessoa — são feitas pela equipe no módulo Combustível.

Como liberar o acesso — dois caminhos equivalentes, que ficam sincronizados:

em Pessoas, edite a pessoa e ligue "Acesso ao Portal do Combustível" (mesmo padrão do Portal do Aeronauta — não precisa ser atleta); ou
em Equipe, atribua o perfil Abastecedor ao convidar ou editar o membro — o convite já cria o login e vincula a Pessoa automaticamente.

Quem só tem esse acesso entra direto no portal ao fazer login; quem tem mais de um portal escolhe na tela de seleção (e pode definir o padrão). A URL é /fueling/today.

Portal do Parceiro¶

Portal só de consulta para quem fornece algo à DZ e recebe repasse — a função Parceiro. Na primeira versão, o parceiro é o dono de equipamento de aluguel (rig): a pessoa ou a empresa cujos equipamentos a DZ aluga para alunos, duplos e atletas. Outros tipos de fornecedor poderão entrar no mesmo portal no futuro.

O que ele mostra:

Resumo do período: repasse de aluguel devido pela DZ, quantidade de aluguéis por tipo de salto (duplo, aluno, esporte), equipamentos ativos e alertas de manutenção.
Equipamentos: os rigs em nome da pessoa ou das empresas vinculadas, com situação de reserva (vencida / vence em X dias / aguardando aprovação) e AAD.
Aluguéis (página própria): o mesmo relatório de Aluguel de equipamentos da administração, filtrado ao que é do parceiro, em dois modos — Consolidado (dono → equipamento → totais) e Detalhado (cada aluguel: data, decolagem, atleta, tipo de salto, produto, repasse e quem confirmou a dobra). Exporta em CSV e imprime nos dois modos.
Carteira e Minhas empresas: os mesmos extratos dos outros portais.

Regra do financeiro: o parceiro sempre vê os valores — é o dinheiro dele. Mas só vê o que é dele: o relatório é limitado aos equipamentos cujo dono é a própria pessoa ou uma empresa à qual ela está vinculada.

Como o sistema reconhece o "dono": de duas formas, iguais às do Portal do Aeronauta —

Posse direta: o equipamento (em Equipamentos) tem como dono a própria pessoa.
Posse pela empresa: o equipamento tem como dono uma organização, e a pessoa está vinculada a essa organização no cadastro dela (Organizações). É o mesmo vínculo que dá acesso à carteira da empresa. Assim, um dobrador (pessoa física) que também fornece equipamentos pela sua empresa (pessoa jurídica) vê os rigs da empresa como próprios.

A atribuição é na data do salto: se um equipamento mudar de dono, o histórico anterior continua com o dono antigo, e o novo dono só vê a partir da transferência.

Vincular alguém à empresa apenas para roteamento de repasse não expõe os aluguéis: o portal só abre para quem tem o acesso ao Portal do Parceiro ligado.

Como liberar o acesso: em Pessoas, edite a pessoa e ligue "Habilitar acesso ao Portal do Parceiro". Não depende de ela ser atleta ou dobrador — um dono que não salta também pode ter acesso. Ao ligar, o sistema prepara o login (a pessoa entra por e‑mail/Google como nos outros portais). Uma pessoa que também é dobrador escolhe entre os portais no login (ou define um portal padrão).

O parceiro abre o portal pela URL /partner (ou pelo menu do usuário, se também tiver outros acessos). Se não houver nenhum equipamento em nome dele ou das empresas vinculadas, o portal mostra um aviso pedindo para falar com a DZ.

Sessões de Exibição (telas/TVs)¶

📍 Sessões de Exibição

Para mostrar o manifesto numa TV/monitor no campo (público, sem login):

Crie uma sessão de exibição — gera um código de 6 caracteres.
Abra a tela pública de display e conecte de uma das formas:
Parear (recomendado): na TV, clique em Gerar código (vale 60s); no painel, em Sessões de Exibição, clique em Parear TV, escolha a sessão (ou crie uma nova ali) e digite o código mostrado na TV. A TV conecta sozinha — sem digitar no controle.
Manual: digite o código de 6 caracteres da sessão direto na TV.
Você pode revogar, estender a validade ou gerar novo código.

Na lista, clique na linha para editar uma sessão (as configurações vêm em abas). Cada sessão indica se é um App Android TV ou um Navegador (e, no navegador, qual). Ao criar/editar uma sessão de navegador, você pode marcar "Sem expiração (permanente)" para um monitor fixo — aí ela fica ativa até ser revogada (as TVs pareadas pelo app já são permanentes).

Em Configurações avançadas da sessão você ajusta o que aparece na TV: tema, loads visíveis, loads passados, horário estimado, passageiros tandem, Exibir detalhes (rádio, aluguel, etc.) — quando ligado, cada slot mostra os mesmos ícones do manifesto (grupo e líder, rádio, equipamento de aluguel e pagamento pelo grupo) — e Exibir QR de cadastro do atleta, que mostra na TV um QR Code apontando para o auto-cadastro público (só aparece se a DZ tiver o cadastro público de atletas habilitado) — e Exibir ventos em altitude. Desligue o que não quiser para uma visão mais limpa.

Ao criar uma nova sessão, esses campos já vêm preenchidos com a configuração da sua sessão mais recente — assim novas TVs herdam os mesmos ajustes sem você reconfigurar tudo de novo; é só mudar o que precisar.

Ventos e clima na tela¶

Se o Local da sessão tiver latitude e longitude preenchidas (em Locais, ao criar/editar um local), o painel mostra automaticamente:

na barra superior: condições atuais — temperatura, vento (direção + velocidade, com rajada quando relevante), pressão (QNH) e nascer/pôr do sol;
no painel lateral (ao lado do QR): os ventos em altitude, camada por camada de 0 a 15000 ft (direção em graus + seta, velocidade em kt e km/h, e temperatura em °C).

Os dados vêm do Open-Meteo e atualizam a cada ~10 min. Sem coordenadas no local, esses blocos simplesmente não aparecem. O widget de ventos também respeita o toggle Exibir ventos em altitude da sessão.

App dedicado para TV box (opcional)¶

Qualquer navegador moderno abre a tela de display — basta apontar para o endereço do painel. Para um aparelho Android TV / TV box ligado o dia todo no campo, existe também o app Airo TV: um app simples que abre o painel em tela cheia e cuida sozinho de religar após queda de energia, reconectar quando a internet volta e manter a tela sempre ligada.

O pareamento é o mesmo descrito acima: a TV mostra o código (Gerar código) e você pareia no painel em Sessões de Exibição → Parear TV.
Fica pareada para sempre. Diferente do navegador (onde o código de exibição vence e a TV pede um novo código de tempos em tempos), uma TV pareada pelo app continua logada indefinidamente — liga, religa após queda de energia e segue mostrando o painel, sem ninguém precisar parear de novo. Na lista de Sessões de Exibição, essas sessões aparecem com a marca TV pareada (em vez de uma data de validade).
Para desconectar a TV, faça uma das duas:
no painel, em Sessões de Exibição, use Revogar na sessão da TV; ou
na própria TV, abra a tela de manutenção do app com a sequência no controle — Cima, Cima, Baixo, Baixo, Esquerda, Direita — e toque em Limpar sessão. Nos dois casos a TV volta a pedir o pareamento. Essa mesma tela de manutenção também permite recarregar ou trocar o endereço do painel.
Atualização automática do app. Quando a TV liga (em geral antes da operação começar), o app verifica se há uma versão nova e se atualiza sozinho — sem reinstalar nada. No painel, em Sessões de Exibição, ao editar uma TV pareada (aba Atualização) você pode desligar a atualização automática e fixar uma versão, e há o botão "Atualizar app agora" para forçar na hora. A lista mostra a versão que cada TV está rodando.

O app é instalado manualmente no aparelho (sideload). Fale com o suporte da Airo para receber o arquivo e as instruções de instalação.

✅ Pronto quando¶

[ ] Bookeo configurado e produtos mapeados (se você usa reservas online).
[ ] Portal do atleta ligado e atletas convidados (se aplicável).
[ ] Portal do dobrador ligado e gatilho definido (se aplicável).
[ ] Donos de equipamento de aluguel com acesso ao Portal do Parceiro (se aplicável).

🎉 Onboarding completo! Sua DZ está pronta para operar. Siga para o Guia de Uso para o dia a dia.