# saijaku0/clean-architecture architecture

> Architecture diagram of the GitHub repository saijaku0/clean-architecture, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/saijaku0/clean-architecture
- Repository: https://github.com/saijaku0/clean-architecture

## Overview

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: [`src/TrainBooking.Infrastructure/Persistence/AppDbContext.cs`](https://github.com/saijaku0/clean-architecture/blob/main/src/TrainBooking.Infrastructure/Persistence/AppDbContext.cs) (SQL Server data), [`src/TrainBooking.Infrastructure/Persistence/Repositories`](https://github.com/saijaku0/clean-architecture/tree/main/src/TrainBooking.Infrastructure/Persistence/Repositories) (Repository adapters), [`src/TrainBooking.Api/Program.cs`](https://github.com/saijaku0/clean-architecture/blob/main/src/TrainBooking.Api/Program.cs) (API host), [`src/TrainBooking.Api/BackgroundServices/ExpireReservationsService.cs`](https://github.com/saijaku0/clean-architecture/blob/main/src/TrainBooking.Api/BackgroundServices/ExpireReservationsService.cs) (Expiry worker)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_web["Angular app<br/>[app]"]
  node_trip_ui["Trip browsing UI<br/>[trip-list]"]
  node_reservation_ui["Reservation UI"]
end

subgraph group_api["API and identity"]
  node_api_host["API host<br/>[Program.cs]"]
  node_trip_api["Trip endpoints<br/>[TripsController.cs]"]
  node_reservation_api["Reservation endpoints"]
  node_auth["Auth provisioning"]
  node_expiry["Expiry worker"]
end

subgraph group_application["Application workflows"]
  node_trip_queries["Trip queries<br/>[Trips]"]
  node_reservation_queries["Reservation queries<br/>[Queries]"]
  node_reservation_commands["Reservation commands<br/>[Commands]"]
  node_user_creation["User creation<br/>[CreateUser]"]
end

subgraph group_domain["Booking domain"]
  node_reservation{{"Reservation aggregate<br/>[Reservation.cs]"}}
  node_trip_seat{{"Trip seat aggregate<br/>[TripSeat.cs]"}}
  node_trip{{"Trip aggregate<br/>[Trip.cs]"}}
  node_train["Train model<br/>[Train.cs]"]
  node_user["Local user<br/>[User.cs]"]
end

subgraph group_infrastructure["Persistence"]
  node_repositories["Repository adapters<br/>[Repositories]"]
  node_database[("SQL Server data<br/>[AppDbContext.cs]")]
  node_payment_gateway["Payment gateway<br/>[PaymentGateway.cs]"]
end

node_passenger(("Passenger"))

node_passenger -->|"uses"| node_web
node_web -->|"browses"| node_trip_ui
node_web -->|"views bookings"| node_reservation_ui
node_trip_ui -.->|"requests trips"| node_trip_api
node_reservation_ui -.->|"manages bookings"| node_reservation_api
node_api_host -.->|"hosts"| node_trip_api
node_api_host -.->|"hosts"| node_reservation_api
node_api_host -->|"configures"| node_auth
node_api_host -->|"registers"| node_expiry
node_trip_api -->|"dispatches"| node_trip_queries
node_reservation_api -->|"dispatches"| node_reservation_commands
node_reservation_api -->|"dispatches"| node_reservation_queries
node_trip_queries -->|"reads trips"| node_repositories
node_reservation_queries -->|"reads bookings"| node_repositories
node_reservation_queries -->|"checks current identity"| node_user
node_reservation_commands -.->|"changes booking state"| node_reservation
node_reservation_commands -.->|"reserves seats"| node_trip_seat
node_expiry -->|"loads and commits"| node_repositories
node_expiry -->|"expires pending"| node_reservation
node_expiry -->|"releases seats"| node_trip_seat
node_repositories -->|"queries and updates"| node_database
node_database -->|"stores"| node_reservation
node_database -->|"stores"| node_trip
node_database -->|"stores"| node_trip_seat
node_database -->|"stores"| node_train
node_database -->|"stores"| node_user
node_auth -.->|"provisions lazily"| node_user_creation
node_user_creation -.->|"persists user"| node_repositories

click node_web "https://github.com/saijaku0/clean-architecture/tree/main/src/TrainBooking.Web/src/app"
click node_trip_ui "https://github.com/saijaku0/clean-architecture/tree/main/src/TrainBooking.Web/src/app/components/trip-list"
click node_reservation_ui "https://github.com/saijaku0/clean-architecture/tree/main/src/TrainBooking.Web/src/app/components/my-reservation-list"
click node_api_host "https://github.com/saijaku0/clean-architecture/blob/main/src/TrainBooking.Api/Program.cs"
click node_trip_api "https://github.com/saijaku0/clean-architecture/blob/main/src/TrainBooking.Api/Controllers/TripsController.cs"
click node_reservation_api "https://github.com/saijaku0/clean-architecture/blob/main/src/TrainBooking.Api/Controllers/ReservationsController.cs"
click node_auth "https://github.com/saijaku0/clean-architecture/blob/main/src/TrainBooking.Api/Middleware/Auth0UserProvisioningMiddleware.cs"
click node_expiry "https://github.com/saijaku0/clean-architecture/blob/main/src/TrainBooking.Api/BackgroundServices/ExpireReservationsService.cs"
click node_trip_queries "https://github.com/saijaku0/clean-architecture/tree/main/src/TrainBooking.Application/Trips"
click node_reservation_queries "https://github.com/saijaku0/clean-architecture/tree/main/src/TrainBooking.Application/Reservations/Queries"
click node_reservation_commands "https://github.com/saijaku0/clean-architecture/tree/main/src/TrainBooking.Application/Reservations/Commands"
click node_user_creation "https://github.com/saijaku0/clean-architecture/tree/main/src/TrainBooking.Application/Users/Commands/CreateUser"
click node_reservation "https://github.com/saijaku0/clean-architecture/blob/main/src/TrainBooking.Domain/Reservations/Reservation.cs"
click node_trip_seat "https://github.com/saijaku0/clean-architecture/blob/main/src/TrainBooking.Domain/TripSeats/TripSeat.cs"
click node_trip "https://github.com/saijaku0/clean-architecture/blob/main/src/TrainBooking.Domain/Trips/Trip.cs"
click node_train "https://github.com/saijaku0/clean-architecture/blob/main/src/TrainBooking.Domain/Trains/Train.cs"
click node_user "https://github.com/saijaku0/clean-architecture/blob/main/src/TrainBooking.Domain/Users/User.cs"
click node_repositories "https://github.com/saijaku0/clean-architecture/tree/main/src/TrainBooking.Infrastructure/Persistence/Repositories"
click node_database "https://github.com/saijaku0/clean-architecture/blob/main/src/TrainBooking.Infrastructure/Persistence/AppDbContext.cs"
click node_payment_gateway "https://github.com/saijaku0/clean-architecture/blob/main/src/TrainBooking.Infrastructure/Payments/PaymentGateway.cs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_web,node_trip_ui,node_reservation_ui toneBlue
class node_api_host,node_trip_api,node_reservation_api,node_auth,node_expiry toneAmber
class node_trip_queries,node_reservation_queries,node_reservation_commands,node_user_creation toneMint
class node_reservation,node_trip_seat,node_trip,node_train,node_user toneRose
class node_repositories,node_database,node_payment_gateway,node_passenger toneIndigo
```

## Components

### Web client

- [Angular app](https://github.com/saijaku0/clean-architecture/tree/main/src/TrainBooking.Web/src/app): `src/TrainBooking.Web/src/app`
- [Trip browsing UI](https://github.com/saijaku0/clean-architecture/tree/main/src/TrainBooking.Web/src/app/components/trip-list): `src/TrainBooking.Web/src/app/components/trip-list`
- [Reservation UI](https://github.com/saijaku0/clean-architecture/tree/main/src/TrainBooking.Web/src/app/components/my-reservation-list): `src/TrainBooking.Web/src/app/components/my-reservation-list`

### API and identity

- [API host](https://github.com/saijaku0/clean-architecture/blob/main/src/TrainBooking.Api/Program.cs): `src/TrainBooking.Api/Program.cs`
- [Trip endpoints](https://github.com/saijaku0/clean-architecture/blob/main/src/TrainBooking.Api/Controllers/TripsController.cs): `src/TrainBooking.Api/Controllers/TripsController.cs`
- [Reservation endpoints](https://github.com/saijaku0/clean-architecture/blob/main/src/TrainBooking.Api/Controllers/ReservationsController.cs): `src/TrainBooking.Api/Controllers/ReservationsController.cs`
- [Auth provisioning](https://github.com/saijaku0/clean-architecture/blob/main/src/TrainBooking.Api/Middleware/Auth0UserProvisioningMiddleware.cs): `src/TrainBooking.Api/Middleware/Auth0UserProvisioningMiddleware.cs`
- [Expiry worker](https://github.com/saijaku0/clean-architecture/blob/main/src/TrainBooking.Api/BackgroundServices/ExpireReservationsService.cs): `src/TrainBooking.Api/BackgroundServices/ExpireReservationsService.cs`

### Application workflows

- [Trip queries](https://github.com/saijaku0/clean-architecture/tree/main/src/TrainBooking.Application/Trips): `src/TrainBooking.Application/Trips`
- [Reservation queries](https://github.com/saijaku0/clean-architecture/tree/main/src/TrainBooking.Application/Reservations/Queries): `src/TrainBooking.Application/Reservations/Queries`
- [Reservation commands](https://github.com/saijaku0/clean-architecture/tree/main/src/TrainBooking.Application/Reservations/Commands): `src/TrainBooking.Application/Reservations/Commands`
- [User creation](https://github.com/saijaku0/clean-architecture/tree/main/src/TrainBooking.Application/Users/Commands/CreateUser): `src/TrainBooking.Application/Users/Commands/CreateUser`

### Booking domain

- [Reservation aggregate](https://github.com/saijaku0/clean-architecture/blob/main/src/TrainBooking.Domain/Reservations/Reservation.cs): `src/TrainBooking.Domain/Reservations/Reservation.cs`
- [Trip seat aggregate](https://github.com/saijaku0/clean-architecture/blob/main/src/TrainBooking.Domain/TripSeats/TripSeat.cs): `src/TrainBooking.Domain/TripSeats/TripSeat.cs`
- [Trip aggregate](https://github.com/saijaku0/clean-architecture/blob/main/src/TrainBooking.Domain/Trips/Trip.cs): `src/TrainBooking.Domain/Trips/Trip.cs`
- [Train model](https://github.com/saijaku0/clean-architecture/blob/main/src/TrainBooking.Domain/Trains/Train.cs): `src/TrainBooking.Domain/Trains/Train.cs`
- [Local user](https://github.com/saijaku0/clean-architecture/blob/main/src/TrainBooking.Domain/Users/User.cs): `src/TrainBooking.Domain/Users/User.cs`

### Persistence

- [Repository adapters](https://github.com/saijaku0/clean-architecture/tree/main/src/TrainBooking.Infrastructure/Persistence/Repositories): `src/TrainBooking.Infrastructure/Persistence/Repositories`
- [SQL Server data](https://github.com/saijaku0/clean-architecture/blob/main/src/TrainBooking.Infrastructure/Persistence/AppDbContext.cs): `src/TrainBooking.Infrastructure/Persistence/AppDbContext.cs`
- [Payment gateway](https://github.com/saijaku0/clean-architecture/blob/main/src/TrainBooking.Infrastructure/Payments/PaymentGateway.cs): `src/TrainBooking.Infrastructure/Payments/PaymentGateway.cs`

### Other components

- **Passenger**

## Connections

- Passenger → Angular app: uses (evidence: `README.md`)
- Angular app → Trip browsing UI: browses (evidence: `src/TrainBooking.Web/src/app/app.routes.ts`)
- Angular app → Reservation UI: views bookings (evidence: `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 (evidence: `src/TrainBooking.Api/Program.cs`)
- API host → Expiry worker: registers (evidence: `src/TrainBooking.Api/Program.cs`)
- Trip endpoints → Trip queries: dispatches (evidence: `src/TrainBooking.Api/Controllers/TripsController.cs`)
- Reservation endpoints → Reservation commands: dispatches (evidence: `src/TrainBooking.Api/Controllers/ReservationsController.cs`)
- Reservation endpoints → Reservation queries: dispatches (evidence: `src/TrainBooking.Api/Controllers/ReservationsController.cs`)
- Trip queries → Repository adapters: reads trips (evidence: `src/TrainBooking.Application/Trips/GetTripById/GetTripByIdQueryHandler.cs`)
- Reservation queries → Repository adapters: reads bookings (evidence: `src/TrainBooking.Application/Reservations/Queries/GetReservationById/GetReservationByIdQueryHandler.cs`)
- Reservation queries → Local user: checks current identity (evidence: `src/TrainBooking.Application/Reservations/Queries/GetReservationById/GetReservationByIdQueryHandler.cs`)
- Reservation commands → Reservation aggregate: changes booking state (evidence: `README.md`)
- Reservation commands → Trip seat aggregate: reserves seats (evidence: `README.md`)
- Expiry worker → Repository adapters: loads and commits (evidence: `src/TrainBooking.Api/BackgroundServices/ExpireReservationsService.cs`)
- Expiry worker → Reservation aggregate: expires pending (evidence: `src/TrainBooking.Api/BackgroundServices/ExpireReservationsService.cs`)
- Expiry worker → Trip seat aggregate: releases seats (evidence: `src/TrainBooking.Api/BackgroundServices/ExpireReservationsService.cs`)
- Repository adapters → SQL Server data: queries and updates (evidence: `src/TrainBooking.Infrastructure/Persistence/Repositories/ReservationRepository.cs`)
- SQL Server data → Reservation aggregate: stores (evidence: `src/TrainBooking.Infrastructure/Persistence/AppDbContext.cs`)
- SQL Server data → Trip aggregate: stores (evidence: `src/TrainBooking.Infrastructure/Persistence/AppDbContext.cs`)
- SQL Server data → Trip seat aggregate: stores (evidence: `src/TrainBooking.Infrastructure/Persistence/AppDbContext.cs`)
- SQL Server data → Train model: stores (evidence: `src/TrainBooking.Infrastructure/Persistence/AppDbContext.cs`)
- SQL Server data → Local user: stores (evidence: `src/TrainBooking.Infrastructure/Persistence/AppDbContext.cs`)
- Auth provisioning → User creation: provisions lazily (evidence: `README.md`)
- User creation → Repository adapters: persists user
