How saijaku0/clean-architecture works
Train Seat Reservation is a web-backed booking API: users browse trips, create a time-limited reservation, then confirm or cancel it; a scheduled worker expires stale pending bookings. The domain separates physical trains from per-trip seat availability, reservations, and locally cached Auth0 users. The graph also includes trip/reservation reads, authentication provisioning, persistence, and the Angular client. Some command handlers and integrations are unsampled, so only README-backed behavior or visible caller relationships are connected; optional client-to-API wiring is marked unverified.
Main entry points: AppDbContext.cs SQL Server data · Repositories Repository adapters · Program.cs API host · ExpireReservationsService.cs Expiry worker
Components 21
Web client
- Angular app
src/TrainBooking.Web/src/app - Trip browsing UI
src/TrainBooking.Web/src/app/components/trip-list - Reservation UI
src/TrainBooking.Web/src/app/components/my-reservation-list
API and identity
- API host
src/TrainBooking.Api/Program.cs - Trip endpoints
src/TrainBooking.Api/Controllers/TripsController.cs - Reservation endpoints
src/TrainBooking.Api/Controllers/ReservationsController.cs - Auth provisioning
src/TrainBooking.Api/Middleware/Auth0UserProvisioningMiddleware.cs - Expiry worker
src/TrainBooking.Api/BackgroundServices/ExpireReservationsService.cs
Application workflows
- Trip queries
src/TrainBooking.Application/Trips - Reservation queries
src/TrainBooking.Application/Reservations/Queries - Reservation commands
src/TrainBooking.Application/Reservations/Commands - User creation
src/TrainBooking.Application/Users/Commands/CreateUser
Booking domain
- Reservation aggregate
src/TrainBooking.Domain/Reservations/Reservation.cs - Trip seat aggregate
src/TrainBooking.Domain/TripSeats/TripSeat.cs - Trip aggregate
src/TrainBooking.Domain/Trips/Trip.cs - Train model
src/TrainBooking.Domain/Trains/Train.cs - Local user
src/TrainBooking.Domain/Users/User.cs
Persistence
- Repository adapters
src/TrainBooking.Infrastructure/Persistence/Repositories - SQL Server data
src/TrainBooking.Infrastructure/Persistence/AppDbContext.cs - Payment gateway
src/TrainBooking.Infrastructure/Payments/PaymentGateway.cs
Other components
- Passenger
Connections 28
- Passenger → Angular app: uses
README.md - Angular app → Trip browsing UI: browses
src/TrainBooking.Web/src/app/app.routes.ts - Angular app → Reservation UI: views bookings
src/TrainBooking.Web/src/app/app.routes.ts - Trip browsing UI → Trip endpoints: requests trips
- Reservation UI → Reservation endpoints: manages bookings
- API host → Trip endpoints: hosts
- API host → Reservation endpoints: hosts
- API host → Auth provisioning: configures
src/TrainBooking.Api/Program.cs - API host → Expiry worker: registers
src/TrainBooking.Api/Program.cs - Trip endpoints → Trip queries: dispatches
src/TrainBooking.Api/Controllers/TripsController.cs - Reservation endpoints → Reservation commands: dispatches
src/TrainBooking.Api/Controllers/ReservationsController.cs - Reservation endpoints → Reservation queries: dispatches
src/TrainBooking.Api/Controllers/ReservationsController.cs - Trip queries → Repository adapters: reads trips
src/TrainBooking.Application/Trips/GetTripById/GetTripByIdQueryHandler.cs - Reservation queries → Repository adapters: reads bookings
src/TrainBooking.Application/Reservations/Queries/GetReservationById/GetReservationByIdQueryHandler.cs - Reservation queries → Local user: checks current identity
src/TrainBooking.Application/Reservations/Queries/GetReservationById/GetReservationByIdQueryHandler.cs - Reservation commands → Reservation aggregate: changes booking state
README.md - Reservation commands → Trip seat aggregate: reserves seats
README.md - Expiry worker → Repository adapters: loads and commits
src/TrainBooking.Api/BackgroundServices/ExpireReservationsService.cs - Expiry worker → Reservation aggregate: expires pending
src/TrainBooking.Api/BackgroundServices/ExpireReservationsService.cs - Expiry worker → Trip seat aggregate: releases seats
src/TrainBooking.Api/BackgroundServices/ExpireReservationsService.cs - Repository adapters → SQL Server data: queries and updates
src/TrainBooking.Infrastructure/Persistence/Repositories/ReservationRepository.cs - SQL Server data → Reservation aggregate: stores
src/TrainBooking.Infrastructure/Persistence/AppDbContext.cs - SQL Server data → Trip aggregate: stores
src/TrainBooking.Infrastructure/Persistence/AppDbContext.cs - SQL Server data → Trip seat aggregate: stores
src/TrainBooking.Infrastructure/Persistence/AppDbContext.cs - SQL Server data → Train model: stores
src/TrainBooking.Infrastructure/Persistence/AppDbContext.cs - SQL Server data → Local user: stores
src/TrainBooking.Infrastructure/Persistence/AppDbContext.cs - Auth provisioning → User creation: provisions lazily
README.md - User creation → Repository adapters: persists user