(ORÇAMENTOS) Implementação de Indicadores no Formulário de Orçamentos
Resumo da Nota Técnica
Resumo da Nota Técnica Nesta ordem de serviço foi implementada a exibição de cards indicadores no formulário de Orçamentos, seguindo o mesmo padrão visual utilizado nos cards de Serviço.
A melhoria permite ao usuário visualizar, diretamente na listagem de Orçamentos, informações consolidadas de valor total, orçamentos em andamento, finalizados, perdidos e percentual de conversão, respeitando as regras de status, período mensal e escopo de representante do usuário logado.
Detalhes da Nota Técnica
Detalhes da Nota Técnica
Criação dos cards indicadores na tela de Orçamentos
Foi implementado o conjunto de cards informativos no formulário de Orçamentos, com layout equivalente ao utilizado na tela de Serviço.
Os cards criados foram:
Valor Total; Andamento; Finalizados; Perdidos; Conversão.
No comportamento responsivo, os cards devem manter a organização visual prevista para mobile, com três cards na linha de cima e dois cards na linha de baixo Imagem 1 Imagem 2
Card Valor Total
O card de Valor Total foi ajustado para apresentar a soma financeira dos orçamentos com status “Negócio Fechado” e data de aprovação dentro do mês atual.
Para composição do valor, o sistema considera a seguinte regra:
quando o orçamento possuir itens, o valor deve ser calculado com base no valor total dos itens; quando o orçamento não possuir itens, o sistema deve considerar o valor informado diretamente no orçamento.
Com essa regra, o indicador passa a refletir o valor consolidado dos orçamentos efetivamente fechados no período mensal corrente.
Card Andamento
O card Andamento foi implementado para totalizar a quantidade de orçamentos com status “Em Andamento”.
Este indicador apresenta o volume operacional de orçamentos ainda em aberto, permitindo ao usuário acompanhar rapidamente a quantidade de negociações em andamento.
Card Finalizados
O card Finalizados foi implementado para contabilizar os orçamentos com status “Negócio Fechado” cuja data de aprovação esteja dentro do mês atual.
Esse indicador permite visualizar a quantidade de orçamentos concluídos com sucesso no período vigente.
Card Perdidos
O card Perdidos foi implementado para contabilizar os orçamentos com status “Negócio Perdido” cuja data de aprovação esteja dentro do mês atual.
Com essa informação, o usuário passa a acompanhar os orçamentos não convertidos dentro do período mensal atual.
Card Conversão
O card Conversão foi implementado para exibir o percentual de conversão dos orçamentos, conforme regra definida para os indicadores da tela.
A conversão é exibida em formato percentual, com duas casas decimais, permitindo ao usuário acompanhar o desempenho dos fechamentos em relação à regra de cálculo aplicada no sistema.
Conversão = (Orçamentos fechados no mês atual / Total histórico de orçamentos fechados) × 100
Fonte de dados e carregamento dos indicadores
Os indicadores da tela de Orçamentos são carregados no componente responsável pelos cards de informações da listagem de orçamentos, utilizando consulta na camada de API SQL genérica.
A apuração utiliza os dados das tabelas de orçamento e itens de orçamento, considerando o status do orçamento, os valores financeiros, a data de aprovação e o escopo de acesso do usuário logado.
Regras de escopo por usuário
A consulta dos indicadores respeita o escopo de permissão do usuário:
usuário master visualiza os indicadores sem filtro por representante; usuário não master visualiza os indicadores filtrados pelo representante vinculado; quando o usuário não possuir representante vinculado, os indicadores devem ser retornados com valor zerado.
Esse comportamento garante que os cards exibam informações compatíveis com a permissão operacional do usuário.
Tratamento e exibição dos valores
Os valores dos cards foram tratados para exibição adequada na interface:
Valor Total exibido com duas casas decimais; Conversão exibida com duas casas decimais e sufixo de percentual; Andamento, Finalizados e Perdidos exibidos como contadores inteiros; em caso de erro na consulta, os indicadores devem retornar valor zero.
Com essa melhoria, a tela de Orçamentos passa a apresentar uma visão resumida e objetiva dos principais indicadores do processo comercial.
