Pular para o conteúdo principal

integracoes-jobs-cli

Cenários de teste e debug - Integrações, Jobs/Polling e Scripts CLI​

1. Integrações externas​

Principais módulos:

  • Movingpay: config/movingpay_tokens.php, config/graficos/dashboard/buscar_transacoes_movingpay*.php
  • Entrepay: config/entrepay/api_entrepay.php, config/entrepay/*.php, config/entrepay/polling_*.php
  • Autentique: config/autentique/*.php, config/autentique/webhook.php

Checklist geral de integrações​

  • Chamada de API com parâmetros válidos (sucesso).
  • Erro de validação retornado pela API externa.
  • Timeout / indisponibilidade do serviço.
  • Respostas inesperadas (campos faltando, status desconhecido).
  • Manuseio de tokens expirados/ inválidos (quando aplicável).
  • Tratamento de webhooks (payload válido, inválido e duplicado).

Pontos de log sugeridos​

  • Módulo: MOVINGPAY / ENTREPAY / AUTENTIQUE
    • CHAMADA_API / CHAMADA_GATEWAY
    • RETORNO_API / RETORNO_GATEWAY
    • AUTENTICACAO_SUCESSO / AUTENTICACAO_ERRO
    • WEBHOOK_RECEBIDO, WEBHOOK_ASSINATURA_INVALIDA, WEBHOOK_DUPLICADO
    • Contexto: IDs internos, status HTTP, códigos de erro.
    • Nunca enviar tokens ou dados sensíveis no contexto.

2. Jobs, Polling e “Crons”​

Arquivos principais:

  • Transações: config/transacoes/polling_transacoes.php, config/transacoes/polling_sync_meia_noite.php, config/transacoes/instalar_polling.php, config/transacoes/teste_cron_sync.php
  • Entrepay: config/entrepay/polling_credenciamentos.php, config/entrepay/polling_continuo.php

Checklist geral​

  • Execução manual do script de polling (via CLI/navegador) sem erros.
  • Processamento de itens quando existem registros pendentes.
  • Execução quando não há nada para processar.
  • Simulação de erros durante o processamento (exceções).
  • Verificação de logs gerados.

Logs sugeridos​

  • Módulo: TRANSACOES / ENTREPAY
    • POLLING_INICIO (INFO) com ['dataRef' => ..., 'tipo' => ...]
    • POLLING_ITEM_PROCESSADO (DEBUG) com ['id' => $id, 'statusAnterior' => ..., 'statusNovo' => ...]
    • POLLING_FIM (INFO) com ['quantidadeProcessada' => $qtd, 'tempoMs' => $tempo]
    • POLLING_ERRO (ERROR) com mensagem da exceção.

3. Scripts de instalação e manutenção (CLI-like)​

Arquivos principais:

  • config/instalar_sistema_completo.php
  • config/instalar_sistema_taxas.php
  • config/instalar_sistema_taxas_simples.php
  • config/instalar_taxas_padrao.php
  • config/corrigir_instalacao.php
  • config/test_update_integrity.php

Checklist geral​

  • Execução em ambiente de desenvolvimento “limpo”.
  • Reexecução sem quebrar o ambiente (idempotência onde fizer sentido).
  • Tratamento de falhas parciais (ex.: migration aplicada pela metade).

Logs sugeridos​

  • Módulo: INSTALACAO
    • INICIO (INFO) com ['script' => __FILE__]
    • ETAPA_EXECUTADA (DEBUG) com ['etapa' => 'criar_tabelas', 'status' => 'ok']
    • ERRO (ERROR) com detalhes da exceção / erro SQL.

4. Frontend / Dashboard (visão geral)​

Para todos os módulos expostos no dashboard:

  • Telas principais:
    • dashboard/dashboard.php
    • dashboard/gestao/*.php
    • dashboard/financeiro/*.php
    • dashboard/propostas/*.php

Checklist geral de UI​

  • Carregamento do dashboard sem erros JS.
  • Carregamento de gráficos com dados corretos.
  • Mensagens corretas em caso de erro (tanto backend quanto frontend).

Debug frontend sugerido​

  • Usar console.log/console.error nos pontos de:
    • Envio de requisições AJAX/fetch.
    • Tratamento de respostas de sucesso/erro.
    • Mudança de estado de loading.