Fontes de Dados e Linhagem¶

Sistema: Drexies Agro | Responsável: Equipe de Dados Sonar

Esta página documenta as fontes internas e externas identificadas no código da Drexies Agro, os componentes que acessam esses dados e os principais fluxos entre origem, processamento, persistência e telas.

Arquitetura geral¶

flowchart LR
    U[Usuário] --> F[Frontend React]
    F --> H[Hooks e services]
    H --> S[Cliente Supabase]
    S --> A[Supabase Auth]
    S --> P[PostgreSQL via PostgREST]
    S --> R[RPCs PostgreSQL]
    S --> E[Edge Functions]
    E --> X[APIs externas]
    E --> P
    H --> C[Cálculos no frontend]
    C --> T[Telas da Drexies Agro]
    P --> H
    R --> H

O frontend React usa hooks e services para carregamento, transformação, cache de consulta e persistência. O cliente @supabase/supabase-js recebe a URL e a chave publicável por VITE_SUPABASE_URL e VITE_SUPABASE_PUBLISHABLE_KEY.

As sessões são persistidas no navegador e possuem renovação automática de token. As operações de dados usam Supabase Auth, PostgreSQL/PostgREST, RPCs ou Edge Functions.

Classificação das fontes¶

Frontend, hooks e services¶

As páginas e os componentes React consomem dados por hooks e services. O frontend também calcula filtros, totais de clientes e não clientes, potencial econômico, comissão, agregações mensais e composição da DRE.

Tela React → hook → service → PostgREST, RPC ou Edge Function → transformação → tela

Supabase, PostgreSQL e autenticação¶

O Supabase atua como backend de autenticação, banco PostgreSQL, API de dados e ambiente das Edge Functions. O frontend executa select, insert, update, upsert e delete nas estruturas expostas pelo cliente.

As migrations locais definem tabelas, view, funções, gatilhos e políticas de segurança em nível de linha. O acesso efetivo depende da sessão, do perfil, do papel e das políticas do ambiente em execução.

Credenciais → Supabase Auth → sessão persistida → perfil e papel → telas e dados permitidos

Recuperação de senha → send-password-reset → conector Resend → e-mail → Supabase Auth

A Edge Function manage-users usa um cliente administrativo do Supabase e consulta perfis e papéis para executar a gestão de usuários.

Produtores, propriedades e território¶

PostgreSQL → PostgREST/services → produtores e propriedades → filtros e cálculos → Regiões e Produtores

A RPC get_macro_aggregates recebe filtros e retorna agregações por município/cultura, município e vendedor, além das dimensões disponíveis.

Filtros da tela → get_macro_aggregates → agregação no PostgreSQL → indicadores regionais

Silos e revendas cadastrados são lidos das respectivas tabelas. Há também uma busca sob demanda de estabelecimentos no Google Maps; as duas origens não são equivalentes.

Produtos, preços, manejo e potenciais¶

Produtos + preços + manejo + parâmetros de mercado
→ services de manejo e potencial
→ cálculo por cultura e área
→ Potencial de Mercado, Regiões, Produtores e planejamento

O cálculo do potencial é realizado pela aplicação. A ordem identificada considera manejo valorizado pelos produtos, produtividade multiplicada pela cotação, valor padrão configurado e fallback técnico. O potencial personalizado é persistido separadamente do potencial padrão.

Itens da simulação → cálculo no frontend → potencial e itens personalizados → produtor

Planos de vendas, simulações, comissões e DRE¶

Produtores + potencial + manejo e preços
→ plano, metas e itens
→ projeções, comissões, aprovações e DRE

Catálogo + quantidade + área + preço
→ cálculo da simulação
→ pedido e itens simulados
→ conversão opcional em itens do plano

Configuração de comissão + itens comerciais
→ commissionService e componentes React
→ comissão linear, por categoria e gerencial
→ produtor e DRE

A DRE é calculada na aplicação com dados de metas, realizados, comissões, Over Price, ajustes e despesas. Não foi identificada uma tabela única que materialize seu resultado completo.

