# singhsanket143/airbnbspring architecture

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

- Interactive diagram: https://gitdiagram.com/singhsanket143/airbnbspring
- Repository: https://github.com/singhsanket143/airbnbspring

## Overview

This is a Spring application for Airbnb-style bookings. The apparent user workflow is to submit a booking request, have booking services coordinate availability and concurrency, persist booking state, and return a result; the tree also shows Redis-backed reads and saga/event handling. Only the build file was excerpted, and the README is empty, so source-level calls and wiring cannot be verified. Dashed, uncited edges indicate likely relationships inferred from component names, not inspected control flow.

Main entry points: [`src/main/java/com/example/AirbnbBookingSpring/services/BookingService.java`](https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/services/BookingService.java) (Booking service), [`src/main/java/com/example/AirbnbBookingSpring/controllers/BookingController.java`](https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/controllers/BookingController.java) (Booking controller), [`src/main/java/com/example/AirbnbBookingSpring/saga/SagaEventProcessor.java`](https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/saga/SagaEventProcessor.java) (Saga processor), [`src/main/java/com/example/AirbnbBookingSpring/repositories/reads/RedisReadRepository.java`](https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/repositories/reads/RedisReadRepository.java) (Redis read repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Booking API"]
  node_app["Spring application"]
  node_controller["Booking controller"]
  node_create_dto["Create request"]
  node_update_dto["Update request"]
end

subgraph group_booking["Booking Services"]
  node_booking_service["Booking service"]
  node_service_interface["Booking service API"]
  node_idempotency["Idempotency service"]
  node_idempotency_api["Idempotency contract"]
  node_concurrency["Concurrency strategy"]
  node_redis_lock["Redis lock strategy"]
end

subgraph group_domain["Booking Domain"]
  node_booking_model["Booking model<br/>[Booking.java]"]
  node_availability_model["Availability model<br/>[Availability.java]"]
  node_airbnb_model["Airbnb model<br/>[Airbnb.java]"]
  node_user_model["User model<br/>[User.java]"]
  node_read_models["Read models"]
end

subgraph group_persistence["Persistence"]
  node_write_repos["Write repositories"]
  node_redis_reads["Redis read repository"]
  node_redis_writes["Redis write repository"]
  node_redis_config["Redis configuration<br/>[RedisConfig.java]"]
end

subgraph group_events["Saga Events"]
  node_saga_publisher["Saga publisher"]
  node_saga_consumer["Saga consumer"]
  node_saga_processor["Saga processor"]
  node_saga_event["Saga event<br/>[SagaEvent.java]"]
  node_booking_handler["Booking event handler"]
  node_availability_handler["Availability event handler"]
end

node_user(("Booking client"))
node_redis_store[("Redis")]

node_user -.->|"submits request"| node_controller
node_controller -.->|"accepts"| node_create_dto
node_controller -.->|"accepts"| node_update_dto
node_controller -.->|"delegates"| node_booking_service
node_booking_service -.->|"checks retries"| node_idempotency
node_booking_service -.->|"coordinates access"| node_concurrency
node_redis_lock -.->|"locks"| node_redis_store
node_booking_service -.->|"persists state"| node_write_repos
node_booking_service -.->|"updates"| node_booking_model
node_booking_service -.->|"checks availability"| node_availability_model
node_booking_service -.->|"uses listing"| node_airbnb_model
node_booking_service -.->|"uses user"| node_user_model
node_booking_service -.->|"publishes events"| node_saga_publisher
node_saga_publisher -.->|"creates"| node_saga_event
node_saga_consumer -.->|"receives"| node_saga_event
node_saga_consumer -.->|"dispatches"| node_saga_processor
node_saga_processor -.->|"dispatches"| node_booking_handler
node_saga_processor -.->|"dispatches"| node_availability_handler
node_redis_config -.->|"configures"| node_redis_store
node_redis_reads -.->|"reads"| node_redis_store
node_redis_writes -.->|"writes"| node_redis_store
node_redis_reads -.->|"loads"| node_read_models

click node_app "https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/AirbnbBookingSpringApplication.java"
click node_controller "https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/controllers/BookingController.java"
click node_create_dto "https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/dtos/CreateBookingRequest.java"
click node_update_dto "https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/dtos/UpdateBookingRequest.java"
click node_booking_service "https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/services/BookingService.java"
click node_service_interface "https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/services/IBookingService.java"
click node_idempotency "https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/services/IdempotencyService.java"
click node_idempotency_api "https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/services/IIdempotencyService.java"
click node_concurrency "https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/services/concurrency/ConcurrencyControlStrategy.java"
click node_redis_lock "https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/services/concurrency/RedisLockStrategy.java"
click node_booking_model "https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/models/Booking.java"
click node_availability_model "https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/models/Availability.java"
click node_airbnb_model "https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/models/Airbnb.java"
click node_user_model "https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/models/User.java"
click node_read_models "https://github.com/singhsanket143/airbnbspring/tree/master/src/main/java/com/example/AirbnbBookingSpring/models/readModels"
click node_write_repos "https://github.com/singhsanket143/airbnbspring/tree/master/src/main/java/com/example/AirbnbBookingSpring/repositories/writes"
click node_redis_reads "https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/repositories/reads/RedisReadRepository.java"
click node_redis_writes "https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/repositories/reads/RedisWriteRepository.java"
click node_redis_config "https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/configurations/RedisConfig.java"
click node_saga_publisher "https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/saga/SagaEventPublisher.java"
click node_saga_consumer "https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/saga/SagaEventConsumer.java"
click node_saga_processor "https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/saga/SagaEventProcessor.java"
click node_saga_event "https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/saga/SagaEvent.java"
click node_booking_handler "https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/services/handlers/BookingEventHandler.java"
click node_availability_handler "https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/services/handlers/AvailabilityEventHandler.java"

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_app,node_controller,node_create_dto,node_update_dto,node_user toneBlue
class node_booking_service,node_service_interface,node_idempotency,node_idempotency_api,node_concurrency,node_redis_lock,node_redis_store toneAmber
class node_booking_model,node_availability_model,node_airbnb_model,node_user_model,node_read_models toneMint
class node_write_repos,node_redis_reads,node_redis_writes,node_redis_config toneRose
class node_saga_publisher,node_saga_consumer,node_saga_processor,node_saga_event,node_booking_handler,node_availability_handler toneIndigo
```

## Components

### Booking API

- [Spring application](https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/AirbnbBookingSpringApplication.java): `src/main/java/com/example/AirbnbBookingSpring/AirbnbBookingSpringApplication.java`
- [Booking controller](https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/controllers/BookingController.java): `src/main/java/com/example/AirbnbBookingSpring/controllers/BookingController.java`
- [Create request](https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/dtos/CreateBookingRequest.java): `src/main/java/com/example/AirbnbBookingSpring/dtos/CreateBookingRequest.java`
- [Update request](https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/dtos/UpdateBookingRequest.java): `src/main/java/com/example/AirbnbBookingSpring/dtos/UpdateBookingRequest.java`

### Booking Services

- [Booking service](https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/services/BookingService.java): `src/main/java/com/example/AirbnbBookingSpring/services/BookingService.java`
- [Booking service API](https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/services/IBookingService.java): `src/main/java/com/example/AirbnbBookingSpring/services/IBookingService.java`
- [Idempotency service](https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/services/IdempotencyService.java): `src/main/java/com/example/AirbnbBookingSpring/services/IdempotencyService.java`
- [Idempotency contract](https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/services/IIdempotencyService.java): `src/main/java/com/example/AirbnbBookingSpring/services/IIdempotencyService.java`
- [Concurrency strategy](https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/services/concurrency/ConcurrencyControlStrategy.java): `src/main/java/com/example/AirbnbBookingSpring/services/concurrency/ConcurrencyControlStrategy.java`
- [Redis lock strategy](https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/services/concurrency/RedisLockStrategy.java): `src/main/java/com/example/AirbnbBookingSpring/services/concurrency/RedisLockStrategy.java`

### Booking Domain

- [Booking model](https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/models/Booking.java): `src/main/java/com/example/AirbnbBookingSpring/models/Booking.java`
- [Availability model](https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/models/Availability.java): `src/main/java/com/example/AirbnbBookingSpring/models/Availability.java`
- [Airbnb model](https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/models/Airbnb.java): `src/main/java/com/example/AirbnbBookingSpring/models/Airbnb.java`
- [User model](https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/models/User.java): `src/main/java/com/example/AirbnbBookingSpring/models/User.java`
- [Read models](https://github.com/singhsanket143/airbnbspring/tree/master/src/main/java/com/example/AirbnbBookingSpring/models/readModels): `src/main/java/com/example/AirbnbBookingSpring/models/readModels`

### Persistence

- [Write repositories](https://github.com/singhsanket143/airbnbspring/tree/master/src/main/java/com/example/AirbnbBookingSpring/repositories/writes): `src/main/java/com/example/AirbnbBookingSpring/repositories/writes`
- [Redis read repository](https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/repositories/reads/RedisReadRepository.java): `src/main/java/com/example/AirbnbBookingSpring/repositories/reads/RedisReadRepository.java`
- [Redis write repository](https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/repositories/reads/RedisWriteRepository.java): `src/main/java/com/example/AirbnbBookingSpring/repositories/reads/RedisWriteRepository.java`
- [Redis configuration](https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/configurations/RedisConfig.java): `src/main/java/com/example/AirbnbBookingSpring/configurations/RedisConfig.java`

### Saga Events

- [Saga publisher](https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/saga/SagaEventPublisher.java): `src/main/java/com/example/AirbnbBookingSpring/saga/SagaEventPublisher.java`
- [Saga consumer](https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/saga/SagaEventConsumer.java): `src/main/java/com/example/AirbnbBookingSpring/saga/SagaEventConsumer.java`
- [Saga processor](https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/saga/SagaEventProcessor.java): `src/main/java/com/example/AirbnbBookingSpring/saga/SagaEventProcessor.java`
- [Saga event](https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/saga/SagaEvent.java): `src/main/java/com/example/AirbnbBookingSpring/saga/SagaEvent.java`
- [Booking event handler](https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/services/handlers/BookingEventHandler.java): `src/main/java/com/example/AirbnbBookingSpring/services/handlers/BookingEventHandler.java`
- [Availability event handler](https://github.com/singhsanket143/airbnbspring/blob/master/src/main/java/com/example/AirbnbBookingSpring/services/handlers/AvailabilityEventHandler.java): `src/main/java/com/example/AirbnbBookingSpring/services/handlers/AvailabilityEventHandler.java`

### Other components

- **Booking client**
- **Redis**

## Connections

- Booking client → Booking controller: submits request
- Booking controller → Create request: accepts
- Booking controller → Update request: accepts
- Booking controller → Booking service: delegates
- Booking service → Idempotency service: checks retries
- Booking service → Concurrency strategy: coordinates access
- Redis lock strategy → Redis: locks
- Booking service → Write repositories: persists state
- Booking service → Booking model: updates
- Booking service → Availability model: checks availability
- Booking service → Airbnb model: uses listing
- Booking service → User model: uses user
- Booking service → Saga publisher: publishes events
- Saga publisher → Saga event: creates
- Saga consumer → Saga event: receives
- Saga consumer → Saga processor: dispatches
- Saga processor → Booking event handler: dispatches
- Saga processor → Availability event handler: dispatches
- Redis configuration → Redis: configures
- Redis read repository → Redis: reads
- Redis write repository → Redis: writes
- Redis read repository → Read models: loads
