planejamento de projeto · v1.0

ERP de Vendas & Comissões integrado ao DataCrazy

Roteiro de execução do MVP: da integração com o DataCrazy até o dashboard gerencial, passando pelo motor de comissões configurável e o controle documental de cada venda.

DataCrazyIntegraçãoMotor de RegrasComissãoFinanceiroDashboard
7
etapas de execução
~8–10
semanas estimadas · MVP
2
perfis de acesso
1
integração externa (DataCrazy)

Etapas do desenvolvimento

escopo · MVP (item 16 do briefing)
01

Levantamento, acessos e arquitetura

~1 semana

Confirmar regras de negócio junto ao cliente, mapear os dados disponíveis na API do DataCrazy e definir a arquitetura técnica (banco de dados, autenticação e perfis de acesso).

  • Validação de requisitos e regras de comissão
  • Modelagem do banco de dados
  • Definição de perfis: Atendente/Corretor e Gestor/Administrador
  • Estrutura de login individual por usuário
  • Ambiente de desenvolvimento configurado
02

Integração com o DataCrazy

~1–2 semanas

Construir a camada de sincronização que importa vendas, clientes, atendentes e produtos do DataCrazy para dentro do ERP, sem duplicar informação.

  • Conexão via API com o DataCrazy
  • Sincronização de vendas, clientes e atendentes
  • Identificação automática do atendente responsável por cada venda
  • Separação clara entre campos vindos do DataCrazy e campos internos do ERP
03

Módulo de Vendas & Produtos

~1 semana

Cada venda sincronizada vira um registro próprio no ERP, com página individual; produtos recebem cadastro com suas regras comerciais.

  • Listagem "Todas as vendas" e "Minhas vendas"
  • Página de detalhe da venda (cliente, produto, valor, status)
  • Cadastro de produtos e regras comerciais (comissão, repasses, descontos)
  • Vínculo automático produto ↔ valor da venda
04

Motor de Comissões

~1–2 semanas

O núcleo do sistema: cálculo automático da comissão por venda, com fórmula configurável pelo administrador e histórico completo de cada cálculo.

  • Fórmula configurável sem alteração de código
  • Cálculo automático (VGV × percentual do produto)
  • Registro de fórmula, percentual, valor-base e resultado por venda
  • Histórico de alterações manuais na comissão
MVP

Escopo inicial: fórmula simples (VGV × %). Regras por cargo, faixa de venda e campanha entram na fase de evolução (item 16 do briefing).

05

Documentos & fluxo financeiro da comissão

~1 semana

Cada venda ganha sua própria área de documentos, e a comissão passa a ter um status que evolui conforme o fluxo financeiro é cumprido.

  • Upload de comprovante de pagamento e nota fiscal
  • Registro de nome, categoria, data e usuário do upload
  • Fluxo de status: gerada → a receber → paga → cancelada
  • Área "Comissões" com filtros por período, atendente, produto e status
06

Dashboard & páginas iniciais

~1 semana

Painéis de indicadores para gestor e atendente, com os principais números de vendas e comissões filtráveis por período.

  • Página inicial do atendente (resumo do mês, minhas vendas)
  • Página inicial do gestor (VGV, vendas, comissões geradas/a pagar)
  • Dashboard básico com filtros por período, produto e atendente
  • Indicadores: VGV total, ticket médio, comissão total gerada/recebida
07

Auditoria, testes e entrega

~1 semana

Registro de histórico das alterações críticas, testes de ponta a ponta com dados reais do DataCrazy e entrega do MVP em produção.

  • Log de auditoria (quem, quando, valor anterior/novo)
  • Testes de sincronização e cálculo de comissão
  • Ajustes finais e homologação com o cliente
  • Deploy do MVP em ambiente de produção

Depois do MVP

Evoluções previstas no briefing (item 16), a serem priorizadas em uma etapa posterior, fora do escopo desta primeira entrega:

Relatórios avançados Metas por atendente Ranking & gamificação Comparação entre períodos Notificações Aprovação de pagamentos Regras por cargo/campanha