How westamz/microservices works
Carsties is a vehicle-auction application organized around an authoritative auction service and an asynchronously maintained search read model. A browser client authenticates through IdentityService, sends requests through the gateway, and searches listings or performs auction operations. Auction lifecycle events flow through RabbitMQ to SearchService consumers; startup synchronization can also fetch auction updates directly. The README documents the overall service topology and frontend capabilities; several implementation details, including gateway routes and frontend request wiring, were not sampled, so those relationships rely on README evidence.
Main entry points: GatewayService/Program.cs HTTP gateway · AuctionController.cs Auction API · IdentityService/Program.cs Identity and tokens · page.tsx Next.js client
Components 21
Web client
- Next.js client
frontend/web-app/app/page.tsx - Listings and filters
frontend/web-app/app/auctions/Listings.tsx - Listing parameters
frontend/web-app/hooks/userParamsStore.tsx - Auction actions
frontend/web-app/app/actions/auctionActions.tsx - Session dashboard
frontend/web-app/app/session/page.tsx - NextAuth integration
frontend/web-app/auth.ts
Gateway and identity
- HTTP gateway
src/GatewayService/Program.cs - Identity and tokens
src/IdentityService/Program.cs - Token profile claims
src/IdentityService/Services/CustomProfileService.cs - Identity database
src/IdentityService/Data/ApplicationDbContext.cs
Auction domain
- Auction API
src/AuctionService/Controllers/AuctionController.cs - Auction database
src/AuctionService/Data/AuctionDbContext.cs - Auction event contracts
src/Contracts/AuctionCreated.cs - Auction event consumers
src/AuctionService/Consumers/AuctionFinishedConsumer.cs
Search read model
- Search API
src/SearchService/Controllers/SearchController.cs - MongoDB search model
src/SearchService/Models/Item.cs - Search event consumers
src/SearchService/Consumers/AuctionCreatedConsumer.cs - Auction sync client
src/SearchService/Services/AuctionSvcHttpClient.cs - Read-model initialization
src/SearchService/Data/DbInitializer.cs
Other components
- Browser user
- RabbitMQ
Connections 24
- Browser user → Next.js client: uses
README.md - Next.js client → Listings and filters: renders
README.md - Listings and filters → Listing parameters: stores filters
- Listings and filters → HTTP gateway: requests search
README.md - Auction actions → HTTP gateway: requests auctions
README.md - Next.js client → NextAuth integration: uses sessions
README.md - Session dashboard → NextAuth integration: reads session
frontend/web-app/app/session/page.tsx - NextAuth integration → Identity and tokens: authenticates
README.md - HTTP gateway → Auction API: routes requests
README.md - HTTP gateway → Search API: routes requests
README.md - HTTP gateway → Identity and tokens: validates tokens
README.md - Identity and tokens → Identity database: stores users
README.md - Identity and tokens → Token profile claims: issues claims
src/IdentityService/Services/CustomProfileService.cs - Auction API → Auction database: reads and writes
src/AuctionService/Controllers/AuctionController.cs - Auction API → RabbitMQ: publishes events
README.md - Auction API → Auction event contracts: maps payloads
src/AuctionService/Controllers/AuctionController.cs - RabbitMQ → Search event consumers: delivers events
README.md - Search event consumers → MongoDB search model: updates model
README.md - Search API → MongoDB search model: queries model
src/SearchService/Controllers/SearchController.cs - Read-model initialization → Auction sync client: requests sync
- Auction sync client → Auction API: fetches updates
src/SearchService/Services/AuctionSvcHttpClient.cs - Read-model initialization → MongoDB search model: initializes model
README.md - RabbitMQ → Auction event consumers: delivers events
README.md - Auction event consumers → Auction database: updates auction
src/AuctionService/Consumers/AuctionFinishedConsumer.cs