Pular para o conteúdo
Voltar ao portfólio

Plataforma de Precificação: orçamentos comerciais

  • React
  • TypeScript
  • Convex
  • Keycloak
  • Claude Code
  • Vitest
  • Stryker

Meu papel

Construí o sistema de ponta a ponta, da modelagem das regras comerciais à skill /inbot-orcamento.

O comercial da InBot montava orçamentos numa planilha de 2023. A Plataforma de Precificação leva essas regras para um sistema em que o preço é calculado no servidor, cada mudança fica registrada e o orçamento só sai quando as aprovações necessárias foram dadas.

Catálogo e tabelas versionadas: produtos com código, categoria e preço base; tabelas de preço com vigência e status rascunho → ativa → arquivada.
Regras comerciais no servidor: desconto de parceiro, percentual de precificação e desconto manual, aplicados na gravação e congelados no item.
Cinco tipos de cobrança: setup, mensalidade, faixas por uso, pacote com franquia e preço de referência.
Alçadas de aprovação: desconto acima do limite ou margem abaixo do mínimo exigem aprovação antes do envio.
Proposta pronta: seções editáveis com variáveis de template, exportação em PDF e Word.
Auditoria: toda alteração grava o registro na mesma transação, com o usuário que a fez.
Operada por agente: a skill /inbot-orcamento entrevista quem é do comercial em linguagem simples, traduz o pedido nos produtos da tabela de preço, mostra a prévia dos totais, grava o orçamento e gera a proposta em PDF com a identidade da InBot. Quem não conhece o sistema monta uma proposta conversando com o Claude Code.

Sistema interno da InBot: o código é proprietário e os prints usam dados fictícios.

Antes

Orçamentos feitos numa planilha de 2023, com fórmulas copiadas de proposta em proposta, sem versão de tabela de preço e sem controle de desconto fora da política.

O problema

Os orçamentos nasciam de uma planilha de 2023, com fórmulas copiadas de proposta em proposta. Não havia versão de tabela de preço, um desconto fora da política passava sem ninguém ver e era difícil saber qual preço valia para um orçamento antigo.

A cada mudança de preço, o risco era a planilha e as propostas já enviadas contarem histórias diferentes.

A solução

Modelei o domínio no Convex com tabelas de preço versionadas e com vigência: versões ativas não se sobrepõem no mesmo segmento, e o simulador mostra qual tabela valia em qualquer data. O preço de cada item é recalculado no servidor pela fórmula da planilha e congelado no próprio item, junto com a grade de faixas vigente.

Alçadas por perfil decidem quem precisa aprovar, e o orçamento não sai de rascunho com aprovação pendente. As regras foram construídas em TDD, com Vitest, testes de Convex e mutation testing com Stryker.

Por cima do sistema, criei a skill /inbot-orcamento: o Claude Code entrevista a pessoa sobre o cliente, escolhe produtos e quantidades na tabela vigente, mostra a prévia e só grava e publica a proposta em PDF depois do "sim".

Decisões e trade-offs

Preço recalculado no servidor pela fórmula da planilha e congelado no próprio item, junto com a grade de faixas vigente. Tabelas de preço com vigência que não se sobrepõem no mesmo segmento. Alçadas por perfil: o orçamento não sai de rascunho com aprovação pendente.

Os resultados

A precificação saiu da planilha para um sistema auditável, com 308 commits e 224 arquivos de teste. Cada orçamento guarda o preço e as regras que valiam no momento em que foi montado, e a proposta sai pronta em PDF ou Word a partir de uma biblioteca de seções. Com a skill, quem não conhece o sistema também monta orçamentos e propostas.

Resultados em números

  • 5Tipos de cobrança
  • 308Commits
  • 224Arquivos de teste
  • /inbot-orcamentoOperação por agente