# Expedição Glider Brasil — Manual Completo (llms-full.txt)

> Índice expandido para leitura por IA. Versão compacta disponível em llms.txt.
> Gerado: 2026-03-18

## Metadados

- **App**: Expedição Glider Brasil
- **Evento**: Expedição de parapente a Iquique, Chile — maio de 2026
- **Plataformas**: Android 6+ e iOS 13+
- **Backend**: Firebase (Firestore, Auth, Storage, Cloud Functions)
- **Arquitetura**: Flutter offline-first + Sembast local DB + sync queue
- **Documentação**: https://manualexp.hawk.com.br
- **Desenvolvedor**: Hawk Informática

## Estrutura da Documentação

| Página | URL | Tipo | Descrição |
|--------|-----|------|-----------|
| Início | https://manualexp.hawk.com.br/ | Home | Portal principal com cards de navegação e acesso rápido às 19 telas |
| Guia Rápido | https://manualexp.hawk.com.br/guia-rapido.html | Onboarding | 12 passos para começar a usar o app do zero |
| Manual Completo | https://manualexp.hawk.com.br/manual.html | Referência | Documentação única de todas as funcionalidades |
| FAQ | https://manualexp.hawk.com.br/faq.html | Suporte | 8 categorias, 20+ perguntas e respostas frequentes |
| Guia por Tela | https://manualexp.hawk.com.br/telas/ | Índice | Grid das 19 telas com links para documentação dedicada |

## Mapeamento de Rotas do App → Documentação

| Rota do App | Nome da Tela | URL da Documentação |
|-------------|--------------|---------------------|
| /home | Home | https://manualexp.hawk.com.br/telas/home.html |
| /news | Notícias | https://manualexp.hawk.com.br/telas/noticias.html |
| /news/editor | Editor de Notícia (admin) | https://manualexp.hawk.com.br/telas/noticias.html#criar |
| /gallery | Galeria | https://manualexp.hawk.com.br/telas/galeria.html |
| /agenda | Agenda | https://manualexp.hawk.com.br/telas/agenda.html |
| /more | Menu Mais | https://manualexp.hawk.com.br/telas/mais.html |
| /pilots | Pilotos | https://manualexp.hawk.com.br/telas/pilotos.html |
| /pilots/{id} | Perfil do Piloto | https://manualexp.hawk.com.br/telas/pilotos.html#perfil |
| /checklist | Checklist | https://manualexp.hawk.com.br/telas/checklist.html |
| /flights | Voos | https://manualexp.hawk.com.br/telas/voos.html |
| /flights/analytics | Analytics de Voo | https://manualexp.hawk.com.br/telas/voos.html#analytics |
| /flights/conditions | Condições de Voo | https://manualexp.hawk.com.br/telas/voos.html#condicoes |
| /polls | Enquetes | https://manualexp.hawk.com.br/telas/enquetes.html |
| /polls/{id} | Detalhes da Enquete | https://manualexp.hawk.com.br/telas/enquetes.html#detalhes |
| /polls/editor | Criar Enquete (admin) | https://manualexp.hawk.com.br/telas/enquetes.html#criar |
| /documents | Documentos | https://manualexp.hawk.com.br/telas/documentos.html |
| /contacts | Contatos | https://manualexp.hawk.com.br/telas/contatos.html |
| /notifications | Notificações | https://manualexp.hawk.com.br/telas/notificacoes.html |
| /sync-center | Centro de Sincronização | https://manualexp.hawk.com.br/telas/sincronizacao.html |
| /settings | Configurações | https://manualexp.hawk.com.br/telas/configuracoes.html |
| /admin | Painel Admin | https://manualexp.hawk.com.br/telas/admin.html |
| /admin/import-whatsapp | Importar WhatsApp (admin) | https://manualexp.hawk.com.br/telas/importar-whatsapp.html |
| /search | Busca | https://manualexp.hawk.com.br/telas/busca.html |
| /about | Sobre | https://manualexp.hawk.com.br/telas/sobre.html |
| /login | Login | https://manualexp.hawk.com.br/telas/login.html |
| /register | Cadastro | https://manualexp.hawk.com.br/telas/login.html#cadastro |
| /forgot-password | Recuperar Senha | https://manualexp.hawk.com.br/telas/login.html#senha |
| /verify-email | Verificar E-mail | https://manualexp.hawk.com.br/telas/login.html#verificar |
| /pending-approval | Aguardando Aprovação | https://manualexp.hawk.com.br/telas/login.html#aprovacao |

## Telas — Documentação Detalhada

