Sistema de órdenes de servicio: qué necesita y cómo lo armó el agente de MadBuilder

Un sistema de órdenes de servicio (OS) es el programa que sigue cada trabajo desde el ingreso hasta la entrega: quién es el cliente, qué equipo llegó, qué técnico se encarga, en qué estado está la orden, cuánto va a costar y cuándo queda lista. Como mínimo, necesita registros de clientes, técnicos y equipos, órdenes con estado, montos y fechas, un dashboard y la OS en PDF.

Abajo verás qué hace cada parte y el paso a paso de una grabación real en la que el agente de IA de MadBuilder arma un sistema para un servicio técnico a partir de un pedido escrito.

Qué necesita un sistema de órdenes de servicio

Estas son las partes que pidió el dueño de un servicio técnico en la grabación. Cada una se convierte en un tipo de pantalla:

Parte	Para qué sirve	Tipo de pantalla
Clientes	Quién trajo el equipo	Formulario y listado
Técnicos	Quién hace el trabajo	Formulario y listado
Equipos	Lo que entró al mostrador, con la marca	Formulario y listado
Órdenes de servicio	Cliente, equipo, técnico, estado, monto y fechas	Formulario y listado
Dashboard	Facturación y avance del trabajo	Dashboard
OS en PDF	El papel que va al cliente	Documento

Registros enlazados entre sí

La orden de servicio apunta a un cliente, un equipo y un técnico. Por eso, el formulario de la OS tiene que mostrar nombres, no números. Nadie en el taller sabe quién es el “técnico 3”. El formulario con listas que vienen de la base de datos lo resuelve con una lista de nombres, con búsqueda.

Estado, montos y fechas

El estado dice en qué punto está cada orden. En el ejemplo de la grabación son cinco: abierta, esperando repuesto, en reparación, lista y entregada. Los montos en moneda y las fechas en el formato local evitan errores a la hora de cobrar y de acordar plazos.

Un listado para el día a día

Con cientos de órdenes, el equipo necesita encontrar una OS rápido. Búsqueda, filtros y paginación son lo mínimo. El listado con filtros, totales y exportación además suma valores en el pie y exporta a CSV, Excel o PDF.

Un dashboard con los números del negocio

Quien lleva el servicio técnico quiere saber cuánto facturó, cuántas órdenes están abiertas y quién tiene más trabajo. En el dashboard con indicadores y gráficos, cada tarjeta y cada gráfico hace su propia consulta a la base de datos. Nadie escribe consultas a mano.

La orden de servicio en PDF

La OS impresa es el comprobante que el cliente se lleva a casa. En MadBuilder, es un documento en PDF armado con los datos del registro, el mismo tipo de página que se usa para facturas, contratos y recibos, con envío por correo o como adjunto.

Cómo crear un sistema de órdenes de servicio con el agente de MadBuilder

La página de inicio del sitio tiene una grabación real de 2 min 9 s, con narración, en la que el agente arma este sistema desde el pedido hasta el PDF. Está acelerada en los tramos en que el agente trabaja y usa datos de ejemplo. La grabación y su narración están en portugués; las citas de abajo son traducciones.

El dashboard del sistema creado en la grabación. Mira la grabación en la página de inicio.

1. El pedido

La narración resume el comienzo: “el dueño de un servicio técnico le pide al agente de MadBuilder un sistema completo: clientes, técnicos, equipos y órdenes de servicio, con dashboard y la orden de servicio en PDF”. El agente también recibe pedidos en español.

2. Un roadmap aprobado antes de empezar

“Primero, arma un roadmap con fases y tareas, y pide tu aprobación antes de empezar.” El roadmap, aquí, es el plan de trabajo. En la grabación fueron 5 fases y 11 tareas. Este es el modo de planificación del agente de IA de MadBuilder: propone el plan sin tocar nada y solo escribe después de que lo apruebas.

3. Las tablas en la base de datos y las pantallas

Con el plan aprobado, el agente crea las tablas en la base de datos y genera cada pantalla: formularios, listados y el dashboard. Todo sale como código Laravel, sin que escribas una línea.

