FAQ — Perguntas Frequentes¶
Sistema: Drexies Agro | Responsável: Equipe de Dados Sonar
Esta página reúne dúvidas frequentes sobre o acesso e o uso das funcionalidades identificadas na Drexies Agro.
Escopo
As respostas descrevem o comportamento comprovado no código analisado. Situações dependentes do ambiente publicado ou de definição da área responsável estão sinalizadas como Ponto a validar.
Acesso, senha e sessão¶
Como acessar a Drexies Agro?¶
Acesse a página de login e informe seu e-mail e sua senha. A autenticação é realizada pelo Supabase Auth. Depois do login, a aplicação carrega o perfil, o papel e as permissões associados ao usuário.
Se o perfil encontrado estiver inativo, a sessão é encerrada. Consulte Primeiros Passos e Autenticação, Perfis, Permissões e RLS.
O que fazer se eu esquecer minha senha?¶
Na tela de login, use a opção de recuperação de senha e informe o e-mail. A aplicação chama a função de envio de redefinição e o link recebido direciona ao fluxo de criação de uma nova senha.
O envio depende da integração de e-mail configurada no ambiente. Não foi identificado no código um procedimento alternativo de suporte.
Como alterar ou redefinir a senha?¶
Há dois fluxos identificados:
- usuário autenticado: em Configurações > Geral, solicite a alteração de senha; a aplicação envia o e-mail de redefinição;
- senha esquecida: use a recuperação disponível no login.
Administradores também possuem uma ação administrativa de redefinição na Gestão de usuários, executada pela Edge Function manage-users.
O que acontece após duas horas sem interação?¶
A aplicação encerra automaticamente a sessão e redireciona para o login. Interações como clique, teclado, entrada de dados, rolagem, movimento do mouse, toque e foco reiniciam o temporizador. Veja Autenticação, Perfis, Permissões e RLS.
Como sair manualmente?¶
Abra o menu do usuário na parte inferior da barra lateral e selecione Sair. A ação encerra a sessão no Supabase Auth.
Perfis e permissões¶
Como funcionam as permissões por perfil?¶
A Drexies Agro possui três papéis identificados no código:
- Administrador Global: acesso integral às telas do menu, Gestão de usuários e Auditoria;
- Administrador: acesso integral às telas do menu e Gestão de usuários, sem a aba Auditoria no frontend;
- Usuário: menu e rotas funcionais condicionados às telas permitidas, com restrições organizacionais aplicadas em algumas telas.
A matriz completa de ações por perfil ainda precisa ser validada. Consulte Autenticação, Perfis, Permissões e RLS.
Por que uma tela pode não aparecer no menu?¶
Para usuários comuns com telas_permitidas preenchida, o menu mostra somente as áreas autorizadas. As chaves controladas são Potencial de Mercado, Regiões, Produtores e Custo Operacional.
Administradores visualizam todas essas áreas. Configurações aparece separadamente para usuários autenticados.
Ponto a validar
No frontend atual, uma lista telas_permitidas vazia concede acesso às quatro áreas funcionais. Confirmar se esse comportamento é intencional.
O que acontece se eu tentar abrir uma rota sem permissão?¶
Sem sessão, a rota protegida direciona ao login. Para usuário comum com uma lista de telas preenchida, uma rota funcional não autorizada direciona à primeira tela permitida reconhecida; se ela não puder ser resolvida, o código usa Potencial de Mercado como fallback.
Como concessionárias e filiais influenciam os dados exibidos?¶
Para usuários comuns, as listas de concessionárias e filiais do perfil filtram os dados da planilha usados nas telas Potencial de Mercado e Produtores. Administradores ignoram esses filtros no frontend.
Essa filtragem acontece na interface e não comprova isolamento territorial equivalente em todas as tabelas do banco. Veja Autenticação, Perfis, Permissões e RLS.
Navegação e filtros¶
Como limpar os filtros?¶
Na tela Produtores, quando existem filtros ativos, use a ação Limpar para devolver todos os filtros dessa tela ao estado inicial definido pelo componente.
Esse comportamento foi comprovado somente na tela Produtores e não deve ser generalizado para as demais telas. A limpeza dos filtros não altera os dados persistidos no Supabase.
Por que uma tela pode aparecer sem dados?¶
Verifique se os filtros selecionados possuem registros correspondentes e se o usuário tem concessionárias, filiais ou telas compatíveis com o conteúdo. Também pode haver consulta em andamento, resposta vazia da fonte ou indisponibilidade de uma integração.
Para entender as origens, consulte Fontes de Dados e Linhagem.
Potencial, segmentos e classes¶
Qual é a diferença entre potencial padrão e potencial simulado?¶
O potencial padrão é calculado pela aplicação a partir das áreas por cultura e do valor de referência por hectare, seguindo as fontes disponíveis no código. O potencial simulado é construído manualmente para o produtor com os itens configurados na simulação.
Quando existe uma simulação personalizada, ela é apresentada separadamente do potencial padrão. Consulte o Dicionário de Indicadores e Regras de Negócio.
Como funcionam a penetração e o valor capturável?¶
A penetração é o percentual do potencial bruto considerado capturável. O sistema oferece 5%, 10%, 15%, 25%, 50%, 75%, 100% e percentual personalizado.
A penetração não altera o potencial padrão bruto. Veja o Dicionário de Indicadores e Regras de Negócio.
Como interpretar os segmentos de produtores?¶
Os segmentos usam a área considerada para o produtor:
| Segmento | Faixa identificada |
|---|---|
| Top Farmer | 701 ha ou mais |
| Top Standard | 17 a 700 ha |
| Standard | 5 a 16 ha |
| Small | 2 a 4 ha |
| Micro Farmer | Menos de 2 ha |
Como interpretar as classes A, B, C e D?¶
Na interface, A é identificada como Premium, B como Potencial, C como Atenção e D como Risco. A distribuição detalhada encontrada no código utiliza proporções observadas no dashboard e possui fallback técnico em quartis.
Ponto a validar
Confirmar se a distribuição proporcional e o fallback em quartis representam a classificação oficial de negócio.
Como exportar a carteira de produtores?¶
Na tela Produtores, aplique os filtros desejados e selecione Exportar CSV. O botão informa a quantidade de produtores filtrados e gera um arquivo carteira-detalhada-AAAA-MM-DD.csv. A exportação é registrada na auditoria.
Plano de vendas e aprovações¶
Como criar um plano de vendas?¶
Acesse Custo Operacional > Plano de Vendas e selecione Criar plano de vendas. Preencha os dados solicitados pelo formulário, aplique a meta e salve. O plano, suas metas e seus itens são persistidos no Supabase.
Os campos e regras detalhados estão em Telas e Funcionalidades.
Como editar ou excluir um plano?¶
Na lista de planos, use a ação Editar para abrir o formulário com os dados atuais. Para remover, use Excluir e confirme a mensagem exibida.
A exclusão do plano comercial é diferente da remoção de sua aplicação na DRE: o segundo fluxo preserva o plano e o histórico da aprovação.
Como enviar um plano para aprovação?¶
Na lista de planos, use a ação Exportar como venda, identificada pelo texto de apoio como envio para aprovação na DRE. Confirme o plano no diálogo e selecione Enviar para aprovação. Um registro é criado inicialmente como pendente.
Quais estados uma aprovação pode ter?¶
Os estados identificados são:
- Pendente;
- Aprovado;
- Negado.
Um plano aprovado pode ser aprovado com comissão ou sem lançamento de comissão. Os planos aprovados considerados ativos alimentam valores realizados, comissão e Over Price na DRE. Consulte Telas e Funcionalidades.
Ponto a validar
A matriz completa de quem pode enviar, aprovar, negar, editar comissão ou remover a aplicação de um plano deve ser confirmada com as políticas efetivamente publicadas.
Comissões, Over Price e seguro agrícola¶
Como funciona a comissão?¶
O código suporta:
- comissão linear, com um percentual único;
- comissão por categoria de produto;
- comissão gerencial adicional.
As configurações podem ser persistidas por produtor. Nos planos aprovados, a comissão pode ser registrada para compor a DRE. Fórmulas e percentuais identificados estão no Dicionário de Indicadores e Regras de Negócio.
O que é Over Price?¶
É um valor adicional calculado sobre a comissão mensal. O código usa como padrão identificado 50% da comissão e permite ajustes manuais por mês.
O que é o seguro agrícola?¶
É uma informação comercial calculada sobre o valor total do plano. O percentual padrão identificado é 3%. O código o trata como informativo e ele não compõe a DRE implementada.
RDV e DRE¶
Como registrar um RDV?¶
Em Custo Operacional > DRE, selecione o vendedor e o ano e localize RDV — Reembolso de Despesas de Viagem. Clique em Adicionar RDV e informe TIPOPER, VLR e DHBAIXA — o campo de data da interface. Para OUTRAS (COM JUSTIFICATIVA), selecione também a Subcategoria. A Justificativa é obrigatória somente para as combinações configuradas dessa forma no código. O lançamento pode ser editado ou excluído depois.
Os valores são agregados por categoria e mês para alimentar a DRE.
Ponto a validar — armazenamento local
No código analisado, os lançamentos de RDV ficam no localStorage do navegador. Não há comprovação de sincronização entre navegadores, dispositivos ou usuários.
Por que a DRE pode mudar após uma aprovação?¶
Planos aprovados e ainda aplicados são usados para formar realizado, composição, comissão e Over Price. Alterar a decisão, a comissão ou remover a aplicação financeira modifica os dados considerados pelo cálculo da DRE.
A fórmula financeira oficial continua sujeita à validação da área responsável. Consulte o Dicionário de Indicadores e Regras de Negócio.
Análise de Risco e contatos¶
Como executar uma Análise de Risco?¶
Abra o detalhamento do produtor e acesse a área Análise de Risco. O fluxo pode assegurar ou criar o vínculo do cliente AgRisk e executar consultas individuais, análise completa ou atualizações específicas, conforme as ações disponíveis.
As consultas dependem de documento válido e da integração configurada. Os resultados e erros são persistidos no Supabase. Veja Telas e Funcionalidades.
Por que uma consulta AgRisk pode não retornar resultado?¶
O código prevê consulta sem dados, processamento, falha de autenticação, erro da API e documento ou vínculo insuficiente. O histórico pode registrar estado e mensagem de erro.
Contratos, produtos habilitados, limites e disponibilidade atual da API não estão definidos integralmente no repositório e devem ser validados. Consulte Fontes de Dados e Linhagem.
Como os contatos podem ser enriquecidos pela eEmóvel?¶
No detalhamento do produtor, a aplicação pode consultar a eEmóvel usando CPF ou CNPJ. A resposta é normalizada e persistida em drexies_producer_contacts.
Se já houver contato persistido, a função pode reutilizá-lo. Uma atualização forçada ignora esse reaproveitamento e realiza nova consulta externa.
Ponto a validar
O código não define um prazo automático de expiração para os contatos persistidos. A política de reconsulta deve ser confirmada.
Configurações pessoais¶
Como alterar o nome e a foto?¶
Acesse Configurações > Geral. O código permite atualizar o nome e adicionar, recortar, substituir ou remover a foto de perfil. Após salvar, o perfil é carregado novamente para refletir as alterações.
Como alternar entre modo claro e escuro?¶
Abra o menu do usuário na barra lateral e selecione Modo claro ou Modo escuro. O tema também pode acompanhar a configuração resolvida pelo provedor de tema do aplicativo.
Quem pode acessar Gestão de usuários e Auditoria?¶
Administradores e Administradores Globais visualizam Usuários. Somente Administradores Globais visualizam Auditoria. A aba Geral fica disponível para qualquer usuário autenticado.
Atualização dos dados¶
Por que os dados podem não atualizar imediatamente?¶
A Drexies Agro combina diferentes mecanismos:
- dados persistidos no Supabase e consultados por PostgREST ou RPC;
- integrações consultadas sob demanda;
- cache do React Query;
- dados calculados no frontend;
- cache climático de 24 horas;
- dados locais do navegador, como RDV.
O staleTime indica por quanto tempo o frontend considera uma resposta atual; ele não representa a frequência de atualização da fonte. Algumas consultas também desabilitam a atualização ao voltar o foco para a janela.
Consulte Regras de Atualização e Sincronização para os tempos e comportamentos identificados.
Os dados do Google Sheets são copiados para o Supabase?¶
Não foi identificada persistência das linhas da planilha em tabela Supabase nesse fluxo. A Edge Function consulta a planilha, e o frontend normaliza e mantém o resultado no cache da aplicação.
Ponto a validar
A frequência real de atualização da planilha e seu responsável operacional não estão definidos no código. Também existe divergência entre o ID mencionado no README e o configurado na Edge Function.
Pontos a validar¶
- Confirmar se
telas_permitidasvazia deve conceder todas as telas aos usuários comuns. - Confirmar a classificação oficial das classes A–D, incluindo distribuição proporcional e fallback em quartis.
- Validar a matriz completa de ações do fluxo de aprovação por perfil.
- Confirmar a persistência e a sincronização esperadas para RDV e ajustes locais da DRE.
- Validar a fórmula financeira oficial da DRE com a área responsável.
- Confirmar contratos, produtos habilitados, limites e disponibilidade das integrações AgRisk e eEmóvel.
- Definir a política de expiração e reconsulta dos contatos enriquecidos.
- Confirmar a frequência, o responsável e o ID correto do Google Sheets.
- Confirmar no Supabase remoto as permissões e políticas RLS efetivamente implantadas.