Backend, APIs y software empresarial
Backend y API para seguimiento de reparación de componentes — RepaOnTrack
EstudioPHP desarrolló para Innovadis el backend y la API de RepaOnTrack, una solución orientada al seguimiento del ciclo de reparación de componentes vinculados a operaciones del sector minero.
Symfony · PHP · API REST · Doctrine · JWT
Un proceso operativo con múltiples etapas
RepaOnTrack estaba orientado al seguimiento de piezas o componentes utilizados en actividades vinculadas al sector minero. El proceso de reparación podía incluir envío, recepción, evaluación, cotización, aprobación, reparación, seguimiento, despacho y entrega.
El backend debía conservar el contexto de cada componente durante ese recorrido y relacionar la información necesaria para comprender su situación operativa.
- Qué componente u orden reparable se estaba procesando.
- En qué estado se encontraba el proceso.
- Qué proveedor intervenía en la reparación.
- Qué documentos estaban asociados a cada etapa.
- Qué acciones se encontraban pendientes.
- Qué costos estaban vinculados al seguimiento.
Backend orientado al workflow
EstudioPHP construyó con Symfony 5.3 una API encargada de centralizar la lógica del proceso. El backend no se limitaba a almacenar registros: modelaba las reglas y transiciones de un workflow empresarial.
La persistencia mediante Doctrine ORM permitía relacionar componentes, reparaciones, proveedores, documentos, usuarios, estados e información temporal sin trasladar esas reglas al frontend.
Estados y reglas de negocio
Cada componente podía encontrarse en una etapa diferente, desde el proceso de envío y la espera de recepción o evaluación hasta la cotización, revisión, liberación, reparación, despacho, tránsito y entrega.
Las operaciones disponibles dependían del estado del proceso. Esta lógica permitía controlar las transiciones, conservar consistencia y dar seguimiento al avance sin presentar el sistema como un CRUD simple.
Componentes y proveedores
El modelo relacionaba los componentes enviados a reparación con sus proveedores y con la información generada durante el avance del trabajo.
La API permitía consultar el proceso por componente o proveedor y mantener el seguimiento de los elementos que continuaban en reparación o requerían atención.
Documentación y trazabilidad
La documentación acompañaba distintas etapas del ciclo de reparación. El backend contemplaba guías, informes de recepción y evaluación, cotizaciones, órdenes, informes de avance y documentos de despacho o recepción.
La asociación entre documentos, estados, usuarios, información temporal y registros históricos permitía conservar la trazabilidad del proceso sin atribuir requisitos regulatorios no documentados.
Seguimiento operativo y costos
La lógica del backend proporcionaba información para consultar componentes en reparación, componentes por proveedor, elementos que requerían atención, costos acumulados, costos por proveedor, información mensual y utilización de presupuesto.
Estas capacidades apoyaban el seguimiento operativo. No se atribuyen ahorros, reducciones de tiempo, mejoras de productividad ni otros resultados económicos porque no existen métricas documentadas.
API, autenticación e integración con el frontend
La solución utilizaba una API REST con autenticación mediante JWT, endpoints protegidos y persistencia en MySQL/MariaDB a través de Doctrine ORM.
La separación mantenía la lógica de negocio en el backend y exponía los endpoints necesarios para el frontend correspondiente. El desarrollo de ese frontend no forma parte de la participación atribuida a EstudioPHP. Esta descripción tampoco constituye una auditoría de seguridad actual.
Participación de EstudioPHP
EstudioPHP estuvo a cargo del desarrollo del backend y la API de RepaOnTrack. Christian Paredes desarrolló la lógica de negocio, persistencia y endpoints necesarios para representar y gestionar el workflow de reparación.
El alcance descrito no atribuye a EstudioPHP el frontend, la interfaz gráfica, el diseño UX/UI, toda la infraestructura ni el desarrollo completo del producto.
Pruebas, despliegue y entrega
Después de las pruebas, la solución fue desplegada y quedó disponible para su utilización durante varios meses. Posteriormente el servidor fue apagado y el código fuente fue entregado a Innovadis.
A partir de esa entrega, EstudioPHP dejó de participar en el proyecto y desconoce la evolución posterior de RepaOnTrack. Por ello no se atribuye ningún estado operativo posterior ni mantenimiento actual.
Qué demuestra este proyecto
RepaOnTrack representa experiencia directa en la construcción de backend para software empresarial: análisis de procesos operativos, modelado de workflows, estados y transiciones, proveedores, documentación, trazabilidad, seguimiento de costos e integración mediante APIs REST.
El proyecto demuestra cómo convertir un proceso con múltiples etapas y relaciones en una arquitectura backend mantenible, sin reducir la solución a una lista de tecnologías.
Workflow empresarial
Del componente recibido a la entrega del proceso reparable.
El diagrama resume el recorrido general. El backend contemplaba estados y transiciones adicionales según la situación de cada componente.
- 01
Componente
- 02
Recepción
- 03
Evaluación
- 04
Cotización
- 05
Aprobación
- 06
Reparación
- 07
Despacho
- 08
Entrega
Responsabilidades del backend
Modelado
Representación del proceso de reparación y sus relaciones de negocio.
Persistencia
Datos de componentes, proveedores, documentos, costos, usuarios y estados.
Workflow
Reglas y transiciones para controlar el avance de cada componente.
API REST
Endpoints necesarios para consultar y operar el proceso desde el frontend.
Trazabilidad
Historial, información temporal y documentación asociada a las etapas.
Tecnologías y conocimientos
Backend
Dominio modelado
Siguiente paso
¿Tu empresa necesita digitalizar un proceso operativo?
Podemos analizar el proceso actual y diseñar un sistema, API o integración que centralice sus reglas de negocio, estados, documentos e información operativa.