Empreendimento FAR

A maior linha do MCMV subsidiado, obra a obra

Modelos dbt

Tabelas de uso

Testes

Entregas

Contexto

O Fundo de Arrendamento Residencial é a modalidade dominante do MCMV subsidiado. Atende famílias urbanas das Faixas 1 e 2, tem a Caixa como agente operador exclusivo e é curado pelo Departamento de Produção Habitacional. Aqui o Estado assume o risco integral de crédito: a família recebe a moradia sem contrair dívida de mercado.

O monitoramento da execução é o ponto crítico sob a perspectiva dos dados. O relatório de obras iniciadas chega semanalmente por e-mail; a execução física e financeira por empreendimento chega mensalmente pelo SFTP, com atraso de um a dois meses. Em situações de emergência, como as enchentes do Rio Grande do Sul, planilhas chegaram por WhatsApp. O efeito é a desconfiança: gasta-se tempo conferindo o dado antes de usá-lo, enquanto as demandas de instâncias superiores exigem resposta no mesmo dia.

A dor principal é a confiança no dado. Como dependemos das informações que a Caixa envia, as pessoas têm receio de usar o dado sem confirmar antes, o que gasta muito tempo.
Equipe do FAR, reunião de diagnóstico

O que a plataforma faz

As tabelas bronze recebem os arquivos como vieram; a silver reconstrói o empreendimento como entidade única, com sua evolução financeira ao longo do tempo; a gold entrega a ficha do empreendimento, o panorama por estado, o mapa nacional e os gráficos de execução física e financeira. É o material que permite comparar medição física e desembolso — a discrepância que indica se uma obra travou de fato ou se é falha de leitura do sistema.

O que sai para uso

As tabelas gold são o ponto de contato entre o pipeline e quem consome: painel, relatório ou análise. Cada uma traz o diagrama do fluxo que a constrói, gerado a partir das dependências declaradas no próprio SQL.

Fonte de origem
Bronze
Silver
Gold
A tabela em questão

gold

evolucao_financeira_chart

Visão Gold display-ready para o gráfico de "Evolução Físico-Financeira" no Superset. Consome a silver evolucao_financeira e enriquece com nome do empreendimento, nome do estado (IBGE) e labels de mês formatados. Uma linha por APF × mês.

Como esta tabela é construída

Ver a definição em Mermaid

graph LR
  n_raw_api_ibge_uf["raw.<br/>api_ibge_uf"]
  n_raw_dados_prioritarios_recebidos_caixa_empreendimentos["raw.<br/>dados_prioritarios_recebidos_caixa_empreendimentos"]
  n_raw_novo_mcmv_far_cad_pj_mensal["raw.<br/>novo_mcmv_far_cad_pj_mensal"]
  n_raw_novo_mcmv_far_consolidado["raw.<br/>novo_mcmv_far_consolidado"]
  n_raw_novo_mcmv_far_financeiro_mensal["raw.<br/>novo_mcmv_far_financeiro_mensal"]
  n_raw_novo_mcmv_far_obra_mensal["raw.<br/>novo_mcmv_far_obra_mensal"]
  n_cadastro_pj["cadastro_pj"]
  n_consolidado["consolidado"]
  n_dados_prioritarios_caixa["dados_prioritarios_caixa"]
  n_financeiro_mensal["financeiro_mensal"]
  n_obra_mensal["obra_mensal"]
  n_empreendimento["empreendimento"]
  n_evolucao_financeira["evolucao_financeira"]
  n_evolucao_financeira_chart["evolucao_financeira_chart"]
  n_ficha_empreendimento["ficha_empreendimento"]
  n_cadastro_pj --> n_empreendimento
  n_consolidado --> n_empreendimento
  n_dados_prioritarios_caixa --> n_empreendimento
  n_empreendimento --> n_evolucao_financeira
  n_empreendimento --> n_ficha_empreendimento
  n_evolucao_financeira --> n_evolucao_financeira_chart
  n_ficha_empreendimento --> n_evolucao_financeira_chart
  n_financeiro_mensal --> n_evolucao_financeira
  n_obra_mensal --> n_empreendimento
  n_raw_api_ibge_uf --> n_evolucao_financeira_chart
  n_raw_dados_prioritarios_recebidos_caixa_empreendimentos --> n_dados_prioritarios_caixa
  n_raw_novo_mcmv_far_cad_pj_mensal --> n_cadastro_pj
  n_raw_novo_mcmv_far_consolidado --> n_consolidado
  n_raw_novo_mcmv_far_financeiro_mensal --> n_financeiro_mensal
  n_raw_novo_mcmv_far_obra_mensal --> n_obra_mensal
  classDef mm-fonte fill:#fff7ed,stroke:#fed7aa,color:#7c2d12
  classDef mm-bronze fill:#fef3e2,stroke:#b45309,color:#7c2d12
  classDef mm-silver fill:#f1f5f9,stroke:#64748b,color:#1e293b
  classDef mm-gold fill:#f3ebff,stroke:#7a34f3,color:#4c1d95
  classDef mm-alvo fill:#7a34f3,stroke:#5b21b6,color:#ffffff,font-weight:bold
  class n_raw_api_ibge_uf,n_raw_dados_prioritarios_recebidos_caixa_empreendimentos,n_raw_novo_mcmv_far_cad_pj_mensal,n_raw_novo_mcmv_far_consolidado,n_raw_novo_mcmv_far_financeiro_mensal,n_raw_novo_mcmv_far_obra_mensal mm-fonte
  class n_cadastro_pj,n_consolidado,n_dados_prioritarios_caixa,n_financeiro_mensal,n_obra_mensal mm-bronze
  class n_empreendimento,n_evolucao_financeira mm-silver
  class n_ficha_empreendimento mm-gold
  class n_evolucao_financeira_chart mm-alvo

