Estudo de caso · Sistema corporativo

Gestão de licitações públicas, da cotação ao recebimento.

Desenvolvi dez módulos do sistema interno de uma empresa que fornece a prefeituras e órgãos públicos. O trabalho inclui regras de negócio, banco de dados, interface, documentos com assinatura digital e testes automatizados.

10
módulos
29 mil+
linhas de código
1.100+
casos de teste

O nome da empresa, os clientes e os números reais são confidenciais. As telas desta página usam dados fictícios e reproduzem o visual do produto.

Contexto

Fornecer para o setor público envolve um ciclo longo, com prazos legais e documentos oficiais.

Entre a cotação de um item e o recebimento passam meses. Os módulos cobrem todas as etapas:

  1. 1

    Comercial

    Treinamento da equipe de cotação, comprovação de preços e obtenção dos atestados exigidos nas licitações.

  2. 2

    Contratos e recebimento

    Saldo de cada contrato, acompanhamento do faturamento e cobrança de valores em atraso.

  3. 3

    Financeiro

    Caixa, cartões, impostos, projeções e indicadores da empresa.

  4. 4

    Equipe

    Comissões, folha mensal e relatórios oficiais em PDF.

Módulos

Os dez módulos

Selecione um módulo para ver a tela e as funções. Clique na imagem para ampliar.

Quadro de simulações de cotação com a nota da rubrica

Comercial · Treinamento

Capacitação de cotação

Ambiente de treino para a equipe de cotação. O sistema gera licitações fictícias, o cotador trabalha item a item e recebe uma nota de 0 a 10 com comentários sobre cada decisão. Nada do treino chega às vendas reais.

  • Cenários gerados automaticamente, com custo de referência oculto
  • Avaliação em cinco critérios: cobertura, custo, qualidade da fonte, margem e a decisão de não cotar
  • Mesmas travas do processo real, incluindo a conferência por IA
  • Quadro com fila, rejeitadas e concluídas, com atribuição por trainee

Node.jsRegras purasSandbox≈ 60 testes

Quero algo assim na minha empresa →
Editor do laudo de exequibilidade com a prévia do PDF

Comercial · Documento oficial

Laudo de exequibilidade

Quando o órgão questiona se o preço é viável, a empresa precisa comprová-lo. O módulo monta o laudo com o custo de cada item (compra, frete, imposto e despesas) e a origem de cada valor, e emite o PDF com assinatura digital.

  • Situação de cada item definida por cálculo: viável, margem apertada ou inviável
  • Bloqueia a emissão quando falta dado ou evidência e indica o que está pendente
  • Prévia do PDF em tempo real, com marca d'água
  • Documento emitido é imutável, com assinatura e hash; correções geram nova versão

Assinatura PAdESSHA-256pdf.js≈ 96 testes

Quero algo assim na minha empresa →
Lista de órgãos priorizados e prévia do ofício assinado

Comercial · Documentos e e-mail

Atestados de capacidade técnica

Muitas licitações exigem atestado de quem já comprou da empresa. O módulo localiza as entregas que podem embasar o pedido, gera o ofício de pedido assinado, deixa o e-mail pronto com os anexos e acompanha a resposta de cada órgão.

  • Define a ordem dos pedidos conforme as próximas licitações que exigem atestado
  • Ofício em PDF com assinatura digital do certificado da empresa
  • O e-mail fica em rascunho e só sai depois da revisão de uma pessoa
  • Leitura das conversas para indicar a próxima ação: responder, cobrar após 15 dias ou aguardar

PDF + PAdESIMAPPriorização≈ 220 testes

Quero algo assim na minha empresa →
Itens ganhos agrupados por cidade e processo com o valor devido

Contratos e recebimento · Operação

Gerência de itens

Tudo o que a empresa ganhou, por cidade, processo e item: saldo do contrato, pedidos, situação da nota fiscal e valor a receber de cada órgão. O financeiro dá baixa nos pagamentos linha a linha.

  • Consulta reduzida de 186 ms para 68 ms, medida em produção
  • Paginação que mantém cada cidade em uma só página
  • Correções em lote com simulação prévia e opção de desfazer
  • Registro manual de item ganho quando a fonte automática falha, com histórico

SQL e índicesPaginaçãoBaixa de pagamento≈ 190 testes

Quero algo assim na minha empresa →
Lista de notas a cobrar por atraso e prévia do ofício de cobrança

Contratos e recebimento · Financeiro

Cobranças

Lista o que cada órgão deve, por valor e faixa de atraso. A partir dela, o financeiro gera o ofício assinado e o e-mail com as notas fiscais anexadas, e acompanha a cobrança até o pagamento.

  • Dois tons de ofício; acima de 60 dias, o texto cita a lei de licitações
  • Sincronização das notas fiscais com o Google Drive a cada hora
  • Leitura da DANFE com validação da chave de acesso; IA apenas para notas em imagem
  • Proteção contra cobrança duplicada da mesma nota

Apps ScriptDANFEIMAP≈ 114 testes

Quero algo assim na minha empresa →
Controle financeiro com saldos, projeção de caixa e simulação de compra

Financeiro · Maior módulo do sistema

Controle financeiro

Centraliza as finanças das empresas do grupo: saldo de cada conta, cartões com parcelas e faturas, custos fixos, orçamento, recebimentos, fechamento mensal e DRE.

  • Simulação de compra: mostra o impacto no caixa e indica o melhor cartão
  • Importação de extratos OFX, CSV e PDF com prévia e sem lançamento duplicado
  • Faturas de cartão com a data real de fechamento, considerando feriados
  • Projeção de caixa, DRE, apuração do Simples Nacional e fechamento a partir do XML das notas
  • Dados de cartão criptografados (AES-256), com registro de cada acesso

