╔═══════════════════════════════════════════════════════════════╗
║                                                               ║
║     ✅ CHECKLIST DE INSTALAÇÃO - SISTEMA PIX POLIMIX         ║
║                                                               ║
╚═══════════════════════════════════════════════════════════════╝


📋 PASSO A PASSO RÁPIDO
═══════════════════════════════════════════════════════════════

□ 1. VERIFICAR PHP
    │
    ├─ Abrir PowerShell
    ├─ Executar: php -v
    │
    └─ [ ] PHP instalado e funcionando
       [ ] Precisa instalar (abrir: COMECE-AQUI.html)


□ 2. INSTALAR DEPENDÊNCIAS (Recomendado)
    │
    ├─ Opção A: Clicar 2x em "instalar-dependencias.bat"
    ├─ Opção B: Executar "php instalar-dependencias.php"
    │
    └─ [ ] Instalação concluída com sucesso
       [ ] Pulei (vai usar modo standalone)


□ 3. TESTAR O SISTEMA
    │
    ├─ Clicar 2x em: INICIAR-SERVIDOR.bat
    ├─ Ou executar: php -S localhost:8000
    │
    └─ [ ] Servidor iniciado (mostra mensagem)


□ 4. VALIDAR FUNCIONAMENTO
    │
    ├─ Abrir navegador
    ├─ Acessar: http://localhost:8000/debug-pix.php
    │
    └─ [ ] Página de debug abriu
       [ ] Mostra "Modo: PROFESSIONAL" ou "STANDALONE"
       [ ] 3 testes executaram com sucesso ✅
       [ ] QR Codes aparecem


□ 5. TESTAR GERAÇÃO DE COBRANÇA
    │
    ├─ Acessar: http://localhost:8000/gerar-cobranca.php
    ├─ Preencher formulário de teste
    ├─ Clicar "Gerar Link"
    │
    └─ [ ] Link foi gerado
       [ ] Consegui copiar o link
       [ ] Link abre em nova aba


□ 6. TESTAR PÁGINA DE PAGAMENTO
    │
    ├─ Colar o link gerado no navegador
    ├─ Adicionar "&debug=1" no final da URL
    │
    └─ [ ] Página de pagamento abriu
       [ ] QR Code aparece
       [ ] Código PIX aparece
       [ ] Botão copiar funciona
       [ ] Seção debug mostra logs (se adicionou &debug=1)


□ 7. TESTE REAL (OPCIONAL)
    │
    ├─ Usar chave PIX real
    ├─ Gerar cobrança com valor pequeno (R$ 1,00)
    ├─ Escanear QR Code no app do banco
    │
    └─ [ ] App bancário reconheceu
       [ ] Dados aparecem corretamente
       [ ] Pagamento funcionou


═══════════════════════════════════════════════════════════════

📊 VERIFICAÇÃO DE MODO

Qual modo está ativo?

[ ] PROFESSIONAL
    ✅ Melhor performance
    ✅ Bibliotecas profissionais
    ✅ QR Code local
    ✅ 100% compatibilidade
    
[ ] STANDALONE
    ✅ Funciona imediatamente
    ✅ Sem instalação
    ⚠️  QR Code via API (precisa internet)
    💡 Considere instalar dependências


═══════════════════════════════════════════════════════════════

🐛 TROUBLESHOOTING

Se algo não funcionar:

□ "php não reconhecido"
  └─ Solução: Abrir COMO-INSTALAR.html

□ "Erro ao instalar dependências"
  └─ Solução: Sistema funciona em modo standalone

□ "Página não carrega"
  └─ Solução: Verificar se servidor está rodando

□ "QR Code não aparece"
  └─ Solução: Adicionar &debug=1 na URL e ver logs

□ "Código PIX com erro"
  └─ Solução: Acessar debug-pix.php para validar

□ Outros problemas
  └─ Solução: Abrir SOLUCAO-ERRO-PIX.md


═══════════════════════════════════════════════════════════════

📚 DOCUMENTAÇÃO

Caso precise de ajuda:

📖 COMECE-AQUI.html         ← Guia visual de início
📘 README.md                ← Documentação principal
📕 README-AVANCADO.md       ← Doc técnica completa
🔧 COMO-INSTALAR.html       ← Como instalar PHP
🐛 SOLUCAO-ERRO-PIX.md      ← Troubleshooting
📊 RESUMO-IMPLEMENTACAO.md  ← Detalhes do sistema


═══════════════════════════════════════════════════════════════

✅ CHECKLIST FINAL

Sistema está pronto quando:

[ ] PHP instalado e funcionando
[ ] Servidor iniciando sem erros
[ ] debug-pix.php mostra testes OK
[ ] gerar-cobranca.php abre normalmente
[ ] Consegue gerar um link
[ ] Link abre página de pagamento
[ ] QR Code é exibido
[ ] Código PIX aparece completo
[ ] Botão copiar funciona

Se TODOS os itens acima estão ✅ = SISTEMA PRONTO! 🎉


═══════════════════════════════════════════════════════════════

💡 DICAS IMPORTANTES

✅ FAÇA:
  • Teste primeiro com debug (&debug=1)
  • Use valores pequenos em testes reais (R$ 1,00)
  • Configure chave PIX real da empresa
  • Mantenha backup da pasta vendor/ após instalar
  • Use modo PROFESSIONAL em produção

❌ NÃO FAÇA:
  • Não teste com valores altos antes de validar
  • Não modifique bootstrap.php sem necessidade
  • Não exponha arquivos de debug em produção
  • Não use chaves PIX de teste em produção


═══════════════════════════════════════════════════════════════

🚀 PRÓXIMOS PASSOS

Após validar que tudo funciona:

1. Configurar chave PIX real da Polimix
2. Personalizar nome/cidade se necessário
3. Testar com um pagamento real pequeno
4. Treinar equipe para usar
5. Começar a gerar cobranças!


═══════════════════════════════════════════════════════════════

Desenvolvido para Polimix Concreto Usinado
Sistema PIX Avançado - Versão Híbrida Professional

═══════════════════════════════════════════════════════════════