Computer Store - Microservices Architecture

An e-commerce platform for computer hardware components built with Spring Boot, Spring Cloud, and Docker.

Features

Microservices Architecture: Fully decoupled services (Store, User, Gateway, Config, Discovery)
Centralized Configuration: Spring Cloud Config Server backed by a local Git repository (config-repo)
Service Discovery: Netflix Eureka for dynamic service registration and discovery
API Gateway: Spring Cloud Gateway for centralized routing, SSL/HTTPS, and rate-limiting
Resilience & Fault Tolerance: Resilience4j Circuit Breaker, Retry, and Fallback mechanisms
Security: Stateless JWT authentication distributed across microservices, Role-Based Access Control (RBAC)
Monitoring & Observability: Full Prometheus & Grafana stack with custom dashboards, Zipkin distributed tracing
Database & Caching: PostgreSQL for persistent data, H2 for testing, Redis for NoSQL caching (@Cacheable) and Rate Limiting
CI/CD: GitHub Actions pipeline for automated building, testing (JaCoCo), and Dockerization
Shopping Cart & Wishlist: Manage items in a persistent cart (DB-backed) and save favorites in a many-to-many wishlist.
Admin Panel: Full CRUD for products, users and orders with pagination and sorting.

The system is decomposed into 5 independent microservices:

config-server (Port 8888) - Centralized configuration management
discovery-server (Port 8761) - Eureka service registry
api-gateway (Port 8443) - Secure entry point, CORS, Rate Limiting
user-service (Port 8082, 8083) - Manages users, JWT authentication, BCrypt encryption
store-service (Port 8081) - Manages products (CQRS Pattern), orders, cart, and wishlist

The project includes 11 entities with various relationship types:

Entities: User, Product, Order, OrderItem, Cart, CartItem, Wishlist, Processor, GraphicsCard, Motherboard, Case.
Relationships:
- @OneToOne: User ↔ Cart, User ↔ Wishlist
- @OneToMany/@ManyToOne: User ↔ Order, Order ↔ OrderItem, Cart ↔ CartItem
- @ManyToMany: Wishlist ↔ Product
Inheritance: Product is the base class for component-specific entities (JOINED strategy).

This will start all databases, infrastructure, and the 5 microservices automatically.

cd ComputerStore
docker compose up -d --build

Note: The user-service scales to 2 instances to demonstrate client-side load balancing.

To launch Prometheus, Grafana, and Zipkin:

cd ComputerStore
docker compose -f docker-compose-monitoring.yml up -d

Store Application (UI): https://localhost:8443/api/store/ (Via Gateway)
Eureka Dashboard: http://localhost:8761
Grafana Dashboard: http://localhost:3000 (User: admin, Password: admin123)
Zipkin Dashboard: http://localhost:9411
Swagger UI: http://localhost:8081/swagger-ui.html

For an in-depth view of the entities, relationship definitions, and business requirements: MVP Requirements Document.

For a summary of how AI agents were used during development: AI Usage Report.

Mateea

Alexandra