Gasoline System
Control de combustible de una flota, en microservicios

Control de combustible con gRPC, eventos NATS y una base de datos por servicio.
- Año
- 2025 – 2026
- Contexto
- Proyecto académico · Aplicaciones Distribuidas, UTA
- Equipo
- 4 personas
- Código
- GitHub
- microservicios independientes
- 5
- síncrono y asíncrono
- gRPC + NATS
- roles con JWT
- 3
El sistema
Control del consumo de combustible de una flota, diseñado como microservicios independientes (autenticación, conductores, vehículos, rutas y combustible), cada uno con su base de datos y su contenedor, detrás de un único API Gateway.
Arquitectura
Decisiones técnicas
Los servicios usan gRPC para respuestas inmediatas y NATS para publicar eventos sin bloquear. Esta separación obliga a gestionar fallos parciales y consistencia entre bases de datos.
Qué hace
- Cinco microservicios (autenticación, conductores, vehículos, rutas y combustible) detrás de un API Gateway en NestJS.
- Contratos gRPC definidos con Protocol Buffers para las llamadas síncronas.
- Eventos NATS para avisar al resto de servicios sin bloquear al que publica.
- Cada servicio en capas: controladores gRPC, aplicación, dominio, infraestructura y persistencia.
- Roles de administrador, operador y supervisor, con JWT.
- Maquinaria ligera y pesada con reglas distintas; los repostajes en MongoDB y el resto en PostgreSQL.
- Panel en Next.js que marca los consumos anómalos como posible robo.
- Todo el sistema se levanta con Docker Compose.
Un reto concreto
Cada dato en la base que le corresponde
Conductores, vehículos y rutas son datos relacionales con integridad referencial; los repostajes son muchos, crecen sin parar y cambian de forma según el tipo de maquinaria. Por eso cada servicio tiene su base: PostgreSQL para lo relacional y MongoDB para el combustible. El precio es que ninguna consulta cruza bases: lo que un servicio necesita de otro lo pide por gRPC o lo recibe en un evento NATS.
Capturas
Gestión de rutas: origen, destino, distancia y estado de cada viaje. La flota, con el tipo de maquinaria y el estado de cada vehículo. Registro de combustible, con los consumos anómalos marcados. Acceso con JWT: cada rol ve sólo lo suyo.
Mi parte
Microservicios, contratos gRPC y publicación y consumo de eventos NATS, en un equipo de cuatro.
Stack
- NestJS
- gRPC
- Protocol Buffers
- NATS
- Prisma
- PostgreSQL
- MongoDB
- Docker Compose
- JWT
- Next.js
