# mohanaprasathr/hotel-revenue-analytics architecture

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

- Interactive diagram: https://gitdiagram.com/mohanaprasathr/hotel-revenue-analytics
- Repository: https://github.com/mohanaprasathr/hotel-revenue-analytics

## Overview

StayPulse is a hotel revenue intelligence platform: users manage reservations and explore operational and financial analytics in an Angular dashboard, backed by a Spring REST API and relational booking store. Its AI Insights capability adds forecasting, anomaly detection, cancellation risk, pricing recommendations, and a data assistant via a Python service. The graph shows documented product stages and sampled booking calls; some unsampled analytics and AI wiring is shown only where documented or marked unverified.

Main entry points: [`frontend/src/app/app.component.ts`](https://github.com/mohanaprasathr/hotel-revenue-analytics/blob/main/frontend/src/app/app.component.ts) (Dashboard Shell), [`ai-service/app/main.py`](https://github.com/mohanaprasathr/hotel-revenue-analytics/blob/main/ai-service/app/main.py) (AI Service API), [`hotel-revenue-analytics-api/src/main/java/com/mohana/hotelanalytics/repository/BookingRepository.java`](https://github.com/mohanaprasathr/hotel-revenue-analytics/blob/main/hotel-revenue-analytics-api/src/main/java/com/mohana/hotelanalytics/repository/BookingRepository.java) (Booking Repository), [`frontend/src/app/pages/bookings/bookings.component.ts`](https://github.com/mohanaprasathr/hotel-revenue-analytics/blob/main/frontend/src/app/pages/bookings/bookings.component.ts) (Booking Pages)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Angular Dashboard"]
  node_webapp["Dashboard Shell<br/>[app.component.ts]"]
  node_bookingui["Booking Pages"]
  node_analyticsui["Analytics Pages"]
  node_aiui["AI Insights Page"]
  node_bookingclient["Booking Client<br/>[booking.service.ts]"]
  node_analyticsclient["Analytics Client"]
  node_aiclient["AI Client<br/>[ai.service.ts]"]
end

subgraph group_api["Spring API"]
  node_bookingapi["Booking API"]
  node_analyticsapi["Analytics API"]
  node_bookinglogic["Booking Logic"]
  node_analyticslogic["Analytics Logic"]
end

subgraph group_ai["AI Insights"]
  node_aiapi["AI Service API<br/>[main.py]"]
  node_forecast["Forecasting Models<br/>[models.py]"]
  node_aiassistant["Data Assistant<br/>[assistant.py]"]
  node_aidata["AI Booking Data<br/>[data.py]"]
  node_demodata["Demo Data<br/>[demo_data.py]"]
end

subgraph group_data["Booking Data"]
  node_bookingstore["Booking Repository"]
  node_bookings[("Relational Booking Store<br/>[Booking.java]")]
end

node_manager(("Revenue Manager"))

node_manager -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_bookingui
node_webapp -->|"routes to"| node_analyticsui
node_webapp -->|"routes to"| node_aiui
node_bookingui -->|"calls"| node_bookingclient
node_bookingclient -->|"HTTP requests"| node_bookingapi
node_analyticsui -.->|"requests analytics"| node_analyticsclient
node_analyticsclient -->|"HTTP requests"| node_analyticsapi
node_aiui -.->|"requests insights"| node_aiclient
node_aiclient -.->|"HTTP requests"| node_aiapi
node_bookingapi -->|"delegates to"| node_bookinglogic
node_bookinglogic -->|"reads and writes"| node_bookingstore
node_bookingstore -->|"queries"| node_bookings
node_analyticsapi -->|"delegates to"| node_analyticslogic
node_analyticslogic -.->|"aggregates bookings"| node_bookingstore
node_bookings -.->|"informs decisions"| node_manager
node_aiapi -.->|"uses models"| node_forecast
node_aiapi -.->|"dispatches questions"| node_aiassistant
node_aiapi -.->|"loads booking data"| node_aidata
node_aidata -->|"loads demo records"| node_demodata

click node_webapp "https://github.com/mohanaprasathr/hotel-revenue-analytics/blob/main/frontend/src/app/app.component.ts"
click node_bookingui "https://github.com/mohanaprasathr/hotel-revenue-analytics/blob/main/frontend/src/app/pages/bookings/bookings.component.ts"
click node_analyticsui "https://github.com/mohanaprasathr/hotel-revenue-analytics/blob/main/frontend/src/app/pages/analytics/analytics.component.ts"
click node_aiui "https://github.com/mohanaprasathr/hotel-revenue-analytics/blob/main/frontend/src/app/pages/ai-insights/ai-insights.component.ts"
click node_bookingclient "https://github.com/mohanaprasathr/hotel-revenue-analytics/blob/main/frontend/src/app/core/services/booking.service.ts"
click node_analyticsclient "https://github.com/mohanaprasathr/hotel-revenue-analytics/blob/main/frontend/src/app/core/services/analytics.service.ts"
click node_aiclient "https://github.com/mohanaprasathr/hotel-revenue-analytics/blob/main/frontend/src/app/core/services/ai.service.ts"
click node_bookingapi "https://github.com/mohanaprasathr/hotel-revenue-analytics/blob/main/hotel-revenue-analytics-api/src/main/java/com/mohana/hotelanalytics/controller/BookingController.java"
click node_analyticsapi "https://github.com/mohanaprasathr/hotel-revenue-analytics/blob/main/hotel-revenue-analytics-api/src/main/java/com/mohana/hotelanalytics/controller/AnalyticsController.java"
click node_bookinglogic "https://github.com/mohanaprasathr/hotel-revenue-analytics/blob/main/hotel-revenue-analytics-api/src/main/java/com/mohana/hotelanalytics/service/impl/BookingServiceImpl.java"
click node_analyticslogic "https://github.com/mohanaprasathr/hotel-revenue-analytics/blob/main/hotel-revenue-analytics-api/src/main/java/com/mohana/hotelanalytics/service/impl/AnalyticsServiceImpl.java"
click node_bookingstore "https://github.com/mohanaprasathr/hotel-revenue-analytics/blob/main/hotel-revenue-analytics-api/src/main/java/com/mohana/hotelanalytics/repository/BookingRepository.java"
click node_bookings "https://github.com/mohanaprasathr/hotel-revenue-analytics/blob/main/hotel-revenue-analytics-api/src/main/java/com/mohana/hotelanalytics/entity/Booking.java"
click node_aiapi "https://github.com/mohanaprasathr/hotel-revenue-analytics/blob/main/ai-service/app/main.py"
click node_forecast "https://github.com/mohanaprasathr/hotel-revenue-analytics/blob/main/ai-service/app/models.py"
click node_aiassistant "https://github.com/mohanaprasathr/hotel-revenue-analytics/blob/main/ai-service/app/assistant.py"
click node_aidata "https://github.com/mohanaprasathr/hotel-revenue-analytics/blob/main/ai-service/app/data.py"
click node_demodata "https://github.com/mohanaprasathr/hotel-revenue-analytics/blob/main/ai-service/app/demo_data.py"

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_webapp,node_bookingui,node_analyticsui,node_aiui,node_bookingclient,node_analyticsclient,node_aiclient toneBlue
class node_bookingapi,node_analyticsapi,node_bookinglogic,node_analyticslogic toneAmber
class node_aiapi,node_forecast,node_aiassistant,node_aidata,node_demodata toneMint
class node_bookingstore,node_bookings toneRose
class node_manager toneIndigo
```

## Components

### Angular Dashboard

- [Dashboard Shell](https://github.com/mohanaprasathr/hotel-revenue-analytics/blob/main/frontend/src/app/app.component.ts): `frontend/src/app/app.component.ts`
- [Booking Pages](https://github.com/mohanaprasathr/hotel-revenue-analytics/blob/main/frontend/src/app/pages/bookings/bookings.component.ts): `frontend/src/app/pages/bookings/bookings.component.ts`
- [Analytics Pages](https://github.com/mohanaprasathr/hotel-revenue-analytics/blob/main/frontend/src/app/pages/analytics/analytics.component.ts): `frontend/src/app/pages/analytics/analytics.component.ts`
- [AI Insights Page](https://github.com/mohanaprasathr/hotel-revenue-analytics/blob/main/frontend/src/app/pages/ai-insights/ai-insights.component.ts): `frontend/src/app/pages/ai-insights/ai-insights.component.ts`
- [Booking Client](https://github.com/mohanaprasathr/hotel-revenue-analytics/blob/main/frontend/src/app/core/services/booking.service.ts): `frontend/src/app/core/services/booking.service.ts`
- [Analytics Client](https://github.com/mohanaprasathr/hotel-revenue-analytics/blob/main/frontend/src/app/core/services/analytics.service.ts): `frontend/src/app/core/services/analytics.service.ts`
- [AI Client](https://github.com/mohanaprasathr/hotel-revenue-analytics/blob/main/frontend/src/app/core/services/ai.service.ts): `frontend/src/app/core/services/ai.service.ts`

### Spring API

- [Booking API](https://github.com/mohanaprasathr/hotel-revenue-analytics/blob/main/hotel-revenue-analytics-api/src/main/java/com/mohana/hotelanalytics/controller/BookingController.java): `hotel-revenue-analytics-api/src/main/java/com/mohana/hotelanalytics/controller/BookingController.java`
- [Analytics API](https://github.com/mohanaprasathr/hotel-revenue-analytics/blob/main/hotel-revenue-analytics-api/src/main/java/com/mohana/hotelanalytics/controller/AnalyticsController.java): `hotel-revenue-analytics-api/src/main/java/com/mohana/hotelanalytics/controller/AnalyticsController.java`
- [Booking Logic](https://github.com/mohanaprasathr/hotel-revenue-analytics/blob/main/hotel-revenue-analytics-api/src/main/java/com/mohana/hotelanalytics/service/impl/BookingServiceImpl.java): `hotel-revenue-analytics-api/src/main/java/com/mohana/hotelanalytics/service/impl/BookingServiceImpl.java`
- [Analytics Logic](https://github.com/mohanaprasathr/hotel-revenue-analytics/blob/main/hotel-revenue-analytics-api/src/main/java/com/mohana/hotelanalytics/service/impl/AnalyticsServiceImpl.java): `hotel-revenue-analytics-api/src/main/java/com/mohana/hotelanalytics/service/impl/AnalyticsServiceImpl.java`

### AI Insights

- [AI Service API](https://github.com/mohanaprasathr/hotel-revenue-analytics/blob/main/ai-service/app/main.py): `ai-service/app/main.py`
- [Forecasting Models](https://github.com/mohanaprasathr/hotel-revenue-analytics/blob/main/ai-service/app/models.py): `ai-service/app/models.py`
- [Data Assistant](https://github.com/mohanaprasathr/hotel-revenue-analytics/blob/main/ai-service/app/assistant.py): `ai-service/app/assistant.py`
- [AI Booking Data](https://github.com/mohanaprasathr/hotel-revenue-analytics/blob/main/ai-service/app/data.py): `ai-service/app/data.py`
- [Demo Data](https://github.com/mohanaprasathr/hotel-revenue-analytics/blob/main/ai-service/app/demo_data.py): `ai-service/app/demo_data.py`

### Booking Data

- [Booking Repository](https://github.com/mohanaprasathr/hotel-revenue-analytics/blob/main/hotel-revenue-analytics-api/src/main/java/com/mohana/hotelanalytics/repository/BookingRepository.java): `hotel-revenue-analytics-api/src/main/java/com/mohana/hotelanalytics/repository/BookingRepository.java`
- [Relational Booking Store](https://github.com/mohanaprasathr/hotel-revenue-analytics/blob/main/hotel-revenue-analytics-api/src/main/java/com/mohana/hotelanalytics/entity/Booking.java): `hotel-revenue-analytics-api/src/main/java/com/mohana/hotelanalytics/entity/Booking.java`

### Other components

- **Revenue Manager**

## Connections

- Revenue Manager → Dashboard Shell: uses (evidence: `README.md`)
- Dashboard Shell → Booking Pages: routes to
- Dashboard Shell → Analytics Pages: routes to
- Dashboard Shell → AI Insights Page: routes to
- Booking Pages → Booking Client: calls (evidence: `frontend/src/app/pages/bookings/bookings.component.ts`)
- Booking Client → Booking API: HTTP requests (evidence: `README.md`)
- Analytics Pages → Analytics Client: requests analytics
- Analytics Client → Analytics API: HTTP requests (evidence: `README.md`)
- AI Insights Page → AI Client: requests insights
- AI Client → AI Service API: HTTP requests
- Booking API → Booking Logic: delegates to (evidence: `hotel-revenue-analytics-api/src/main/java/com/mohana/hotelanalytics/controller/BookingController.java`)
- Booking Logic → Booking Repository: reads and writes (evidence: `hotel-revenue-analytics-api/src/main/java/com/mohana/hotelanalytics/service/impl/BookingServiceImpl.java`)
- Booking Repository → Relational Booking Store: queries (evidence: `hotel-revenue-analytics-api/src/main/java/com/mohana/hotelanalytics/repository/BookingRepository.java`)
- Analytics API → Analytics Logic: delegates to (evidence: `README.md`)
- Analytics Logic → Booking Repository: aggregates bookings
- Relational Booking Store → Revenue Manager: informs decisions
- AI Service API → Forecasting Models: uses models (evidence: `ai-service/app/main.py`)
- AI Service API → Data Assistant: dispatches questions (evidence: `ai-service/app/main.py`)
- AI Service API → AI Booking Data: loads booking data (evidence: `ai-service/app/main.py`)
- AI Booking Data → Demo Data: loads demo records (evidence: `ai-service/app/data.py`)