gold

execucao_fisica_financeira_chart

Tabela Gold para o gráfico de acompanhamento da execução física e financeira. Faz o join entre a base silver de evolução financeira e a base bronze de obra mensal.

Como esta tabela é construída

Ver a definição em Mermaid

graph LR
  n_raw_dados_prioritarios_recebidos_caixa_empreendimentos["raw.<br/>dados_prioritarios_recebidos_caixa_empreendimentos"]
  n_raw_novo_mcmv_far_cad_pj_mensal["raw.<br/>novo_mcmv_far_cad_pj_mensal"]
  n_raw_novo_mcmv_far_consolidado["raw.<br/>novo_mcmv_far_consolidado"]
  n_raw_novo_mcmv_far_financeiro_mensal["raw.<br/>novo_mcmv_far_financeiro_mensal"]
  n_raw_novo_mcmv_far_obra_mensal["raw.<br/>novo_mcmv_far_obra_mensal"]
  n_cadastro_pj["cadastro_pj"]
  n_consolidado["consolidado"]
  n_dados_prioritarios_caixa["dados_prioritarios_caixa"]
  n_financeiro_mensal["financeiro_mensal"]
  n_obra_mensal["obra_mensal"]
  n_empreendimento["empreendimento"]
  n_evolucao_financeira["evolucao_financeira"]
  n_execucao_fisica_financeira_chart["execucao_fisica_<br/>financeira_chart"]
  n_cadastro_pj --> n_empreendimento
  n_consolidado --> n_empreendimento
  n_dados_prioritarios_caixa --> n_empreendimento
  n_empreendimento --> n_evolucao_financeira
  n_empreendimento --> n_execucao_fisica_financeira_chart
  n_evolucao_financeira --> n_execucao_fisica_financeira_chart
  n_financeiro_mensal --> n_evolucao_financeira
  n_obra_mensal --> n_empreendimento
  n_obra_mensal --> n_execucao_fisica_financeira_chart
  n_raw_dados_prioritarios_recebidos_caixa_empreendimentos --> n_dados_prioritarios_caixa
  n_raw_novo_mcmv_far_cad_pj_mensal --> n_cadastro_pj
  n_raw_novo_mcmv_far_consolidado --> n_consolidado
  n_raw_novo_mcmv_far_financeiro_mensal --> n_financeiro_mensal
  n_raw_novo_mcmv_far_obra_mensal --> n_obra_mensal
  classDef mm-fonte fill:#fff7ed,stroke:#fed7aa,color:#7c2d12
  classDef mm-bronze fill:#fef3e2,stroke:#b45309,color:#7c2d12
  classDef mm-silver fill:#f1f5f9,stroke:#64748b,color:#1e293b
  classDef mm-gold fill:#f3ebff,stroke:#7a34f3,color:#4c1d95
  classDef mm-alvo fill:#7a34f3,stroke:#5b21b6,color:#ffffff,font-weight:bold
  class n_raw_dados_prioritarios_recebidos_caixa_empreendimentos,n_raw_novo_mcmv_far_cad_pj_mensal,n_raw_novo_mcmv_far_consolidado,n_raw_novo_mcmv_far_financeiro_mensal,n_raw_novo_mcmv_far_obra_mensal mm-fonte
  class n_cadastro_pj,n_consolidado,n_dados_prioritarios_caixa,n_financeiro_mensal,n_obra_mensal mm-bronze
  class n_empreendimento,n_evolucao_financeira mm-silver
  class n_execucao_fisica_financeira_chart mm-alvo

