Saltar al contenido
Rafhael Marsigli

Cómo una web app a medida transformó la generación de informes NR-12 de un trabajo de meses a una operación de días

Una empresa de inspección de NR-12 armaba sus informes a mano, en Word y Excel, un trabajo de meses para fábricas con cientos de máquinas. Construí una web app en Laravel que estructuró la recolección y automatizó los reportes, reduciendo el tiempo de producción de meses a días y llevando toda la operación a la nube

Cliente
NR Secure
Rol
Proyecto completo: de la arquitectura a la entrega
Período
v1 en 2016, v2 en 2023

NR Secure hace inspecciones de conformidad con la NR-12, la norma regulatoria brasileña de seguridad en máquinas y equipos. En la práctica: el equipo va a la fábrica del cliente, inspecciona máquina por máquina, documenta todo con fotos y checklists, y entrega un informe técnico (laudo). Ese informe es el producto. Es por él que la empresa cobra.

El problema era que el informe se armaba a mano, en Word y Excel.

Imagina una fábrica con 200 o más máquinas. Para cada una: fotografiar, anotar en papel o en el celular y después - de vuelta en la oficina - transcribir todo, organizar las imágenes, dar formato y revisar. Cada máquina rendía fácilmente de 3 a 5 páginas. Un informe completo era un trabajo de meses. Me contrataron para construir una web app a medida que eliminara ese cuello de botella. El resultado redujo el tiempo de producción de un informe de un orden de magnitud de meses a un orden de magnitud de días, y sacó toda la operación del escritorio aislado de una sola persona a la nube, accesible desde cualquier lugar y cualquier dispositivo.

El problema

El flujo antiguo concentraba todo el esfuerzo en el posinspección. La recolección en campo era solo el comienzo; el trabajo pesado venía después, en la oficina, y era enteramente manual:

  • Transcribir anotaciones de papel/celular a documentos estructurados
  • Insertar y posicionar decenas (o cientos) de fotos manualmente
  • Replicar el mismo formato para cada máquina, sin errores
  • Consolidar las máquinas individuales en un único informe por empresa
  • Revisar todo a mano, con riesgo de inconsistencia en cada copiar/pegar

Mientras más grande el cliente, peor la escala: el esfuerzo crecía linealmente con el número de máquinas, y no había reutilización estructural entre informes. Cada documento se rehacía prácticamente desde cero.

También había un problema de movilidad y continuidad: los archivos vivían en una máquina local. Trabajar desde otro lugar, en otro dispositivo, o dividir la tarea entre personas, era difícil.

Las restricciones

El proyecto tenía condiciones de borde claras que moldearon las decisiones técnicas:

  • Presupuesto de freelancer, no de producto enterprise. La solución tenía que ser directa y eficiente, sin infraestructura cara ni complejidad innecesaria.
  • Hosting compartido. Nada de colas de jobs sofisticadas, microservicios ni servidor dedicado. La solución tenía que funcionar bien dentro de esas restricciones.
  • Los informes los descargaba el propio equipo, no se enviaban automáticamente al cliente final. Esto tuvo un impacto directo en la decisión sobre la generación de PDF (más abajo).

La solución

Construí una web app en Laravel que reemplazó todo el flujo de Word y Excel por una operación estructurada y centralizada en la nube.

Registro de máquinas e inspecciones. Cada empresa/cliente, cada máquina y cada inspección pasaron a ser entidades en el sistema. La estructura que antes existía solo como convención informal en los documentos pasó a ser un modelo de datos de verdad.

Recolección optimizada para la velocidad. La interfaz de llenado fue diseñada para minimizar la escritura libre. Siempre que fue posible, usé checkboxes y selects en lugar de campos de texto. Eso hizo dos cosas al mismo tiempo: aceleró el llenado en campo y estandarizó los datos, lo que, a su vez, estandarizó el informe final. Menos texto libre significa menos inconsistencia y menos revisión.

Subida de fotos directo desde el sistema. Las imágenes de cada máquina pasaron a subirse y asociarse directamente a la inspección, eliminando el paso manual de insertar y posicionar fotos en Word.

Generación automática del informe. A partir de los datos estructurados, el sistema armaba el informe formateado automáticamente, tanto el reporte de una máquina individual como un informe consolidado de un conjunto de máquinas, agrupado por empresa.

La decisión del PDF: usar el navegador en vez de una librería

Un detalle técnico que vale la pena destacar, porque ilustra una decisión pragmática. Como los informes los descargaba el propio equipo (y no se enviaban automáticamente al cliente), no incorporé ninguna librería de generación de PDF.

El informe se renderizaba como una página web bien formateada, y el equipo usaba el propio "imprimir → guardar como PDF" del navegador. Eso evitó una dependencia entera, con todo el mantenimiento, el peso y los potenciales bugs de renderizado que cargan las librerías de PDF, para un problema que el navegador ya resolvía de forma nativa. Bajo la restricción de hosting compartido y presupuesto ajustado, fue la elección correcta: la solución más simple que cumplía el requisito real, y no el requisito imaginado.

El resultado

El impacto fue inmediato y visible:

  • El tiempo de producción de informes pasó de una escala de meses a una escala de días. El trabajo que antes ocupaba un mes pasó a caber en una semana; los informes de los clientes más grandes, que tomaban varios meses, se redujeron a una fracción de eso.
  • Operación 100% en la nube. Lo que vivía atado a una máquina local pasó a ser accesible desde cualquier lugar y cualquier dispositivo, en hosting compartido.
  • Estandarización de los informes. Con la recolección basada en campos estructurados, el documento final ganó una consistencia que el flujo manual no podía garantizar.
  • Escala desacoplada del esfuerzo. Inspeccionar una fábrica con cientos de máquinas dejó de significar cientos de páginas armadas a mano.

La reacción del equipo al ver toda la operación organizada en la nube, accesible desde cualquier lugar, fue de sorpresa genuina, la ganancia les quedó clara desde el principio.

El proyecto tuvo dos versiones a lo largo de los años: la primera, hace cerca de una década, y una segunda, hace cerca de tres años, que mantuvo la misma propuesta y refinó la solución con base en el uso real.

Lo que demuestra este proyecto

Más que el stack, este caso muestra un patrón que aplico en todo trabajo: identificar el cuello de botella real y atacarlo con la solución más simple que funcione. La ganancia aquí no vino de tecnología sofisticada - vino de transformar un proceso manual y desestructurado en datos estructurados, y dejar que el sistema haga el trabajo repetitivo. La decisión de no usar una librería de PDF es la misma filosofía en miniatura: resolver el problema que existe, no el que parece impresionante.

Empieza a escribir para encontrar algo.