CRM · Gestão comercialProjeto 01 / 06

Vértice CRM

Gestão comercial completa para pequenas empresas.

Uma plataforma que centraliza leads, clientes, oportunidades, tarefas e o histórico de relacionamento em um único ambiente, com pipeline visual, follow-ups e permissões por perfil.

  • React 19
  • Node.js
  • Express 5
  • API REST
  • SQLite
  • JWT

Case demonstrativo. A Vértice Solar, integradora de energia solar de Goiânia (GO), é uma empresa fictícia e todos os dados de clientes e leads foram gerados artificialmente.

Pipeline de vendas em kanban com etapas Prospecção, Visita técnica e Proposta enviada
ProspecçãoVisita técnicaProposta enviadaNegociação
01A jornada de uma venda

Do primeiro contato ao fechamento, sem perder o fio.

Cada etapa do funil comercial tem uma tela própria no sistema. Role para acompanhar uma oportunidade do início ao fim.

  1. 01 · Lead

    O contato entra organizado.

    Cadastro com origem, segmento e conta de luz, que gera o kWp estimado do sistema. Abas por status e filtros por origem, segmento e responsável.

    • Origem
    • kWp estimado
    • Abas por status
    Lista de leads com abas por status e filtros por origem, segmento e responsável
  2. 02 · Cliente

    Qualificou, virou cliente.

    Um lead qualificado vira cliente e oportunidade de uma só vez, em uma transação. A carteira reúne PF e PJ, e cada cliente tem uma página 360°.

    • Conversão em 1 passo
    • PF e PJ
    • Página 360°
    Carteira de clientes com segmento, cidade, oportunidades abertas e total contratado
  3. 03 · Pipeline

    A oportunidade avança no kanban.

    Arrastar o card muda a etapa, com totais por coluna e previsão ponderada. A interface responde na hora e desfaz a mudança se a API recusar.

    • Arrastar e soltar
    • Totais por etapa
    • Previsão ponderada
    Pipeline de vendas em kanban com etapas Prospecção, Visita técnica e Proposta enviada
  4. 04 · Follow-up

    Nenhum retorno esquecido.

    Tarefas agrupadas em atrasadas, hoje, amanhã e próximos 7 dias, vinculadas ao contato e concluídas em um clique. Cada interação vai para a linha do tempo.

    • Atrasadas · hoje · 7 dias
    • Linha do tempo
    Lista de tarefas com grupo de atrasadas, prioridade e vínculo com o contato
  5. 05 · Fechamento

    Ganho ou perda, sempre com motivo.

    A perda exige um motivo. O resultado entra no funil, nas vendas do mês e no balanço de ganhos e perdas do período.

    • Motivo de perda
    • Funil por etapa
    Gráfico de vendas fechadas nos últimos seis meses e funil de vendas por etapa
02Visão do gestor

O comercial inteiro em um painel.

A visão consolidada da equipe: pipeline aberto, vendas do mês comparadas ao mesmo período do mês anterior, novos leads e taxa de conversão, com alerta de tarefas atrasadas logo no topo.

Dashboard do Vértice CRM com indicadores comerciais
  • Pipeline aberto
  • Vendas do mês vs. mesmo período anterior
  • Novos leads
  • Conversão e ticket médio
  • Funil, origem dos leads e ranking
03Quem vê o quê

Cada perfil enxerga a sua parte.

O controle de acesso é aplicado no backend e refletido na interface. Registros fora do escopo de um vendedor retornam 404: a API não confirma que eles existem.

Permissões por perfil no Vértice CRM
AçãoAdminGerenteVendedor
Ver e editar os próprios leads, clientes e oportunidades
Ver registros de toda a equipe
Reatribuir responsável
Excluir registros
Dashboard da equipe e ranking
Gerenciar usuários
04Experiência

Os detalhes que fazem diferença no uso.

  • Busca global Ctrl + K

    Encontra clientes, leads e oportunidades com navegação por teclado.

  • Filtros e paginação no servidor

    Status, origem, segmento, UF, tipo, responsável e prioridade, com ordenação por coluna.

  • Kanban otimista

    A interface responde na hora e desfaz a mudança se a API recusar.

  • Login protegido

    Senhas com bcrypt, limite de tentativas e mensagem genérica que evita enumeração de usuários.

  • Escopo por registro

    Registros fora do escopo de um vendedor retornam 404: a API não confirma que existem.

  • Fuso de Brasília

    Datas, prazos e agrupamentos de tarefas calculados no fuso correto.

05Tecnologia

Como o sistema é construído.

Frontend
React 19 · Vite · React Router · Tailwind CSS 4 · Recharts
Backend
Node.js 22 · Express 5
API
REST com validação Zod
Banco
SQLite (node:sqlite) com chaves estrangeiras e índices
Autenticação
JWT · bcrypt · rate limit · helmet
Permissões
RBAC no backend
Arquitetura
  1. 01Navegador · SPA React
  2. 02API REST · Express
  3. 03Autenticação JWT + RBAC
  4. 04Regras e validação · Zod
  5. 05SQLite

Decisões técnicas

  • Permissões aplicadas no backend, não apenas escondidas na interface.
  • Conversão de lead em cliente e oportunidade dentro de uma única transação.
  • Em produção, a API serve o front compilado em uma única porta.
06Roadmap

Próximos passos.

Evoluções previstas na documentação do projeto. Nenhuma delas está implementada.

  • Planejado · não implementadoMigrar o banco para Supabase (Postgres) com Row Level Security espelhando o RBAC atual
  • Planejado · não implementadoWebhooks para n8n: leads do formulário do site e do Instagram entrando direto no CRM
  • Planejado · não implementadoIntegração de WhatsApp (Evolution API / Chatwoot) registrando conversas na linha do tempo
  • Planejado · não implementadoGeração da proposta comercial em PDF a partir da oportunidade
  • Planejado · não implementadoTestes automatizados (Vitest + Supertest) e integração contínua

Seu processopode ser um sistema.

A CLV cria sistemas sob medida para transformar processos complexos em operações mais simples, organizadas e escaláveis.