feat: origem de recurso nas golds de teds e convenios

[luanaa2005]

Descrição

Adiciona a informação de origem do recurso (emenda parlamentar vs. recurso próprio do ministério) nas golds de Convênio (resumo_convenios e resumo_termos_fomento) e TED (ted_resumo_orcamentario). Em resumo_convenios/resumo_termos_fomento, via join com emendas_convenio por nr_convenio (usando a CTE emendas já existente nos models). Em ted_resumo_orcamentario, via join com numero_transferencia por num_transf/numero_transferencia (nova CTE emendas adicionada ao model).

resumo_convenios.sql (gold de Convênio)

• Adicionada coluna origem
• Lógica: case when em.nr_convenio is not null then true else false end, usando a CTE emendas já existente no model (agregação de emendas_convenio).
• Validado: 174 convênios com emenda / 463 recurso próprio, sem nenhum caso de conflito.

resumo_termos_fomento.sql (também gold de Convênio, para termos de fomento)

• Mesma lógica e mesma origem de dados (emendas_convenio via nr_convenio), adicionada a coluna origem ('Emenda' / 'Recurso Próprio').

ted_resumo_orcamentario.sql (gold de TED)

• Adicionada a CTE emendas (join com numero_transferencia) e a coluna origem, seguindo o mesmo padrão.
• Join feito por num_transf/numero_transferencia, com coalesce(vf.num_transf, jp.num_transf) para cobrir os casos em que o full join interno deixa vf.num_transf nulo.
• Validado: 69 TEDs com emenda / 858 recurso próprio.

ted_empenhos_plano_acao.sql — NÃO alterado

• Diferente das outras golds, esse model não parte de uma CTE que já tem acesso a num_transf de forma direta e única — para trazer a origem aqui, seria necessário replicar toda a estrutura de CTE/join de emendas (numero_transferencia) que já existe em ted_resumo_orcamentario, duplicando lógica sem necessidade. Como esse model é de granularidade de empenho individual (não de TED), quem precisar da origem do recurso pode fazer join com ted_resumo_orcamentario via num_transf, evitando duplicar a lógica de emendas em dois lugares.

Testes realizados

• Confirmado que id_autor (usado para detectar vínculo com emenda) é integer, sem sujeira de dados (sem string vazia mascarando NULL).
• Contagens de emenda/recurso próprio conferidas manualmente em resumo_convenios e ted_resumo_orcamentario.
• Verificado individualmente que um num_transf de TED classificado como "Recurso Próprio" (992125) de fato não existe em numero_transferencia, confirmando que o join está correto.

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

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
dbt run --select resumo_convenios
dbt test --select resumo_convenios

dbt run --select resumo_termos_fomento
dbt test --select resumo_termos_fomento

cd airflow_lappis/dags/dbt/empenhos_ted_dbt
dbt run --select ted_resumo_orcamentario
dbt test --select ted_resumo_orcamentario

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

[TiagoSBittencourt]

Muito bom Luana!