BK-263 - Observabilidade fina do checkout por pedido

Objetivo

• registrar milestones do checkout por pedido_id
• descobrir com precisão onde o fluxo parou
• mostrar essa trilha diretamente no admin

Escopo da rodada

• action.php
• checkout_pix.php
• js/checkout_pix.js
• admin/modulos/pedidos_2/detalhe.php

Eventos alvo

• checkout_open
• method_click
• submit_pix
• submit_card
• submit_wallet_credit
• pix_generated
• pix_error
• card_success
• card_pending
• card_warning
• card_error
• wallet_credit_success

Resultado esperado

• cada pedido em aberto passa a ter trilha de eventos cronológicos no backend
• o admin deixa de depender só de inferência por status_transacao

Implementação - 2026-04-12 04:35 -03

• action.php
• criada a tabela checkout_flow_events
• nova action leve checkout_flow_ping
• eventos backend persistidos em pontos-chave:
• pedido_draft_created
• pedido_checkout_ready
• pix_generated_backend
• pix_error_backend
• card_backend_paid
• card_backend_pending
• card_backend_warning
• card_backend_error
• mercadopago_sync_paid
• mercadopago_sync_pending
• mercadopago_sync_error
• js/checkout_pix.js
• frontend passou a enviar beacons de milestones:
• checkout_open
• method_click
• submit_pix
• submit_card
• submit_wallet_credit
• pix_generated_frontend
• pix_error_frontend
• card_success_frontend
• card_pending_frontend
• card_warning_frontend
• card_error_frontend
• wallet_credit_success_frontend
• admin/modulos/pedidos_2/detalhe.php
• novo painel Linha do Checkout com data/hora, evento, origem e detalhes
• admin/modulos/pedidos_2/index.php
• quando o cliente do pedido já tiver Clarity User ID, o próprio ID do pedido vira atalho para impressions
• admin/modulos/clientes/detalhe.php
• nova aba Linha do Checkout
• agrupamento dos milestones recentes por pedido do cliente
• governança operacional
• após validar a rodada, executado php admin/cron/monitor_mercadopago_integrity.php --seal
• baseline do guard do Mercado Pago atualizada para o estado novo validado do checkout

Validações executadas

• php -l action.php
• php -l admin/modulos/pedidos_2/detalhe.php
• node --check js/checkout_pix.js