Skip to main content
SGIVU is a comprehensive vehicle inventory management system designed for used car dealerships, featuring OAuth 2.1 authentication, microservices architecture, and ML-powered demand prediction.

Key Features

Authentication & Authorization

OAuth 2.1/OIDC with JWT tokens and role-based access control

Vehicle Management

Complete vehicle catalog with S3 image storage and advanced search

Demand Prediction

ML-powered demand forecasting with FastAPI and scikit-learn

Microservices Architecture

Scalable Spring Cloud microservices with service discovery

Get Started

Deploy SGIVU locally in minutes

Architecture Overview

Understand the system design

API Reference

Explore the REST APIs

Backend Services

Learn about each microservice

Technology Stack

SGIVU is built with modern, production-ready technologies:
  • Backend: Spring Boot 4.0, Spring Cloud, Spring Security OAuth2
  • Frontend: Angular 21 with TypeScript
  • ML Service: FastAPI, scikit-learn, XGBoost
  • Databases: PostgreSQL, Redis
  • Infrastructure: Docker, Docker Compose, Nginx
  • Observability: Actuator, Micrometer, Zipkin

Architecture Highlights

1

API Gateway with BFF Pattern

The gateway acts as a Backend-For-Frontend, managing OAuth2 tokens securely with Redis session storage
2

Service Discovery

Eureka service registry enables dynamic service-to-service communication
3

Centralized Configuration

Spring Cloud Config Server manages configuration across all microservices
4

ML Integration

FastAPI-based ML service provides demand prediction APIs with model retraining capabilities

What’s Inside

Core Services

  • sgivu-auth: OAuth 2.1/OIDC Authorization Server
  • sgivu-gateway: API Gateway with BFF pattern
  • sgivu-user: User and role management
  • sgivu-vehicle: Vehicle catalog and image management
  • sgivu-client: Client relationship management
  • sgivu-purchase-sale: Transaction tracking
  • sgivu-ml: Demand prediction service

Supporting Infrastructure

  • sgivu-config: Centralized configuration server
  • sgivu-discovery: Eureka service registry
  • sgivu-frontend: Angular-based web application

Get Started

Quickstart Guide

Deploy the complete stack with Docker Compose and make your first API call