Para ser exactos: el proyecto es Laravel común, con Eloquent, Blade, Alpine, migrations y rutas, y trae junto el framework MAD en la carpeta packages/. De ahí vienen los componentes <mad-*> usados en las pantallas.

4. La prueba en la Prueba online

“Después, él mismo levanta el sistema en la Prueba online, entra con el usuario administrador y revisa las pantallas que creó.” La Prueba online es un entorno temporal, con dirección pública, que usa los mismos archivos que van a producción. Más detalles en publicación, despliegue y Prueba online.

5. Un ajuste en el editor visual

“Y no te quedas atado a lo que hizo la IA.” En la grabación, el campo técnico del formulario de la OS salió como número. En el editor visual, pasa a ser una lista con los nombres del equipo, en pocos clics. Cada ajuste se convierte en código al instante, en el Blade y el PHP del proyecto.

En Blade, una lista enlazada a otra tabla queda así (fragmento del registro de ventas de la página de formulario):

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

6. El documento de la OS enlazado a los datos

En el documento de la orden de servicio, cada campo está enlazado a los datos del cliente y del equipo, directo en el panel del editor. Cada OS impresa trae la información de su propia orden.

7. El sistema funcionando

El final de la grabación muestra el sistema en línea, con 229 órdenes de servicio, 60 clientes y 4 técnicos registrados:

• El listado tiene búsqueda, filtros y paginación.
• El formulario muestra el equipo y el técnico por nombre, con el monto y las fechas en el formato correcto.
• El dashboard muestra la facturación, las órdenes por estado, el trabajo de cada técnico y la facturación por marca.
• La orden de servicio sale en PDF, lista para imprimir y entregar al cliente.

Lo que la grabación no muestra

Conviene dejarlo claro:

• El tiempo está acelerado. Los tramos en que el agente trabaja pasan más rápido. El trabajo real toma más tiempo.
• Los datos son de ejemplo. Las 229 órdenes, los 60 clientes y los 4 técnicos son ficticios.
• Hubo ajustes a mano. El técnico como lista y los campos del PDF se afinaron en el editor visual, después del trabajo del agente. La idea es esa: la IA arma la base y tú ajustas en lo visual.

Por dónde empezar

Si prefieres empezar sin el agente, el modelado de datos tiene 13 plantillas de dominio, y una de ellas es orden de servicio con SLA (el plazo de atención acordado con el cliente). Partes de un diagrama listo y ajustas las tablas.

Una vez listo, el sistema puede correr en MadCloud, el hosting gestionado en São Paulo, con HTTPS, base de datos con 30 días de backup y staging, o en el servidor de tu empresa, por SSH o Git. Si diriges la empresa y no programas, mira MadBuilder para empresas.

Preguntas frecuentes

¿Necesito saber programar para crear un sistema de órdenes de servicio?

No para armar las pantallas. Describes el sistema en español y el agente lo arma, o arrastras componentes en el editor visual. Las reglas muy específicas de tu negocio son más fáciles con un desarrollador cerca, y encontrará un proyecto Laravel común.

¿El sistema queda atado a MadBuilder?

No. En los planes de pago, descargas el proyecto completo en cualquier momento. Es un proyecto Laravel con el framework MAD incluido en la carpeta packages/, y corre en tu servidor o en MadCloud. Si dejas de usar MadBuilder, el sistema sigue funcionando.

¿La orden de servicio en PDF sale con los datos de cada OS?

Sí. El documento se arma con los datos del registro. En la grabación, los campos se enlazaron a los datos del cliente y del equipo en el panel del editor.

¿Cuánto cuesta?

El plan gratuito cubre 1 proyecto con hasta 20 tablas. Para descargar el código y publicar en tu servidor, los planes de pago tienen precio por desarrollador al año. El agente de IA funciona con tu propia clave de API en el plan Pro IA, o con la IA incluida del Mad Coding Plan, un complemento mensual que exige el plan Pro. Los detalles están en la página de precios.