2025 – 2026

Gasoline System

Control de combustible de una flota, en microservicios

Gestión de rutas: origen, destino, distancia y estado de cada viaje.

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

Arquitectura: Gasoline SystemHTTPgRPCCliente webNext.jsAPI GatewayNestJS · JWTAutenticaciónConductoresVehículosRutasCombustibleNATSevents
síncronoasíncrono

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

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
Siguiente proyectoMódulo contable · Junta de Agua de MiñaricaContabilidad por partida doble para una junta comunitaria de agua