# gowtham1412-p/soa-project architecture

> Architecture diagram of the GitHub repository gowtham1412-p/soa-project, 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/gowtham1412-p/soa-project
- Repository: https://github.com/gowtham1412-p/soa-project

## Overview

This is a hotel-booking application: guests browse rooms, authenticate, book date ranges, and manage reservations; administrators have a protected dashboard. The frontend routes requests through its API client to gateway-backed services. User, room, and booking services separate identity, inventory, and reservation responsibilities; booking checks room details and overlapping dates before confirming a reservation. The excerpts establish frontend routing, authentication flow, service calls, and a documented room/booking availability interface. Other frontend API destinations and service deployment wiring were not inspected, so those links are left unasserted.

Main entry points: [`frontend/src/api/api.js`](https://github.com/gowtham1412-p/soa-project/blob/main/frontend/src/api/api.js) (API client), [`frontend/src/App.jsx`](https://github.com/gowtham1412-p/soa-project/blob/main/frontend/src/App.jsx) (Web routes), [`room-service/src/main/java/com/starlight/room/controller/RoomController.java`](https://github.com/gowtham1412-p/soa-project/blob/main/room-service/src/main/java/com/starlight/room/controller/RoomController.java) (Room endpoints), [`user-service/src/main/java/com/starlight/user/service/impl/UserServiceImpl.java`](https://github.com/gowtham1412-p/soa-project/blob/main/user-service/src/main/java/com/starlight/user/service/impl/UserServiceImpl.java) (Account and login)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web experience"]
  node_app["Web routes<br/>[App.jsx]"]
  node_auth["Session and auth<br/>[AuthContext.jsx]"]
  node_api["API client<br/>[api.js]"]
  node_room_browse["Room browsing<br/>[Rooms.jsx]"]
  node_room_detail["Room details<br/>[RoomDetails.jsx]"]
  node_booking_ui["Booking form<br/>[Booking.jsx]"]
  node_my_bookings["My bookings<br/>[MyBookings.jsx]"]
  node_admin_ui["Admin dashboard<br/>[AdminDashboard.jsx]"]
end

subgraph group_edge["Gateway and discovery"]
  node_gateway["API gateway"]
  node_discovery["Service discovery"]
end

subgraph group_identity["Identity service"]
  node_user_api["User endpoints"]
  node_user_logic["Account and login"]
  node_jwt["JWT issuance"]
  node_user_repo["User repository"]
end

subgraph group_inventory["Room inventory"]
  node_room_api["Room endpoints"]
  node_room_logic["Room inventory logic"]
  node_room_repo["Room repository"]
end

subgraph group_reservations["Booking management"]
  node_booking_api["Booking endpoints"]
  node_booking_logic["Booking validation"]
  node_room_client["Room service client<br/>[RoomClient.java]"]
  node_booking_repo["Booking repository"]
end

node_guest(("Guest or admin"))

node_guest -->|"uses"| node_app
node_app -->|"routes to"| node_room_browse
node_app -->|"routes to"| node_room_detail
node_app -->|"routes to"| node_booking_ui
node_app -->|"routes to"| node_my_bookings
node_app -->|"routes to"| node_admin_ui
node_auth -->|"calls"| node_api
node_guest -->|"authenticates"| node_auth
node_api -.->|"requests"| node_gateway
node_gateway -.->|"routes requests"| node_user_api
node_user_api -->|"delegates to"| node_user_logic
node_user_logic -->|"reads and writes"| node_user_repo
node_user_logic -->|"generates token"| node_jwt
node_room_browse -.->|"requests data"| node_api
node_room_detail -.->|"requests data"| node_api
node_booking_ui -.->|"submits booking"| node_api
node_my_bookings -.->|"requests bookings"| node_api
node_admin_ui -.->|"requests admin data"| node_api
node_api -.->|"requests inventory"| node_room_api
node_api -.->|"requests bookings"| node_booking_api
node_room_api -->|"delegates to"| node_room_logic
node_room_logic -->|"reads and writes"| node_room_repo
node_booking_api -->|"delegates to"| node_booking_logic
node_booking_logic -->|"fetches room"| node_room_client
node_room_client -.->|"fetches room details"| node_room_api
node_booking_logic -->|"checks and persists"| node_booking_repo
node_room_api -->|"queries booked IDs"| node_booking_api
node_discovery -.->|"service routing"| node_gateway

click node_app "https://github.com/gowtham1412-p/soa-project/blob/main/frontend/src/App.jsx"
click node_auth "https://github.com/gowtham1412-p/soa-project/blob/main/frontend/src/context/AuthContext.jsx"
click node_api "https://github.com/gowtham1412-p/soa-project/blob/main/frontend/src/api/api.js"
click node_room_browse "https://github.com/gowtham1412-p/soa-project/blob/main/frontend/src/pages/Rooms.jsx"
click node_room_detail "https://github.com/gowtham1412-p/soa-project/blob/main/frontend/src/pages/RoomDetails.jsx"
click node_booking_ui "https://github.com/gowtham1412-p/soa-project/blob/main/frontend/src/pages/Booking.jsx"
click node_my_bookings "https://github.com/gowtham1412-p/soa-project/blob/main/frontend/src/pages/MyBookings.jsx"
click node_admin_ui "https://github.com/gowtham1412-p/soa-project/blob/main/frontend/src/pages/AdminDashboard.jsx"
click node_gateway "https://github.com/gowtham1412-p/soa-project/blob/main/api-gateway/src/main/java/com/starlight/gateway/filter/JwtAuthenticationFilter.java"
click node_discovery "https://github.com/gowtham1412-p/soa-project/blob/main/eureka-server/src/main/java/com/starlight/eureka/EurekaServerApplication.java"
click node_user_api "https://github.com/gowtham1412-p/soa-project/blob/main/user-service/src/main/java/com/starlight/user/controller/UserController.java"
click node_user_logic "https://github.com/gowtham1412-p/soa-project/blob/main/user-service/src/main/java/com/starlight/user/service/impl/UserServiceImpl.java"
click node_jwt "https://github.com/gowtham1412-p/soa-project/blob/main/user-service/src/main/java/com/starlight/user/security/JwtTokenProvider.java"
click node_user_repo "https://github.com/gowtham1412-p/soa-project/blob/main/user-service/src/main/java/com/starlight/user/repository/UserRepository.java"
click node_room_api "https://github.com/gowtham1412-p/soa-project/blob/main/room-service/src/main/java/com/starlight/room/controller/RoomController.java"
click node_room_logic "https://github.com/gowtham1412-p/soa-project/blob/main/room-service/src/main/java/com/starlight/room/service/impl/RoomServiceImpl.java"
click node_room_repo "https://github.com/gowtham1412-p/soa-project/blob/main/room-service/src/main/java/com/starlight/room/repository/RoomRepository.java"
click node_booking_api "https://github.com/gowtham1412-p/soa-project/blob/main/booking-service/src/main/java/com/starlight/booking/controller/BookingController.java"
click node_booking_logic "https://github.com/gowtham1412-p/soa-project/blob/main/booking-service/src/main/java/com/starlight/booking/service/impl/BookingServiceImpl.java"
click node_room_client "https://github.com/gowtham1412-p/soa-project/blob/main/booking-service/src/main/java/com/starlight/booking/client/RoomClient.java"
click node_booking_repo "https://github.com/gowtham1412-p/soa-project/blob/main/booking-service/src/main/java/com/starlight/booking/repository/BookingRepository.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_auth,node_api,node_room_browse,node_room_detail,node_booking_ui,node_my_bookings,node_admin_ui toneBlue
class node_gateway,node_discovery toneAmber
class node_user_api,node_user_logic,node_jwt,node_user_repo toneMint
class node_room_api,node_room_logic,node_room_repo toneRose
class node_booking_api,node_booking_logic,node_room_client,node_booking_repo,node_guest toneIndigo
```

## Components

### Web experience

- [Web routes](https://github.com/gowtham1412-p/soa-project/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Session and auth](https://github.com/gowtham1412-p/soa-project/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [API client](https://github.com/gowtham1412-p/soa-project/blob/main/frontend/src/api/api.js): `frontend/src/api/api.js`
- [Room browsing](https://github.com/gowtham1412-p/soa-project/blob/main/frontend/src/pages/Rooms.jsx): `frontend/src/pages/Rooms.jsx`
- [Room details](https://github.com/gowtham1412-p/soa-project/blob/main/frontend/src/pages/RoomDetails.jsx): `frontend/src/pages/RoomDetails.jsx`
- [Booking form](https://github.com/gowtham1412-p/soa-project/blob/main/frontend/src/pages/Booking.jsx): `frontend/src/pages/Booking.jsx`
- [My bookings](https://github.com/gowtham1412-p/soa-project/blob/main/frontend/src/pages/MyBookings.jsx): `frontend/src/pages/MyBookings.jsx`
- [Admin dashboard](https://github.com/gowtham1412-p/soa-project/blob/main/frontend/src/pages/AdminDashboard.jsx): `frontend/src/pages/AdminDashboard.jsx`

### Gateway and discovery

- [API gateway](https://github.com/gowtham1412-p/soa-project/blob/main/api-gateway/src/main/java/com/starlight/gateway/filter/JwtAuthenticationFilter.java): `api-gateway/src/main/java/com/starlight/gateway/filter/JwtAuthenticationFilter.java`
- [Service discovery](https://github.com/gowtham1412-p/soa-project/blob/main/eureka-server/src/main/java/com/starlight/eureka/EurekaServerApplication.java): `eureka-server/src/main/java/com/starlight/eureka/EurekaServerApplication.java`

### Identity service

- [User endpoints](https://github.com/gowtham1412-p/soa-project/blob/main/user-service/src/main/java/com/starlight/user/controller/UserController.java): `user-service/src/main/java/com/starlight/user/controller/UserController.java`
- [Account and login](https://github.com/gowtham1412-p/soa-project/blob/main/user-service/src/main/java/com/starlight/user/service/impl/UserServiceImpl.java): `user-service/src/main/java/com/starlight/user/service/impl/UserServiceImpl.java`
- [JWT issuance](https://github.com/gowtham1412-p/soa-project/blob/main/user-service/src/main/java/com/starlight/user/security/JwtTokenProvider.java): `user-service/src/main/java/com/starlight/user/security/JwtTokenProvider.java`
- [User repository](https://github.com/gowtham1412-p/soa-project/blob/main/user-service/src/main/java/com/starlight/user/repository/UserRepository.java): `user-service/src/main/java/com/starlight/user/repository/UserRepository.java`

### Room inventory

- [Room endpoints](https://github.com/gowtham1412-p/soa-project/blob/main/room-service/src/main/java/com/starlight/room/controller/RoomController.java): `room-service/src/main/java/com/starlight/room/controller/RoomController.java`
- [Room inventory logic](https://github.com/gowtham1412-p/soa-project/blob/main/room-service/src/main/java/com/starlight/room/service/impl/RoomServiceImpl.java): `room-service/src/main/java/com/starlight/room/service/impl/RoomServiceImpl.java`
- [Room repository](https://github.com/gowtham1412-p/soa-project/blob/main/room-service/src/main/java/com/starlight/room/repository/RoomRepository.java): `room-service/src/main/java/com/starlight/room/repository/RoomRepository.java`

### Booking management

- [Booking endpoints](https://github.com/gowtham1412-p/soa-project/blob/main/booking-service/src/main/java/com/starlight/booking/controller/BookingController.java): `booking-service/src/main/java/com/starlight/booking/controller/BookingController.java`
- [Booking validation](https://github.com/gowtham1412-p/soa-project/blob/main/booking-service/src/main/java/com/starlight/booking/service/impl/BookingServiceImpl.java): `booking-service/src/main/java/com/starlight/booking/service/impl/BookingServiceImpl.java`
- [Room service client](https://github.com/gowtham1412-p/soa-project/blob/main/booking-service/src/main/java/com/starlight/booking/client/RoomClient.java): `booking-service/src/main/java/com/starlight/booking/client/RoomClient.java`
- [Booking repository](https://github.com/gowtham1412-p/soa-project/blob/main/booking-service/src/main/java/com/starlight/booking/repository/BookingRepository.java): `booking-service/src/main/java/com/starlight/booking/repository/BookingRepository.java`

### Other components

- **Guest or admin**

## Connections

- Guest or admin → Web routes: uses (evidence: `frontend/src/App.jsx`)
- Web routes → Room browsing: routes to (evidence: `frontend/src/App.jsx`)
- Web routes → Room details: routes to (evidence: `frontend/src/App.jsx`)
- Web routes → Booking form: routes to (evidence: `frontend/src/App.jsx`)
- Web routes → My bookings: routes to (evidence: `frontend/src/App.jsx`)
- Web routes → Admin dashboard: routes to (evidence: `frontend/src/App.jsx`)
- Session and auth → API client: calls (evidence: `frontend/src/context/AuthContext.jsx`)
- Guest or admin → Session and auth: authenticates (evidence: `frontend/src/context/AuthContext.jsx`)
- API client → API gateway: requests
- API gateway → User endpoints: routes requests
- User endpoints → Account and login: delegates to (evidence: `user-service/src/main/java/com/starlight/user/controller/UserController.java`)
- Account and login → User repository: reads and writes (evidence: `user-service/src/main/java/com/starlight/user/service/impl/UserServiceImpl.java`)
- Account and login → JWT issuance: generates token (evidence: `user-service/src/main/java/com/starlight/user/service/impl/UserServiceImpl.java`)
- Room browsing → API client: requests data
- Room details → API client: requests data
- Booking form → API client: submits booking (evidence: `frontend/src/pages/Booking.jsx`)
- My bookings → API client: requests bookings
- Admin dashboard → API client: requests admin data (evidence: `frontend/src/pages/AdminDashboard.jsx`)
- API client → Room endpoints: requests inventory
- API client → Booking endpoints: requests bookings
- Room endpoints → Room inventory logic: delegates to (evidence: `room-service/src/main/java/com/starlight/room/controller/RoomController.java`)
- Room inventory logic → Room repository: reads and writes (evidence: `room-service/src/main/java/com/starlight/room/service/impl/RoomServiceImpl.java`)
- Booking endpoints → Booking validation: delegates to (evidence: `booking-service/src/main/java/com/starlight/booking/controller/BookingController.java`)
- Booking validation → Room service client: fetches room (evidence: `booking-service/src/main/java/com/starlight/booking/service/impl/BookingServiceImpl.java`)
- Room service client → Room endpoints: fetches room details
- Booking validation → Booking repository: checks and persists (evidence: `booking-service/src/main/java/com/starlight/booking/service/impl/BookingServiceImpl.java`)
- Room endpoints → Booking endpoints: queries booked IDs (evidence: `booking-service/src/main/java/com/starlight/booking/controller/BookingController.java`)
- Service discovery → API gateway: service routing
