feat: adiciona model Silver estagios_mensal

[TiagoSBittencourt]

Descrição

Este PR implementa a model de camada silver estagios_mensal, que discrimina, mês a mês, os estágios da despesa (empenhado, liquidado, pago e restos a pagar) extraídos do SIAFI a partir da bronze empenhos_tesouro. A model é a base do cruzamento contratos_estagios do domínio de Contratos.

Alterações Realizadas

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

• Parsing da fonte: extração de ne (12 últimas posições de ne_ccor), cnpj_cpf (ne_ccor_favorecido), info_complementar (prefixo numérico de ne_info_complementar), além de mês/ano de lançamento a partir de emissao_dia/emissao_mes.
• Agregação: soma dos valores (valor_empenhado, valor_liquidado, valor_pago, restos_a_pagar, restos_a_pagar_pago) por ne, cnpj_cpf e mês/ano de lançamento.
• Tratamento de Restos a Pagar (RAP): registros inscritos em RAP são identificados pelo prefixo 000/ em emissao_dia e desdobrados entre o ano de lançamento (mês original) e o ano de origem (mês 12), com o valor de restos_a_pagar invertido no ano de origem para refletir a baixa da inscrição. Replica a lógica validada no pipeline IPEA.
• Referência de processo: propaga o menor ne_num_processo observado por NE via window function.

2. Documentação e Testes (schema.yml)

• Documentação de todas as colunas da model na camada silver.
• Adição de 6 testes de tipagem (verificacao_tipagem) para as chaves e métricas: mes_lancamento (date), valor_empenhado, valor_liquidado, valor_pago, restos_a_pagar (numeric) e dt_ingest (timestamp with time zone).

---

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 #453

Domínio de revisão

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

Como testar / validar

cd airflow_lappis/dags/dbt/mir

# Materializa a model silver
dbt run --select estagios_mensal

# Executa os testes de tipagem definidos no schema.yml
dbt test --select estagios_mensal

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]

Muito bom