-- Migration 008 — RENAME colunas para prefixo padrao `agente_` (ADR-0004) — FASE 1
-- PRD: docs/PRDs/PRD-0002-modelo-agente/PRD-0002-modelo-agente.md
-- ADR: docs/ADRs/ADR-0004-prefixo-colunas-projeto-agente.md
-- Card: INT#3 (roadmap)
-- Data: 06/05/2026
--
-- ESCOPO FASE 1 (esta migration): renomeia apenas colunas em `tbl_Pedido` —
-- nenhuma delas e usada por sistemas correlatos (verificado por grep em
-- newportaltefnet/, ApuraComercial/, new-dashboard-tef/, ticket-grupo-porto/).
--
-- Renomeia:
--   tbl_Pedido.cod_Agente              -> agente_cod_snap
--   tbl_Pedido.pct_agente              -> agente_pct_snap
--   tbl_Pedido.modalidade_agente_snap  -> agente_modalidade_snap
--
-- E renomeia o indice correspondente:
--   idx_pedido_agente  -> idx_pedido_agente_cod_snap
--
-- FASE 2 (NAO inclusa aqui): renomeio de tbl_Representante.cod_Agente_vinculado
-- depende de coordenacao com AG#2-M (toca newportaltefnet — sistema vivo,
-- ja le/escreve essa coluna em revenda.php e updateRevenda_V16.php).
-- Sera tratado em migration futura quando AG#2-M for executado.

ALTER TABLE tbl_Pedido
  CHANGE COLUMN cod_Agente             agente_cod_snap         INT NULL DEFAULT NULL
    COMMENT '[satelite:agente] Snapshot do agente vinculado a revenda no momento do pedido (FK soft tbl_Representante.id idNatureza=3)',
  CHANGE COLUMN pct_agente             agente_pct_snap         DECIMAL(8,4) NULL DEFAULT NULL
    COMMENT '[satelite:agente] Snapshot do percentual aplicado',
  CHANGE COLUMN modalidade_agente_snap agente_modalidade_snap  ENUM('pct_venda','pct_comissao','tabela_preco') NULL DEFAULT NULL
    COMMENT '[satelite:agente] Snapshot da modalidade de comissao no momento do pedido',
  RENAME INDEX idx_pedido_agente TO idx_pedido_agente_cod_snap;