# saran-067/travelbookingmanagement architecture

> Architecture diagram of the GitHub repository saran-067/travelbookingmanagement, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/saran-067/travelbookingmanagement
- Repository: https://github.com/saran-067/travelbookingmanagement

## Overview

TravelBookingManagement is a bus-travel booking application with an Angular client and an ASP.NET API backed by Entity Framework. The passenger journey is schedule discovery, seat selection, checkout, and booking follow-up; separate operator and admin areas manage transport operations and users. The source index and excerpts establish several backend calls and persistence relationships, but most feature implementations and frontend API wiring were not sampled, so those links are left unasserted or marked unverified.

Main entry points: [`TravelBooking.Infra/Repository`](https://github.com/saran-067/travelbookingmanagement/tree/master/TravelBooking.Infra/Repository) (Repositories), [`frontend/src/app/app.routes.ts`](https://github.com/saran-067/travelbookingmanagement/blob/master/frontend/src/app/app.routes.ts) (App routing), [`TravelBooking.API/Program.cs`](https://github.com/saran-067/travelbookingmanagement/blob/master/TravelBooking.API/Program.cs) (Travel API), [`TravelBooking.Infra/Data/ApplicationDbContext.cs`](https://github.com/saran-067/travelbookingmanagement/blob/master/TravelBooking.Infra/Data/ApplicationDbContext.cs) (EF Core context)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Angular client"]
  node_web_routes["App routing<br/>[app.routes.ts]"]
  node_schedule_search["Schedule search"]
  node_seat_picker["Seat selection"]
  node_checkout["Checkout"]
  node_passenger_records["Passenger records"]
  node_operator_console["Operator console"]
  node_admin_console["Admin console"]
end

subgraph group_api["API layer"]
  node_travel_api["Travel API<br/>[Program.cs]"]
  node_auth_controller["Authentication endpoints<br/>[AuthController.cs]"]
  node_booking_controller["Booking endpoints"]
  node_review_controller["Review endpoints"]
end

subgraph group_domain["Domain services"]
  node_auth_service["Authentication<br/>[AuthService.cs]"]
  node_booking_service["Booking management<br/>[BookingService.cs]"]
  node_payment_service["Payment management<br/>[PaymentService.cs]"]
  node_cancellation_service["Cancellations"]
  node_review_service["Reviews<br/>[ReviewService.cs]"]
end

subgraph group_operations["Transport operations"]
  node_route_service["Route management<br/>[RoutesService.cs]"]
  node_schedule_service["Schedules and seats<br/>[ScheduleService.cs]"]
  node_fleet_services["Fleet and operators<br/>[Services]"]
  node_user_service["Users and roles<br/>[UserService.cs]"]
end

subgraph group_persistence["Persistence"]
  node_repositories["Repositories<br/>[Repository]"]
  node_entity_models["Domain entities<br/>[Models]"]
  node_db_context["EF Core context"]
  node_database[("Application database")]
end

node_passenger(("Passenger"))

node_passenger -->|"uses"| node_web_routes
node_web_routes -->|"routes to"| node_schedule_search
node_web_routes -->|"routes to"| node_seat_picker
node_web_routes -->|"routes to"| node_checkout
node_web_routes -->|"routes to"| node_passenger_records
node_web_routes -->|"routes to"| node_operator_console
node_web_routes -->|"routes to"| node_admin_console
node_web_routes -.->|"API use unverified"| node_travel_api
node_travel_api -.->|"hosts"| node_auth_controller
node_travel_api -.->|"hosts"| node_booking_controller
node_travel_api -.->|"hosts"| node_review_controller
node_auth_controller -.->|"delegates to"| node_auth_service
node_booking_controller -.->|"delegates to"| node_booking_service
node_review_controller -->|"calls"| node_review_service
node_auth_service -->|"reads and writes"| node_repositories
node_review_service -->|"uses"| node_repositories
node_route_service -->|"uses"| node_repositories
node_booking_service -.->|"uses"| node_repositories
node_payment_service -.->|"uses"| node_repositories
node_cancellation_service -.->|"uses"| node_repositories
node_schedule_service -.->|"uses"| node_repositories
node_fleet_services -.->|"uses"| node_repositories
node_user_service -.->|"uses"| node_repositories
node_repositories -->|"queries"| node_db_context
node_db_context -->|"maps"| node_entity_models
node_db_context -.->|"persists"| node_database

click node_web_routes "https://github.com/saran-067/travelbookingmanagement/blob/master/frontend/src/app/app.routes.ts"
click node_schedule_search "https://github.com/saran-067/travelbookingmanagement/blob/master/frontend/src/app/features/passenger/schedules-list.component.ts"
click node_seat_picker "https://github.com/saran-067/travelbookingmanagement/blob/master/frontend/src/app/features/passenger/seat-picker.component.ts"
click node_checkout "https://github.com/saran-067/travelbookingmanagement/blob/master/frontend/src/app/features/passenger/checkout.component.ts"
click node_passenger_records "https://github.com/saran-067/travelbookingmanagement/tree/master/frontend/src/app/features/passenger"
click node_operator_console "https://github.com/saran-067/travelbookingmanagement/tree/master/frontend/src/app/features/operator"
click node_admin_console "https://github.com/saran-067/travelbookingmanagement/tree/master/frontend/src/app/features/admin"
click node_travel_api "https://github.com/saran-067/travelbookingmanagement/blob/master/TravelBooking.API/Program.cs"
click node_auth_controller "https://github.com/saran-067/travelbookingmanagement/blob/master/TravelBooking.API/Controllers/AuthController.cs"
click node_booking_controller "https://github.com/saran-067/travelbookingmanagement/blob/master/TravelBooking.API/Controllers/BookingController.cs"
click node_review_controller "https://github.com/saran-067/travelbookingmanagement/blob/master/TravelBooking.API/Controllers/ReviewController.cs"
click node_auth_service "https://github.com/saran-067/travelbookingmanagement/blob/master/TravelBooking.Core/Services/AuthService.cs"
click node_booking_service "https://github.com/saran-067/travelbookingmanagement/blob/master/TravelBooking.Core/Services/BookingService.cs"
click node_payment_service "https://github.com/saran-067/travelbookingmanagement/blob/master/TravelBooking.Core/Services/PaymentService.cs"
click node_cancellation_service "https://github.com/saran-067/travelbookingmanagement/blob/master/TravelBooking.Core/Services/CancellationService.cs"
click node_review_service "https://github.com/saran-067/travelbookingmanagement/blob/master/TravelBooking.Core/Services/ReviewService.cs"
click node_route_service "https://github.com/saran-067/travelbookingmanagement/blob/master/TravelBooking.Core/Services/RoutesService.cs"
click node_schedule_service "https://github.com/saran-067/travelbookingmanagement/blob/master/TravelBooking.Core/Services/ScheduleService.cs"
click node_fleet_services "https://github.com/saran-067/travelbookingmanagement/tree/master/TravelBooking.Core/Services"
click node_user_service "https://github.com/saran-067/travelbookingmanagement/blob/master/TravelBooking.Core/Services/UserService.cs"
click node_repositories "https://github.com/saran-067/travelbookingmanagement/tree/master/TravelBooking.Infra/Repository"
click node_entity_models "https://github.com/saran-067/travelbookingmanagement/tree/master/TravelBooking.Infra/Models"
click node_db_context "https://github.com/saran-067/travelbookingmanagement/blob/master/TravelBooking.Infra/Data/ApplicationDbContext.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_routes,node_schedule_search,node_seat_picker,node_checkout,node_passenger_records,node_operator_console,node_admin_console toneBlue
class node_travel_api,node_auth_controller,node_booking_controller,node_review_controller toneAmber
class node_auth_service,node_booking_service,node_payment_service,node_cancellation_service,node_review_service toneMint
class node_route_service,node_schedule_service,node_fleet_services,node_user_service toneRose
class node_repositories,node_entity_models,node_db_context,node_database,node_passenger toneIndigo
```

## Components

### Angular client

- [App routing](https://github.com/saran-067/travelbookingmanagement/blob/master/frontend/src/app/app.routes.ts): `frontend/src/app/app.routes.ts`
- [Schedule search](https://github.com/saran-067/travelbookingmanagement/blob/master/frontend/src/app/features/passenger/schedules-list.component.ts): `frontend/src/app/features/passenger/schedules-list.component.ts`
- [Seat selection](https://github.com/saran-067/travelbookingmanagement/blob/master/frontend/src/app/features/passenger/seat-picker.component.ts): `frontend/src/app/features/passenger/seat-picker.component.ts`
- [Checkout](https://github.com/saran-067/travelbookingmanagement/blob/master/frontend/src/app/features/passenger/checkout.component.ts): `frontend/src/app/features/passenger/checkout.component.ts`
- [Passenger records](https://github.com/saran-067/travelbookingmanagement/tree/master/frontend/src/app/features/passenger): `frontend/src/app/features/passenger`
- [Operator console](https://github.com/saran-067/travelbookingmanagement/tree/master/frontend/src/app/features/operator): `frontend/src/app/features/operator`
- [Admin console](https://github.com/saran-067/travelbookingmanagement/tree/master/frontend/src/app/features/admin): `frontend/src/app/features/admin`

### API layer

- [Travel API](https://github.com/saran-067/travelbookingmanagement/blob/master/TravelBooking.API/Program.cs): `TravelBooking.API/Program.cs`
- [Authentication endpoints](https://github.com/saran-067/travelbookingmanagement/blob/master/TravelBooking.API/Controllers/AuthController.cs): `TravelBooking.API/Controllers/AuthController.cs`
- [Booking endpoints](https://github.com/saran-067/travelbookingmanagement/blob/master/TravelBooking.API/Controllers/BookingController.cs): `TravelBooking.API/Controllers/BookingController.cs`
- [Review endpoints](https://github.com/saran-067/travelbookingmanagement/blob/master/TravelBooking.API/Controllers/ReviewController.cs): `TravelBooking.API/Controllers/ReviewController.cs`

### Domain services

- [Authentication](https://github.com/saran-067/travelbookingmanagement/blob/master/TravelBooking.Core/Services/AuthService.cs): `TravelBooking.Core/Services/AuthService.cs`
- [Booking management](https://github.com/saran-067/travelbookingmanagement/blob/master/TravelBooking.Core/Services/BookingService.cs): `TravelBooking.Core/Services/BookingService.cs`
- [Payment management](https://github.com/saran-067/travelbookingmanagement/blob/master/TravelBooking.Core/Services/PaymentService.cs): `TravelBooking.Core/Services/PaymentService.cs`
- [Cancellations](https://github.com/saran-067/travelbookingmanagement/blob/master/TravelBooking.Core/Services/CancellationService.cs): `TravelBooking.Core/Services/CancellationService.cs`
- [Reviews](https://github.com/saran-067/travelbookingmanagement/blob/master/TravelBooking.Core/Services/ReviewService.cs): `TravelBooking.Core/Services/ReviewService.cs`

### Transport operations

- [Route management](https://github.com/saran-067/travelbookingmanagement/blob/master/TravelBooking.Core/Services/RoutesService.cs): `TravelBooking.Core/Services/RoutesService.cs`
- [Schedules and seats](https://github.com/saran-067/travelbookingmanagement/blob/master/TravelBooking.Core/Services/ScheduleService.cs): `TravelBooking.Core/Services/ScheduleService.cs`
- [Fleet and operators](https://github.com/saran-067/travelbookingmanagement/tree/master/TravelBooking.Core/Services): `TravelBooking.Core/Services`
- [Users and roles](https://github.com/saran-067/travelbookingmanagement/blob/master/TravelBooking.Core/Services/UserService.cs): `TravelBooking.Core/Services/UserService.cs`

### Persistence

- [Repositories](https://github.com/saran-067/travelbookingmanagement/tree/master/TravelBooking.Infra/Repository): `TravelBooking.Infra/Repository`
- [Domain entities](https://github.com/saran-067/travelbookingmanagement/tree/master/TravelBooking.Infra/Models): `TravelBooking.Infra/Models`
- [EF Core context](https://github.com/saran-067/travelbookingmanagement/blob/master/TravelBooking.Infra/Data/ApplicationDbContext.cs): `TravelBooking.Infra/Data/ApplicationDbContext.cs`
- **Application database**

### Other components

- **Passenger**

## Connections

- Passenger → App routing: uses (evidence: `frontend/src/app/app.routes.ts`)
- App routing → Schedule search: routes to (evidence: `frontend/src/app/app.routes.ts`)
- App routing → Seat selection: routes to (evidence: `frontend/src/app/app.routes.ts`)
- App routing → Checkout: routes to (evidence: `frontend/src/app/app.routes.ts`)
- App routing → Passenger records: routes to (evidence: `frontend/src/app/app.routes.ts`)
- App routing → Operator console: routes to (evidence: `frontend/src/app/app.routes.ts`)
- App routing → Admin console: routes to (evidence: `frontend/src/app/app.routes.ts`)
- App routing → Travel API: API use unverified
- Travel API → Authentication endpoints: hosts
- Travel API → Booking endpoints: hosts
- Travel API → Review endpoints: hosts
- Authentication endpoints → Authentication: delegates to
- Booking endpoints → Booking management: delegates to
- Review endpoints → Reviews: calls (evidence: `TravelBooking.API/Controllers/ReviewController.cs`)
- Authentication → Repositories: reads and writes (evidence: `TravelBooking.Core/Services/AuthService.cs`)
- Reviews → Repositories: uses (evidence: `TravelBooking.Core/Services/ReviewService.cs`)
- Route management → Repositories: uses (evidence: `TravelBooking.Core/Services/RoutesService.cs`)
- Booking management → Repositories: uses
- Payment management → Repositories: uses
- Cancellations → Repositories: uses
- Schedules and seats → Repositories: uses
- Fleet and operators → Repositories: uses
- Users and roles → Repositories: uses
- Repositories → EF Core context: queries (evidence: `TravelBooking.Infra/Repository/ReviewRepository.cs`)
- EF Core context → Domain entities: maps (evidence: `TravelBooking.Infra/Data/ApplicationDbContext.cs`)
- EF Core context → Application database: persists
