-- Migration 019 — BACKFILL SNAPSHOT DO AGENTE 417 EM tbl_Faturamento
-- Competência: 2024-10 · Cliente: 13.569.064/0007-45 (REDE HG COMBUSTIVEIS LTDA)
-- 1 linha (id=78797) · valor R$ 172,00 · vencimento 2024-10-15
--
-- Decisão Stakeholder (09/05/2026 noite): popular faturamentos legados da carteira
-- REDE HG mês a mês, começando por out/2024 com baixo volume (1 cliente) pra
-- validar procedimento antes dos meses cheios.
--
-- ⚠️ EXCEÇÃO FORMAL ao PRD-0006 D-03 ("snapshot é puro, nunca muda após INSERT").
-- Justificativa: Migration 018 (09/05/2026) carimbou agente=417 em 48 pedidos da
-- carteira REDE HG, mas faturamentos pré-Migration 018 ficaram com snapshot NULL.
-- Apuração comercial do agente 417 lê de tbl_Faturamento (PRD-0006 D-04 + ADR-0005).
-- Sem este backfill, a apuração desconsidera todo o histórico legítimo da carteira.
-- Override autorizado mês a mês pelo Stakeholder Leader.
--
-- Defesa em profundidade: WHERE com id + cliente_id + pedido_id + agente_cod_snap IS NULL.
-- Engine InnoDB → ROLLBACK transacional disponível em caso de problema.

UPDATE tbl_Faturamento
SET
    agente_cod_snap        = 417,
    agente_modalidade_snap = 'pct_venda',
    agente_pct_snap        = 10.0000
WHERE id = 78797
  AND cliente_id = 5812
  AND pedido_id  = 6340
  AND agente_cod_snap IS NULL;

-- Verificação pós-aplicação esperada: 1 linha afetada.
