Skip to content

feat: adiciona cruzamento Silver cronogramas_faturas_mensal - #20

Merged
TiagoSBittencourt merged 1 commit into
mainfrom
feat/silver-cronogramas-faturas-mensal
Aug 11, 2026
Merged

feat: adiciona cruzamento Silver cronogramas_faturas_mensal#20
TiagoSBittencourt merged 1 commit into
mainfrom
feat/silver-cronogramas-faturas-mensal

Conversation

@luanaa2005

Copy link
Copy Markdown
Member

Descrição

Este PR implementa a model de camada silver cronogramas_faturas_mensal, responsavel por consolidar, por contrato e mes de referencia, os valores previstos no cronograma de execucao e os valores acumulados de faturas pagas e pendentes, calculando o saldo contratual disponivel.

Alteracoes Realizadas

1. Model models/contratos_dbt/silver/cronogramas_faturas_mensal.sql

  • Agregacao do Cronograma: Agrupamento por contrato_id, anoref e mesref para apuracao do valor previsto em cronograma (valor_cronograma).
  • Agregacao de Faturas: Agrupamento por contrato_id e mes de emissao (emissao), segregando:
    • Faturas Pagas (situacao = 'siafi apropriado').
    • Faturas Pendentes (situacao = 'pendente').
  • Calculo do Saldo: Aplicacao do tratamento de nulos (COALESCE) antes dos calculos e apuracao da regra:
    saldo_contratual_disponivel = valor_cronograma - valor_faturas_pagas - valor_faturas_pendentes
  • Enriquecimento Cadastral: LEFT JOIN final com contratos para vincular informacoes cadastrais (fornecedor, orgao contratante, unidade gestora e vigencias).

2. Documentacao e Testes (schema.yml)

  • Inclusao da documentacao das colunas do model na camada silver.
  • Adicao dos testes de tipagem de colunas (verificacao_tipagem) para todas as metricas e chaves.

Tipo de mudança

  • Nova funcionalidade / pipeline
  • Correção de bug ou inconsistência de dados
  • Refatoração de modelo DBT
  • Documentação
  • Infraestrutura / CI
  • Outro: ___

Issues relacionadas

Closes #457

Domínio de revisão

  • GCES / OSS
  • IPEA
  • MIR
  • MCid
  • MinC
  • OSS
  • Múltiplos domínios: ___

Como testar / validar

- Execution: `dbt run --select cronogramas_faturas_mensal`
  - Tabela gerada com sucesso (7.192 registros processados).
  
- Tests: `dbt test --select cronogramas_faturas_mensal`
  - Todos os 8 testes de tipagem executados e aprovados (`PASS=8`).

Evidências

Checklist

  • Título do PR segue Conventional Commits
  • Issue relacionada foi referenciada
  • Testes/lint foram executados ou a ausência foi justificada
  • Testes DBT adicionados/atualizados, se aplicável
  • Documentação atualizada, se aplicável
  • Sem dados sensíveis ou credenciais no código
  • Branch atualizada com upstream/main ou origin/main
  • Revisores automáticos por domínio foram solicitados pelo GitHub ou justificados no PR

@luanaa2005 luanaa2005 self-assigned this Aug 11, 2026

@TiagoSBittencourt TiagoSBittencourt left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Muito bom Luana

@TiagoSBittencourt
TiagoSBittencourt merged commit c39b9a3 into main Aug 11, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

feat(contratos): implementar cruzamento Silver cronogramas_faturas_mensal

2 participants