@wibi-global/sdk 0.1.0 → 0.1.2

package/dist/sdk/src/data/views.wbx

@@ -0,0 +1,1118 @@
+{
+    "__CONTEXT_BLOCK__": {
+        "block_name": "DB_SCHEMA_VIEWS",
+        "block_role": "SOURCE_OF_TRUTH_FOR_SQL_VIEWS_AND_COLUMNS",
+        "llm_instruction": "Neste bloco, somente as chaves que começam com vw_ representam views válidas. Os campos dentro dessas views são os únicos nomes permitidos para SQL de dados no TSX. O campo __doc__ dentro de cada view explica sua finalidade, relacionamentos e exemplos de uso — NÃO é uma coluna SQL."
+    },
+    "vw_abastecimentos": {
+        "__doc__": "Registros de abastecimento de veículos (combustível, lubrificantes, serviços). Cada linha é uma transação de abastecimento com dados do veículo, motorista, estabelecimento e valores. Útil para dashboards de frota: custo por km, consumo médio, gastos por veículo/motorista. Não possui FK direta com outras views — é uma tabela independente importada de sistema de gestão de frota.",
+        "transacao": "UInt64",
+        "cartao": "UInt64",
+        "placa": "String",
+        "modelo": "String",
+        "responsavel": "String",
+        "quilometragem": "UInt32",
+        "km_rodados": "UInt32",
+        "numero_externo": "Nullable(Float64)",
+        "motorista": "String",
+        "matricula": "UInt32",
+        "data_hora": "DateTime",
+        "tipo": "String",
+        "liberacao_restricao": "Nullable(Float64)",
+        "estabelecimento": "String",
+        "cidade": "String",
+        "servico": "String",
+        "valor": "Float64",
+        "horas": "UInt32",
+        "horas_trabalhadas": "UInt32",
+        "litros": "Float64",
+        "km_por_litro": "Float64",
+        "litros_por_hora": "UInt32",
+        "valor_por_litro": "Float64",
+        "ordem_servico": "Nullable(Float64)",
+        "emissora": "Nullable(Float64)",
+        "info_adicional_1_veiculo": "String",
+        "info_adicional_2_veiculo": "String",
+        "info_adicional_3_veiculo": "String",
+        "info_adicional_4_veiculo": "Nullable(Float64)",
+        "info_adicional_5_veiculo": "Nullable(Float64)",
+        "info_adicional_1_motorista": "Nullable(String)",
+        "info_adicional_2_motorista": "Nullable(String)",
+        "info_adicional_3_motorista": "Nullable(Float64)",
+        "info_adicional_4_motorista": "Nullable(Float64)",
+        "info_adicional_5_motorista": "Nullable(Float64)"
+    },
+    "vw_calendario": {
+        "__doc__": "Tabela dimensão de calendário. Cada linha representa um dia com ano, mês, semana e dia da semana pré-calculados. Útil para JOINs com fatos (vendas, financeiro) quando se precisa agrupar por semana ou garantir continuidade de datas (inclusive dias sem movimento). JOIN por: data. Relaciona-se com vw_calendario_rotas por (ano, mes, semana).",
+        "uid": "UUID",
+        "id_coligada": "Int64",
+        "data": "Nullable(Date)",
+        "ano": "Int64",
+        "mes": "Int64",
+        "semana": "Int64",
+        "dia_semana": "Int64",
+        "semana_order": "Int64",
+        "is_deleted": "Int64",
+        "last_upd": "DateTime64(3)",
+        "last_sync": "Nullable(DateTime64(3))"
+    },
+    "vw_calendario_rotas": {
+        "__doc__": "Calendário por rota comercial. Indica quantas semanas cada rota teve atividade no mês e quantas semanas foram efetivamente trabalhadas. Usado para calcular cobertura e frequência de visitas por rota. JOIN: id_rota → vw_rotas.id_rota. Complementa vw_calendario com a dimensão de rota.",
+        "uid": "UUID",
+        "id_coligada": "Int64",
+        "id_rota": "Int64",
+        "ano": "Int64",
+        "mes": "Int64",
+        "semana": "Int64",
+        "semanas_mes": "Int64",
+        "semanas_trabalhadas": "Int64",
+        "is_deleted": "Int64",
+        "last_upd": "DateTime64(3)",
+        "last_sync": "Nullable(DateTime64(3))"
+    },
+    "vw_clientes": {
+        "__doc__": "Cadastro de clientes (dimensão). Contém dados cadastrais, endereço, geolocalização, segmento, grupo econômico, limites de crédito e vendedor vinculado. É a principal tabela de dimensão para análises comerciais. JOINs: id_cliente → vw_vendas_validas.id_cliente, vw_clientes_estatisticas.id_cliente, vw_clientes_rotas.id_cliente, vw_financ_cr_parcelas.id_entidade. O campo id_vendedor liga ao vendedor padrão em vw_vendedores.id_vendedor.",
+        "uid": "UUID",
+        "id_coligada": "Int64",
+        "id_cliente": "Int64",
+        "tipo_pessoa": "String",
+        "cnpjcpf": "String",
+        "nome_completo": "String",
+        "nome_abreviado": "String",
+        "sexo": "String",
+        "datanasc": "Nullable(Date)",
+        "datacadas": "Nullable(Date)",
+        "tipo_logradouro": "String",
+        "logradouro": "String",
+        "numero": "String",
+        "complemento": "String",
+        "bairro": "String",
+        "cidade": "String",
+        "uf": "String",
+        "ponto_ref": "String",
+        "latitude": "String",
+        "longitude": "String",
+        "segmento": "String",
+        "grupo_economico": "String",
+        "grupo_segmento": "String",
+        "dia_semana": "String",
+        "limitecredito_1": "Nullable(Float64)",
+        "limitecredito_2": "Nullable(Float64)",
+        "limitecredito_atraso": "Int64",
+        "id_vendedor": "Int64",
+        "is_deleted": "Int64",
+        "last_upd": "DateTime64(3)",
+        "last_sync": "Nullable(DateTime64(3))"
+    },
+    "vw_clientes_estatisticas": {
+        "__doc__": "Estatísticas consolidadas por cliente. Contém indicadores financeiros (títulos abertos/atraso, inadimplência, dias de atraso), comerciais (ticket médio, mix, compras, cobertura, positivação, efetivação) e logísticos (entregas, devoluções, CMV). Snapshot atualizado periodicamente. JOIN: id_cliente → vw_clientes.id_cliente. Ideal para dashboards de saúde da carteira, análise de inadimplência e ranking de clientes.",
+        "uid": "UUID",
+        "id_coligada": "Int64",
+        "id_cliente": "Int64",
+        "titulos_aberto": "Int64",
+        "titulos_atraso": "Int64",
+        "valor_aberto": "Nullable(Float64)",
+        "valor_atraso": "Nullable(Float64)",
+        "valor_aberto_orig": "Nullable(Float64)",
+        "inadimplencia": "Nullable(Float64)",
+        "dias_atraso": "Int64",
+        "media_atraso": "Nullable(Float64)",
+        "cartorio": "Int64",
+        "ultimo_venc": "Nullable(Date)",
+        "data_titulo_mais_antigo": "Nullable(Date)",
+        "data_cadastro": "Nullable(Date)",
+        "data_upd_cob": "Nullable(Date)",
+        "valor_ultima_compra": "Nullable(Float64)",
+        "data_ultima_compra": "Nullable(Date)",
+        "ultimo_pag_valor": "Nullable(Float64)",
+        "ultimo_pag_data": "Nullable(Date)",
+        "ticket_medio": "Nullable(Float64)",
+        "ticket_medio_geral": "Nullable(Float64)",
+        "mix": "Nullable(Float64)",
+        "compras": "Int64",
+        "compras_geral": "Int64",
+        "total_compras": "Nullable(Float64)",
+        "potencial_setor": "Nullable(Float64)",
+        "potencial_rota": "Nullable(Float64)",
+        "coberto_mix": "Int64",
+        "coberto_especial": "Int64",
+        "coberto": "UInt8",
+        "efetivacao": "Int64",
+        "entregues": "Int64",
+        "efetiv_entrega": "Nullable(Float64)",
+        "devolucoes": "Int64",
+        "indice_devolucoes": "Nullable(Float64)",
+        "canceladas": "Int64",
+        "cmv_geral": "Nullable(Float64)",
+        "cmv_real": "Nullable(Float64)",
+        "custo_entrega_geral": "Nullable(Float64)",
+        "custo_entrega_real": "Nullable(Float64)",
+        "lucratividade": "Nullable(Float64)",
+        "titulos_aberto_custom": "Int64",
+        "titulos_atraso_custom": "Int64",
+        "acompanhamento": "Int64",
+        "is_deleted": "Int64",
+        "last_upd": "DateTime64(3)",
+        "last_sync": "Nullable(DateTime64(3))"
+    },
+    "vw_clientes_rotas": {
+        "__doc__": "Tabela associativa N:N entre clientes e rotas. Um cliente pode estar em várias rotas e uma rota atende vários clientes. Essencial para análises de cobertura geográfica e frequência de visitas. JOINs: id_cliente → vw_clientes.id_cliente | id_rota → vw_rotas.id_rota. Usar para filtrar vendas por rota ou calcular quantos clientes uma rota possui.",
+        "uid": "UUID",
+        "id_coligada": "Int64",
+        "id_cliente": "Int64",
+        "id_rota": "Int64",
+        "is_deleted": "Int64",
+        "last_upd": "DateTime64(3)",
+        "last_sync": "Nullable(DateTime64(3))"
+    },
+    "vw_custos": {
+        "__doc__": "Custos de aquisição e reposição por produto. Contém composição detalhada: valor de compra, frete, IPI, ICMS-ST, PIS/COFINS (crédito e débito), ICMS, IRPJ e comissão. O campo 'atual' (UInt8) indica se é o custo vigente (1) ou histórico (0). JOIN: id_produto → vw_produtos.id_produto. Usado para calcular margem de lucro, CMV e análises de precificação. Filtrar com atual = 1 para custo corrente.",
+        "uid": "UUID",
+        "id_coligada": "Int64",
+        "id_empresa": "Int64",
+        "id_custo": "Int64",
+        "id_produto": "Int64",
+        "data_custo": "Nullable(Date)",
+        "valor_compra": "Nullable(Float64)",
+        "valor_frete": "Nullable(Float64)",
+        "ipi": "Nullable(Float64)",
+        "icms_st": "Nullable(Float64)",
+        "valor_custo_aquisicao": "Nullable(Float64)",
+        "pis_credito": "Nullable(Float64)",
+        "cofins_credito": "Nullable(Float64)",
+        "icms_credito": "Nullable(Float64)",
+        "pis_debito": "Nullable(Float64)",
+        "cofins_debito": "Nullable(Float64)",
+        "icms_pf_debito": "Nullable(Float64)",
+        "icms_pj_debito": "Nullable(Float64)",
+        "valor_custo_reposicao": "Nullable(Float64)",
+        "irpj": "Nullable(Float64)",
+        "comissao": "Nullable(Float64)",
+        "atual": "UInt8",
+        "is_deleted": "Int64",
+        "last_upd": "DateTime64(3)",
+        "last_sync": "Nullable(DateTime64(3))"
+    },
+    "vw_empresas": {
+        "__doc__": "Cadastro de empresas (filiais) do grupo. Cada empresa tem CNPJ próprio e pode ser uma filial de distribuição, fábrica, etc. O campo id_coligada agrupa empresas do mesmo grupo econômico. JOIN: id_empresa → vw_vendas_validas.id_empresa, vw_produtos.id_empresa, vw_estoque_operacoes.id_empresa, vw_financ_*.id_empresa. Usado como filtro dimensional em praticamente todas as análises.",
+        "uid": "UUID",
+        "id_coligada": "Int64",
+        "id_empresa": "Int64",
+        "razao_social": "String",
+        "nome_fantasia": "String",
+        "cnpj": "String",
+        "inscricao_estadual": "String",
+        "inscricao_municipal": "String",
+        "simples_nacional": "Int64",
+        "endereco": "String",
+        "latitude": "String",
+        "longitude": "String",
+        "is_deleted": "Int64",
+        "last_upd": "DateTime64(3)",
+        "last_sync": "Nullable(DateTime64(3))"
+    },
+    "vw_estoque_operacoes": {
+        "__doc__": "Movimentações de estoque (entradas, saídas, transferências, ajustes). Cada linha é uma operação com produto, quantidade, custo e tipo de operação. O campo 'operacao' indica a direção (entrada/saída) e 'estorno' indica reversão. Pode vincular a vendas (id_venda), notas fiscais (id_nota_fiscal) e cargas (id_carga). JOIN: id_produto → vw_produtos.id_produto | id_empresa → vw_empresas.id_empresa. Usado para saldo de estoque, giro, e rastreabilidade de movimentações.",
+        "uid": "UUID",
+        "id_coligada": "Int64",
+        "id_empresa": "Int64",
+        "descricao_estoque": "String",
+        "apelido_usuario": "String",
+        "descricao_tipo_operacao": "String",
+        "id_produto": "Int64",
+        "unidade": "String",
+        "unidade_original": "String",
+        "id_pedido": "Int64",
+        "id_venda": "Int64",
+        "id_nota_fiscal": "Int64",
+        "id_carga": "Int64",
+        "id_operacao": "Int64",
+        "data_operacao": "Nullable(Date)",
+        "hora_operacao": "String",
+        "historico": "String",
+        "quantidade": "Nullable(Float64)",
+        "fator": "Nullable(Float64)",
+        "custo": "Nullable(Float64)",
+        "operacao": "Int64",
+        "estorno": "UInt8",
+        "is_deleted": "UInt8",
+        "last_upd": "DateTime64(3)",
+        "last_sync": "Nullable(DateTime64(3))"
+    },
+    "vw_financ_cp_parcelas": {
+        "__doc__": "Contas a Pagar — parcelas. Cada linha é uma parcela com valor original, corrigido, pago, juros, multa, desconto, datas (lançamento, vencimento, pagamento) e status/situação. Inclui categoria (plano de contas) e centro de custo. JOIN: id_empresa → vw_empresas.id_empresa | id_entidade → vw_fornecedores.id_entidade | id_plano_contas → vw_plano_contas.id_plano_contas. Pode vincular a venda (id_venda) e nota fiscal (id_nota_fiscal). Usado para dashboards financeiros: fluxo de caixa, aging de pagáveis, DRE por categoria.",
+        "uid": "UUID",
+        "id_coligada": "Int64",
+        "id_empresa": "Int64",
+        "id_conta_pagar": "Int64",
+        "id_parcela": "Int64",
+        "id_parcela_pai": "Int64",
+        "numero_parcela": "Int64",
+        "id_entidade": "Int64",
+        "id_plano_contas": "Int64",
+        "id_centro_custo": "Int64",
+        "id_venda": "Int64",
+        "id_nota_fiscal": "Int64",
+        "tipo_documento": "String",
+        "numero_documento": "String",
+        "valor_original": "Nullable(Float64)",
+        "valor_corrigido": "Nullable(Float64)",
+        "valor_pago": "Nullable(Float64)",
+        "juros": "Nullable(Float64)",
+        "multa": "Nullable(Float64)",
+        "desconto": "Nullable(Float64)",
+        "outros_acrescimos": "Nullable(Float64)",
+        "data_lancamento": "Nullable(Date)",
+        "data_vencimento": "Nullable(Date)",
+        "data_pagamento": "Nullable(Date)",
+        "data_estorno": "Nullable(Date)",
+        "forma_pagamento": "String",
+        "historico": "String",
+        "observacao": "String",
+        "descricao_categoria": "String",
+        "descricao_centro_custo": "String",
+        "status": "Nullable(String)",
+        "situacao": "Nullable(String)",
+        "is_deleted": "Int64",
+        "last_upd": "DateTime64(3)",
+        "last_sync": "Nullable(DateTime64(3))"
+    },
+    "vw_financ_cr_parcelas": {
+        "__doc__": "Contas a Receber — parcelas. Mesma estrutura do CP mas para recebíveis. Inclui campo is_bonif (bonificação) e data_pagamento_process. O campo status é numérico e situacao é texto descritivo. JOIN: id_empresa → vw_empresas.id_empresa | id_entidade → vw_clientes.id_cliente | id_plano_contas → vw_plano_contas.id_plano_contas | id_venda → vw_vendas_validas.id_venda. Usado para aging de recebíveis, inadimplência, previsão de caixa e conciliação com vendas.",
+        "uid": "UUID",
+        "id_coligada": "Int64",
+        "id_empresa": "Int64",
+        "id_conta_pagar": "Int64",
+        "id_parcela": "Int64",
+        "id_parcela_pai": "Int64",
+        "numero_parcela": "Int64",
+        "id_entidade": "Int64",
+        "id_plano_contas": "Int64",
+        "id_centro_custo": "Int64",
+        "id_venda": "Int64",
+        "tipo_documento": "String",
+        "numero_documento": "String",
+        "valor_original": "Nullable(Float64)",
+        "valor_corrigido": "Nullable(Float64)",
+        "valor_pago": "Nullable(Float64)",
+        "juros": "Nullable(Float64)",
+        "multa": "Nullable(Float64)",
+        "desconto": "Nullable(Float64)",
+        "outros_acrescimos": "Nullable(Float64)",
+        "data_lancamento": "Nullable(Date)",
+        "data_vencimento": "Nullable(Date)",
+        "data_pagamento": "Nullable(Date)",
+        "data_pagamento_process": "Nullable(Date)",
+        "forma_pagamento": "String",
+        "historico": "String",
+        "observacao": "String",
+        "descricao_categoria": "String",
+        "descricao_centro_custo": "String",
+        "status": "Int64",
+        "situacao": "String",
+        "is_bonif": "Int64",
+        "is_deleted": "Int64",
+        "last_upd": "DateTime64(3)",
+        "last_sync": "Nullable(DateTime64(3))"
+    },
+    "vw_financ_mov_contas": {
+        "__doc__": "Movimentações financeiras (caixa/bancos). Cada linha é um lançamento com valor, operação (entrada/saída), tipo, descrição e vínculos com CR/CP e transferências. Registra o usuário responsável e rota (para caixas de rota). JOIN: id_empresa → vw_empresas.id_empresa | id_plano_contas → vw_plano_contas.id_plano_contas | id_entidade → vw_clientes ou vw_fornecedores | id_conta_receber → vw_financ_cr_parcelas | id_conta_pagar → vw_financ_cp_parcelas. Usado para fluxo de caixa realizado, extrato bancário e conciliação.",
+        "uid": "UUID",
+        "id_coligada": "Int64",
+        "id_empresa": "Int64",
+        "id_usuario": "Int64",
+        "apelido_usuario": "String",
+        "id_plano_contas": "Int64",
+        "id_entidade": "Int64",
+        "id_movimento": "Int64",
+        "numero_documento": "String",
+        "data_movimento": "Nullable(Date)",
+        "hora_movimento": "String",
+        "descricao": "String",
+        "valor": "Nullable(Float64)",
+        "operacao": "Int64",
+        "historico": "String",
+        "data_lancamento": "Nullable(Date)",
+        "hora_lancamento": "String",
+        "tipo": "Int64",
+        "descricao_tipo": "String",
+        "id_conta_receber": "Int64",
+        "id_conta_pagar": "Int64",
+        "id_transf_contas": "Int64",
+        "id_rota": "Int64",
+        "id_funcionario": "Int64",
+        "is_deleted": "Int64",
+        "last_upd": "DateTime64(3)",
+        "last_sync": "Nullable(DateTime64(3))"
+    },
+    "vw_fornecedores": {
+        "__doc__": "Cadastro de fornecedores (dimensão). Contém dados cadastrais, CNPJ/CPF, cidade e flags especiais (transportador, produtor rural, contador). O campo id_plano_contas_padrao indica a categoria padrão para lançamentos financeiros deste fornecedor. JOIN: id_entidade → vw_financ_cp_parcelas.id_entidade | id_fornecedor é o código interno. O campo 'fornecedor' em vw_produtos e vw_vendas_validas é o nome textual (não FK numérica). Usado para análises de compras, fornecedores por categoria e aging de pagáveis.",
+        "uid": "UUID",
+        "id_coligada": "Int64",
+        "id_entidade": "Int64",
+        "id_fornecedor": "Int64",
+        "nome_completo": "String",
+        "email": "String",
+        "cnpjcpf": "String",
+        "cnpjcpf_formatado": "String",
+        "cidade": "String",
+        "transportador": "Int64",
+        "funrural": "Nullable(Float64)",
+        "produtor_rural": "UInt8",
+        "contador": "UInt8",
+        "id_plano_contas_padrao": "Int64",
+        "is_deleted": "Int64",
+        "last_upd": "DateTime64(3)",
+        "last_sync": "Nullable(DateTime64(3))"
+    },
+    "vw_metas": {
+        "__doc__": "Cabeçalho das metas comerciais. Define metas por empresa, ano, mês e tipo. É o registro mestre — os detalhes por produto/vendedor/rota estão em vw_metas_produtos. JOIN: id_meta → vw_metas_produtos.id_meta | id_empresa → vw_empresas.id_empresa. Usado para dashboards de acompanhamento de metas: faturamento vs meta, ranking de vendedores vs objetivo.",
+        "uid": "UUID",
+        "id_coligada": "Int64",
+        "id_empresa": "Int64",
+        "id_meta": "Int64",
+        "descricao": "String",
+        "ano": "Int64",
+        "mes": "Int64",
+        "tipo": "Int64",
+        "is_deleted": "Int64",
+        "last_upd": "DateTime64(3)",
+        "last_sync": "Nullable(DateTime64(3))"
+    },
+    "vw_metas_produtos": {
+        "__doc__": "Detalhamento das metas por produto, rota e vendedor. Cada linha define metas de faturamento, volume, positivação, cobertura e visitas para uma combinação específica. O campo tipo_meta indica a granularidade. JOIN: id_meta → vw_metas.id_meta | id_produto → vw_produtos.id_produto | id_vendedor → vw_vendedores.id_vendedor | id_rota → vw_rotas.id_rota. Cruzar com vw_vendas_validas para calcular atingimento (realizado vs meta).",
+        "uid": "UUID",
+        "id_coligada": "Int64",
+        "id_meta": "Int64",
+        "id_produto": "Int64",
+        "id_rota": "Int64",
+        "id_vendedor": "Int64",
+        "id_meta_familia": "Int64",
+        "id_meta_produto": "Int64",
+        "meta_faturamento": "Nullable(Float64)",
+        "meta_volume": "Nullable(Float64)",
+        "meta_positivacao": "Nullable(Float64)",
+        "meta_cobertura": "Nullable(Float64)",
+        "visitas": "Int64",
+        "atualizado": "UInt8",
+        "is_deleted": "Int64",
+        "last_upd": "DateTime64(3)",
+        "last_sync": "Nullable(DateTime64(3))",
+        "tipo_meta": "String"
+    },
+    "vw_plano_contas": {
+        "__doc__": "Plano de contas contábil/gerencial (dimensão hierárquica). Estrutura em árvore com id_pai indicando o nível superior. O campo 'der' indica se é Despesa/Receita. O código (codigo_plano_contas) segue formatação hierárquica (ex: 1.01.003). JOIN: id_plano_contas → vw_financ_cp_parcelas.id_plano_contas, vw_financ_cr_parcelas.id_plano_contas, vw_financ_mov_contas.id_plano_contas. Usado para DRE, classificação de receitas/despesas e análise por categoria financeira.",
+        "uid": "UUID",
+        "id_coligada": "Int64",
+        "id_empresa": "Int64",
+        "id_plano_contas": "Int64",
+        "codigo_plano_contas": "String",
+        "nome": "String",
+        "descricao": "String",
+        "id_pai": "Int64",
+        "ativo": "Int64",
+        "der": "Int64",
+        "is_deleted": "Int64",
+        "last_upd": "DateTime64(3)",
+        "last_sync": "Nullable(DateTime64(3))"
+    },
+    "vw_produtos": {
+        "__doc__": "Cadastro de produtos (dimensão). Hierarquia: fornecedor → seção → grupo → subgrupo. Contém marca, código de barras, referência, unidade, fator de venda/unidade e preços (compra, custo última entrada, venda). Campo 'ativo' indica status. JOIN: id_produto → vw_vendas_validas.id_produto, vw_custos.id_produto, vw_estoque_operacoes.id_produto, vw_metas_produtos.id_produto, vw_produtos_precos_detalhes.id_produto. A principal dimensão de produto para todas as análises comerciais e de estoque.",
+        "uid": "UUID",
+        "id_coligada": "Int64",
+        "id_empresa": "Int64",
+        "id_produto": "Int64",
+        "fornecedor": "String",
+        "secao": "String",
+        "grupo": "String",
+        "subgrupo": "String",
+        "tipo_produto": "String",
+        "codigo_fiscal": "String",
+        "codigo_barras": "String",
+        "referencia": "String",
+        "marca": "String",
+        "descricao": "String",
+        "unidade": "String",
+        "fator_venda": "Nullable(Float64)",
+        "fator_unidade": "Nullable(Float64)",
+        "preco_compra": "Nullable(Float64)",
+        "custo_ultima_entrada": "Nullable(Float64)",
+        "preco_venda": "Nullable(Float64)",
+        "ativo": "String",
+        "periodo_cobertura": "Int64",
+        "is_deleted": "Int64",
+        "last_upd": "DateTime64(3)",
+        "last_sync": "Nullable(DateTime64(3))"
+    },
+    "vw_produtos_precos_detalhes": {
+        "__doc__": "Preços por tabela de preço e produto. Cada produto pode ter preços em múltiplas tabelas (ex: tabela padrão, atacado, promoção). O campo tabela_padrao indica a tabela principal. Inclui quantidade mínima para aplicação do preço. JOIN: id_produto → vw_produtos.id_produto | id_tabela_preco → vw_vendas_validas.id_tabela_preco. Usado para análise de política de preços, desconto médio vs tabela e margem por tabela.",
+        "uid": "UUID",
+        "id_coligada": "Int64",
+        "id_empresa": "Int64",
+        "id_produto": "Int64",
+        "id_tabela_preco": "Int64",
+        "descricao_tabela": "String",
+        "tabela_padrao": "UInt8",
+        "preco_ativo": "Int64",
+        "preco_venda": "Nullable(Float64)",
+        "quantidade_minima": "Nullable(Float64)",
+        "is_deleted": "Int64",
+        "last_upd": "DateTime64(3)",
+        "last_sync": "Nullable(DateTime64(3))"
+    },
+    "vw_rotas": {
+        "__doc__": "Cadastro de rotas comerciais (dimensão). A rota representa um dia de visita/entrega: cada rota é um dia da semana atribuído a uma região geográfica. Hierarquia: região → área → zona → setor → rota. O campo dia_semana indica o dia (1=segunda..7=domingo). Um vendedor atende múltiplas rotas (vw_rotas_vendedores) e cada rota tem múltiplos clientes (vw_clientes_rotas). JOIN: id_rota → vw_vendas_validas.id_rota, vw_clientes_rotas.id_rota, vw_rotas_vendedores.id_rota, vw_metas_produtos.id_rota, vw_calendario_rotas.id_rota.",
+        "uid": "UUID",
+        "id_coligada": "Int64",
+        "id_rota": "Int64",
+        "estrutura": "String",
+        "regiao": "Int64",
+        "area": "String",
+        "zona": "Int64",
+        "setor": "Int64",
+        "rota": "Int64",
+        "dia_semana": "Int64",
+        "ativo": "Int64",
+        "is_deleted": "Int64",
+        "last_upd": "DateTime64(3)",
+        "last_sync": "Nullable(DateTime64(3))"
+    },
+    "vw_rotas_vendedores": {
+        "__doc__": "Tabela associativa N:N entre rotas e vendedores. Um vendedor pode atender várias rotas e uma rota pode ter vários vendedores (ex: titular e substituto). JOIN: id_rota → vw_rotas.id_rota | id_vendedor → vw_vendedores.id_vendedor. Usar para descobrir quais rotas um vendedor atende ou quais vendedores cobrem uma rota.",
+        "uid": "UUID",
+        "id_coligada": "Int64",
+        "id_rota": "Int64",
+        "id_vendedor": "Int64",
+        "is_deleted": "Int64",
+        "last_upd": "DateTime64(3)",
+        "last_sync": "Nullable(DateTime64(3))"
+    },
+    "vw_vendedores": {
+        "__doc__": "Cadastro de vendedores (dimensão). Contém nome, CPF/CNPJ, email, telefone e status (ativo). JOIN: id_vendedor → vw_vendas_validas.id_vendedor, vw_clientes.id_vendedor, vw_rotas_vendedores.id_vendedor, vw_metas_produtos.id_vendedor. Principal dimensão para análises de desempenho comercial: ranking de vendedores, meta vs realizado, carteira por vendedor.",
+        "uid": "UUID",
+        "id_coligada": "Int64",
+        "id_vendedor": "Int64",
+        "nome_completo": "String",
+        "nome_abreviado": "String",
+        "cnpjcpf": "String",
+        "email": "String",
+        "telefone": "String",
+        "ativo": "Int64",
+        "datacadas": "Nullable(Date)",
+        "is_deleted": "Int64",
+        "last_upd": "DateTime64(3)",
+        "last_sync": "Nullable(DateTime64(3))"
+    },
+    "vw_positivacao_semanal_cliente": {
+        "__doc__": "Positivação semanal por cliente. View materializada que indica se o cliente comprou (1) ou não (0) em cada semana do ano (semana1..semana53). Inclui totais e percentual de frequência. Contém dados geográficos da rota (região, zona, área, setor, rota). JOIN: id_cliente → vw_clientes.id_cliente. Usado para análise de frequência de compra, regularidade da carteira e cobertura semanal. Variantes: _fornecedor, _grupo, _produto, _secao, _subgrupo adicionam dimensões de produto.",
+        "id_coligada": "Int64",
+        "id_empresa": "Int64",
+        "ano": "Int64",
+        "id_cliente": "Int64",
+        "regiao": "Int64",
+        "zona": "Int64",
+        "area": "String",
+        "setor": "Int64",
+        "rota": "Int64",
+        "semana1": "UInt8",
+        "semana2": "UInt8",
+        "semana3": "UInt8",
+        "semana4": "UInt8",
+        "semana5": "UInt8",
+        "semana6": "UInt8",
+        "semana7": "UInt8",
+        "semana8": "UInt8",
+        "semana9": "UInt8",
+        "semana10": "UInt8",
+        "semana11": "UInt8",
+        "semana12": "UInt8",
+        "semana13": "UInt8",
+        "semana14": "UInt8",
+        "semana15": "UInt8",
+        "semana16": "UInt8",
+        "semana17": "UInt8",
+        "semana18": "UInt8",
+        "semana19": "UInt8",
+        "semana20": "UInt8",
+        "semana21": "UInt8",
+        "semana22": "UInt8",
+        "semana23": "UInt8",
+        "semana24": "UInt8",
+        "semana25": "UInt8",
+        "semana26": "UInt8",
+        "semana27": "UInt8",
+        "semana28": "UInt8",
+        "semana29": "UInt8",
+        "semana30": "UInt8",
+        "semana31": "UInt8",
+        "semana32": "UInt8",
+        "semana33": "UInt8",
+        "semana34": "UInt8",
+        "semana35": "UInt8",
+        "semana36": "UInt8",
+        "semana37": "UInt8",
+        "semana38": "UInt8",
+        "semana39": "UInt8",
+        "semana40": "UInt8",
+        "semana41": "UInt8",
+        "semana42": "UInt8",
+        "semana43": "UInt8",
+        "semana44": "UInt8",
+        "semana45": "UInt8",
+        "semana46": "UInt8",
+        "semana47": "UInt8",
+        "semana48": "UInt8",
+        "semana49": "UInt8",
+        "semana50": "UInt8",
+        "semana51": "UInt8",
+        "semana52": "UInt8",
+        "semana53": "UInt8",
+        "total_semanas_compradas": "UInt64",
+        "percentual_frequencia": "Float64"
+    },
+    "vw_positivacao_semanal_fornecedor": {
+        "__doc__": "Positivação semanal por cliente + fornecedor. Indica se o cliente comprou produtos de determinado fornecedor em cada semana. Útil para medir penetração de marcas/fornecedores na carteira. Mesma estrutura de semana1..semana53 que vw_positivacao_semanal_cliente, com adição da dimensão fornecedor (texto).",
+        "id_coligada": "Int64",
+        "id_empresa": "Int64",
+        "ano": "Int64",
+        "id_cliente": "Int64",
+        "regiao": "Int64",
+        "zona": "Int64",
+        "area": "String",
+        "setor": "Int64",
+        "rota": "Int64",
+        "fornecedor": "String",
+        "semana1": "UInt8",
+        "semana2": "UInt8",
+        "semana3": "UInt8",
+        "semana4": "UInt8",
+        "semana5": "UInt8",
+        "semana6": "UInt8",
+        "semana7": "UInt8",
+        "semana8": "UInt8",
+        "semana9": "UInt8",
+        "semana10": "UInt8",
+        "semana11": "UInt8",
+        "semana12": "UInt8",
+        "semana13": "UInt8",
+        "semana14": "UInt8",
+        "semana15": "UInt8",
+        "semana16": "UInt8",
+        "semana17": "UInt8",
+        "semana18": "UInt8",
+        "semana19": "UInt8",
+        "semana20": "UInt8",
+        "semana21": "UInt8",
+        "semana22": "UInt8",
+        "semana23": "UInt8",
+        "semana24": "UInt8",
+        "semana25": "UInt8",
+        "semana26": "UInt8",
+        "semana27": "UInt8",
+        "semana28": "UInt8",
+        "semana29": "UInt8",
+        "semana30": "UInt8",
+        "semana31": "UInt8",
+        "semana32": "UInt8",
+        "semana33": "UInt8",
+        "semana34": "UInt8",
+        "semana35": "UInt8",
+        "semana36": "UInt8",
+        "semana37": "UInt8",
+        "semana38": "UInt8",
+        "semana39": "UInt8",
+        "semana40": "UInt8",
+        "semana41": "UInt8",
+        "semana42": "UInt8",
+        "semana43": "UInt8",
+        "semana44": "UInt8",
+        "semana45": "UInt8",
+        "semana46": "UInt8",
+        "semana47": "UInt8",
+        "semana48": "UInt8",
+        "semana49": "UInt8",
+        "semana50": "UInt8",
+        "semana51": "UInt8",
+        "semana52": "UInt8",
+        "semana53": "UInt8",
+        "total_semanas_compradas": "UInt64",
+        "percentual_frequencia": "Float64"
+    },
+    "vw_positivacao_semanal_grupo": {
+        "__doc__": "Positivação semanal por cliente + fornecedor + seção + grupo de produto. Permite analisar se o cliente comprou produtos de um grupo específico em cada semana. Granularidade mais fina que _fornecedor e _secao. Mesma estrutura de semana1..semana53.",
+        "id_coligada": "Int64",
+        "id_empresa": "Int64",
+        "ano": "Int64",
+        "id_cliente": "Int64",
+        "regiao": "Int64",
+        "zona": "Int64",
+        "area": "String",
+        "setor": "Int64",
+        "rota": "Int64",
+        "fornecedor": "String",
+        "secao": "String",
+        "grupo": "String",
+        "semana1": "UInt8",
+        "semana2": "UInt8",
+        "semana3": "UInt8",
+        "semana4": "UInt8",
+        "semana5": "UInt8",
+        "semana6": "UInt8",
+        "semana7": "UInt8",
+        "semana8": "UInt8",
+        "semana9": "UInt8",
+        "semana10": "UInt8",
+        "semana11": "UInt8",
+        "semana12": "UInt8",
+        "semana13": "UInt8",
+        "semana14": "UInt8",
+        "semana15": "UInt8",
+        "semana16": "UInt8",
+        "semana17": "UInt8",
+        "semana18": "UInt8",
+        "semana19": "UInt8",
+        "semana20": "UInt8",
+        "semana21": "UInt8",
+        "semana22": "UInt8",
+        "semana23": "UInt8",
+        "semana24": "UInt8",
+        "semana25": "UInt8",
+        "semana26": "UInt8",
+        "semana27": "UInt8",
+        "semana28": "UInt8",
+        "semana29": "UInt8",
+        "semana30": "UInt8",
+        "semana31": "UInt8",
+        "semana32": "UInt8",
+        "semana33": "UInt8",
+        "semana34": "UInt8",
+        "semana35": "UInt8",
+        "semana36": "UInt8",
+        "semana37": "UInt8",
+        "semana38": "UInt8",
+        "semana39": "UInt8",
+        "semana40": "UInt8",
+        "semana41": "UInt8",
+        "semana42": "UInt8",
+        "semana43": "UInt8",
+        "semana44": "UInt8",
+        "semana45": "UInt8",
+        "semana46": "UInt8",
+        "semana47": "UInt8",
+        "semana48": "UInt8",
+        "semana49": "UInt8",
+        "semana50": "UInt8",
+        "semana51": "UInt8",
+        "semana52": "UInt8",
+        "semana53": "UInt8",
+        "total_semanas_compradas": "UInt64",
+        "percentual_frequencia": "Float64"
+    },
+    "vw_positivacao_semanal_produto": {
+        "__doc__": "Positivação semanal por cliente + produto individual. A mais granular das views de positivação — indica se o cliente comprou um produto específico em cada semana. JOIN: id_produto → vw_produtos.id_produto | id_cliente → vw_clientes.id_cliente. Útil para análise de mix de produtos por cliente e frequência de recompra de itens específicos.",
+        "id_coligada": "Int64",
+        "id_empresa": "Int64",
+        "ano": "Int64",
+        "id_cliente": "Int64",
+        "regiao": "Int64",
+        "zona": "Int64",
+        "area": "String",
+        "setor": "Int64",
+        "rota": "Int64",
+        "id_produto": "Int64",
+        "semana1": "UInt8",
+        "semana2": "UInt8",
+        "semana3": "UInt8",
+        "semana4": "UInt8",
+        "semana5": "UInt8",
+        "semana6": "UInt8",
+        "semana7": "UInt8",
+        "semana8": "UInt8",
+        "semana9": "UInt8",
+        "semana10": "UInt8",
+        "semana11": "UInt8",
+        "semana12": "UInt8",
+        "semana13": "UInt8",
+        "semana14": "UInt8",
+        "semana15": "UInt8",
+        "semana16": "UInt8",
+        "semana17": "UInt8",
+        "semana18": "UInt8",
+        "semana19": "UInt8",
+        "semana20": "UInt8",
+        "semana21": "UInt8",
+        "semana22": "UInt8",
+        "semana23": "UInt8",
+        "semana24": "UInt8",
+        "semana25": "UInt8",
+        "semana26": "UInt8",
+        "semana27": "UInt8",
+        "semana28": "UInt8",
+        "semana29": "UInt8",
+        "semana30": "UInt8",
+        "semana31": "UInt8",
+        "semana32": "UInt8",
+        "semana33": "UInt8",
+        "semana34": "UInt8",
+        "semana35": "UInt8",
+        "semana36": "UInt8",
+        "semana37": "UInt8",
+        "semana38": "UInt8",
+        "semana39": "UInt8",
+        "semana40": "UInt8",
+        "semana41": "UInt8",
+        "semana42": "UInt8",
+        "semana43": "UInt8",
+        "semana44": "UInt8",
+        "semana45": "UInt8",
+        "semana46": "UInt8",
+        "semana47": "UInt8",
+        "semana48": "UInt8",
+        "semana49": "UInt8",
+        "semana50": "UInt8",
+        "semana51": "UInt8",
+        "semana52": "UInt8",
+        "semana53": "UInt8",
+        "total_semanas_compradas": "UInt64",
+        "percentual_frequencia": "Float64"
+    },
+    "vw_positivacao_semanal_secao": {
+        "__doc__": "Positivação semanal por cliente + fornecedor + seção de produto. Indica se o cliente comprou produtos de uma seção (categoria de nível 1 da hierarquia de produtos) em cada semana. Intermediário entre _fornecedor (mais agregado) e _grupo (mais detalhado).",
+        "id_coligada": "Int64",
+        "id_empresa": "Int64",
+        "ano": "Int64",
+        "id_cliente": "Int64",
+        "regiao": "Int64",
+        "zona": "Int64",
+        "area": "String",
+        "setor": "Int64",
+        "rota": "Int64",
+        "fornecedor": "String",
+        "secao": "String",
+        "semana1": "UInt8",
+        "semana2": "UInt8",
+        "semana3": "UInt8",
+        "semana4": "UInt8",
+        "semana5": "UInt8",
+        "semana6": "UInt8",
+        "semana7": "UInt8",
+        "semana8": "UInt8",
+        "semana9": "UInt8",
+        "semana10": "UInt8",
+        "semana11": "UInt8",
+        "semana12": "UInt8",
+        "semana13": "UInt8",
+        "semana14": "UInt8",
+        "semana15": "UInt8",
+        "semana16": "UInt8",
+        "semana17": "UInt8",
+        "semana18": "UInt8",
+        "semana19": "UInt8",
+        "semana20": "UInt8",
+        "semana21": "UInt8",
+        "semana22": "UInt8",
+        "semana23": "UInt8",
+        "semana24": "UInt8",
+        "semana25": "UInt8",
+        "semana26": "UInt8",
+        "semana27": "UInt8",
+        "semana28": "UInt8",
+        "semana29": "UInt8",
+        "semana30": "UInt8",
+        "semana31": "UInt8",
+        "semana32": "UInt8",
+        "semana33": "UInt8",
+        "semana34": "UInt8",
+        "semana35": "UInt8",
+        "semana36": "UInt8",
+        "semana37": "UInt8",
+        "semana38": "UInt8",
+        "semana39": "UInt8",
+        "semana40": "UInt8",
+        "semana41": "UInt8",
+        "semana42": "UInt8",
+        "semana43": "UInt8",
+        "semana44": "UInt8",
+        "semana45": "UInt8",
+        "semana46": "UInt8",
+        "semana47": "UInt8",
+        "semana48": "UInt8",
+        "semana49": "UInt8",
+        "semana50": "UInt8",
+        "semana51": "UInt8",
+        "semana52": "UInt8",
+        "semana53": "UInt8",
+        "total_semanas_compradas": "UInt64",
+        "percentual_frequencia": "Float64"
+    },
+    "vw_positivacao_semanal_subgrupo": {
+        "__doc__": "Positivação semanal por cliente + fornecedor + seção + grupo + subgrupo. A mais detalhada das views de positivação com hierarquia de produto (antes de chegar ao SKU individual em _produto). Útil para análise de penetração de categorias na carteira de clientes.",
+        "id_coligada": "Int64",
+        "id_empresa": "Int64",
+        "ano": "Int64",
+        "id_cliente": "Int64",
+        "regiao": "Int64",
+        "zona": "Int64",
+        "area": "String",
+        "setor": "Int64",
+        "rota": "Int64",
+        "fornecedor": "String",
+        "secao": "String",
+        "grupo": "String",
+        "subgrupo": "String",
+        "semana1": "UInt8",
+        "semana2": "UInt8",
+        "semana3": "UInt8",
+        "semana4": "UInt8",
+        "semana5": "UInt8",
+        "semana6": "UInt8",
+        "semana7": "UInt8",
+        "semana8": "UInt8",
+        "semana9": "UInt8",
+        "semana10": "UInt8",
+        "semana11": "UInt8",
+        "semana12": "UInt8",
+        "semana13": "UInt8",
+        "semana14": "UInt8",
+        "semana15": "UInt8",
+        "semana16": "UInt8",
+        "semana17": "UInt8",
+        "semana18": "UInt8",
+        "semana19": "UInt8",
+        "semana20": "UInt8",
+        "semana21": "UInt8",
+        "semana22": "UInt8",
+        "semana23": "UInt8",
+        "semana24": "UInt8",
+        "semana25": "UInt8",
+        "semana26": "UInt8",
+        "semana27": "UInt8",
+        "semana28": "UInt8",
+        "semana29": "UInt8",
+        "semana30": "UInt8",
+        "semana31": "UInt8",
+        "semana32": "UInt8",
+        "semana33": "UInt8",
+        "semana34": "UInt8",
+        "semana35": "UInt8",
+        "semana36": "UInt8",
+        "semana37": "UInt8",
+        "semana38": "UInt8",
+        "semana39": "UInt8",
+        "semana40": "UInt8",
+        "semana41": "UInt8",
+        "semana42": "UInt8",
+        "semana43": "UInt8",
+        "semana44": "UInt8",
+        "semana45": "UInt8",
+        "semana46": "UInt8",
+        "semana47": "UInt8",
+        "semana48": "UInt8",
+        "semana49": "UInt8",
+        "semana50": "UInt8",
+        "semana51": "UInt8",
+        "semana52": "UInt8",
+        "semana53": "UInt8",
+        "total_semanas_compradas": "UInt64",
+        "percentual_frequencia": "Float64"
+    },
+    "vw_ficha_tecnica": {
+        "__doc__": "Cabeçalho da ficha técnica de produção. Define a receita/fórmula de fabricação de um produto: nome, quantidade base de referência e status (ativo/inativo). É o registro mestre que conecta insumos (vw_ficha_tecnica_detalhes) e produtos acabados (vw_ficha_tecnica_acabados). JOIN: ftp_id → vw_ficha_tecnica_detalhes.ftp_id, vw_ficha_tecnica_acabados.ftp_id, vw_ordem_producao_itens.ftp_id. Usado para dashboards de produção: composição de produtos, custo de receita e planejamento.",
+        "ftp_id": "Int32",
+        "ftp_descricao": "Nullable(String)",
+        "ftp_qtd_base": "Nullable(Float64)",
+        "ftp_ativo": "UInt8",
+        "ftp_id_externo": "Nullable(Int32)"
+    },
+    "vw_ficha_tecnica_detalhes": {
+        "__doc__": "Componentes (insumos/matérias-primas) de cada ficha técnica. Cada linha é um insumo necessário para produzir a receita, com quantidade e estoque de referência. Os campos ftpd_E1..ftpd_E10 e ftpd_EF são flags que indicam em qual etapa do processo produtivo o insumo é consumido. JOIN: ftp_id → vw_ficha_tecnica.ftp_id | pr_codigo → vw_produtos.id_produto. Usado para calcular custo de matéria-prima por receita e explosão de necessidades.",
+        "ftpd_id": "Int32",
+        "ftp_id": "Nullable(Int32)",
+        "pr_codigo": "Nullable(Int32)",
+        "eqt_codigo": "Nullable(Int32)",
+        "ftpd_qtd": "Nullable(Float64)",
+        "ftpd_embalagem": "UInt8",
+        "ftpd_E1": "UInt8",
+        "ftpd_E2": "UInt8",
+        "ftpd_E3": "UInt8",
+        "ftpd_E4": "UInt8",
+        "ftpd_E5": "UInt8",
+        "ftpd_E6": "UInt8",
+        "ftpd_E7": "UInt8",
+        "ftpd_E8": "UInt8",
+        "ftpd_E9": "UInt8",
+        "ftpd_E10": "UInt8",
+        "ftpd_EF": "UInt8"
+    },
+    "vw_ficha_tecnica_acabados": {
+        "__doc__": "Produtos acabados gerados por cada ficha técnica. Uma ficha pode gerar múltiplos produtos acabados (ex: cortes diferentes de uma mesma matéria-prima). Cada linha indica o produto resultante, quantidade gerada e estoque destino. JOIN: ftp_id → vw_ficha_tecnica.ftp_id | pr_codigo → vw_produtos.id_produto. Embalagens dos acabados estão em vw_ficha_tecnica_acabados_emb.",
+        "ftpa_id": "Int32",
+        "ftp_id": "Nullable(Int32)",
+        "pr_codigo": "Nullable(Int32)",
+        "eqt_codigo": "Nullable(Int32)",
+        "ftpa_qtd": "Nullable(Float64)"
+    },
+    "vw_ficha_tecnica_acabados_emb": {
+        "__doc__": "Embalagens associadas a cada produto acabado da ficha técnica. Define qual produto-embalagem é usado para acondicionar o produto acabado e o fator de conversão (ex: caixa com 12 unidades → fator 12). JOIN: ftp_id → vw_ficha_tecnica.ftp_id | pr_codigo_acabado → vw_produtos.id_produto (acabado) | pr_codigo_emb → vw_produtos.id_produto (embalagem).",
+        "ftpae_id": "Int32",
+        "ftp_id": "Nullable(Int32)",
+        "pr_codigo_acabado": "Nullable(Int32)",
+        "pr_codigo_emb": "Nullable(Int32)",
+        "ftpae_fator": "Nullable(Float64)"
+    },
+    "vw_ordem_producao": {
+        "__doc__": "Cabeçalho da Ordem de Produção (OP). Cada linha é uma OP com empresa, tipo de produção, datas (abertura, início/fim previstos) e status (0=Aberta, 1=Em Andamento, 2=Finalizada, 3=Cancelada). É o registro mestre que conecta itens a produzir (vw_ordem_producao_itens) e etapas (vw_ordem_producao_etapas). JOIN: opr_id → vw_ordem_producao_itens.opr_id, vw_ordem_producao_etapas.opr_id | em_codigo → vw_empresas.id_empresa. Usado para dashboards de produção: acompanhamento de OPs, lead time, volume produzido.",
+        "opr_id": "Int32",
+        "em_codigo": "Nullable(Int32)",
+        "tp_producao": "Nullable(Int32)",
+        "opr_data": "Nullable(DateTime)",
+        "opr_di": "Nullable(DateTime)",
+        "opr_df": "Nullable(DateTime)",
+        "opr_status": "Nullable(Int16) -- 0=Aberta 1=Em Andamento 2=Finalizada 3=Cancelada",
+        "opr_obs": "Nullable(String)"
+    },
+    "vw_ordem_producao_etapas": {
+        "__doc__": "Etapas de execução de cada item da OP. Registra o avanço real da produção: funcionário responsável, datas início/fim reais, quantidade processada, lote e validade. Os campos opre_E1..opre_E10 e opre_EF são flags dos estágios produtivos (mesma lógica da ficha técnica). JOIN: opri_id → vw_ordem_producao_itens.opri_id | opr_id → vw_ordem_producao.opr_id | ftp_id → vw_ficha_tecnica.ftp_id | pr_codigo → vw_produtos.id_produto. Equipamentos usados nas etapas estão em vw_ordem_producao_etapas_equip.",
+        "opre_id": "Int32",
+        "opri_id": "Nullable(Int32)",
+        "opr_id": "Nullable(Int32)",
+        "fu_codigo": "Nullable(Int32)",
+        "pr_codigo": "Nullable(Int32)",
+        "pre_id": "Nullable(Int32)",
+        "ftp_id": "Nullable(Int32)",
+        "un_sigla": "Nullable(String)",
+        "opre_di": "Nullable(DateTime)",
+        "opre_df": "Nullable(DateTime)",
+        "opre_qtd": "Nullable(Int32)",
+        "opre_lote": "Nullable(String)",
+        "opre_lote_validade": "Nullable(DateTime)",
+        "opre_finalizada": "UInt8",
+        "opre_ultima": "UInt8",
+        "opre_horas": "Nullable(Int32)",
+        "opre_E1": "UInt8",
+        "opre_E2": "UInt8",
+        "opre_E3": "UInt8",
+        "opre_E4": "UInt8",
+        "opre_E5": "UInt8",
+        "opre_E6": "UInt8",
+        "opre_E7": "UInt8",
+        "opre_E8": "UInt8",
+        "opre_E9": "UInt8",
+        "opre_E10": "UInt8",
+        "opre_EF": "UInt8"
+    },
+    "vw_ordem_producao_etapas_equip": {
+        "__doc__": "Equipamentos utilizados em cada etapa da OP. Registra qual equipamento (patrimônio) foi alocado e quantas horas foi utilizado. JOIN: opre_id → vw_ordem_producao_etapas.opre_id. Usado para análise de utilização de equipamentos, custo-hora-máquina e planejamento de capacidade produtiva.",
+        "opreq_id": "Int32",
+        "opre_id": "Nullable(Int32)",
+        "peq_id": "Nullable(Int32)",
+        "opreq_horas": "Nullable(Int32)"
+    },
+    "vw_ordem_producao_itens": {
+        "__doc__": "Produtos a produzir dentro de cada OP. Cada linha é um item com ficha técnica vinculada, quantidades (planejada, prevista, real), custo e status (finalizado/cancelado). JOIN: opr_id → vw_ordem_producao.opr_id | pr_codigo → vw_produtos.id_produto | ftp_id → vw_ficha_tecnica.ftp_id. Componentes consumidos por cada item estão em vw_ordem_producao_itens_comp. Etapas de execução em vw_ordem_producao_etapas.",
+        "opri_id": "Int32",
+        "opr_id": "Nullable(Int32)",
+        "pr_codigo": "Nullable(Int32)",
+        "ftp_id": "Nullable(Int32)",
+        "un_sigla": "Nullable(String)",
+        "opri_qtd": "Nullable(Float64)",
+        "opri_qtd_prevista": "Nullable(Float64)",
+        "opri_qtd_real": "Nullable(Float64)",
+        "opri_custo": "Nullable(Float64)",
+        "opri_finalizado": "UInt8",
+        "opri_cancelado": "UInt8",
+        "opri_remessas": "Nullable(Int32)"
+    },
+    "vw_ordem_producao_itens_comp": {
+        "__doc__": "Componentes (matérias-primas) efetivamente consumidos por item da OP. Detalha quantidade prevista vs real, custo, perda percentual e saldo de estoque no momento. Flags classificam o componente: principal, opcional, subproduto ou embalagem. JOIN: opri_id → vw_ordem_producao_itens.opri_id | pr_codigo → vw_produtos.id_produto. Usado para análise de consumo real vs planejado, desperdício e custo efetivo de produção.",
+        "opric_id": "Int32",
+        "opri_id": "Int32",
+        "pr_codigo": "Nullable(Int32)",
+        "eqt_codigo": "Nullable(Int32)",
+        "un_sigla": "Nullable(String)",
+        "opric_qtd": "Nullable(Float64)",
+        "opric_qtd_un": "Nullable(Float64)",
+        "opric_qtd_real": "Nullable(Float64)",
+        "opric_custo": "Nullable(Float64)",
+        "opric_perda_perc": "Nullable(Float64)",
+        "opric_estoque": "Nullable(Float64)",
+        "opric_em_uso": "UInt8",
+        "opric_principal": "UInt8",
+        "opric_opcional": "UInt8",
+        "opric_subproduto": "UInt8",
+        "opric_embalagem": "UInt8"
+    },
+    "vw_vendas_validas": {
+        "__doc__": "View principal de vendas (fato). Cada linha é um ITEM de venda (não um pedido — um pedido tem vários itens). Contém dados completos: datas (venda, fatura, entrega, fechamento), valores (unitário, tabela, custo, total), quantidades, desconto/acréscimo e status (1=ABERTO, 2=FATURADO, 3=ENTREGA, 4=FECHADO, 12=CANCELADO — vendas faturadas: status IN 2,3,4). Já traz desnormalizados: dados do produto (fornecedor, seção, grupo, subgrupo, marca, descrição), da rota (região, área, zona, setor, rota), nomes do cliente e vendedor. JOINs: id_cliente → vw_clientes.id_cliente | id_vendedor → vw_vendedores.id_vendedor | id_rota → vw_rotas.id_rota | id_produto → vw_produtos.id_produto | id_empresa → vw_empresas.id_empresa. É a tabela fato central para todas as análises comerciais.",
+        "uid": "UUID",
+        "id_coligada": "Int64",
+        "id_empresa": "Int64",
+        "id_item": "Int64",
+        "id_venda": "Int64",
+        "ano": "Int64",
+        "semana": "Int64",
+        "data_venda": "Nullable(Date)",
+        "hora_venda": "String",
+        "data_fatura": "Nullable(Date)",
+        "data_fatura_process": "Nullable(Date)",
+        "hora_fatura_process": "String",
+        "data_entrega": "Nullable(Date)",
+        "data_final": "Nullable(Date)",
+        "hora_final": "String",
+        "desconto": "Nullable(Float64)",
+        "acrescimo": "Nullable(Float64)",
+        "bonif": "Int64",
+        "troca": "UInt8",
+        "status": "Int64 -- 1=ABERTO | 2=FATURADO | 3=ENTREGA | 4=FECHADO | 12=CANCELADO | vendas faturadas = status IN (2,3,4)",
+        "id_pedido": "Int64",
+        "id_cliente": "Int64",
+        "id_vendedor": "Int64",
+        "id_rota": "Int64",
+        "limite_credito_1": "Nullable(Float64)",
+        "limite_credito_2": "Nullable(Float64)",
+        "limite_credito_atraso": "Int64",
+        "id_produto": "Int64",
+        "saldo_estoque": "Nullable(Float64)",
+        "quantidade": "Nullable(Float64)",
+        "valor_unitario": "Nullable(Float64)",
+        "preco_tabela": "Nullable(Float64)",
+        "custo_ultima_entrada": "Nullable(Float64)",
+        "custo_boleto": "Nullable(Float64)",
+        "rateio_item": "Nullable(Float64)",
+        "valor_total": "Nullable(Float64)",
+        "id_tabela_preco": "Int64",
+        "is_deleted": "Int64",
+        "fornecedor": "String",
+        "secao": "String",
+        "grupo": "String",
+        "subgrupo": "String",
+        "marca": "String",
+        "descricao_produto": "String",
+        "regiao": "Int64",
+        "area": "String",
+        "zona": "Int64",
+        "setor": "Int64",
+        "rota": "Int64",
+        "nome_completo_cliente": "String",
+        "nome_abreviado_cliente": "String",
+        "nome_vendedor": "String"
+    },
+    "vw_base_agrolog": {
+        "__doc__": "Dados de movimentação agrológica (base_agrolog). Cada linha representa um movimento de produto agrícola com código, descrição, categoria/subcategoria, fornecedor, localização (cidade/estado), data, quantidade, valores unitário e total, e status. Útil para dashboards de agronegócio: faturamento por categoria, ranking de fornecedores, análise geográfica de vendas, evolução temporal de movimentações. Tabela independente importada de sistema agrológico.",
+        "ingestion_datetime": "DateTime",
+        "source_file": "String",
+        "id": "UInt64",
+        "codigo": "String",
+        "descricao": "String",
+        "categoria": "String",
+        "subcategoria": "String",
+        "fornecedor": "String",
+        "cidade": "String",
+        "estado": "String",
+        "data_movimento": "Date",
+        "quantidade": "Decimal(18, 4)",
+        "valor_unitario": "Decimal(18, 4)",
+        "valor_total": "Decimal(18, 4)",
+        "status": "String"
+    }
+}