Sistema de ordem de serviço: o que ele precisa ter e como o agente do MadBuilder montou um

Um sistema de ordem de serviço (OS) é o programa que acompanha cada serviço da entrada à entrega: quem é o cliente, que equipamento chegou, qual técnico cuida dele, em que status a ordem está, quanto vai custar e quando fica pronta. No mínimo, ele precisa de cadastros de clientes, técnicos e equipamentos, ordens com status, valores e datas, um dashboard e a OS em PDF.

Abaixo, você vê o que cada parte faz e o passo a passo de uma gravação real em que o agente de IA do MadBuilder monta um sistema para assistência técnica a partir de um pedido em português.

O que um sistema de ordem de serviço precisa ter

Estas são as partes que o dono de uma assistência técnica pediu na gravação. Cada uma vira um tipo de tela:

Parte	Para que serve	Tipo de tela
Clientes	Quem trouxe o equipamento	Formulário e listagem
Técnicos	Quem faz o serviço	Formulário e listagem
Equipamentos	O que entrou na bancada, com a marca	Formulário e listagem
Ordens de serviço	Cliente, equipamento, técnico, status, valor e datas	Formulário e listagem
Dashboard	Faturamento e andamento do trabalho	Dashboard
OS em PDF	O papel que vai para o cliente	Documento

Cadastros ligados entre si

A ordem de serviço aponta para um cliente, um equipamento e um técnico. Por isso, o formulário da OS tem que mostrar nomes, não números. Ninguém na bancada sabe quem é o “técnico 3”. O formulário com listas que vêm do banco resolve isso com uma lista de nomes, com busca.

Status, valores e datas

O status diz em que pé está cada ordem. No exemplo da gravação, são cinco: aberta, aguardando peça, em reparo, pronta e entregue. Valor em reais e datas no formato brasileiro evitam erro na hora de cobrar e de combinar prazo.

Uma listagem para o dia a dia

Com centenas de ordens, a equipe precisa achar uma OS rápido. Busca, filtros e paginação são o mínimo. A listagem com filtros, totais e exportação ainda soma valores no rodapé e exporta para CSV, Excel ou PDF.

Um dashboard com os números do negócio

Quem cuida da assistência quer saber quanto faturou, quantas ordens estão abertas e quem está com mais serviço. No dashboard com indicadores e gráficos, cada card e cada gráfico faz a própria consulta ao banco. Ninguém escreve consulta à mão.

A ordem de serviço em PDF

A OS impressa é o comprovante que o cliente leva para casa. No MadBuilder, ela é um documento em PDF montado com os dados do registro, o mesmo tipo de página usado para nota, contrato e recibo, com envio por e-mail ou como anexo.

Como criar um sistema de ordem de serviço com o agente do MadBuilder

A página inicial do site tem uma gravação real de 2 min 9 s, com narração, em que o agente monta esse sistema do pedido ao PDF. Ela foi acelerada nos trechos em que o agente está trabalhando e usa dados de exemplo.

O dashboard do sistema criado na gravação. Assista à gravação na página inicial.

1. O pedido, em português

A narração resume o começo: “o dono de uma assistência técnica pede ao agente do MadBuilder um sistema completo: clientes, técnicos, equipamentos e ordens de serviço, com dashboard e a ordem de serviço em PDF”.

2. Um roadmap aprovado antes de começar

“Primeiro, ele monta um roadmap com fases e tarefas, e pede sua aprovação antes de começar.” Roadmap, aqui, é o plano de trabalho. Na gravação, foram 5 fases e 11 tarefas. Esse é o modo de planejamento do agente de IA do MadBuilder: ele propõe o plano sem mexer em nada e só escreve depois que você aprova.

3. As tabelas no banco e as telas

Com o plano aprovado, o agente cria as tabelas no banco e gera cada tela: formulários, listagens e o dashboard. Tudo sai como código Laravel, sem você escrever uma linha.

