Vídeo
(1)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
| Componente | Tecnologia | Responsabilidade |
|---|---|---|
| Backoffice web | React, TanStack Router/Query, Vite | Cadastros, metas, auditoria, dashboard e relatórios |
| Tablet/lista da vez | React PWA com fila offline | Fila de vendedores, atendimentos, pausas e perdas |
| Visão do vendedor | React | Indicadores pessoais, meta do dia/mês e campanhas |
| API | Node.js e NestJS | Autenticação, regras de negócio, REST e integrações |
| Banco | PostgreSQL e Prisma | Persistência transacional e auditoria |
| Redis | Redis | Infraestrutura preparada para filas e trabalhos assíncronos |
| Integração | Protheus REST e planilha | Entrada e reconciliação de vendas |
Perfis e escopo
| Perfil na interface | Papel da API | Escopo principal |
|---|---|---|
| Administrador | ADMIN ou SUPER_ADMIN | Empresa inteira, todas as lojas e configurações |
| Supervisor | REGIONAL_MANAGER | Somente lojas vinculadas ao supervisor |
| Lojista/líder | STORE_MANAGER | Dashboard, relatórios, auditorias e consulta de funcionários somente da loja vinculada |
| Vendedor | SELLER | Próprios indicadores e operação autorizada na loja |
| Tablet | DEVICE | Operaçã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
- O administrador mantém lojas, supervisores, líderes, vendedores e calendários.
- As metas mensais são distribuídas conforme dias de operação da loja e disponibilidade do vendedor.
- O Protheus envia movimentos de venda em sincronizações agendadas ou manuais.
- A API cria ou atualiza lojas, vendedores, vendas, itens e totais diários.
- Alterações em uma NF já recebida e notas sem vendedor entram no Validador NF.
- O responsável confere e valida os totais por loja e dia no Validador de dados.
- Vendas incluídas nos indicadores alimentam metas, dashboards e relatórios.
- Atendimentos e perdas do tablet alimentam conversão, produtividade e motivos.
- 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ência | Rota |
|---|---|
| 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.
