Ir para o conteúdo

Glossário

Referência centralizada dos principais termos funcionais, comerciais e técnicos utilizados na Drexies Agro. Os termos estão organizados por assunto; regras de cálculo detalhadas permanecem no Dicionário de Indicadores e Regras de Negócio.

Plataforma e áreas funcionais

Drexies Agro : Plataforma que reúne recursos de análise de mercado, gestão territorial e de produtores, planejamento comercial, custos, riscos e configurações de acesso.

Potencial de Mercado : Área da plataforma destinada à visão consolidada do mercado, da carteira de clientes, do potencial a explorar e da distribuição dos produtores.

Regiões : Área de análise territorial que apresenta indicadores de potencial, carteira, propriedades, área plantada e valor capturável conforme a penetração selecionada.

Produtores : Área de consulta e gestão da carteira de produtores e de suas propriedades, com filtros, detalhamento, exportação e ações relacionadas.

Custo Operacional : Conjunto de recursos de planejamento e acompanhamento comercial que inclui Plano de Vendas, Aprovações, DRE e RDV.

Configurações : Área administrativa da plataforma destinada às configurações gerais e, conforme as permissões do usuário, à gestão de usuários e à auditoria.

Simulação : Recurso que permite configurar itens, quantidades ou doses, área, preços e parâmetros aplicáveis para calcular um cenário de potencial diferente do potencial padrão.

Aprovação : Fluxo relacionado a simulações e planos comerciais, no qual um registro enviado pode permanecer pendente, ser aprovado ou ser negado, conforme as ações disponíveis ao perfil autorizado.

Mercado, áreas e potencial

Carteira de clientes : Conjunto de produtores ou propriedades identificados como clientes e considerado nos indicadores de carteira.

Não clientes / potencial a explorar : Parcela do mercado que não integra a carteira de clientes e representa oportunidade potencial de atuação.

Participação da carteira : Indicador que compara a presença da carteira de clientes com o mercado analisado. Consulte o Dicionário de Indicadores para a regra aplicada.

Área agricultável : Área da propriedade considerada apta ao uso agrícola nos dados consultados pela aplicação.

Área plantada : Área associada às culturas plantadas e utilizada em análises territoriais e de potencial.

Potencial total : Potencial bruto calculado para o conjunto de propriedades e culturas considerado na análise, sem ser definido, por si só, como valor ajustado pela penetração.

Potencial da carteira : Potencial bruto correspondente aos produtores ou propriedades pertencentes à carteira de clientes, distinto do valor capturável.

Potencial padrão : Potencial calculado pela aplicação a partir de cultura, área e valor de referência por hectare, seguindo as origens e fallbacks descritos no Dicionário de Indicadores.

Potencial simulado : Resultado calculado a partir dos itens configurados na simulação para o cenário analisado.

Penetração : Percentual selecionado para estimar quanto do potencial bruto pode ser capturado em um cenário comercial.

Valor capturável : Parcela do potencial estimada conforme a penetração selecionada. A regra detalhada está no Dicionário de Indicadores.

Segmentação e saúde da carteira

Top Farmer : Segmento de produtor com área de 701 hectares ou mais.

Top Standard : Segmento de produtor com área de 17 a 700 hectares.

Standard : Segmento de produtor com área de 5 a 16 hectares.

Small : Segmento de produtor com área de 2 a 4 hectares.

Micro Farmer : Segmento de produtor com área inferior a 2 hectares.

Classe A / Premium : Classe apresentada para produtor com uso de tecnologia, boa saúde financeira e sem restrição socioambiental.

Classe B / Potencial : Classe apresentada para produtor com boa saúde financeira e sem restrição socioambiental, mas sem uso de tecnologia.

Classe C / Atenção : Classe apresentada quando há situação financeira negativa ou restrição socioambiental.

Classe D / Risco : Classe apresentada quando coexistem situação financeira negativa e restrição socioambiental.

Índice de saúde da carteira : Indicador ponderado pela distribuição dos produtores entre as classes A, B, C e D, utilizado para representar a saúde da carteira. Pesos e faixas estão no Dicionário de Indicadores.

Ponto a validar: confirmar com a área responsável a regra oficial de distribuição dos produtores nas classes A, B, C e D, inclusive o uso do fallback por quartis identificado no código.

Planejamento, vendas e resultado

Plano de Vendas : Planejamento comercial por período e cultura que reúne metas, projeções, realizados e informações usadas no acompanhamento das janelas comerciais.

Meta em hectares : Meta física definida no Plano de Vendas e expressa em hectares.

Meta financeira : Valor financeiro esperado para o período do Plano de Vendas, expresso em reais.

