How alexanderminko/ssp-ming-exchange works
This is an OpenRTB supply-side ad exchange. An incoming bid request is admitted using supply configuration and request validation, fanned out concurrently to demand bidders, evaluated in an auction, and returned as a bid or no-bid response. The orchestrator also records metrics and auction events. The graph preserves the documented serving stages and major model, cache, and telemetry areas; links for unsampled components are limited to relationships shown by the source index or orchestrator excerpt.
Main entry points: RtbOrchestrator.java RTB Orchestrator · BidderService.java Bidder Fan-out · AuctionService.java Auction · BidController.java Bid API
Components 23
Request Serving
- Bid API
src/main/java/com/ming/sspexchange/api/BidController.java - RTB Orchestrator
src/main/java/com/ming/sspexchange/service/RtbOrchestrator.java - Request Context
src/main/java/com/ming/sspexchange/model - Response Mapper
src/main/java/com/ming/sspexchange/service/mapper/BidResponseMapper.java
Supply Configuration
- Supply Resolver
src/main/java/com/ming/sspexchange/service/supply/SupplyResolver.java - Request Validation
src/main/java/com/ming/sspexchange/service/supply/RequestValidationService.java - Supply Partner Cache
src/main/java/com/ming/sspexchange/cache/SupplyPartnerCache.java - Supply Repository
src/main/java/com/ming/sspexchange/repository/SupplyPartnerRepository.java
Demand And Auction
- Bidder Cache
src/main/java/com/ming/sspexchange/cache/BidderCache.java - Bidder Repository
src/main/java/com/ming/sspexchange/repository/BidderRepository.java - Bidder Fan-out
src/main/java/com/ming/sspexchange/service/demand/BidderService.java - Bidder Results
src/main/java/com/ming/sspexchange/service/demand - Auction
src/main/java/com/ming/sspexchange/service/auction/AuctionService.java - Bid Validation
src/main/java/com/ming/sspexchange/service/auction/BidResponseValidationService.java - Winning Bid
src/main/java/com/ming/sspexchange/service/auction/WinningBid.java
Exchange Models
- Supply Models
src/main/java/com/ming/sspexchange/model/entity - Bidder Model
src/main/java/com/ming/sspexchange/model/entity/Bidder.java - OpenRTB Models
src/main/java/com/ming/sspexchange/model/openrtb
Metrics And Events
- Exchange Metrics
src/main/java/com/ming/sspexchange/service/metrics/ExchangeMetrics.java - Auction Event Mapper
src/main/java/com/ming/sspexchange/service/mapper/AuctionEventMapper.java - Auction Event Logger
src/main/java/com/ming/sspexchange/service/event/AuctionEventLogger.java
Other components
- Supply Partner
- Demand Bidders
Connections 20
- Supply Partner → Bid API: submits request
src/main/java/com/ming/sspexchange/api/BidController.java - Bid API → RTB Orchestrator: invokes
src/main/java/com/ming/sspexchange/api/BidController.java - RTB Orchestrator → Supply Resolver: resolves supply
src/main/java/com/ming/sspexchange/service/RtbOrchestrator.java - RTB Orchestrator → Request Validation: validates request
src/main/java/com/ming/sspexchange/service/RtbOrchestrator.java - RTB Orchestrator → Bidder Cache: loads bidders
src/main/java/com/ming/sspexchange/service/RtbOrchestrator.java - RTB Orchestrator → Bidder Fan-out: fans out
src/main/java/com/ming/sspexchange/service/RtbOrchestrator.java - Bidder Fan-out → Demand Bidders: sends bid request
src/main/java/com/ming/sspexchange/service/demand/BidderService.java - Bidder Fan-out → Bidder Results: returns outcomes
src/main/java/com/ming/sspexchange/service/demand/BidderService.java - RTB Orchestrator → Auction: selects winner
src/main/java/com/ming/sspexchange/service/RtbOrchestrator.java - Auction → Bid Validation: filters bids
src/main/java/com/ming/sspexchange/service/auction/AuctionService.java - Auction → Winning Bid: produces winner
src/main/java/com/ming/sspexchange/service/auction/AuctionService.java - RTB Orchestrator → Response Mapper: builds response
src/main/java/com/ming/sspexchange/service/RtbOrchestrator.java - Response Mapper → OpenRTB Models: maps response
src/main/java/com/ming/sspexchange/service/mapper/BidResponseMapper.java - RTB Orchestrator → Request Context: tracks request state
src/main/java/com/ming/sspexchange/service/RtbOrchestrator.java - RTB Orchestrator → Exchange Metrics: records outcomes
src/main/java/com/ming/sspexchange/service/RtbOrchestrator.java - RTB Orchestrator → Auction Event Mapper: maps auction event
src/main/java/com/ming/sspexchange/service/RtbOrchestrator.java - RTB Orchestrator → Auction Event Logger: logs event
src/main/java/com/ming/sspexchange/service/RtbOrchestrator.java - Auction Event Mapper → Request Context: reads auction state
src/main/java/com/ming/sspexchange/service/mapper/AuctionEventMapper.java - Bidder Cache → Bidder Repository: loads bidders
src/main/java/com/ming/sspexchange/cache/BidderCache.java - Supply Partner Cache → Supply Repository: loads supply config
src/main/java/com/ming/sspexchange/cache/SupplyPartnerCache.java