Telas e Funcionalidades

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

Esta página apresenta a documentação funcional das telas e dos principais fluxos identificados no código da Drexies Agro. As funcionalidades estão organizadas conforme o acesso inicial, a navegação do menu lateral e as operações realizadas dentro de cada módulo.

Acesso condicionado ao perfil

As telas e os dados disponíveis podem variar conforme o perfil, as telas permitidas e as restrições de concessionária e filial associadas ao usuário.

---

1. Login

Objetivo

Autenticar o usuário e iniciar uma sessão no sistema.

Campos e ações

Item	Tipo	Comportamento
E-mail	Campo de e-mail	Recebe o endereço cadastrado
Senha	Campo de senha	Recebe a senha do usuário
Exibir/ocultar senha	Botão de ícone	Alterna a visibilidade dos caracteres
Entrar	Botão	Envia as credenciais para autenticação
Esqueci minha senha	Link/botão	Abre o formulário de recuperação

Validações e funcionamento

• E-mail e senha são obrigatórios.
• Credenciais inválidas apresentam uma mensagem genérica de erro.
• Um usuário que já possua sessão ativa é direcionado para Potencial de Mercado.
• Após a autenticação, o sistema carrega o perfil e verifica se a conta está ativa.
• Perfis inativos são desconectados e não acessam as áreas protegidas.

---

2. Recuperação de senha

Objetivo

Solicitar um link de redefinição de senha a partir da tela de login.

Campos e ações

Item	Comportamento
E-mail	Endereço associado à conta
Confirmar e-mail	Repetição do endereço; o campo bloqueia colagem
Cancelar	Fecha o formulário
Enviar link	Solicita o envio do e-mail de recuperação

Validações e funcionamento

• Os dois campos são obrigatórios.
• Os endereços são comparados sem diferenciação entre letras maiúsculas e minúsculas.
• Os e-mails precisam coincidir.
• A confirmação não revela se o endereço está cadastrado.
• O envio é realizado pela função de recuperação de senha do backend.

---

3. Redefinição de senha

Objetivo

Validar o link recebido e permitir a criação de uma nova senha.

Estados da tela

• Validando link.
• Link válido e formulário disponível.
• Link inválido ou expirado.
• Senha alterada com sucesso.

Campos e ações

• Nova senha.
• Confirmação da nova senha.
• Exibir ou ocultar cada senha.
• Salvar nova senha.
• Solicitar novo link quando o anterior estiver inválido.
• Voltar ao login.

Validações

A nova senha deve:

• possuir pelo menos 6 caracteres;
• conter pelo menos um caractere especial;
• coincidir com a confirmação.

O sistema aceita os formatos de recuperação previstos pelo Supabase e encerra a sessão depois que a senha é alterada com sucesso.

---

4. Navegação geral

Após o login, o menu lateral apresenta as áreas liberadas para o usuário:

• Potencial de Mercado
• Regiões
• Produtores
• Custo Operacional
• Configurações

O menu pode ser expandido ou recolhido. No rodapé, o usuário encontra sua identificação, perfil, e-mail, alternância de tema, acesso às configurações e a ação Sair.

Usuários comuns têm os itens das quatro telas principais filtrados pela lista de telas permitidas. Administradores visualizam todas essas telas.

---

5. Potencial de Mercado

Objetivo

Apresentar uma visão executiva do mercado agrícola, da carteira atual e das oportunidades ainda não atendidas.

Filtros

Filtro	Comportamento
Concessionária	Restringe a análise à concessionária selecionada
Filial	Depende da concessionária e restringe a análise à unidade selecionada

As opções também respeitam as concessionárias e filiais permitidas no perfil.

Indicadores apresentados

• Mercado total.
• Carteira de clientes.
• Participação da carteira no mercado.
• Não clientes ou potencial a explorar.
• Clientes Classe A.
• Participação da Classe A da carteira sobre a Classe A do mercado.

Visualizações

• Mercado total por segmento.
• Carteira por segmento.
• Potencial a explorar por segmento.
• Distribuição por rank A, B, C e D.
• Clientes versus não clientes.
• Índice de saúde da carteira.
• Resumo detalhado por segmento e classe.

Funcionamento

Os dados são tratados antes da apresentação para consolidar clientes e não clientes por segmento e classe. As definições e fórmulas dos indicadores serão detalhadas no Dicionário de Indicadores e Regras de Negócio.

---

6. Regiões

Objetivo

Analisar área e potencial econômico por território, município e cultura.