gold

ficha_empreendimento

Tabela Gold projetada especificamente para alimentar o componente visual de "Ficha do Empreendimento" nos Dashboards. Ela consome os dados da camada Silver (empreendimento) e injeta regras de negócio finais como cálculo de status, prazos e ritmo financeiro.

Como esta tabela é construída

Ver a definição em Mermaid

graph LR
  n_raw_dados_prioritarios_recebidos_caixa_empreendimentos["raw.<br/>dados_prioritarios_recebidos_caixa_empreendimentos"]
  n_raw_novo_mcmv_far_cad_pj_mensal["raw.<br/>novo_mcmv_far_cad_pj_mensal"]
  n_raw_novo_mcmv_far_consolidado["raw.<br/>novo_mcmv_far_consolidado"]
  n_raw_novo_mcmv_far_obra_mensal["raw.<br/>novo_mcmv_far_obra_mensal"]
  n_cadastro_pj["cadastro_pj"]
  n_consolidado["consolidado"]
  n_dados_prioritarios_caixa["dados_prioritarios_caixa"]
  n_obra_mensal["obra_mensal"]
  n_empreendimento["empreendimento"]
  n_ficha_empreendimento["ficha_empreendimento"]
  n_cadastro_pj --> n_empreendimento
  n_consolidado --> n_empreendimento
  n_dados_prioritarios_caixa --> n_empreendimento
  n_empreendimento --> n_ficha_empreendimento
  n_obra_mensal --> n_empreendimento
  n_raw_dados_prioritarios_recebidos_caixa_empreendimentos --> n_dados_prioritarios_caixa
  n_raw_novo_mcmv_far_cad_pj_mensal --> n_cadastro_pj
  n_raw_novo_mcmv_far_consolidado --> n_consolidado
  n_raw_novo_mcmv_far_obra_mensal --> n_obra_mensal
  classDef mm-fonte fill:#fff7ed,stroke:#fed7aa,color:#7c2d12
  classDef mm-bronze fill:#fef3e2,stroke:#b45309,color:#7c2d12
  classDef mm-silver fill:#f1f5f9,stroke:#64748b,color:#1e293b
  classDef mm-gold fill:#f3ebff,stroke:#7a34f3,color:#4c1d95
  classDef mm-alvo fill:#7a34f3,stroke:#5b21b6,color:#ffffff,font-weight:bold
  class n_raw_dados_prioritarios_recebidos_caixa_empreendimentos,n_raw_novo_mcmv_far_cad_pj_mensal,n_raw_novo_mcmv_far_consolidado,n_raw_novo_mcmv_far_obra_mensal mm-fonte
  class n_cadastro_pj,n_consolidado,n_dados_prioritarios_caixa,n_obra_mensal mm-bronze
  class n_empreendimento mm-silver
  class n_ficha_empreendimento mm-alvo

gold

mapa_nacional

Visão Gold geográfica para alimentar mapas coropléticos (Country Map) e gráficos por região no Superset. Contém duas visões filtradas pela coluna 'nivel': 'uf' (27 linhas, uma por estado com código ISO 3166-2) e 'regiao' (5 linhas, uma por macrorregião). Usa a tabela IBGE api_ibge_uf como referência.

