GestFrota

O cliente

Prefeituras contratam uma empresa gerenciadora para abastecer a frota municipal numa rede de postos credenciados, com cartão por veículo. O edital de Carlos Chagas descreve em detalhe o que esse sistema precisa fazer: senha do condutor, limite por veículo, teto de preço, comprovante no posto, contingência quando a rede cai e uma longa lista de relatórios. Editais desse tipo são muito parecidos entre municípios. Por isso o GestFrota foi pensado como produto para várias gerenciadoras, cada uma com vários contratos, e não como sistema de uma prefeitura só.

O desafio

Dinheiro público exige que cada litro seja explicado ao fiscal do contrato. Uma autorização errada, um centavo perdido em arredondamento ou um relatório com o dia errado vira glosa e problema na prestação de contas. Os dados de um contrato não podem aparecer em outro, nem se a aplicação tiver um erro. E tudo isso precisava caber numa VPS de 1 vCPU e 4 GB, junto de outros projetos.

O que foi construído

O centro do sistema é um motor de autorização: cada regra do edital, como cartão ativo, condutor habilitado, saldo do veículo, combustível compatível e preço abaixo do teto, é uma função pura testada que responde aprovado ou recusado com motivo. Toda transação entra num registro único de eventos que não se edita, e o estorno é um evento novo que aponta para o original. O isolamento entre organizações e contratos fica no próprio PostgreSQL, com segurança por linha e um papel de banco sem permissão para ignorar essas regras. Cada requisito tem um identificador ligado à cláusula do edital, e esse identificador aparece nos commits e nos testes.

O que o sistema faz

• Cadastro de veículos, condutores e cartões, com importação em massa, bloqueio e cancelamento imediato.
• Motor de autorização com regras parametrizáveis por contrato e um simulador que usa as mesmas funções.
• Teto de preço por litro pela média semanal da ANP no município, importada por tarefa agendada.
• Limite de gasto por veículo e período, com exceção que só passa com autorização registrada.
• Lançamento de contingência a partir do formulário em papel do posto, com prazo e justificativa.
• Catálogo de relatórios com período livre, exportação em planilha e PDF com cabeçalho institucional.
• Fatura por centro de custo, repasse ao posto, ocorrências do fiscal e trilha de auditoria de cada alteração.
• Registro de viagens em que dois usos do mesmo veículo ou do mesmo motorista no mesmo horário são barrados pelo próprio banco.

Perguntas frequentes