════════════════════════════════════════════════════════════════════════════════
  GUIA DE CONFIGURAÇÃO - SISTEMA DE CONSULTA DE VOOS E MILHAS
════════════════════════════════════════════════════════════════════════════════

📋 PASSO A PASSO PARA CONFIGURAR O SISTEMA

1. OBTER CREDENCIAIS AMADEUS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

   a) Acesse: https://developers.amadeus.com/
   b) Crie uma conta gratuita
   c) Crie um novo App no dashboard
   d) Copie as credenciais:
      - API Key
      - API Secret

   e) Escolha o ambiente:
      - Test (gratuito, dados de teste)
      - Production (pago, dados reais)

2. OBTER CREDENCIAIS LATAM PASS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

   a) Acesse o portal de desenvolvedores LATAM Pass
   b) Registre sua aplicação
   c) Copie as credenciais:
      - Client ID
      - Client Secret

   d) Configure os scopes necessários:
      - member-balance (saldo de milhas)
      - member-tier (categoria)
      - member-status (status da conta)
      - member-name (nome do membro)

3. CONFIGURAR O ARQUIVO scrape_check.php
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

   Localize a seção de configuração (linhas 16-30):

   // ===== AMADEUS =====
   $AMADEUS_ENV        = 'test'; // ou 'production'
   $AMADEUS_API_KEY    = 'COLE_SUA_API_KEY_AQUI';
   $AMADEUS_API_SECRET = 'COLE_SEU_API_SECRET_AQUI';

   // ===== LATAM PASS (SANDBOX) =====
   $LATAM_BASE         = 'https://api.latampass.com/sandbox'; // ou production
   $LATAM_CLIENT_ID     = 'COLE_SEU_CLIENT_ID_AQUI';
   $LATAM_CLIENT_SECRET = 'COLE_SEU_CLIENT_SECRET_AQUI';

4. TESTAR A INSTALAÇÃO
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

   a) Inicie seu servidor web (XAMPP, WAMP, etc.)
   b) Acesse: http://localhost/Teste_Consulta_Voo/scrape_check.php
   c) Faça uma busca de teste:
      - Origem: GRU (São Paulo/Guarulhos)
      - Destino: GIG (Rio de Janeiro/Galeão)
      - Data: Data futura (ex: próximo mês)
      - Adultos: 1
      - Máx. resultados: 10
   d) Clique em "Buscar"

5. SOLUÇÃO DE PROBLEMAS COMUNS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

   ❌ Erro: "invalid_client"
   ✅ Solução: Verifique se API Key/Secret estão corretos e se o ambiente
      (test/production) está configurado corretamente

   ❌ Erro: "401 Unauthorized"
   ✅ Solução: Suas credenciais podem estar expiradas ou inválidas

   ❌ Erro: "LATAM retornou HTML (provável WAF)"
   ✅ Solução: O WAF da LATAM pode estar bloqueando. Verifique os headers
      e certifique-se de estar usando o sandbox corretamente

   ❌ Erro: "INVALID_SCOPE"
   ✅ Solução: Os scopes solicitados não estão configurados no seu App LATAM.
      Ajuste no portal de desenvolvedores

   ❌ Erro: "cURL error"
   ✅ Solução: Verifique se a extensão cURL está habilitada no PHP:
      - Abra php.ini
      - Procure por: ;extension=curl
      - Remova o ";" para descomentar
      - Reinicie o servidor

6. EXEMPLO DE CONSULTA COM LATAM PASS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

   Para ver seu saldo de milhas, preencha na seção "LATAM Member (opcional)":

   Opção 1 - Por FFN (LATAM Pass Number):
   ┌────────────────────────────────┐
   │ FFN: 68245775886               │
   │ (Deixe documento em branco)    │
   └────────────────────────────────┘

   Opção 2 - Por CPF:
   ┌────────────────────────────────┐
   │ Documento: 12345678900         │
   │ Tipo: CPF                      │
   │ País: BR                       │
   └────────────────────────────────┘

   Scopes recomendados:
   member-balance,member-tier,member-status,member-name

7. RECURSOS DO SISTEMA
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

   ✓ Consulta de voos em tempo real
   ✓ 16 aeroportos brasileiros pré-configurados
   ✓ Cálculo automático de milhas estimadas
   ✓ Comparação R$ vs Milhas
   ✓ Informações detalhadas (escalas, duração, classe)
   ✓ Links diretos para companhias aéreas
   ✓ Botão de resgate LATAM Pass
   ✓ Verificação de saldo suficiente
   ✓ Interface moderna e responsiva
   ✓ Debug completo para diagnóstico

8. AEROPORTOS DISPONÍVEIS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

   GRU - São Paulo/Guarulhos          CGH - São Paulo/Congonhas
   VCP - Campinas/Viracopos           GIG - Rio de Janeiro/Galeão
   SDU - Rio de Janeiro/Santos Dumont CNF - Belo Horizonte/Confins
   PLU - Belo Horizonte/Pampulha      BSB - Brasília
   SSA - Salvador                     REC - Recife
   FOR - Fortaleza                    CWB - Curitiba
   POA - Porto Alegre                 FLN - Florianópolis
   MAO - Manaus                       BEL - Belém

9. COMPANHIAS AÉREAS COM LINKS DIRETOS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

   🇧🇷 Brasileiras:
   - LATAM (LA, JJ)
   - GOL (G3)
   - Azul (AD)

   🌎 Internacionais:
   - TAP Portugal (TP)
   - Iberia (IB)
   - American Airlines (AA)
   - Delta (DL)
   - United (UA)
   - Air France (AF)
   - KLM (KL)
   - Lufthansa (LH)
   - British Airways (BA)

10. SEGURANÇA E BOAS PRÁTICAS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

   ⚠️  NUNCA compartilhe suas credenciais API
   ⚠️  Use ambiente de teste durante desenvolvimento
   ⚠️  Rotacione suas chaves periodicamente
   ⚠️  Monitore o uso de requisições
   ⚠️  Em produção, use variáveis de ambiente
   ⚠️  Implemente rate limiting se necessário
   ⚠️  Faça backup das configurações

11. INFORMAÇÕES ADICIONAIS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

   📚 Documentação Amadeus API:
      https://developers.amadeus.com/self-service/category/flights

   📚 Documentação LATAM Pass:
      Consulte o portal de desenvolvedores LATAM

   💡 Dicas:
   - Use o ambiente de teste para desenvolvimento
   - Verifique os limites de requisições
   - As milhas são estimativas baseadas em distância
   - Valores exatos devem ser consultados no site oficial

════════════════════════════════════════════════════════════════════════════════
  Desenvolvido para consulta inteligente de voos e comparação de preços
════════════════════════════════════════════════════════════════════════════════