Para ser exato: o projeto é Laravel comum, com Eloquent, Blade, Alpine, migrations e rotas, e traz junto o framework MAD na pasta packages/. É de lá que vêm os componentes <mad-*> usados nas telas.

4. O teste no Teste Online

“Depois, ele mesmo sobe o sistema no Teste Online, entra com o usuário administrador e confere as telas que criou.” O Teste Online é um ambiente temporário, com endereço público, que usa os mesmos arquivos que vão para produção. Mais detalhes em publicação, deploy e Teste Online.

5. Um ajuste no editor visual

“E você não fica preso ao que a IA fez.” Na gravação, o campo técnico do formulário da OS saiu como número. No editor visual, ele vira uma lista com os nomes da equipe, em poucos cliques. Cada ajuste vira código na hora, no Blade e no PHP do projeto.

No Blade, uma lista ligada a outra tabela fica assim (trecho do cadastro de venda da página de formulário):

<mad-dbcombo-field name="cliente_id" label="Cliente" model="Pessoa"
    display="{nome}" order-by="nome" :required="true" />

6. O documento da OS ligado aos dados

No documento da ordem de serviço, cada campo é ligado aos dados do cliente e do equipamento, direto no painel do editor. Cada OS impressa puxa as informações da própria ordem.

7. O sistema rodando

O fim da gravação mostra o sistema no ar, com 229 ordens de serviço, 60 clientes e 4 técnicos cadastrados:

• A listagem tem busca, filtros e paginação.
• O formulário mostra o equipamento e o técnico pelo nome, com valor e datas no formato certo.
• O dashboard traz o faturamento, as ordens por status, o trabalho de cada técnico e o faturamento por marca.
• A ordem de serviço sai em PDF, pronta para imprimir e entregar ao cliente.

O que a gravação não mostra

Vale deixar claro:

• O tempo é acelerado. Os trechos em que o agente trabalha passam mais rápido. O trabalho real leva mais tempo.
• Os dados são de exemplo. As 229 ordens, os 60 clientes e os 4 técnicos são fictícios.
• Houve ajuste à mão. O técnico como lista e os campos do PDF foram acertados no editor visual, depois do trabalho do agente. A ideia é essa: a IA monta a base e você ajusta no visual.

Por onde começar

Se você prefere começar sem o agente, a modelagem de dados tem 13 templates de domínio, e um deles é ordem de serviço com SLA (o prazo de atendimento combinado com o cliente). Você parte de um diagrama pronto e ajusta as tabelas.

Depois de pronto, o sistema pode rodar na MadCloud, a hospedagem gerenciada em São Paulo, com HTTPS, banco com 30 dias de backup e staging, ou no servidor da sua empresa, por SSH ou Git. Se você cuida da empresa e não programa, veja o MadBuilder para empresas.

Perguntas frequentes

Preciso saber programar para criar um sistema de ordem de serviço?

Não para montar as telas. Você descreve o sistema em português e o agente monta, ou arrasta componentes no editor visual. Regras muito específicas do seu negócio ficam mais fáceis com um desenvolvedor por perto, e ele vai encontrar um projeto Laravel comum.

O sistema fica preso ao MadBuilder?

Não. Nos planos pagos, você baixa o projeto inteiro a qualquer momento. É um projeto Laravel com o framework MAD incluído na pasta packages/, e ele roda no seu servidor ou na MadCloud. Se você parar de usar o MadBuilder, o sistema continua funcionando.

A ordem de serviço em PDF sai com os dados de cada OS?

Sim. O documento é montado com os dados do registro. Na gravação, os campos foram ligados aos dados do cliente e do equipamento no painel do editor.

Quanto custa?

O plano Gratuito cobre 1 projeto com até 20 tabelas. Para baixar o código e publicar no seu servidor, os planos começam em R$ 997 por desenvolvedor, por ano. O agente de IA funciona com a sua própria chave de API no plano Pro IA, ou com a IA inclusa do Mad Coding Plan, a partir de R$ 97 por mês, que exige o plano Pro. Os detalhes estão na página de preços.