Documentação/Produto
Todos os públicos
3 min de leitura

Vídeo

(1)
Apresentação da plataforma (tour completo)9:16

Visão geral da plataforma

Última atualização: 23/07/2026
Status: disponível em homologação

Finalidade

O GV - Gestor de Vendas centraliza a gestão comercial das lojas Technos. A plataforma recebe as vendas do ERP Protheus ou de planilha, combina esses dados com metas, pessoas, atendimentos e perdas, e entrega acompanhamento operacional para administração, supervisão, liderança de loja e vendedores.

Componentes

ComponenteTecnologiaResponsabilidade
Backoffice webReact, TanStack Router/Query, ViteCadastros, metas, auditoria, dashboard e relatórios
Tablet/lista da vezReact PWA com fila offlineFila de vendedores, atendimentos, pausas e perdas
Visão do vendedorReactIndicadores pessoais, meta do dia/mês e campanhas
APINode.js e NestJSAutenticação, regras de negócio, REST e integrações
BancoPostgreSQL e PrismaPersistência transacional e auditoria
RedisRedisInfraestrutura preparada para filas e trabalhos assíncronos
IntegraçãoProtheus REST e planilhaEntrada e reconciliação de vendas

Perfis e escopo

Perfil na interfacePapel da APIEscopo principal
AdministradorADMIN ou SUPER_ADMINEmpresa inteira, todas as lojas e configurações
SupervisorREGIONAL_MANAGERSomente lojas vinculadas ao supervisor
Lojista/líderSTORE_MANAGERDashboard, relatórios, auditorias e consulta de funcionários somente da loja vinculada
VendedorSELLERPróprios indicadores e operação autorizada na loja
TabletDEVICEOperação do dispositivo e da loja vinculada

O escopo é aplicado no backend. Os seletores e tabelas do frontend também limitam as opções conforme o usuário autenticado.

Módulos do backoffice

  • Dashboard: números comerciais, comparação com mês anterior, performance, situação das lojas, ranking, série por período e detalhamento por supervisor ou loja. O filtro começa no mês atual e é preservado ao navegar.
  • Metas: criação por loja e mês, divisão semanal, três faixas de meta, distribuição por vendedor e por dia, edição pelo mesmo assistente e publicação.
  • Campanhas: comunicação de campanhas comerciais para as equipes.
  • Lojas: cadastro, edição, CNPJ, código Protheus, operação, funcionamento e supervisor.
  • Funcionários: usuários e vendedores, foto, credenciais, férias, ausências, lotações temporárias, transferências e trilha de auditoria.
  • Auditoria: validação diária das vendas e tratamento de divergências de NF.
  • Relatórios: Raio-X, comparador de períodos, analítico de vendas e perdas.
  • Configurações: motivos de perda, feriados, parâmetros, fontes de dados e logs.

Fluxo dos dados

  1. O administrador mantém lojas, supervisores, líderes, vendedores e calendários.
  2. As metas mensais são distribuídas conforme dias de operação da loja e disponibilidade do vendedor.
  3. O Protheus envia movimentos de venda em sincronizações agendadas ou manuais.
  4. A API cria ou atualiza lojas, vendedores, vendas, itens e totais diários.
  5. Alterações em uma NF já recebida e notas sem vendedor entram no Validador NF.
  6. O responsável confere e valida os totais por loja e dia no Validador de dados.
  7. Vendas incluídas nos indicadores alimentam metas, dashboards e relatórios.
  8. Atendimentos e perdas do tablet alimentam conversão, produtividade e motivos.
  9. Toda ação crítica gera registro para auditoria.

Princípios de operação

  • A NF é a unidade de reconciliação da integração de vendas.
  • Uma carga repetida deve atualizar o mesmo registro, não duplicar a venda.
  • Uma divergência não sobrescreve silenciosamente uma NF já conhecida.
  • O operador decide se uma NF validada participa ou não das metas e indicadores.
  • Validação manual e bloqueio de atualização preservam a decisão humana.
  • Férias, ausências, lotação, funcionamento e feriados afetam os dias disponíveis para distribuição das metas.
  • Senhas, PINs e tokens nunca devem aparecer em documentos ou telas compartilhadas.

Rotas principais

ExperiênciaRota
Login do backoffice/login
Dashboard/dashboard
Tablet/lista da vez/listavez/login
Visão do vendedor/vendedor/login
Apresentação institucional existente/pitch
Apresentação executiva do sistema/pitch2

Situação da solução

A solução está em homologação com backend e banco reais, integração Protheus, processos de validação, metas, dashboards, relatórios e experiências de tablet e vendedor. Antes de produção definitiva devem ser executados o roteiro de QA, a validação de dados com o cliente, o treinamento dos perfis e a definição formal de backup, monitoramento e suporte.