How moriarty178/backend-electronic-devices works
Project Type and Purpose
• This is a backend‐only, full‐stack support system for an e-commerce platform (“Selling Computer Equipment – Backend”).
• It is built with Java Spring Boot, containerized with Docker, fronted by an Nginx (OpenResty) reverse proxy/load balancer, uses Redis for rate-limiting and messaging, and employs PostgreSQL Primary-Replica streaming replication behind Pgpool-II.
High-Level Architecture Components
a. Clients (web browsers or mobile apps)
b. Nginx (OpenResty) Reverse Proxy & Load Balancer
• Rate limiting via Lua scripts + Redis (sliding-window logs)
• Auto-scale hook, upstream health checks
c. Spring Boot Back-End Service Instances (stateless)
• Auth, Cart, Order, Product, Chat WebSocket controllers
d. Redis
• Caching / session management
• Rate-limiting store
• Pub/Sub for WebSocket messaging & RedisKeyExpirationListener
e. Pgpool-II
• Connection pooling, failover/follow primary
f. PostgreSQL Cluster
• Primary node (read/write)
• Replica(s) (read-only, failover target)
g. Docker / Docker‐Compose
• Containerizes all above services
Relationships & Data Flows
• Clients → (HTTP/WebSocket) → Nginx
• Nginx → load-balances → Spring Boot Instances
• Spring Boot → queries/writes → Pgpool-II
• Pgpool-II → routes → Primary or Replica PostgreSQL
• Spring Boot → reads/writes → Redis (cache, rate limit counters, pub/sub)
• WebSocket connections (via Nginx) ↔ Spring Boot ↔ Redis pub/sub for real-time chat
Architectural Patterns & Principles
• Layered Architecture:
• Presentation layer (Nginx)
• Application layer (stateless Spring Boot services)
• Data layer (Pgpool-II + PostgreSQL, Redis)
• High Availability & Scalability:
• Stateless app containers behind a load balancer → easy horizontal scaling
• Streaming replication + Pgpool-II for DB failover & read-scaling
• Caching & Rate Limiting: Redis + Lua for hot data and protecting endpoints
• Real-time Messaging: WebSocket over Nginx, backed by Redis pub/sub
• Containerization: Docker to ensure reproducibility & simplified deployment