Volver a proyectos

Proyecto universitario 路 Completado 路 1.er semestre 路 2025

Truckly

Plataforma full-stack para gestionar flotas vehiculares con roles, asignaciones y mantenimiento, respaldada por una arquitectura de servicios tipada.

Diagrama de la plataforma Truckly

Una arquitectura full-stack para gestionar flotas

Truckly fue desarrollado para el ramo de Desarrollo de Aplicaciones Empresariales. El proyecto concentra en una sola plataforma la gesti贸n de veh铆culos, usuarios, asignaciones y mantenimientos para peque帽as y medianas empresas.

El principal desaf铆o estuvo en integrar una arquitectura full-stack con varias piezas que deb铆an funcionar como un sistema coherente: un frontend en React y Vite, enrutamiento y carga de datos con TanStack Router y TanStack Query, una API tipada con Hono y tRPC, autenticaci贸n y permisos con Better Auth, y persistencia relacional con PostgreSQL y Drizzle ORM.

La carga de datos del frontend fue un foco importante de la implementaci贸n. Las rutas precargan informaci贸n cuando corresponde, las estad铆sticas se renderizan con Suspense y skeletons, y las tablas muestran estados de carga y actualizaci贸n. Despu茅s de cada mutaci贸n, las queries se invalidan para que los cambios aparezcan sin recargar manualmente la p谩gina. Esto permite que los paneles de administraci贸n y de conductores se sientan 谩giles incluso mientras consultan datos reales.

El sistema distingue entre administradores y conductores, con flujos diferentes para registrar veh铆culos, gestionar asignaciones, revisar mantenimientos y actualizar el estado de las tareas. El alcance fue el de una demostraci贸n funcional desplegada con usuarios de prueba, pero la arquitectura qued贸 preparada para crecer m谩s all谩 del prototipo.