Como esta tabela é construída

Ver a definição em Mermaid

graph LR
  n_raw_api_ibge_uf["raw.<br/>api_ibge_uf"]
  n_raw_dados_prioritarios_recebidos_caixa_empreendimentos["raw.<br/>dados_prioritarios_recebidos_caixa_empreendimentos"]
  n_raw_novo_mcmv_far_cad_pj_mensal["raw.<br/>novo_mcmv_far_cad_pj_mensal"]
  n_raw_novo_mcmv_far_consolidado["raw.<br/>novo_mcmv_far_consolidado"]
  n_raw_novo_mcmv_far_obra_mensal["raw.<br/>novo_mcmv_far_obra_mensal"]
  n_cadastro_pj["cadastro_pj"]
  n_consolidado["consolidado"]
  n_dados_prioritarios_caixa["dados_prioritarios_caixa"]
  n_obra_mensal["obra_mensal"]
  n_empreendimento["empreendimento"]
  n_ficha_empreendimento["ficha_empreendimento"]
  n_mapa_nacional["mapa_nacional"]
  n_cadastro_pj --> n_empreendimento
  n_consolidado --> n_empreendimento
  n_dados_prioritarios_caixa --> n_empreendimento
  n_empreendimento --> n_ficha_empreendimento
  n_ficha_empreendimento --> n_mapa_nacional
  n_obra_mensal --> n_empreendimento
  n_raw_api_ibge_uf --> n_mapa_nacional
  n_raw_dados_prioritarios_recebidos_caixa_empreendimentos --> n_dados_prioritarios_caixa
  n_raw_novo_mcmv_far_cad_pj_mensal --> n_cadastro_pj
  n_raw_novo_mcmv_far_consolidado --> n_consolidado
  n_raw_novo_mcmv_far_obra_mensal --> n_obra_mensal
  classDef mm-fonte fill:#fff7ed,stroke:#fed7aa,color:#7c2d12
  classDef mm-bronze fill:#fef3e2,stroke:#b45309,color:#7c2d12
  classDef mm-silver fill:#f1f5f9,stroke:#64748b,color:#1e293b
  classDef mm-gold fill:#f3ebff,stroke:#7a34f3,color:#4c1d95
  classDef mm-alvo fill:#7a34f3,stroke:#5b21b6,color:#ffffff,font-weight:bold
  class n_raw_api_ibge_uf,n_raw_dados_prioritarios_recebidos_caixa_empreendimentos,n_raw_novo_mcmv_far_cad_pj_mensal,n_raw_novo_mcmv_far_consolidado,n_raw_novo_mcmv_far_obra_mensal mm-fonte
  class n_cadastro_pj,n_consolidado,n_dados_prioritarios_caixa,n_obra_mensal mm-bronze
  class n_empreendimento mm-silver
  class n_ficha_empreendimento mm-gold
  class n_mapa_nacional mm-alvo

gold

panorama_estadual

Visão Gold agregada por UF para alimentar o dashboard "Panorama Estadual". Consolida todos os empreendimentos de um estado em seções distintas, cada uma identificada pela coluna 'secao'. A ferramenta de BI filtra WHERE secao = 'X' para montar cada card do painel.

Como esta tabela é construída

Ver a definição em Mermaid

