Una plataforma marítima con límites claros entre sistemas
Diseñé una plataforma marítima por capas que separaba una interfaz PWA en Next.js, una API en Go (Huma/Fiber) y una capa de funciones PostgreSQL, manteniendo toda la lógica de negocio en la base de datos.
Trabajo realizado: 2025
Cómo llega la solicitud a la base de datos
Descripción general de la implementación del recorrido de una solicitud; los resultados y el contexto de las mediciones se recogen en el texto del caso práctico.
Solicitud del frontend
El frontend marítimo solicita datos estructurados y presenta el JSON recibido.
API en Go
La API en Go gestiona el enrutamiento, la validación de solicitudes, la seguridad y la llamada a la base de datos.
JSON de PostgreSQL
Las funciones de la base de datos generan el JSON completo, que la API devuelve sin cambios.
una plataforma marítima en tres capas bien separadas
Situación. NextMariner es una plataforma marítima que abarca redes profesionales, reseñas de empresas y patrocinios educativos. La contribución de la fundadora a la arquitectura se registra dentro del encargo de NextMariner que comienza en noviembre de 2025; el registro no distingue un período de empleo posterior ni acredita que Engineer ApS entregara la totalidad del producto.
Tarea. Como responsable de la arquitectura, había que decidir desde el principio dónde residiría cada tipo de lógica, con límites lo bastante claros para resistir bajo presión en lugar de desdibujarse la primera vez que alguien tuviera prisa.
Acción. La solución quedó organizada en tres capas, cada una con su propia función. El frontend Next.js se ocupa de la presentación y la interactividad, y de nada más. La API Go — Huma sobre Fiber — es deliberadamente ligera: enruta, valida la solicitud, aplica el filtrado de seguridad y orquesta, pero no contiene ninguna lógica de negocio. Toda la lógica de negocio reside en funciones PostgreSQL, que preparan el resultado completo y lo devuelven para que la API lo reenvíe. Así, cuando cambia una regla, cambia en una sola capa, en SQL, y las otras dos no necesitan enterarse. Los límites se documentaron y se hicieron cumplir en las revisiones, porque una convención que nadie vigila deja de serlo.
Resultado. La arquitectura implementada asigna responsabilidades separadas a la presentación, el tratamiento de solicitudes y las reglas de negocio. La fuente documenta esa separación y su justificación; no acredita una mejora medida en la velocidad de entrega, la fiabilidad o el rendimiento del negocio.

Foto: mherfurt / Pixabay 
Foto: atti69 / Pixabay
Aplique esta experiencia a su proyecto
Utilice «Una plataforma marítima con límites claros entre sistemas» como punto de partida para un reto similar en su organización. Los servicios que respaldan este trabajo están disponibles para su proyecto. Una estructura que refleja cómo funciona el negocio para poder responder también a las preguntas que surjan más adelante.
Mire más allá del resultado
Lea la situación, las decisiones y el resultado de este ejemplo. Podemos hablar de qué partes se adaptan a sus restricciones y cuáles necesitan otro enfoque. Una plataforma marítima con límites claros entre sistemas — una plataforma marítima en tres capas bien separadas
Lea a continuación: Paso directo de JSON de Postgres a la API. O eche un vistazo al Portafolio completo.
Presentamos este trabajo a los clientes como Una plataforma marítima con límites claros entre sistemas — véalo junto a los demás casos prácticos.
Una parte de una trayectoria más amplia — y toda ella está en este sitio.
Cada entrada sigue la misma estructura: la situación, la tarea, lo que hicimos y lo que cambió.