OFX/CSV/PDFConciliaçãoDREAES-256≈ 350 testes

Quero algo assim na minha empresa →
Dashboard com resultado, a receber, gráfico de 12 meses e curva ABC

Financeiro · Indicadores

Dashboard da empresa

Indicadores para a direção da empresa: resultado, valores a receber, entradas, saldo de contrato não faturado e ticket médio, em qualquer período, com comparação ao período anterior ou ao mesmo período do ano passado.

  • Atrasos por faixa e prazo médio de recebimento
  • Curva ABC de clientes, Pareto e meta × realizado
  • Cerca de 14 consultas em paralelo para montar a tela
  • Gráficos próprios em SVG, sem biblioteca externa

SQL/CTEIndicadoresSVG

Quero algo assim na minha empresa →
Painel de transparência com a situação da comissão de cada item

Equipe · Auditoria

Transparência de comissões

Cada colaborador acompanha a comissão gerada em cada item e a etapa em que ela está: aguardando pedido, aguardando liberação, a sacar no mês ou paga. Quando o valor ainda não foi liberado, a tela informa o motivo.

  • Liberação proporcional ao que o órgão já pagou, no mês do recebimento
  • Cálculo centralizado em um único ponto, com teste que impede contas duplicadas
  • Dado ausente aparece como pendência, com o motivo, e não como R$ 0,00
  • Descontos e abonos com justificativa registrada

SQL/CTEPró-rataAuditoria≈ 67 testes

Quero algo assim na minha empresa →
Grade da folha de pagamento com fixo, bônus, comissão e total

Equipe · Financeiro

Folha de pagamento

Folha mensal da equipe com fixo, bônus, comissão liberada, moedas de incentivo e descontos. O financeiro edita os valores em uma grade e exporta o PDF timbrado.

  • Usa o mesmo cálculo de comissão da tela de transparência
  • Gravação em transação única: se uma linha falha, nada é salvo
  • Recálculo em tempo real e chave PIX herdada do mês anterior

Transação em lotePDF

Quero algo assim na minha empresa →
Geração de relatórios em PDF timbrado

Equipe · Documentos

Relatórios

PDFs em papel timbrado: comissões por pessoa, ou de toda a equipe em um ZIP com um arquivo para cada uma, e faturamento e recebimentos do período.

  • Atalhos de período: semana, quinzena, mês e últimos 30 dias
  • Tratamento de caracteres especiais, que antes quebravam os PDFs
  • Geração disponível na tela e por linha de comando

pdf-libZIPCLI

Quero algo assim na minha empresa →

Engenharia

Critérios aplicados a todos os módulos

Um sistema que lida com dinheiro e documentos oficiais precisa fechar as contas, guardar histórico e produzir registros confiáveis.

Regras de negócio isoladas

Cada regra é uma função independente de banco e de rede. A mesma lógica atende a tela, o PDF e os testes.

Histórico completo

Cada alteração registra autor, data, origem, motivo e os valores anterior e novo, na mesma transação.

Cálculo centralizado

Valores sensíveis vêm de um único ponto de cálculo, e um teste automático falha se a conta for refeita em outro lugar.

Dado ausente não vira zero

Quando falta informação, a tela indica o motivo em vez de exibir um R$ 0,00 enganoso.

Documentos imutáveis

Ofícios e laudos emitidos ficam travados, com assinatura digital e hash. Correções geram uma nova versão.

Testes com banco real

Além dos testes rápidos de cada regra, a suíte sobe um PostgreSQL descartável e percorre o fluxo inteiro.

Regra pura: a situação do item é sempre calculada trecho ilustrativo
function statusDoItem({ custoCents, precoCents, margemMinima }) {
  if (custoCents == null || precoCents == null)
    return { status: 'incompleto', motivo: 'falta custo ou preço' };
  const margem = (precoCents - custoCents) / precoCents;
  if (margem < 0)            return { status: 'inviavel', margem };
  if (margem < margemMinima) return { status: 'apertado', margem };
  return { status: 'viavel', margem };
}
Alteração e histórico gravados na mesma transação trecho ilustrativo
await tx(pool, async (client) => {
  const antes = await lerComTrava(client, id);   // SELECT … FOR UPDATE
  const v = regra.validar(antes, entrada);       // função pura
  if (!v.ok) throw new Recusa(v.motivo);
  await gravar(client, id, v.para);
  await registrarEvento(client, {
    tipo: 'DocumentoAtualizado', entidadeId: id,
    payload: { de: antes, para: v.para, motivo: entrada.motivo },
    autor, contexto,
  });
});

Back-end

Node.jsExpressEJSBullMQ + Redisnode-cron

Dados

PostgreSQLSQL com CTEsJSONBLog de eventos

Front-end

JavaScript puroTailwinddaisyUISVGpdf.js

Documentos

pdf-libAssinatura PAdESNF-e XML/DANFEOFX/CSV

Integrações

E-mail IMAPGoogle Apps ScriptEmissor de NF-eAPIs de CNPJ/CEPLLMs

Qualidade

Testes de unidadePGliteTestes-guardaGitHub Actions

Precisa de um sistema para a sua empresa?

Comissões, cobrança, caixa e documentos oficiais podem funcionar em um sistema desenvolvido para os processos da sua operação.

WhatsApp