Os lançamentos de RDV do hook useRdvs ficam no localStorage, por vendedor e ano, e são agregados mensalmente no navegador antes de compor a DRE.

Google Sheets¶

A Edge Function google-sheets-proxy consulta a API do Google Sheets usando o secret GOOGLE_SHEETS_API_KEY. O service dataSource lê os cabeçalhos, normaliza nomes e números, descarta linhas inválidas e calcula totais por classe, clientes e não clientes.

Google Sheets → google-sheets-proxy → dataSource → normalização e cálculos → Potencial de Mercado

O código tenta extrair códigos IBGE e cidades da aba principal quando as colunas existem. Na ausência dos cabeçalhos esperados, retorna lista vazia. As linhas são processadas em memória; não foi identificada persistência desse fluxo no Supabase.

AgRisk¶

A Edge Function agrisk centraliza autenticação, sincronização de produtos e clientes, consultas, análise completa, atualização de riscos e ativos e vínculos com produtores.

Análise de Risco → useAgrisk → Edge Function agrisk
→ API AgRisk → normalização e persistência → telas de risco

Os resultados externos são consultados sob demanda e parcialmente persistidos. A função usa AGRISK_CREDENTIAL e AGRISK_PASSWORD.

eEmóvel¶

A Edge Function eemovel-enrich consulta a API eEmóvel por CPF ou CNPJ com EEMOVEL_API_KEY, normaliza os dados e atualiza drexies_producer_contacts, podendo relacionar a resposta aos produtores encontrados.

Documento → eemovel-enrich → API eEmóvel
→ normalização → drexies_producer_contacts → produtor

O código também contém processamento em lotes por chamadas sucessivas à Edge Function.

IBGE e dados geográficos¶

A Edge Function ibge-municipios consulta municípios de um estado. O mapa consulta diretamente malhas municipais GeoJSON para desenhar polígonos e usa camadas externas do CARTO como base e rótulos.

Estado → ibge-municipios → API IBGE → municípios → filtros e cadastros

Código IBGE → API de malhas do IBGE → GeoJSON em memória → mapa regional

Google Maps, concorrentes e clima¶

A Edge Function nearby-competitors pesquisa cooperativas, revendas e silos pelo conector Google Maps, elimina duplicidades, calcula distância e ordena os resultados. Não foi identificada persistência dessa busca.

Coordenadas → nearby-competitors → Google Maps/Places
→ filtro e distância → produtor

A Edge Function weather-summary consulta condições atuais e histórico horário, calcula temperatura média e precipitação dos 30 dias considerados e mantém cache de 24 horas por coordenadas arredondadas.

Coordenadas → weather-summary → drexies_weather_cache
→ se necessário, Google Weather → consolidação → cache → tela

As funções usam LOVABLE_API_KEY e GOOGLE_MAPS_API_KEY para o conector configurado.

Edge Functions identificadas¶

Inventário consolidado do Supabase¶

Linhagem resumida por área¶

Pontos a validar¶

1. Confirmar o estado real do Supabase remoto e sua aderência às migrations e aos tipos gerados.
2. Confirmar o conteúdo atual, as abas, os cabeçalhos, os responsáveis e a atualização do Google Sheets.
3. Confirmar contratos, produtos, limites, cotas, custos e versões atuais das APIs AgRisk, eEmóvel, IBGE, Google Maps, Google Weather, CARTO e Resend.
4. Confirmar quais secrets estão configurados no Supabase e em quais ambientes, sem registrar seus valores.
5. Confirmar a origem, carga e atualização de drexies_silos e drexies_revendas, distinguindo-as dos resultados do Google Maps.
6. Confirmar o processo real de revisão, publicação e reversão de Edge Functions e migrations.
7. Confirmar se o RDV deve permanecer no navegador ou ser integrado a uma fonte persistente e compartilhada.
8. Confirmar as políticas de retenção, atualização e reconsulta dos resultados da AgRisk e da eEmóvel.

Referências¶

• Regras de Atualização e Sincronização — comportamento de atualização das fontes
• Dicionário de Indicadores e Regras de Negócio — cálculos realizados sobre os dados
• Telas e Funcionalidades — utilização dos dados nas telas