### Home (/home)
**URL**: https://manualexp.hawk.com.br/telas/home.html
**Aliases**: tela inicial, dashboard, página principal, início
**Palavras-chave**: contagem regressiva, partida, Iquique, 1 de maio, feed, notícias recentes, acesso rápido
**Descrição**: Tela principal exibida após login bem-sucedido. Apresenta um contador regressivo para 1º de maio de 2026, destaques das últimas notícias publicadas pela organização, cards de acesso rápido para checklist, pilotos e voos, e resumo do status offline/sync.
**Ações disponíveis**: navegar para qualquer seção via cards, ver contador regressivo, ler resumo de notícias recentes.

### Notícias (/news)
**URL**: https://manualexp.hawk.com.br/telas/noticias.html
**Aliases**: feed de notícias, comunicados, posts, publicações, novidades
**Palavras-chave**: notícia, publicação, foto, galeria, importar WhatsApp, criar notícia, editor, admin, comunicado
**Descrição**: Feed cronológico com todos os comunicados e publicações da organização da expedição. Suporta texto e imagens. Administradores podem criar, editar e excluir notícias. Suporta importação de mensagens do WhatsApp como notícias.
**Seções especiais**: #criar — documentação do editor de notícias (apenas admin).
**Ações**: ler notícias, abrir fotos em tela cheia, filtrar por tipo. Admin: criar, editar, excluir notícias, importar do WhatsApp.

### Editor de Notícia (/news/editor) — Admin
**URL**: https://manualexp.hawk.com.br/telas/noticias.html#criar
**Aliases**: criar notícia, publicar notícia, escrever notícia, novo post
**Palavras-chave**: título, texto, foto, imagem, publicar, salvar rascunho, editar, excluir
**Descrição**: Disponível apenas para administradores. Permite criar notícias com título, texto rico e múltiplas fotos. Suporta criação offline — a notícia fica em fila e é publicada quando a internet voltar.

### Galeria (/gallery)
**URL**: https://manualexp.hawk.com.br/telas/galeria.html
**Aliases**: fotos, álbum, imagens, fotos da expedição, galeria de fotos
**Palavras-chave**: foto, imagem, voo, paisagem, Iquique, álbum, download, compartilhar
**Descrição**: Repositório visual da expedição com fotos organizadas por data ou álbum. Visualização em tela cheia com gesto de zoom. Apenas administradores publicam fotos na galeria oficial; participantes podem sugerir fotos via WhatsApp para que o admin publique.

### Agenda (/agenda)
**URL**: https://manualexp.hawk.com.br/telas/agenda.html
**Aliases**: programação, cronograma, calendário, schedule, eventos, roteiro
**Palavras-chave**: evento, data, horário, atividade, voo, passeio, chegada, partida, hotel, transfer
**Descrição**: Cronograma completo da expedição dia a dia. Exibe chegada em Iquique, dias de voo, passeios, atividades especiais e partida. Cada evento tem detalhes como horário, local e descrição. Disponível offline após primeiro carregamento.

### Pilotos (/pilots)
**URL**: https://manualexp.hawk.com.br/telas/pilotos.html
**Aliases**: lista de pilotos, participantes, equipe, perfil de piloto, ficha do piloto
**Palavras-chave**: piloto, participante, perfil, foto, equipamento, experiência, voos, contato, emergência
**Descrição**: Diretório de todos os pilotos confirmados na expedição. Cada piloto tem perfil completo: foto, nome, nível de experiência (horas de voo, certificações), equipamento (asa, vela, rádio), e contatos de emergência. Cada piloto só pode editar seu próprio perfil.
**Seções especiais**: #perfil — documentação da ficha individual do piloto com todos os campos.

### Checklist (/checklist)
**URL**: https://manualexp.hawk.com.br/telas/checklist.html
**Aliases**: lista de verificação, preparação, itens obrigatórios, to-do, tarefas
**Palavras-chave**: documento, passaporte, seguro, vacina, equipamento, asa, rádio, GPS, mochila, emergência, visto Chile
**Descrição**: Lista de verificação completa de preparação para a expedição. Organizada em categorias: Documentação, Equipamentos de Voo, Saúde e Segurança, Logística e Comunicação. Cada piloto marca seus itens individualmente. Progresso sincronizado entre dispositivos. Disponível offline.
**Ações**: marcar/desmarcar itens, ver progresso por categoria, ver progresso geral.

### Voos (/flights)
**URL**: https://manualexp.hawk.com.br/telas/voos.html
**Aliases**: log de voos, registros de voo, estatísticas, replay, mapa de voo
**Palavras-chave**: voo, trajeto, mapa, altitude, distância, tempo, replay, condições, vento, temperatura
**Descrição**: Central de voos da expedição. Lista todos os voos registrados com data, piloto, duração e distância. Permite visualizar o trajeto de cada voo no mapa (replay). Inclui análise estatística individual por piloto.
**Seções especiais**:
- #analytics — estatísticas de voo (altitude máxima, distância percorrida, tempo total de voo por piloto)
- #condicoes — condições meteorológicas de Iquique em tempo real (vento, temperatura, umidade, visibilidade). Atualizado a cada 30 minutos.

