Sistema de Ordens de Serviço
Controla a manutenção de equipamentos industriais, da entrada na oficina até o relatório entregue ao cliente.
- Meu papel
- Único desenvolvedor, do início no estágio até a produção: especificação, backend, frontend e deploy.
- Tecnologias
- .NET 10 · React 19 · TypeScript · PostgreSQL · Docker · Azure DevOps · Spec Kit · Claude Code
- Em análise
- Aguardando orçamento
- Aguardando peças
- Em execução
- Finalização
- Entregue
O problema
A CRC Equipamentos acompanhava cada ordem de serviço em papel, Trello e planilhas, e montava à mão o relatório entregue ao cliente. Para saber o andamento de uma OS, era preciso perguntar a alguém.
O que entreguei
- Fluxo único da OS, registrando quem fez o quê e quando em cada etapa.
- Checklist técnico com pontuação por peça, que calcula se o reparo compensa.
- Fotos de evidência com marcação direto do celular e relatório em PDF gerado pelo sistema.
- Quadro Kanban, painel operacional, permissões por perfil e importação de peças por Excel.
- 358 testes automatizados e entrega contínua com Azure DevOps e Docker.
Decisões técnicas
Checklist congelado na entrega
Quando a OS é entregue, o checklist preenchido vira uma cópia imutável. Mudar o modelo depois não altera o histórico.
Custo da escolha: exige versionar os modelos de checklist.
Contrato único entre API e frontend
Os tipos e as chamadas do React são gerados a partir do OpenAPI com Orval. Uma mudança na API aparece como erro de compilação, não como bug na tela.
Custo da escolha: um passo a mais de geração a cada mudança.
Resultado
Em produção na CRC Equipamentos, depois de três versões entregues e validadas em homologação.
Sistema feito na Rumo Soluções: o código e as telas não são públicos.