graph LR
  n_raw_api_ibge_uf["raw.<br/>api_ibge_uf"]
  n_raw_dados_prioritarios_recebidos_caixa_empreendimentos["raw.<br/>dados_prioritarios_recebidos_caixa_empreendimentos"]
  n_raw_novo_mcmv_far_cad_pj_mensal["raw.<br/>novo_mcmv_far_cad_pj_mensal"]
  n_raw_novo_mcmv_far_consolidado["raw.<br/>novo_mcmv_far_consolidado"]
  n_raw_novo_mcmv_far_obra_mensal["raw.<br/>novo_mcmv_far_obra_mensal"]
  n_cadastro_pj["cadastro_pj"]
  n_consolidado["consolidado"]
  n_dados_prioritarios_caixa["dados_prioritarios_caixa"]
  n_obra_mensal["obra_mensal"]
  n_empreendimento["empreendimento"]
  n_ficha_empreendimento["ficha_empreendimento"]
  n_panorama_estadual["panorama_estadual"]
  n_cadastro_pj --> n_empreendimento
  n_consolidado --> n_empreendimento
  n_dados_prioritarios_caixa --> n_empreendimento
  n_empreendimento --> n_ficha_empreendimento
  n_ficha_empreendimento --> n_panorama_estadual
  n_obra_mensal --> n_empreendimento
  n_raw_api_ibge_uf --> n_panorama_estadual
  n_raw_dados_prioritarios_recebidos_caixa_empreendimentos --> n_dados_prioritarios_caixa
  n_raw_novo_mcmv_far_cad_pj_mensal --> n_cadastro_pj
  n_raw_novo_mcmv_far_consolidado --> n_consolidado
  n_raw_novo_mcmv_far_obra_mensal --> n_obra_mensal
  classDef mm-fonte fill:#fff7ed,stroke:#fed7aa,color:#7c2d12
  classDef mm-bronze fill:#fef3e2,stroke:#b45309,color:#7c2d12
  classDef mm-silver fill:#f1f5f9,stroke:#64748b,color:#1e293b
  classDef mm-gold fill:#f3ebff,stroke:#7a34f3,color:#4c1d95
  classDef mm-alvo fill:#7a34f3,stroke:#5b21b6,color:#ffffff,font-weight:bold
  class n_raw_api_ibge_uf,n_raw_dados_prioritarios_recebidos_caixa_empreendimentos,n_raw_novo_mcmv_far_cad_pj_mensal,n_raw_novo_mcmv_far_consolidado,n_raw_novo_mcmv_far_obra_mensal mm-fonte
  class n_cadastro_pj,n_consolidado,n_dados_prioritarios_caixa,n_obra_mensal mm-bronze
  class n_empreendimento mm-silver
  class n_ficha_empreendimento mm-gold
  class n_panorama_estadual mm-alvo

gold

resumo_gerencial

Visão agregada Gold contendo os grandes KPIs e somatórios (UHs, Pessoas Atendidas, Valores) agrupados por tipologia e situação. Perfeita para os gráficos de pizza e barras dos painéis gerenciais.

Como esta tabela é construída

Ver a definição em Mermaid

graph LR
  n_raw_dados_prioritarios_recebidos_caixa_empreendimentos["raw.<br/>dados_prioritarios_recebidos_caixa_empreendimentos"]
  n_raw_novo_mcmv_far_cad_pj_mensal["raw.<br/>novo_mcmv_far_cad_pj_mensal"]
  n_raw_novo_mcmv_far_consolidado["raw.<br/>novo_mcmv_far_consolidado"]
  n_raw_novo_mcmv_far_obra_mensal["raw.<br/>novo_mcmv_far_obra_mensal"]
  n_cadastro_pj["cadastro_pj"]
  n_consolidado["consolidado"]
  n_dados_prioritarios_caixa["dados_prioritarios_caixa"]
  n_obra_mensal["obra_mensal"]
  n_empreendimento["empreendimento"]
  n_ficha_empreendimento["ficha_empreendimento"]
  n_resumo_gerencial["resumo_gerencial"]
  n_cadastro_pj --> n_empreendimento
  n_consolidado --> n_empreendimento
  n_dados_prioritarios_caixa --> n_empreendimento
  n_empreendimento --> n_ficha_empreendimento
  n_ficha_empreendimento --> n_resumo_gerencial
  n_obra_mensal --> n_empreendimento
  n_raw_dados_prioritarios_recebidos_caixa_empreendimentos --> n_dados_prioritarios_caixa
  n_raw_novo_mcmv_far_cad_pj_mensal --> n_cadastro_pj
  n_raw_novo_mcmv_far_consolidado --> n_consolidado
  n_raw_novo_mcmv_far_obra_mensal --> n_obra_mensal
  classDef mm-fonte fill:#fff7ed,stroke:#fed7aa,color:#7c2d12
  classDef mm-bronze fill:#fef3e2,stroke:#b45309,color:#7c2d12
  classDef mm-silver fill:#f1f5f9,stroke:#64748b,color:#1e293b
  classDef mm-gold fill:#f3ebff,stroke:#7a34f3,color:#4c1d95
  classDef mm-alvo fill:#7a34f3,stroke:#5b21b6,color:#ffffff,font-weight:bold
  class n_raw_dados_prioritarios_recebidos_caixa_empreendimentos,n_raw_novo_mcmv_far_cad_pj_mensal,n_raw_novo_mcmv_far_consolidado,n_raw_novo_mcmv_far_obra_mensal mm-fonte
  class n_cadastro_pj,n_consolidado,n_dados_prioritarios_caixa,n_obra_mensal mm-bronze
  class n_empreendimento mm-silver
  class n_ficha_empreendimento mm-gold
  class n_resumo_gerencial mm-alvo

