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 un video narrado en el 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 el video. 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 del video 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 un video de 2 min 9 s, con narración, que muestra cómo el agente arma este sistema desde el pedido hasta el PDF. Las pantallas se recrearon para el video, los datos son de ejemplo y los tramos en que el agente trabaja están acelerados. Las citas de abajo vienen de su narración.

El dashboard del sistema creado en el video. Mira el video en la página de inicio.

1. El pedido

La narración resume el comienzo: “el dueño de un taller de reparación 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 el video 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 en línea, 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 el video, 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 del video 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 el video no muestra

Conviene dejarlo claro:

• Las pantallas son una reconstrucción. Se recrearon para este video y muestran el mismo flujo; no son una captura de una sesión en vivo.
• 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 el video, 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, pagas una vez por proyecto con el Ship Pass, o por desarrollador al año con Unlimited. El agente de IA funciona con tu propia clave de API en cualquier plan de pago, o con la IA incluida del Mad Coding Plan, un complemento mensual que funciona con cualquier plan de pago. Los detalles están en la página de precios.