### Enquetes (/polls)
**URL**: https://manualexp.hawk.com.br/telas/enquetes.html
**Aliases**: votações, polls, votar, decisão do grupo, enquete
**Palavras-chave**: votar, opção, resultado, criar enquete, prazo, único voto, anônimo
**Descrição**: Sistema de votação para decisões coletivas do grupo. Administradores criam enquetes com múltiplas opções e prazo de votação. Cada participante vota uma vez. Resultados visíveis em tempo real.
**Seções especiais**:
- #detalhes — como votar e visualizar resultados de uma enquete específica
- #criar — documentação de como administradores criam novas enquetes (campos, opções, prazo)

### Documentos (/documents)
**URL**: https://manualexp.hawk.com.br/telas/documentos.html
**Aliases**: arquivos, PDFs, regulamentos, formulários, guias, documentação oficial
**Palavras-chave**: PDF, regulamento, seguro, autorização, formulário, CIVL, FAI, ABVL, guia, hotel, transfer
**Descrição**: Repositório de documentos oficiais da expedição. Inclui regulamentos de voo de Iquique, formulários de seguro, autorizações, guias de hospedagem e transporte. Documentos em PDF visualizáveis e baixáveis. Disponível offline após download inicial.

### Contatos (/contacts)
**URL**: https://manualexp.hawk.com.br/telas/contatos.html
**Aliases**: telefones, contatos de emergência, contatos úteis, números importantes
**Palavras-chave**: emergência, hospital, polícia, aeródromo, hotel, organização, WhatsApp, ligação, Chile, Iquique
**Descrição**: Central de contatos úteis para a expedição. Inclui: contatos de emergência local (bombeiros, polícia, SAMU Iquique), aeródromo de Iquique, hotel da expedição, organização brasileira, contatos médicos. Disponível offline.

### Notificações (/notifications)
**URL**: https://manualexp.hawk.com.br/telas/notificacoes.html
**Aliases**: alertas, avisos, push notifications, histórico de notificações
**Palavras-chave**: notificação, alerta, aviso, push, aprovação, notícia, enquete, atualização
**Descrição**: Central de notificações e alertas enviados pela organização. Exibe histórico completo de notificações recebidas. Tipos: aprovação de conta, nova notícia, nova enquete, alertas de segurança, atualizações da expedição. Configurável em Configurações → Notificações.

### Centro de Sincronização (/sync-center)
**URL**: https://manualexp.hawk.com.br/telas/sincronizacao.html
**Aliases**: sync, sincronização offline, fila de sync, centro de sincronização, offline mode
**Palavras-chave**: offline, sincronização, fila, pendente, conflito, Sembast, Firebase, reconectar, forçar sync
**Descrição**: Painel de monitoramento do estado offline do app. Exibe: itens pendentes de sincronização, itens com erro, status da conexão, e botão para forçar sincronização manual. Quando o app fica offline, todas as ações ficam em fila local (Sembast) e são enviadas ao Firebase automaticamente ao reconectar.
**Ações**: ver fila de pendentes, ver erros, forçar sincronização, resolver conflitos.

### Configurações (/settings)
**URL**: https://manualexp.hawk.com.br/telas/configuracoes.html
**Aliases**: settings, preferências, conta, perfil, notificações, aparência
**Palavras-chave**: conta, logout, sair, senha, foto de perfil, notificações, tema, idioma, armazenamento, limpar cache
**Descrição**: Central de configurações do app. Inclui: gerenciamento de conta (foto, senha, logout), preferências de notificações por categoria, configurações de armazenamento (limpar cache), informações sobre o app e versão.

### Painel Admin (/admin)
**URL**: https://manualexp.hawk.com.br/telas/admin.html
**Aliases**: administração, painel administrativo, dashboard admin, gerenciar usuários
**Palavras-chave**: aprovar usuário, rejeitar, bloquear, reset, coleções, Firestore, conflitos, admin, superadmin
**Descrição**: Painel exclusivo para administradores e superadmin. Funcionalidades: aprovar/rejeitar/bloquear contas, gerenciar coleções Firestore, resolver conflitos de dados, acompanhar progresso dos pilotos no checklist, executar reset beta (apenas superadmin).
**Permissões**: Admin pode aprovar usuários e gerenciar conteúdo. Superadmin tem acesso total incluindo reset de dados.