Filtros

• Região/estado.
• Vendedor ou território.
• Município.
• Cultura.
• Situação de carteira.
• Exibição de silos.
• Exibição de revendas.
• Penetração simulada.

A seleção de um município no mapa também restringe a análise àquele município.

Indicadores

• Área agricultável ou hectares totais, conforme o contexto.
• Potencial total da região.
• Potencial da carteira.
• Quantidade de propriedades da carteira.
• Área plantada.
• Valor capturável conforme a penetração selecionada.

Visualizações e ações

• Distribuição de área e potencial por cultura.
• Mapa de densidade financeira por município.
• Alternância de entidades entre produtores, silos e revendas.
• Seleção de município pelo mapa.
• Resumo por município e cultura.
• Paginação e alteração da quantidade de linhas da tabela.
• Bloco de armazenamento quando a visualização de silos está ativa.

Resumo por município e cultura

Informação	Descrição
Município	Localização das propriedades
Cultura	Cultura plantada
Área plantada	Hectares plantados
Área da carteira	Hectares pertencentes à carteira
Potencial total	Estimativa total para município e cultura
Potencial da carteira	Parcela associada à carteira
Capturável	Potencial ajustado pela penetração
% carteira	Participação da carteira sobre a área analisada

Dupla safra

O código admite que a área plantada supere a área agricultável quando o mesmo terreno recebe mais de uma safra no período.

---

7. Produtores

Objetivo

Apresentar a carteira detalhada e permitir a priorização e análise individual de produtores.

Indicadores

• Quantidade de produtores filtrados.
• Total de hectares.
• Potencial padrão.
• Potencial simulado.

Filtros

• Pesquisa textual.
• Vendedor ou território.
• Município.
• Produtor.
• Propriedade.
• Cultura.
• Safra.
• Existência de potencial personalizado.
• Segmento.
• Tecnificação.
• Status comercial.
• Classe/rank.
• Faixa de hectares.
• Penetração.

Há uma ação para limpar os filtros aplicados.

Informações da carteira

• Produtor e culturas.
• Cidade e propriedade.
• Hectares.
• Classe.
• Segmento.
• Status comercial.
• Potencial padrão.
• Potencial simulado.
• Comissão.
• Indicação de simulação personalizada.

Ações

• Abrir o detalhamento ao selecionar um produtor.
• Exportar a carteira filtrada em arquivo CSV.

A ordenação inicial prioriza os maiores potenciais padrão identificados no conjunto filtrado.

---

8. Detalhamento do produtor

Objetivo

Concentrar as informações operacionais, comerciais e de risco de um produtor selecionado.

Áreas identificadas

• Detalhes.
• Simulação.
• Comissão.
• Resumo.
• Análise de Risco.
• Catálogo.

Informações apresentadas

Conforme os dados existentes para o produtor, o detalhamento pode reunir:

• identificação e documento;
• propriedades, cidades, áreas e culturas;
• situação comercial e tecnificação;
• potencial padrão e personalizado;
• contatos e endereços;
• informações de silos e revendas próximas;
• simulações e itens comerciais;
• comissões configuradas;
• resultados de consultas de risco.

A disponibilidade de informações depende dos registros encontrados para o produtor e suas propriedades.

---

9. Simulação

Objetivo

Construir um potencial comercial personalizado para o produtor, item a item.

Informações e campos

• Cultura.
• Área da cultura.
• Produtos ou insumos.
• Categoria.
• Dose ou quantidade.
• Unidade.
• Preço unitário.
• Quantidade calculada.
• Valor total.

Para sementes, existem parâmetros específicos por cultura e unidade comercial.

Ações

• Criar ou alterar a simulação.
• Adicionar insumo.
• Editar item.
• Editar parâmetros de semente/cultura.
• Remover item.
• Recalcular valores.
• Enviar a simulação para aprovação.

Funcionamento

• Insumos são calculados a partir da dose e da área.
• Sementes utilizam parâmetros próprios de população e unidade comercial.
• Uma simulação personalizada é armazenada por produtor e usuário.
• Quando enviada, a simulação origina uma solicitação associada ao produtor e ao vendedor/território.

As fórmulas de cálculo serão consolidadas no Dicionário de Indicadores e Regras de Negócio.

---

10. Comissão

Objetivo

Configurar e calcular as comissões relacionadas ao produtor e aos itens comerciais.

Modalidades

• Linear: um percentual aplicado à base informada.
• Por categoria: percentuais específicos conforme a categoria de produto.

