Paso directo de JSON de Postgres a la API
Diseñé una arquitectura de paso directo de JSON en la que las funciones PostgreSQL devuelven documentos JSON completos que la API en Go transmite sin cambios, eliminando la deserialización intermedia y desacoplando la interfaz de los cambios del esquema.
2025
Situación. El recorrido habitual de los datos desde una base de datos hasta un navegador es una carrera de relevos de transformaciones. La base de datos entrega filas a la API, la API las deserializa en estructuras, las reorganiza, vuelve a serializarlas como JSON y solo entonces las envía. Cada uno de esos pasos es código que hay que escribir, código que hay que probar y otro punto donde la idea que la API tiene de los datos puede separarse de la que tiene la base de datos.
Tarea. La idea era saltarse la carrera de relevos. Si la base de datos podía devolver la respuesta terminada, la API podía limitarse a transmitirla, y el frontend podía depender directamente de la estructura de la base de datos en lugar de una copia de ella mantenida a mano en Go.
Acción. Por eso se construyó como un paso directo. Las funciones PostgreSQL preparan toda la respuesta como JSON — darle forma es responsabilidad de SQL y se hace donde ya están los datos. El controlador Go la recibe como json.RawMessage y la reenvía intacta; nunca la descompone ni la vuelve a codificar. Un pequeño auxiliar QueryJSON convirtió ese patrón en la opción más fácil, en lugar de algo que hubiera que acordarse de hacer. Desapareció toda la maquinaria intermedia que acumula una API convencional por capas — los DTO, los mapeadores y las estructuras de respuesta.
Resultado. El código de los controladores se redujo drásticamente y, lo que es más relevante, el frontend dejó de estar acoplado a Go. Si cambia lo que devuelve una función, la nueva estructura llega directamente al cliente sin que nadie modifique una línea del controlador. Hay menos piezas móviles, y aquí sencillamente no existe toda una categoría de divergencias entre capas.