O que foi feito

6 entregas tocaram este domínio, das quais 4 vêm com descrição própria do autor. O texto abaixo é o do pull request, não uma reescrita.

10/jul/2026 #101 pull request

Adiciona script de dif entre Minio e sftp

Juan-Ricarte · outro
10/jul/2026 #102 pull request

melhoras no script de snapshot

gusrberto · refatoração

Adiciona ao script sftp_snapshot.py a capacidade de detectar cópia de arquivos entre diretórios do SFTP. - Um arquivo novo cujo nome+tamanho coincide com um arquivo ainda presente em outro path é classificado como copiado (origem -> destino), não como novo.

sftp_snapshot.py
01/jul/2026 #99 pull request

ingestão dos dados do sftp

gusrberto · funcionalidade

Foram feitos dois scripts: - [x] Script de inserção de dados do SFTP no banco do projeto; - [x] Script de snapshots para descobrir alterações que ocorreram no SFTP entre períodos diferentes.

Resolve as issues #91 e #92
18/mai/2026 #23 pull request

evolucao financeira da obra FAR

gusrberto · funcionalidade
Resolve a issue #20

Cria as camadas bronze, silver e gold de evolução financeira que:
- [x] Limpar e tipar os dados brutos da tabela financeiro_mensal (bronze)
- [x] Agregar as liberações por APF e mês, calcular o desembolso acumulado e fazer o JOIN com os empreendimentos (silver);
- [x] Expor os dados ao Superset em formato display-ready, seguindo a convenção do projeto onde apenas modelos gold são consumidos pelo BI (gold)
08/mai/2026 #13 pull request

agregacao de empreendimentos far por estado

gusrberto · funcionalidade
- [x] Nova tabela gold de panorama_estadual que agrega as informações dos empreendimentos do Novo MCMV FAR em diferentes tipos de charts;
- [x] Criação de nova aba Estados na Dashboard do FAR no Superset para visualização da gold criada;
05/mai/2026 #8 pull request

DBTs bronze, silver e gold para empreendimentos far

gusrberto · funcionalidade

Resolve a issue #7

Modelos

O caminho completo do dado neste domínio, camada a camada.