Campos identificados

• Tipo de comissão.
• Categoria, quando aplicável.
• Percentual do vendedor.
• Percentual de gerência.
• Valor-base.
• Valores calculados de comissão.

Ações e validações

• Adicionar uma ou mais configurações.
• Editar configuração.
• Remover configuração.
• Salvar as comissões.
• É necessário adicionar pelo menos uma comissão antes de salvar.
• Valores são recalculados conforme modalidade, base e percentuais.

O sistema também calcula informações relacionadas a comissão gerencial, Over Price e seguro agrícola. Os critérios serão detalhados na página de métricas e regras de negócio.

---

11. Análise de Risco

Objetivo

Executar e consultar uma análise consolidada de crédito, cadastro e conformidade do produtor.

Informações identificadas

• Produtos de consulta disponíveis.
• Histórico e situação das consultas.
• Pontuações de crédito.
• Valores restritivos.
• Protestos e resumo de protestos.
• Processos judiciais.
• Recuperação judicial.
• Conformidade socioambiental.
• Pessoa Politicamente Exposta (PEP).
• Trabalho Escravo.
• Dados cadastrais e contatos.
• Grupo econômico e familiar.
• Imóveis rurais.
• Endividamento.

Ações e funcionamento

• Executar uma nova consulta para o produtor.
• Consultar resultados persistidos.
• Exibir erros registrados quando uma consulta não é concluída.
• Complementar contatos por meio do recurso de enriquecimento cadastral.

A consulta depende de serviços externos e da disponibilidade de documento válido e dados compatíveis com o produtor.

---

12. Custo Operacional — Plano de Vendas

Objetivo

Criar e acompanhar planos comerciais por vendedor, cultura e período.

Filtros gerais

• Vendedor ou território.
• Período.
• Penetração.

Formulário do plano

Campo	Regra identificada
Nome do plano	Obrigatório
Vendedor	Obrigatório
Cultura	Opcional
Cultura em plantio	Seleção de cultura
Período	Pelo menos um mês obrigatório
Penetração	Valor predefinido ou personalizado
Área ativa do vendedor	Valor de referência do plano
Meta em hectares	Meta física
Meta em R$	Meta financeira
Observações	Texto complementar

Informações e recursos

• Projeção mensal.
• Abertura por cultura e categorias de produtos.
• Metas financeiras e de penetração.
• Comparação entre projeção e meta.
• Manejo associado ao plano.
• Calculadora de projeção.
• Forecast.
• Lista de planos criados.

Ações

• Criar plano.
• Editar plano.
• Excluir plano.
• Selecionar um plano para análise.
• Exportar informações.
• Vincular projeção.
• Enviar plano para aprovação na DRE.

Lista de planos

• Nome.
• Região.
• Vendedor.
• Cultura.
• Período.
• Penetração.
• Valor projetado.
• Ações.

Janelas comerciais

Cultura	Período comercial
Milho verão	Setembro a dezembro
Milho inverno	Janeiro a abril
Soja	Setembro a dezembro
Cana perene 1	Janeiro a março
Cana perene 2	Setembro a novembro
Feijão inverno	Maio a julho
Arroz	Setembro a novembro
Trigo	Abril a junho

Situação da meta

Situação	Critério
Superado	Realizado igual ou superior à meta
No prazo	Realizado a partir de 85% da meta
Atrasado	Realizado abaixo de 85% da meta

---

13. Aprovações

Objetivo

Controlar o envio, a análise e a aplicação de simulações e planos comerciais.

Estados identificados

• Pendente.
• Aprovado.
• Negado.

Informações

• Plano e produtor relacionados.
• Vendedor.
• Ano.
• Cultura.
• Período.
• Valor total.
• Status da solicitação.

Ações

• Enviar plano ou simulação.
• Abrir os detalhes da solicitação.
• Aprovar.
• Negar.
• Aplicar um plano aprovado.
• Remover um plano aplicado.

As ações disponíveis dependem do estado atual da solicitação e das permissões aplicadas no banco.

---

14. Custo Operacional — DRE

Objetivo

Consolidar as informações financeiras e operacionais relacionadas aos planos comerciais.

Informações e recursos identificados

• Resumos financeiros.
• Receita e valores de planos.
• Custos de produtos.
• Comissões.
• Despesas operacionais e RDV.
• Valores mensais e totais.
• Margens e resultado.
• Planos enviados para aprovação.
• Ficha cadastral do cliente.
• Edição de comissões do plano.
• Limpeza controlada de dados aplicados à DRE.