### Importar WhatsApp (/admin/import-whatsapp)
**URL**: https://manualexp.hawk.com.br/telas/importar-whatsapp.html
**Aliases**: importação WhatsApp, importar mensagens, histórico WhatsApp, converter chat
**Palavras-chave**: WhatsApp, exportar conversa, arquivo .txt, importar, notícia, mídia, foto, modo simples, modo diário
**Descrição**: Ferramenta exclusiva para administradores. Converte histórico exportado do WhatsApp em notícias no app. Fluxo: exportar chat do WhatsApp como .txt → fazer upload no app → selecionar admin da expedição → escolher modo de importação (simples ou diário) → visualizar prévia → confirmar importação. Fotos e mídia podem ser incluídas ou ignoradas.
**Modos de importação**:
- Simples: cada mensagem vira uma notícia
- Diário: mensagens do mesmo dia são agrupadas em uma única notícia
**Importante**: apenas mensagens com conteúdo (texto e/ou foto) são importadas. Mensagens de sistema e stickers são ignorados.

### Menu Mais (/more)
**URL**: https://manualexp.hawk.com.br/telas/mais.html
**Aliases**: menu mais, tela mais, mais opções, drawer, navegação lateral
**Palavras-chave**: mais, menu, busca, documentos, contatos, notificações, sync, configurações, sobre, admin
**Descrição**: Hub de navegação para seções secundárias do app. Agrupa: Busca global, Documentos, Contatos, Notificações, Centro de Sincronização, Configurações, Sobre o app, e Painel Admin (visível apenas para admins). É a porta de entrada para funcionalidades menos frequentes.

### Busca (/search)
**URL**: https://manualexp.hawk.com.br/telas/busca.html
**Aliases**: pesquisa, busca global, procurar, encontrar
**Palavras-chave**: buscar, pesquisar, notícia, piloto, documento, agenda, checklist, encontrar, palavra-chave
**Descrição**: Motor de busca global do app. Pesquisa em tempo real em todas as seções: notícias, pilotos, agenda, checklist, documentos e contatos. Funciona offline usando o índice local do Sembast. Resultados agrupados por categoria com navegação direta.

### Sobre (/about)
**URL**: https://manualexp.hawk.com.br/telas/sobre.html
**Aliases**: sobre o app, versão, créditos, informações, about
**Palavras-chave**: versão, build, Flutter, Firebase, Hawk Informática, expedição, Iquique 2026, créditos
**Descrição**: Informações sobre o aplicativo: versão atual, stack tecnológico, créditos da equipe de desenvolvimento (Hawk Informática), e informações sobre a expedição Glider Brasil Iquique 2026.

### Login e Cadastro (/login, /register)
**URL**: https://manualexp.hawk.com.br/telas/login.html
**Aliases**: entrar, fazer login, criar conta, cadastrar, registrar, acessar
**Palavras-chave**: e-mail, senha, Google, login, cadastro, criar conta, verificação, aprovação, aguardando
**Descrição**: Tela de autenticação do app. Suporta login com e-mail/senha e com conta Google. Para novos usuários: cadastro → verificação de e-mail (apenas e-mail/senha) → aguardando aprovação admin → acesso liberado.
**Seções especiais**:
- #cadastro — como criar uma nova conta passo a passo
- #aprovacao — fluxo de aprovação pelo administrador
- #senha — recuperação de senha esquecida
- #verificar — processo de verificação de e-mail

## Autenticação e Fluxo de Acesso

O app usa um fluxo de aprovação em 4 estados:
1. **pendingEmailVerification** — aguardando verificação do e-mail (apenas e-mail/senha)
2. **pendingAdminApproval** — aguardando aprovação do administrador
3. **approved** — acesso completo liberado
4. **rejected** / **blocked** — acesso negado

Login com Google pula a etapa 1 e vai direto para 2.
O e-mail hawkinf@gmail.com é sempre forçado para superadmin + aprovado.

## Arquitetura Técnica

- **Frontend**: Flutter (Dart), Riverpod (state management), GoRouter (routing)
- **Backend**: Firebase (Auth, Firestore, Storage, Cloud Functions TypeScript)
- **Local DB**: Sembast (offline-first storage)
- **Sincronização**: Fila local + sync automático ao reconectar + resolução de conflitos
- **Notificações**: Firebase Cloud Messaging (FCM)
- **Importação WhatsApp**: Cloud Function TypeScript processa .txt e importa mensagens

## Artefatos AI-Readable

| Arquivo | URL | Descrição |
|---------|-----|-----------|
| llms.txt | https://manualexp.hawk.com.br/llms.txt | Resumo compacto para IA |
| llms-full.txt | https://manualexp.hawk.com.br/llms-full.txt | Este arquivo — índice expandido |
| screen-help-map.json | https://manualexp.hawk.com.br/screen-help-map.json | Mapeamento rota → URL doc |
| docs-index.json | https://manualexp.hawk.com.br/docs-index.json | Índice completo da documentação |
| sitemap.xml | https://manualexp.hawk.com.br/sitemap.xml | Sitemap para crawlers |