← Todos los trabajos
EncargoEn producción

Cartobol

Una tienda B2B y su back office para recambios de maquinaria.

Sector
Suministro industrial
Cliente
Cartobol
Rol
Desarrollador full-stack, construcción en solitario
Año
2026

Cartobol vende recambios de maquinaria a otras empresas, lo que convierte las partes «aburridas» en las difíciles: la integridad del catálogo, el cálculo de precios y envíos, y una superficie de administración que un equipo no técnico pueda manejar de verdad.

Un monorepo, limpiamente dividido en capas

Todo el conjunto es un monorepo de Turborepo: una API de Express 5 escrita en ESM y una SPA de React sobre Vite. La API está deliberadamente organizada en capas: los routers se dividen por audiencia, los validadores se sitúan en la frontera de la ruta para que ningún controlador reciba datos sin validar, los controladores se mantienen finos y propagan los errores, y los servicios concentran cada consulta a la base de datos y cada regla de negocio. El trabajo transversal (precios, envíos, mapeo del catálogo y gestión de medios) vive en helpers dedicados en lugar de quedar repartido por los controladores. Los fallos se someten a la misma disciplina: una única capa convierte cualquier tipo de error (de validación, de base de datos, de pago) en una respuesta con la misma forma, así que el cliente solo tiene que manejar un formato de error.

Comportarse como un solo producto

En el front, las rutas se cargan de forma diferida y se dividen por nivel de acceso, y toda la obtención de datos pasa por una única capa que gestiona la sesión y los errores en un solo sitio. Para quien la usa, la plataforma se percibe como un único producto.