Projeção : Valor projetado no planejamento comercial para o período analisado.

Realizado : Resultado efetivamente registrado e comparado às metas do planejamento comercial.

Forecast : Previsão utilizada no acompanhamento do desempenho comercial, apresentada junto aos dados de planejamento e realização.

Manejo : Configuração de produtos e quantidades associada a uma cultura, utilizada na composição do valor de referência por hectare quando disponível.

Comissão linear : Modalidade de comissão calculada com um percentual linear aplicado à base considerada pela aplicação.

Comissão por categoria : Modalidade de comissão cuja configuração varia conforme a categoria considerada no cálculo.

Comissão gerencial : Modalidade de comissão destinada ao cálculo gerencial, conforme os parâmetros configurados na aplicação.

Over Price : Valor adicional considerado no contexto do cálculo de comissão, conforme a configuração registrada.

Seguro agrícola : Informação comercial relacionada ao plano e às condições consideradas no planejamento de vendas.

DRE (Demonstração do Resultado do Exercício) : Área que organiza componentes de receitas, custos, despesas e resultados calculados pela aplicação para análise financeira.

Ponto a validar: confirmar com a área responsável as fórmulas e classificações financeiras oficiais da DRE antes de tratá-las como regras definitivas de negócio.

RDV : Recurso de registro de despesas de viagem, com informações de operação, valor, data, subcategoria e justificativa; os registros identificados no frontend são armazenados localmente no navegador.

Risco, dados e conformidade

Análise de Risco : Funcionalidade de consulta de informações cadastrais, financeiras, socioambientais e de conformidade relacionadas ao produtor analisado.

AgRisk : Serviço externo consultado sob demanda para obter dados usados na Análise de Risco.

eEmóvel : Serviço externo utilizado sob demanda para enriquecimento de informações de contato de produtores.

PEP (Pessoa Politicamente Exposta) : Indicador de conformidade que informa a identificação de uma pessoa como politicamente exposta nos dados consultados.

Conformidade socioambiental : Conjunto de verificações relacionadas a restrições ambientais e sociais, incluindo informações como trabalho escravo quando retornadas pelas fontes consultadas.

Acesso e permissões

Administrador Global : Perfil considerado administrador pelo frontend, com acesso às quatro telas funcionais principais, à Gestão de usuários e à Auditoria.

Administrador : Perfil com acesso, pelo frontend, às quatro telas funcionais principais e à Gestão de usuários, mas sem acesso à Auditoria.

Usuário : Perfil comum cujo acesso às telas e aos dados depende das permissões e dos escopos organizacionais cadastrados.

Telas permitidas : Relação de telas liberadas para um usuário e utilizada pelo frontend para compor o menu e controlar o acesso às rotas.

Concessionárias permitidas : Relação de concessionárias que delimita o escopo organizacional associado ao usuário.

Filiais permitidas : Relação de filiais que delimita o escopo organizacional associado ao usuário.

Tecnologia e atualização de dados

Supabase : Plataforma de backend utilizada pela Drexies Agro para autenticação, acesso ao PostgreSQL, APIs, funções e outros serviços de dados.

Supabase Auth : Serviço de autenticação usado para login, recuperação e redefinição de senha e manutenção da sessão do usuário.

PostgREST : Camada de API usada pelo Supabase para expor operações sobre tabelas e views do PostgreSQL consumidas pela aplicação.

RLS (Row-Level Security) : Mecanismo do PostgreSQL que aplica políticas de acesso às linhas das tabelas no banco. É distinto das restrições visuais implementadas no frontend.

Edge Function : Função executada no ambiente Supabase para intermediar integrações ou operações de backend, como proxies para serviços externos e gestão de usuários.

RPC (Remote Procedure Call) : Chamada a uma função do banco por meio da API do Supabase, utilizada para executar processamento e retornar resultados à aplicação.

React Query : Biblioteca utilizada no frontend para consultar dados, gerenciar cache e invalidar consultas após determinadas alterações.

staleTime : Tempo durante o qual uma consulta em cache é considerada atual pelo React Query. Após esse período, ela passa a ser considerada desatualizada e pode ser consultada novamente conforme os gatilhos e as configurações da aplicação.

gcTime : Tempo durante o qual dados de uma consulta sem uso permanecem no cache do React Query antes de serem removidos.

localStorage : Armazenamento persistente do navegador usado por partes da aplicação para conservar dados localmente no dispositivo, sem equivaler à persistência no Supabase.

Referências

Algum termo não está listado aqui? Solicite a inclusão à Equipe de Dados Sonar.