Jean Marte
← Volver al inicio

Caso de estudio

Santoral Logistic

Para Maed Logistic Trading

Santoral Logistic — Para Maed Logistic Trading

El problema

Maed Logistic Trading llevaba su operación con procesos manuales y sistemas heredados. Cotizaciones, embarques, inventario y datos de clientes vivían separados, así que responder algo tan simple como «¿en qué va esta carga?» obligaba a juntar información de varios lugares distintos, cada uno con su propia versión de la verdad.

Contexto

Es una operación de comercio y logística de carga: se cotiza, se embarca y se almacena. El encargo fue digitalizar y estandarizar ese flujo operativo completo, reemplazando lo manual y lo heredado por un solo sistema. [PENDIENTE: tamaño de la operación y cuántas personas usan el sistema a diario]

La solución

  • Gestión de transporte (TMS): cotizaciones y órdenes de embarque
  • Gestión de almacén (WMS): operaciones de inventario
  • Gestión de clientes (CRM): clientes y contactos
  • Configuración base compartida por todos los módulos

Funcionalidades

  • Catálogos base de la operación: monedas, modos de transporte, tipos de bulto y puertos.
  • Registro de clientes y sus contactos, consultable desde cualquier módulo.
  • Generación y seguimiento de cotizaciones.
  • Órdenes de embarque ligadas a la cotización que las originó, para no volver a capturar los mismos datos.

Mi participación

Arquitectura de la aplicaciónModelo de datosBackend y frontendContenerización y entornosDespliegue

Decisiones técnicas

Un solo despliegue, no dos aplicaciones

Elegí un monolito moderno con Inertia.js en lugar de separar API y SPA. Para un equipo interno eso significa un único lugar donde desplegar y un único modelo de permisos; separarlo habría duplicado el mantenimiento sin darle nada al cliente.

PostgreSQL porque todo depende de todo

Una orden de embarque nace de una cotización y arrastra cliente, puerto, moneda y tipo de bulto. Si esas relaciones no son consistentes, el sistema deja de ser una fuente confiable y el equipo vuelve a la hoja de cálculo.

Docker desde el primer día

El entorno del cliente y el de desarrollo son el mismo. Es la manera de que «en mi máquina funciona» deje de ser una conversación, y de que el sistema se pueda mover de servidor sin rehacer la configuración.

Stack

Laravel 12 (PHP 8.3)React 19 + Inertia.jsPostgreSQL 16Redis + HorizonTailwindCSS + shadcn/uiDocker
Ver el código

Dificultades

  • [PENDIENTE: dificultades técnicas reales — migración desde los sistemas heredados, adopción del equipo, o lo que más haya costado]

Resultado

  • El MVP está en producción y reemplaza los procesos separados de cotización, embarque, inventario y clientes por un flujo único.
  • La orden de embarque se genera desde la cotización, así que los datos se capturan una sola vez.
  • [PENDIENTE: resultado observable en la operación diaria — qué cambió para el equipo]

Demo

La mejor prueba es el sistema andando. Está en producción:

Abrir la demo