# Changelog do escopo — Distribuidora Vale Sul

## 2026-07-21 — v1.3 (MINOR — correção de régua da skill)
* **Fix**: `apps/vendas.md` afirmava "5/5 relationships batem 1:1 com
  `lineage.md`" no bloco "Evidência do cubo" — mas o relationship
  `dim_calendario.data -> fact_pedido_item.data` não tem chave explícita na
  tabela "Dimensões (chaves usadas no fato)" de `lineage.md` (só há a aresta
  table-level `DIMCAL --> FACT` e a linha STM `TGFCAB.DTNEG ->
  fact_pedido_item.data`, que documenta a origem da coluna do FATO, não a
  chave do lado da dimensão); `data` é nome inferido por convenção. Linha da
  evidência separada em duas (4/4 rastreáveis no STM + 1 inferido, Status
  "Premissa não validada"); novo registro
  `escopo/incognitas.md#calendario-chave-join-inferida` (`dono:
  precisa-acesso-banco`) rastreia a lacuna; `README.md` (régua) e a seção
  "Nomeação do cubo" de `apps/vendas.md` ajustados para consistência —
  a última também corrigia atribuição errada (`dashboards/vendas-executivo.md`
  não usa `app:vendas-executivo` nos comandos; quem usa é `aceite.md` e o
  `teste_reconciliacao` das 2 métricas).
* Correção de régua/consistência do gabarito, não de escopo aprovado — não
  reabre `aprovacao.*`.

## 2026-07-17 — v1.2 (MINOR — atualização de régua da skill)
* **Update**: bundle migrado para a camada de confiança (`confianca:
  confirmado | hipótese | a-perguntar`, ver `incognitas.md`) no lugar do
  antigo `status: validado`. `projeto.md`, `tabelas/fact_pedido_item.md`,
  `metricas/receita-liquida.md` e `metricas/ticket-medio.md` trocaram
  `status:` por `confianca:` com rastro completo (`validado_por`/
  `validado_em`/`canal`/`evidencia`); KPI cards ganharam os campos que
  faltavam do template atual (`decisao_associada`, `camada`, `mask`,
  `aviso_apos`, `sla_cliente` — `cadencia: diaria` removido, era o exemplo
  RUIM de `calibracao-qualidade.md`). `processos/faturamento.md` teve o
  `grain` convertido para o formato com rastro e as 5 dimensões ganharam
  etiqueta de confiança individual (2 `confirmado`, 3 `hipótese` — mix
  realista, não 100% validado). Fichas de widget de Vendas Executivo
  ganharam `confianca:` (widget 4 — ranking por vendedor — fica `hipótese`:
  critério de top-N/corte ainda não fechado com Marcos). Criado
  `escopo/incognitas.md` com 4 registros completos (3 `dono: cliente`, 1
  `dono: precisa-acesso-banco`), amarrados a lacunas reais já sinalizadas no
  bundle: estorno de pedido cancelado pós-fechamento (variante do exemplo
  canônico `cancelamento-pedido`), retenção LGPD de `fact_pedido_item`
  (`retencao_dw`), origem dos 12% de `DT_ALTERACAO` nulo, e o detalhamento
  fino de RLS por vendedor. `aceite.md` trocou o placeholder `[A CONFIRMAR]`
  solto por referência ao registro correspondente em `incognitas.md`.
* Atualização de régua, não de escopo aprovado — não reabre `aprovacao.*`.

## 2026-07-02 — v1.1 (MINOR — atualização de régua da skill)
* **Update**: bundle realinhado com campos novos da skill lumo-scope.
  `teste_reconciliacao` adicionado aos KPI cards de Receita Líquida e Ticket
  Médio; `mensagem` adicionado a toda ficha de widget de Vendas Executivo
  (público executivo); ficha 4 (tendência diária de Receita Líquida) convertida
  para `relacao: tendencia-inline` dentro do KPI card 2 — dashboard cai de 6
  para 5 widgets, wireframe HTML e `fora-de-escopo.md` ajustados para
  coerência. `aceite.md` ganhou os itens de uniqueness no destino (COUNT vs
  COUNT DISTINCT na tabela DW carregada) e o pré-requisito de evidência de
  `defasagem_atual` no item de frescor; evidência correspondente adicionada em
  `tabelas/fact_pedido_item.md`.
* Atualização de régua, não de escopo aprovado — não reabre `aprovacao.*`.

## 2026-04-14 — v1.0 (MAJOR — aprovação inicial)
* **Criação**: escopo completo do processo Faturamento — grain, 1 fato, 2
  métricas, 1 dashboard (Vendas Executivo, 6 widgets).
* Aprovado por Marcos Aurélio (Diretor Comercial) em call de 14/04/2026 —
  confirmação por e-mail encaminhado em anexo ao bundle (ver `aceite.md`).
* `git tag scope-v1.0` no workspace.

## 2026-04-10 — pré-aprovação
* **Update**: bloco de evidência de `fact_pedido_item.md` revisado após
  Marcos confirmar que bonificação (`TIPMOV='B'`) não é venda — descoberta do
  profiling (achado B2, ver `tabelas/fact_pedido_item.md`).

## 2026-04-08 — rascunho
* **Criação**: primeira versão de `processos/faturamento.md` e KPI cards, ao
  fechar a rodada da Fase 2 (Entrevista).
