[dbt] Modelagem de Dados - Meta 3 (Diversidade, Cotas e Territórios)

[CaioMelo25]

Objetivo:
Construir os modelos no domínio agentes_dbt para auditar as ações afirmativas da PNAB e LPG. O modelo final deve entregar os percentuais consolidados de recursos destinados a pessoas negras (25%), indígenas (10%), PCDs (5%) e territórios vulnerabilizados (20%).

Tarefas de Desenvolvimento (Checklist):

Camada Bronze

• Criar os modelos base agentes_pf.sql, agentes_pj.sql e agentes_coletivos.sql lendo das tabelas brutas da LPG.
• Criar o modelo acoes_gerais_pnab.sql para extrair os dados territoriais da PNAB.
• Realizar a tipagem de dados e limpar caracteres especiais brutos gerados na ingestão.

Camada Views/Silver

• Criar uma View (identificadores_agentes.sql) para unificar as chaves (CPF/CNPJ) via UNION ALL das três tabelas de agentes.
• Criar o modelo Silver perfil_agentes_normalizado.sql.
• Aplicar CASE WHEN para padronizar as autodeclarações da coluna raça, cor ou etnia (ex: agrupar pretos e pardos como 'Negra') e a flag de PCD.
• Criar o modelo territorios_vulnerabilizados.sql aplicando o filtro na coluna "a atividade destina recursos para áreas periféricas...".

Camada Gold

• Criar o modelo distribuicao_cotas_agentes.sql com as agregações de contagem distinta de CPFs/CNPJs por categoria de diversidade.
• Criar o modelo distribuicao_recursos_territorios.sql somando o valor financeiro repassado para periferias.
• Gerar as colunas de percentual via Window Functions (OVER()) para viabilizar a comparação direta com as metas normativas.

---