Filtros e ações

• Vendedor/território.
• Período.
• Plano comercial.
• Consultar detalhes de aprovação.
• Aprovar ou negar plano.
• Editar informações de comissão.
• Abrir ficha cadastral.
• Remover plano aplicado.
• Executar limpeza mediante confirmação.

Ponto a validar

As fórmulas e classificações financeiras oficiais da DRE precisam ser confirmadas com a área responsável antes de serem apresentadas como regras definitivas. O código comprova os componentes e cálculos implementados, mas não substitui a validação contábil e de negócio.

---

15. RDV

Objetivo

Registrar e manter despesas de viagem e operação vinculadas ao contexto comercial.

Campos identificados

• Tipo de operação.
• Subcategoria, quando aplicável.
• Valor.
• Data.
• Justificativa.

Ações

• Adicionar lançamento.
• Editar.
• Salvar.
• Cancelar edição.
• Excluir.
• Registrar justificativa.

Validações e funcionamento

• O valor informado é tratado como valor monetário.
• Determinadas classificações exigem subcategoria.
• A justificativa é obrigatória nos casos sinalizados pela interface.
• Cada tipo de lançamento alimenta uma linha correspondente da DRE.

---

16. Configurações gerais

Objetivo

Permitir que o usuário mantenha suas informações pessoais, preferências e opções de segurança.

Informações e campos

• Foto de perfil.
• Nome.
• E-mail.
• Tipo de perfil.
• Tema da aplicação.

Ações

• Alterar nome.
• Selecionar uma imagem.
• Recortar e pré-visualizar o avatar.
• Salvar ou remover a foto.
• Selecionar tema claro, escuro ou conforme o sistema.
• Solicitar link de redefinição de senha.

Validações

• O nome informado deve ser válido.
• O upload deve ser um arquivo de imagem.
• O e-mail é exibido, mas não é editado diretamente nesta tela.

Esta área está disponível para usuários autenticados.

---

17. Gestão de usuários

Objetivo

Administrar contas, perfis e permissões de acesso.

Acesso

Disponível para os perfis Administrador e Administrador Global.

Filtro e tabela

É possível pesquisar por usuário. A listagem apresenta:

• nome;
• e-mail;
• perfil;
• status;
• concessionárias permitidas;
• telas permitidas;
• ações.

Formulário

Campo	Finalidade
Nome	Identificação do usuário
E-mail	Credencial de acesso
Senha inicial	Informada na criação
Perfil	Administrador Global, Administrador ou Usuário
Ativo	Libera ou bloqueia o acesso
Concessionárias permitidas	Restringe o escopo organizacional
Filiais permitidas	Restringe o escopo territorial
Telas permitidas	Define os módulos acessíveis

Ações

• Criar usuário.
• Editar usuário.
• Ativar ou inativar.
• Excluir usuário.
• Identificar contas protegidas.

Contas protegidas não disponibilizam todas as ações administrativas comuns.

---

18. Auditoria

Objetivo

Consultar ações relevantes registradas pelo sistema.

Acesso

Disponível somente para o perfil Administrador Global.

Filtros

• Pesquisa por usuário, e-mail ou descrição.
• Tipo de ação.

Informações apresentadas

• Data e hora.
• Usuário.
• Ação.
• Descrição.

A auditoria registra ações que utilizam o serviço de log do sistema; ela não representa necessariamente todo evento técnico ocorrido na aplicação.

---

19. Comportamentos transversais

• As áreas principais exigem autenticação.
• O menu e as rotas verificam as telas permitidas.
• Administradores possuem acesso às quatro telas principais.
• Restrições de concessionária e filial são aplicadas aos dados utilizados nas análises.
• O sistema disponibiliza modos claro e escuro.
• A sessão é encerrada após 2 horas sem interação.
• Operações apresentam mensagens de sucesso ou erro.
• Consultas utilizam estados de carregamento e estados vazios quando não há dados.

---

Pontos a validar

• Confirmar com a área responsável as fórmulas e classificações financeiras oficiais da DRE.
• Confirmar a matriz operacional completa de ações permitidas em aprovações para cada perfil.
• Confirmar quais registros estão configurados como contas protegidas no ambiente publicado.
• A página de gestão de tabelas de preço existe no código como AdminPriceLists.tsx, mas não possui rota registrada. Por isso, não está documentada como funcionalidade normalmente disponível; sua finalidade e eventual publicação precisam ser confirmadas.