# dkraiser/abp architecture

> Architecture diagram of the GitHub repository dkraiser/abp, 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/dkraiser/abp
- Repository: https://github.com/dkraiser/abp

## Overview

This is a small ASP.NET booking API with in-memory persistence. Users manage rooms, search availability, book rooms with optional services, and request utilization/revenue reports. The API controllers invoke application handlers, which apply domain rules and booking/pricing policies and use repository interfaces; the API startup registers implementations and initial configuration. The graph follows documented capabilities, but unsampled handlers, policies and report wiring are shown only where the README or indexed source references support them.

Main entry points: [`src/api/Program.cs`](https://github.com/dkraiser/abp/blob/main/src/api/Program.cs) (Startup wiring), [`src/application/implementations/handlers/BookRoomsHandler.cs`](https://github.com/dkraiser/abp/blob/main/src/application/implementations/handlers/BookRoomsHandler.cs) (Booking workflow), [`src/application/implementations/handlers/ManageRoomsHandler.cs`](https://github.com/dkraiser/abp/blob/main/src/application/implementations/handlers/ManageRoomsHandler.cs) (Room management), [`src/application/interfaces/repositories/IRoomRepository.cs`](https://github.com/dkraiser/abp/blob/main/src/application/interfaces/repositories/IRoomRepository.cs) (Room repository contract)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_program["Startup wiring<br/>[Program.cs]"]
  node_room_api["Room endpoints<br/>[RoomsController.cs]"]
  node_booking_api["Booking endpoints"]
  node_reports_api["Report endpoints"]
end

subgraph group_application["Application workflows"]
  node_manage["Room management"]
  node_search["Availability search"]
  node_book["Booking workflow"]
  node_reports["Report calculations<br/>[ReportHandler.cs]"]
  node_booking_policy["Booking restrictions"]
  node_pricing_policy["Hourly pricing"]
end

subgraph group_domain["Booking domain"]
  node_room["Room and services<br/>[Room.cs]"]
  node_service["Service entity<br/>[Service.cs]"]
  node_booking["Booking entity<br/>[Booking.cs]"]
  node_result["Result and errors<br/>[Result.cs]"]
end

subgraph group_storage["In-memory storage"]
  node_room_repo["Room repository contract<br/>[IRoomRepository.cs]"]
  node_booking_repo["Booking repository contract"]
  node_room_store[("Strict room store")]
  node_booking_store[("Strict booking store")]
end

node_caller(("API client"))

node_caller -->|"manages rooms"| node_room_api
node_caller -->|"searches and books"| node_booking_api
node_caller -->|"requests reports"| node_reports_api
node_program -.->|"hosts API"| node_room_api
node_program -.->|"hosts API"| node_booking_api
node_program -.->|"hosts API"| node_reports_api
node_program -->|"registers handler"| node_manage
node_program -->|"registers handler"| node_search
node_program -->|"registers handler"| node_book
node_program -->|"registers handler"| node_reports
node_program -->|"registers store"| node_room_store
node_program -->|"registers store"| node_booking_store
node_room_api -->|"invokes"| node_manage
node_booking_api -->|"invokes"| node_search
node_booking_api -->|"invokes"| node_book
node_reports_api -->|"invokes"| node_reports
node_manage -->|"reads and writes"| node_room_repo
node_search -->|"reads rooms"| node_room_repo
node_search -->|"checks bookings"| node_booking_repo
node_book -->|"loads room"| node_room_repo
node_book -->|"checks and saves"| node_booking_repo
node_reports -->|"reads rooms"| node_room_repo
node_reports -->|"reads bookings"| node_booking_repo
node_room_store -->|"implements"| node_room_repo
node_booking_store -->|"implements"| node_booking_repo
node_manage -->|"creates and updates"| node_room
node_room -->|"contains services"| node_service
node_book -->|"constructs and prices"| node_booking
node_book -->|"checks policies"| node_booking_policy
node_book -->|"calculates price"| node_pricing_policy
node_book -->|"returns outcomes"| node_result
node_manage -->|"returns outcomes"| node_result

click node_program "https://github.com/dkraiser/abp/blob/main/src/api/Program.cs"
click node_room_api "https://github.com/dkraiser/abp/blob/main/src/api/controllers/RoomsController.cs"
click node_booking_api "https://github.com/dkraiser/abp/blob/main/src/api/controllers/BookingsController.cs"
click node_reports_api "https://github.com/dkraiser/abp/blob/main/src/api/controllers/ReportsController.cs"
click node_manage "https://github.com/dkraiser/abp/blob/main/src/application/implementations/handlers/ManageRoomsHandler.cs"
click node_search "https://github.com/dkraiser/abp/blob/main/src/application/implementations/handlers/SearchAvailableRoomsHandler.cs"
click node_book "https://github.com/dkraiser/abp/blob/main/src/application/implementations/handlers/BookRoomsHandler.cs"
click node_reports "https://github.com/dkraiser/abp/blob/main/src/application/implementations/handlers/ReportHandler.cs"
click node_booking_policy "https://github.com/dkraiser/abp/blob/main/src/application/implementations/policies/booking/ForbiddenPeriodPolicy.cs"
click node_pricing_policy "https://github.com/dkraiser/abp/blob/main/src/application/implementations/policies/pricing/hoursPolicy/HoursPricingPolicy.cs"
click node_room "https://github.com/dkraiser/abp/blob/main/src/domain/entities/Room.cs"
click node_service "https://github.com/dkraiser/abp/blob/main/src/domain/entities/Service.cs"
click node_booking "https://github.com/dkraiser/abp/blob/main/src/domain/entities/Booking.cs"
click node_result "https://github.com/dkraiser/abp/blob/main/src/domain/result/Result.cs"
click node_room_repo "https://github.com/dkraiser/abp/blob/main/src/application/interfaces/repositories/IRoomRepository.cs"
click node_booking_repo "https://github.com/dkraiser/abp/blob/main/src/application/interfaces/repositories/IBookingRepository.cs"
click node_room_store "https://github.com/dkraiser/abp/blob/main/src/infrastructure/repositories/inMemory/strict/InMemoryStrictRoomRepository.cs"
click node_booking_store "https://github.com/dkraiser/abp/blob/main/src/infrastructure/repositories/inMemory/strict/InMemoryStrictBookingRepository.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_program,node_room_api,node_booking_api,node_reports_api,node_caller toneBlue
class node_manage,node_search,node_book,node_reports,node_booking_policy,node_pricing_policy toneAmber
class node_room,node_service,node_booking,node_result toneMint
class node_room_repo,node_booking_repo,node_room_store,node_booking_store toneRose
```

## Components

### HTTP API

- [Startup wiring](https://github.com/dkraiser/abp/blob/main/src/api/Program.cs): `src/api/Program.cs`
- [Room endpoints](https://github.com/dkraiser/abp/blob/main/src/api/controllers/RoomsController.cs): `src/api/controllers/RoomsController.cs`
- [Booking endpoints](https://github.com/dkraiser/abp/blob/main/src/api/controllers/BookingsController.cs): `src/api/controllers/BookingsController.cs`
- [Report endpoints](https://github.com/dkraiser/abp/blob/main/src/api/controllers/ReportsController.cs): `src/api/controllers/ReportsController.cs`

### Application workflows

- [Room management](https://github.com/dkraiser/abp/blob/main/src/application/implementations/handlers/ManageRoomsHandler.cs): `src/application/implementations/handlers/ManageRoomsHandler.cs`
- [Availability search](https://github.com/dkraiser/abp/blob/main/src/application/implementations/handlers/SearchAvailableRoomsHandler.cs): `src/application/implementations/handlers/SearchAvailableRoomsHandler.cs`
- [Booking workflow](https://github.com/dkraiser/abp/blob/main/src/application/implementations/handlers/BookRoomsHandler.cs): `src/application/implementations/handlers/BookRoomsHandler.cs`
- [Report calculations](https://github.com/dkraiser/abp/blob/main/src/application/implementations/handlers/ReportHandler.cs): `src/application/implementations/handlers/ReportHandler.cs`
- [Booking restrictions](https://github.com/dkraiser/abp/blob/main/src/application/implementations/policies/booking/ForbiddenPeriodPolicy.cs): `src/application/implementations/policies/booking/ForbiddenPeriodPolicy.cs`
- [Hourly pricing](https://github.com/dkraiser/abp/blob/main/src/application/implementations/policies/pricing/hoursPolicy/HoursPricingPolicy.cs): `src/application/implementations/policies/pricing/hoursPolicy/HoursPricingPolicy.cs`

### Booking domain

- [Room and services](https://github.com/dkraiser/abp/blob/main/src/domain/entities/Room.cs): `src/domain/entities/Room.cs`
- [Service entity](https://github.com/dkraiser/abp/blob/main/src/domain/entities/Service.cs): `src/domain/entities/Service.cs`
- [Booking entity](https://github.com/dkraiser/abp/blob/main/src/domain/entities/Booking.cs): `src/domain/entities/Booking.cs`
- [Result and errors](https://github.com/dkraiser/abp/blob/main/src/domain/result/Result.cs): `src/domain/result/Result.cs`

### In-memory storage

- [Room repository contract](https://github.com/dkraiser/abp/blob/main/src/application/interfaces/repositories/IRoomRepository.cs): `src/application/interfaces/repositories/IRoomRepository.cs`
- [Booking repository contract](https://github.com/dkraiser/abp/blob/main/src/application/interfaces/repositories/IBookingRepository.cs): `src/application/interfaces/repositories/IBookingRepository.cs`
- [Strict room store](https://github.com/dkraiser/abp/blob/main/src/infrastructure/repositories/inMemory/strict/InMemoryStrictRoomRepository.cs): `src/infrastructure/repositories/inMemory/strict/InMemoryStrictRoomRepository.cs`
- [Strict booking store](https://github.com/dkraiser/abp/blob/main/src/infrastructure/repositories/inMemory/strict/InMemoryStrictBookingRepository.cs): `src/infrastructure/repositories/inMemory/strict/InMemoryStrictBookingRepository.cs`

### Other components

- **API client**

## Connections

- API client → Room endpoints: manages rooms (evidence: `src/api/controllers/RoomsController.cs`)
- API client → Booking endpoints: searches and books (evidence: `src/api/controllers/BookingsController.cs`)
- API client → Report endpoints: requests reports (evidence: `src/api/controllers/ReportsController.cs`)
- Startup wiring → Room endpoints: hosts API (evidence: `src/api/Program.cs`)
- Startup wiring → Booking endpoints: hosts API (evidence: `src/api/Program.cs`)
- Startup wiring → Report endpoints: hosts API (evidence: `src/api/Program.cs`)
- Startup wiring → Room management: registers handler (evidence: `src/api/Program.cs`)
- Startup wiring → Availability search: registers handler (evidence: `src/api/Program.cs`)
- Startup wiring → Booking workflow: registers handler (evidence: `src/api/Program.cs`)
- Startup wiring → Report calculations: registers handler (evidence: `src/api/Program.cs`)
- Startup wiring → Strict room store: registers store (evidence: `src/api/Program.cs`)
- Startup wiring → Strict booking store: registers store (evidence: `src/api/Program.cs`)
- Room endpoints → Room management: invokes (evidence: `src/api/controllers/RoomsController.cs`)
- Booking endpoints → Availability search: invokes (evidence: `src/api/controllers/BookingsController.cs`)
- Booking endpoints → Booking workflow: invokes (evidence: `src/api/controllers/BookingsController.cs`)
- Report endpoints → Report calculations: invokes (evidence: `src/api/controllers/ReportsController.cs`)
- Room management → Room repository contract: reads and writes (evidence: `src/application/implementations/handlers/ManageRoomsHandler.cs`)
- Availability search → Room repository contract: reads rooms (evidence: `src/application/implementations/handlers/SearchAvailableRoomsHandler.cs`)
- Availability search → Booking repository contract: checks bookings (evidence: `src/application/implementations/handlers/SearchAvailableRoomsHandler.cs`)
- Booking workflow → Room repository contract: loads room (evidence: `src/application/implementations/handlers/BookRoomsHandler.cs`)
- Booking workflow → Booking repository contract: checks and saves (evidence: `src/application/implementations/handlers/BookRoomsHandler.cs`)
- Report calculations → Room repository contract: reads rooms (evidence: `src/application/implementations/handlers/ReportHandler.cs`)
- Report calculations → Booking repository contract: reads bookings (evidence: `src/application/implementations/handlers/ReportHandler.cs`)
- Strict room store → Room repository contract: implements (evidence: `src/infrastructure/repositories/inMemory/strict/InMemoryStrictRoomRepository.cs`)
- Strict booking store → Booking repository contract: implements (evidence: `src/infrastructure/repositories/inMemory/strict/InMemoryStrictBookingRepository.cs`)
- Room management → Room and services: creates and updates (evidence: `src/application/implementations/handlers/ManageRoomsHandler.cs`)
- Room and services → Service entity: contains services (evidence: `src/domain/entities/Room.cs`)
- Booking workflow → Booking entity: constructs and prices (evidence: `src/application/implementations/handlers/BookRoomsHandler.cs`)
- Booking workflow → Booking restrictions: checks policies (evidence: `src/application/implementations/handlers/BookRoomsHandler.cs`)
- Booking workflow → Hourly pricing: calculates price (evidence: `src/application/implementations/handlers/BookRoomsHandler.cs`)
- Booking workflow → Result and errors: returns outcomes (evidence: `src/application/implementations/handlers/BookRoomsHandler.cs`)
- Room management → Result and errors: returns outcomes (evidence: `src/application/implementations/handlers/ManageRoomsHandler.cs`)