Camada	Modelo	Descrição	Depende de	Testes
bronze	`cadastro_pj`	Cadastro detalhado de pessoa jurídica (empreendimento contratado). 822 empreendimentos com composição financeira completa, coordenadas GPS, tipologia, construtora, datas-chave e indicadores do empreendimento.	raw.novo_mcmv_far_cad_pj_mensal	1
bronze	`consolidado`	Dados do GFAR consolidado com propostas e contratos FAR do Novo MCMV. Cobre todo o ciclo de vida: da proposta protocolizada até a contratação. Contém 15.091 registros (13.216 propostas únicas, 940 com APF). Tipagem aplicada: text→int, text→date, text→numeric, text→boolean.	raw.novo_mcmv_far_consolidado	1
bronze	`dados_prioritarios_caixa`	Snapshot consolidado dos dados prioritários recebidos da CAIXA. Filtrado apenas para modalidade FAR (4.443 empreendimentos). Contém situação atual, percentual de execução, valores e coordenadas.	raw.dados_prioritarios_recebidos_caixa_empreendimentos	0
bronze	`financeiro_mensal`	Série temporal de liberações financeiras. Contém 6.069 registros para 638 APFs (média de 9,5 liberações por empreendimento). Cada registro representa uma liberação de recurso com decomposição por componente.	raw.novo_mcmv_far_financeiro_mensal	0
bronze	`obra_mensal`	Evolução física da obra. Snapshot mensal com percentual previsto/realizado, situação da obra, UHs concluídas e datas de paralisação/retomada/entrega. 822 registros (1 por empreendimento no snapshot atual).	raw.novo_mcmv_far_obra_mensal	1
silver	`empreendimento`	Tabela Silver (Visão Unificada) de Empreendimentos FAR do Novo MCMV. Esta tabela consolida as informações da camada bronze cruzando as tabelas cadastro_pj, consolidado, obra_mensal e dados_prioritarios_caixa através da chave APF. Gera uma visão final pronta para alimentar painéis e dashboards.	`cadastro_pjconsolidadodados_prioritarios_caixaobra_mensal`	0
silver	`evolucao_financeira`	Tabela Silver de Evolução Financeira dos Empreendimentos FAR. Série temporal mensal de liberações financeiras por empreendimento (APF × mês). Agrega as liberações da bronze financeiro_mensal e faz o JOIN com a silver empreendimento usando a raiz de 6 dígitos do APF: LEFT(cad_pj.apf, 6) = RIGHT(fin.apf, 6). Cobertura: ~79% dos empreendimentos (651/823) possuem dados financeiros. Relação 1:N com empreendimento (1 APF → N meses de liberações).	`empreendimentofinanceiro_mensal`	3
gold	`evolucao_financeira_chart`	Visão Gold display-ready para o gráfico de "Evolução Físico-Financeira" no Superset. Consome a silver evolucao_financeira e enriquece com nome do empreendimento, nome do estado (IBGE) e labels de mês formatados. Uma linha por APF × mês.	`evolucao_financeiraficha_empreendimento`raw.api_ibge_uf	0
gold	`execucao_fisica_financeira_chart`	Tabela Gold para o gráfico de acompanhamento da execução física e financeira. Faz o join entre a base silver de evolução financeira e a base bronze de obra mensal.	`empreendimentoevolucao_financeiraobra_mensal`	0
gold	`ficha_empreendimento`	Tabela Gold projetada especificamente para alimentar o componente visual de "Ficha do Empreendimento" nos Dashboards. Ela consome os dados da camada Silver (empreendimento) e injeta regras de negócio finais como cálculo de status, prazos e ritmo financeiro.	`empreendimento`	0
gold	`mapa_nacional`	Visão Gold geográfica para alimentar mapas coropléticos (Country Map) e gráficos por região no Superset. Contém duas visões filtradas pela coluna 'nivel': 'uf' (27 linhas, uma por estado com código ISO 3166-2) e 'regiao' (5 linhas, uma por macrorregião). Usa a tabela IBGE api_ibge_uf como referência.	`ficha_empreendimento`raw.api_ibge_uf	0
gold	`panorama_estadual`	Visão Gold agregada por UF para alimentar o dashboard "Panorama Estadual". Consolida todos os empreendimentos de um estado em seções distintas, cada uma identificada pela coluna 'secao'. A ferramenta de BI filtra WHERE secao = 'X' para montar cada card do painel.	`ficha_empreendimento`raw.api_ibge_uf	0
gold	`resumo_gerencial`	Visão agregada Gold contendo os grandes KPIs e somatórios (UHs, Pessoas Atendidas, Valores) agrupados por tipologia e situação. Perfeita para os gráficos de pizza e barras dos painéis gerenciais.	`ficha_empreendimento`	0

Empreendimento FAR

Contexto

O que a plataforma faz

O que sai para uso

evolucao_financeira_chart

execucao_fisica_financeira_chart

ficha_empreendimento

mapa_nacional

panorama_estadual

resumo_gerencial

O que foi feito

Adiciona script de dif entre Minio e sftp

melhoras no script de snapshot

ingestão dos dados do sftp

evolucao financeira da obra FAR

agregacao de empreendimentos far por estado

DBTs bronze, silver e gold para empreendimentos far

Modelos