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.

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

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