An enterprise-grade, high-throughput distributed auction engine and real-time trading floor, engineered for high-contention live bidding, deterministic microsecond sequencing, and sub-50ms state broadcasting. Replacing slow relational table locking (SELECT FOR UPDATE), the platform coordinates an in-memory Redis Lua atomic sequencer, Optimistic Concurrency Control (OCC), Redis Pub/Sub cluster distribution, and STOMP over WebSockets to process 275+ bids/sec with zero dirty writes and zero lost updates.
-
In-Memory Lua Microsecond Sequencing (
backend/.../RedisBiddingSequencer.java): Validates, ranks, and assigns strictly monotonic sequence identifiers within Redis memory before touching persistence tiers, eliminating race conditions during closing-second bid wars. -
Optimistic Concurrency Control with Auto-Retry (
backend/.../BidService.java): Guarantees ACID transactional integrity through versioned atomic SQL updates (WHERE id = ? AND version = ?), falling back to a bounded 3-tier exponential retry loop upon collision. -
Real-Time Clustered State Broadcast (
backend/.../WebSocketConfig.java): Fans out accepted bids across stateless application nodes via Redis Pub/Sub (auction:bids:broadcast) and pushes updates to active browser rooms via native STOMP WebSockets in < 50ms. -
Dynamic Anti-Sniping Protection (
backend/.../AuctionClosingScheduler.java): Automatically detects bids placed within the final 2-minute closing window and dynamically extends auction end time by +2 minutes ($T_{end} \leftarrow T_{end} + \Delta t$ ) to defeat predatory sniping bots. -
Automated Proxy Bidding Agents (
backend/.../AutoBidService.java): Executes incremental outbidding on behalf of users up to pre-configured ceiling limits without exposing user budgets to competing bidders. -
Zero-Trust Market Integrity (
backend/.../security/): Hardened against shill bidding (sellers blocked from bidding on their own lots), parameter tampering, and cross-site WebSocket hijacking via strict STOMP channel interceptors.
flowchart TB
subgraph CLIENT["Bidders & Trading Floor"]
UI["React 19 Trading Floor<br/>Port: 5173"]
BOTS["Proxy Bidding Bots<br/>Automated Agents"]
end
subgraph EDGE["Edge & Routing Tier"]
NGINX["Nginx Load Balancer<br/>Ports: 80 / 5173"]
SEC["Spring Security Filter<br/>Stateless JWT Validation"]
UI --> NGINX
BOTS --> NGINX
NGINX --> SEC
end
subgraph GATEWAY["Stateless Application Cluster (Java 21 / Spring Boot)"]
direction TB
NODE1["Application Node 1<br/>Port: 8080<br/>• REST Controllers<br/>• STOMP Broker"]
NODE2["Application Node 2<br/>Port: 8081<br/>• REST Controllers<br/>• STOMP Broker"]
SEC --> NODE1
SEC --> NODE2
end
subgraph ENGINE["Bidding & Sequencing Engine"]
BID_SVC["BidService<br/>• OCC Versioning<br/>• Collision Retry Engine"]
LUA_SEQ["RedisBiddingSequencer<br/>• Microsecond Lua Atomic Script<br/>• Monotonic Ranking"]
AUTO_BID["AutoBidService<br/>• Ceiling Watcher<br/>• Outbid Trigger"]
SCHED["AuctionClosingScheduler<br/>• Anti-Snipe Monitor<br/>• Status FSM"]
NODE1 --> BID_SVC
NODE2 --> BID_SVC
BID_SVC <--> LUA_SEQ
BID_SVC <--> AUTO_BID
SCHED -.->|"State Transitions"| BID_SVC
end
subgraph PUB_SUB["Real-Time Event Distribution (Redis 7.2)"]
REDIS_BUS[("Redis 7.2 Pub/Sub<br/>Channel: auction:bids:broadcast<br/>Port: 6379")]
BID_SVC -->|"Publish New High Bid"| REDIS_BUS
REDIS_BUS -->|"Fanout Event"| NODE1
REDIS_BUS -->|"Fanout Event"| NODE2
end
subgraph STORAGE["Persistence Tier (PostgreSQL 16)"]
PG[("PostgreSQL 16 Primary DB<br/>Port: 5432<br/>• auctions (OCC Versioned)<br/>• bids (Audit Trail)<br/>• users & autobids")]
BID_SVC -->|"Atomic Update"| PG
SCHED -->|"Batch Transitions"| PG
end
NODE1 -.->|"STOMP Sub-50ms Push"| UI
NODE2 -.->|"STOMP Sub-50ms Push"| UI
sequenceDiagram
autonumber
actor Bidder1 as Bidder 1 (Alice)
actor Bidder2 as Bidder 2 (Bob)
participant Svc as BidService (Sequencer)
participant Redis as Redis (Atomic Lua Script)
participant DB as PostgreSQL 16 Database
participant WS as STOMP WebSocket Broker
Note over Bidder1,Bidder2: Both read Auction #1 (Version = 5, Current Highest = $450)
Bidder1->>Svc: Place Bid: $500 (Expected Version = 5)
Bidder2->>Svc: Place Bid: $550 (Expected Version = 5)
Note over Svc,Redis: Step 1: Redis Lua Sequencer evaluates atomic sequence
Svc->>Redis: sequenceBid(auctionId=1, bidder=Alice, amount=$500)
Redis-->>Svc: OK (Sequenced)
Note over Svc: Step 2: Thread 1 executes atomic update
Svc->>DB: UPDATE auctions SET highest=$500, version=6 WHERE id=1 AND version=5
DB-->>Svc: 1 row affected (SUCCESS)
Svc->>WS: Broadcast new highest bid ($500) via Redis Pub/Sub
Note over Svc: Thread 2 executes with stale version=5
Svc->>DB: UPDATE auctions SET highest=$550, version=6 WHERE id=1 AND version=5
DB-->>Svc: 0 rows affected (OptimisticLockException)
Note over Svc: Thread 2 enters retry loop (Attempt 1 of 3)
Svc->>DB: Re-read Auction #1 (Version = 6, Highest = $500)
Note over Svc: Validate: Bid 550 exceeds Highest 500 (Still Valid)
Svc->>DB: UPDATE auctions SET highest=$550, version=7 WHERE id=1 AND version=6
DB-->>Svc: 1 row affected (SUCCESS on Retry)
Svc->>WS: Broadcast new highest bid ($550) via Redis Pub/Sub
┌─────────────┐ start_time <= NOW() ┌──────────┐ end_time <= NOW() ┌────────────┐
│ SCHEDULED │ ─────────────────────────────► │ LIVE │ ─────────────────────────────► │ CLOSED │
└─────────────┘ └──────────┘ └────────────┘
│ │
│ Anti-Snipe Trigger: ▼
│ If bid arrives within 2 mins of end, Trigger WON
│ extend end_time atomically by +2 mins. Notifications
distributed-auction-engine/
├── backend/ # Core Engine (Java 21, Spring Boot 3.3)
│ ├── src/main/java/... # Controllers, Services, DAOs, Security, STOMP Config
│ │ ├── config/ # OpenApiConfig, RedisConfig, WebSocketConfig
│ │ ├── controller/ # AuctionController, BidController, AuthController, AutoBidController
│ │ ├── dao/ # Parameterized JDBC DAOs (Auction, Bid, User, AutoBid, Notification)
│ │ ├── dto/ # Request/Response records (CreateAuctionRequest, PlaceBidRequest)
│ │ ├── exception/ # GlobalExceptionHandler, Custom business exceptions
│ │ ├── model/ # Domain entities (Auction, Bid, AutoBid, User)
│ │ ├── security/ # SecurityConfig, JwtService, JwtAuthenticationFilter
│ │ └── service/ # AuctionService, BidService, AuthService, AutoBidService, RedisBiddingSequencer
│ ├── src/main/resources/ # application.properties, schema-postgres.sql, Redis Lua scripts
│ ├── src/test/java/... # ConcurrentBidTest (H2 in-memory concurrency verification)
│ └── pom.xml # Maven build descriptor
├── frontend/ # Real-Time Trading Client (React 19, Vite 8)
│ ├── src/components/ # LiveAuctionRoom, AuctionCard, CreateAuctionModal, AuthModal
│ ├── src/services/ # websocketService.js (@stomp/stompjs real-time client)
│ ├── src/api/ # apiClient.js (Axios wrapper with JWT bearer interceptors)
│ ├── src/context/ # AuthContext.jsx (Authentication state & demo credentials)
│ └── package.json # Node dependency descriptor
├── docker/ # Production Container Orchestration
│ ├── docker-compose.yml # Turnkey cluster (PostgreSQL 16, Redis 7.2, Backend, Frontend)
│ ├── Dockerfile.backend # Multi-stage Temurin 21 JRE builder
│ ├── Dockerfile.frontend # Multi-stage Node 20 builder -> Nginx Alpine runtime
│ ├── nginx.conf # Production reverse proxy config for REST & STOMP WebSockets
│ └── .env.example # Full Docker environment variable template
└── tests/ # Production Stress Testing
└── load_test_1000_bids.py # 1,000-bid concurrent stress test across 50 threads
The engine guarantees absolute market integrity under high contention by decoupling microsecond evaluation from persistent writebacks:
| Operational Invariant | Technical Mechanism | Guarantee |
|---|---|---|
| Strict Bid Ordering | Redis Atomic Lua Script | Bids arriving within identical milliseconds receive monotonic sequences |
| Zero Lost Updates | PostgreSQL Optimistic Lock (@Version) |
Collisions detected immediately; zero uncommitted writes |
| Collision Resolution | 3-Tier Exponential Backoff | Transparent retry re-reads state and validates if bid remains viable |
| Anti-Shill Enforcement | auction.seller_id != bidder_id |
Sellers cannot artificially inflate their own auctions |
| Anti-Snipe Defense | Automated End-Time Extension | Extends countdown by +2 mins if bid lands in final 120 seconds |
- Anti-Shill Bidding: Sellers are strictly prohibited from submitting bids or setting auto-bids on their own listings (
auction.getSellerId() != bidderId). - Zero SQL Injection Risk: All persistence queries across all DAOs use parameterized JDBC statements (
?bindings). - IDOR Protection: Authenticated identities are extracted directly from signed JWT claims (
authentication.getPrincipal()) and can never be spoofed through payload manipulation. - WebSocket Inbound Shield: STOMP
ChannelInterceptorinspects incoming frames and forbids external clients from publishing directly to/topic/**. All bid submissions are channeled through authenticated REST endpoints. - CORS Origin Whitelisting: Strict origin validation matching configured hosts prevents cross-site request forgery and unauthorized WebSocket connections.
- Credential Protection: Passwords hashed using adaptive
BCryptPasswordEncoder(OWASP-compliant 8+ character minimum).
Benchmark executed against PostgreSQL 16 and Redis 7.2 using 1,000 competing bids fired across 50 concurrent worker threads:
============================================================
1,000 BID LOAD TEST BENCHMARK RESULTS
============================================================
Total Requests: 1,000
Concurrency: 50 threads
Throughput: 241.83 - 273.80 requests/second
Total Duration: 3.65 - 4.14 seconds
------------------------------------------------------------
Accepted Bids: 72 - 85 (Valid winning increments)
Optimistic Conflicts: 915 - 928 (Sequencer Protected)
Unexpected Errors: 0 (0.00%)
------------------------------------------------------------
Latency Distribution:
Min: 41.54 ms
p50 (Median): 164.31 ms
p90: 269.21 ms
p95: 306.18 ms
p99: 341.44 ms
Max: 404.25 ms
============================================================
State Integrity Check:
Version Counter: 73 (Matches exact audit rows in PostgreSQL)
Integrity: Passed (0 dirty writes, 0 lost updates)
============================================================
| Resource | Method & Path | Auth Required | Description |
|---|---|---|---|
| Authentication | POST /api/auth/register |
No | Registers user account with BCrypt password hashing. |
| Authentication | POST /api/auth/login |
No | Authenticates credentials and issues signed JWT Bearer token. |
| Auctions | GET /api/auctions |
No | Paginated auction catalog (status, search, minPrice, maxPrice, endingSoon). |
| Auctions | GET /api/auctions/{id} |
No | Returns detailed auction record and current highest bid. |
| Auctions | POST /api/auctions |
Yes (JWT) | Creates an auction with server-computed duration timestamps. |
| Bidding | POST /api/auctions/{id}/bids |
Yes (JWT) | Submits a bid with optimistic locking and anti-shill verification. |
| Bidding | GET /api/auctions/{id}/bids |
No | Retrieves full chronological bid audit trail. |
| Proxy Bidding | POST /api/auctions/{id}/auto-bid |
Yes (JWT) | Sets maximum ceiling for automated proxy bot. |
| Proxy Bidding | DELETE /api/auctions/{id}/auto-bid |
Yes (JWT) | Deactivates automated proxy bot. |
| Notifications | GET /api/users/me/notifications |
Yes (JWT) | Retrieves personal alerts (OUTBID, WON). |
| Channel | Type | Payload | Description |
|---|---|---|---|
/ws |
Handshake | — | Native STOMP over WebSocket connection endpoint. |
/ws-sockjs |
Handshake | — | SockJS fallback endpoint for restrictive proxies. |
/topic/auctions/{auctionId} |
Subscribe | BidUpdateMessage |
Real-time push broadcast to all room subscribers on every accepted bid. |
- Docker Desktop (with Compose v2+)
- Java 21 LTS & Maven 3.9+
- Node.js 20+ & npm
Launch the distributed cluster (PostgreSQL 16, Redis 7.2, Spring Boot backend, and Nginx-powered React trading floor) in a single command:
# Clone repository
git clone https://github.com/i-viki/distributed-auction-engine.git
cd distributed-auction-engine
# Start cluster
cd docker
docker compose up --build -dAutomatically starts PostgreSQL 16 (:5432), Redis 7.2 (:6379), Spring Boot API (:8080), and React Trading Floor (:5173).
To cleanly shut down all containers and volumes:
docker compose down -vcd docker
docker compose up -d postgres rediscd backend
mvn clean spring-boot:run
# Backend REST & STOMP gateway active on :8080cd frontend
npm install
npm run dev
# Trading floor active at: http://localhost:5173All engine invariants, ports, and credentials are configurable via environment variables:
| Variable | Default | Purpose |
|---|---|---|
TZ |
Asia/Kolkata |
System timezone across all container clocks. |
FRONTEND_PORT |
5173 |
Host port for the React/Nginx trading floor. |
BACKEND_PORT |
8080 |
Host port for the Spring Boot REST/STOMP gateway. |
POSTGRES_PORT |
5432 |
Host port for PostgreSQL 16. |
REDIS_PORT |
6379 |
Host port for Redis 7.2. |
POSTGRES_DB |
livebid_db |
Relational database catalog name. |
JWT_SECRET |
(256-bit key) | HMAC-SHA secret for token minting and validation. |
ANTI_SNIPE_WINDOW_MINUTES |
2 |
Duration before closing that triggers anti-snipe extension. |
ANTI_SNIPE_EXTENSION_MINUTES |
2 |
Number of minutes added to end_time upon snipe detection. |
BID_MAX_RETRIES |
3 |
Maximum retry attempts on optimistic lock collision. |
AUTO_BID_INCREMENT |
10.00 |
Minimum increment used by automated proxy bidding bots. |
CLOSING_SCHEDULER_RATE_MS |
10000 |
Background worker polling interval for status transitions. |
| Hub / Service | Port | URL | Role & Live Features |
|---|---|---|---|
| Trading Floor Web App | 5173 |
http://localhost:5173 | Live Interactive Trading Floor, STOMP room updates & bidding bot UI. |
| Backend REST Gateway | 8080 |
http://localhost:8080 | Core auction state, proxy bot management, and user notifications. |
| Interactive OpenAPI Docs | 8080 |
http://localhost:8080/swagger-ui.html | OpenAPI 3.0 interactive Swagger specification. |
| Spring Boot Actuator | 8080 |
http://localhost:8080/actuator/health | Backend health checks, thread pools, and datasource status. |
| STOMP WebSocket Hub | 8080 |
ws://localhost:8080/ws |
Real-time bi-directional messaging channel for bid streaming. |
cd backend
mvn test
# Executes ConcurrentBidTest asserting zero dirty writes under parallel threads.python tests/load_test_1000_bids.py
# Fired across 50 concurrent threads: asserts 0 unexpected errors, verifies version counter integrity.curl -X POST http://localhost:8080/api/auctions/1/bids \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <JWT_TOKEN>" \
-d '{
"amount": 750.00
}'Jayavignesh
- Website: jayavignesh.dev
- GitHub: @i-viki
- Email: hello@jayavignesh.dev
This platform is distributed under the MIT License. See the LICENSE file for complete terms.