# aleee-lc/rms architecture

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

- Interactive diagram: https://gitdiagram.com/aleee-lc/rms
- Repository: https://github.com/aleee-lc/rms

## Overview

RevSight is a hotel revenue-management product: hotel teams ingest reservation, forecast, CRS, and competitive pricing data, then review metrics, pricing recommendations, alerts, and operational intelligence. The Angular app exposes workflows for upload, configuration, recommendations, rate-plan governance, calendar, alerts, and reports; the NestJS API provides those capabilities. The README documents the major feature areas, but most frontend-to-API calls and several backend implementations were not sampled, so those links are not asserted as verified.

Main entry points: [`src/prisma/prisma.service.ts`](https://github.com/aleee-lc/rms/blob/main/src/prisma/prisma.service.ts) (Prisma Persistence), [`src/ingestion/ingestion.service.ts`](https://github.com/aleee-lc/rms/blob/main/src/ingestion/ingestion.service.ts) (File Ingestion), [`frontend/src/app/app.component.ts`](https://github.com/aleee-lc/rms/blob/main/frontend/src/app/app.component.ts) (RevSight App), [`src/recommendation/recommendation.service.ts`](https://github.com/aleee-lc/rms/blob/main/src/recommendation/recommendation.service.ts) (Recommendation Engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Hotel Team App"]
  node_angular_app["RevSight App<br/>[app.component.ts]"]
  node_upload_ui["Data Upload"]
  node_recommendations_ui["Recommendations"]
  node_calendar_ui["Revenue Calendar"]
  node_reports_ui["Reports &amp; Exports"]
  node_auth_ui["Login"]
end

subgraph group_access["Identity &amp; Hotels"]
  node_auth["Authentication<br/>[auth.service.ts]"]
  node_hotel_admin["Hotel Configuration<br/>[hotels.service.ts]"]
  node_hotel_context["Hotel Access Context"]
end

subgraph group_data["Revenue Data"]
  node_ingestion["File Ingestion"]
  node_market_rates["Market &amp; Competitors<br/>[market.service.ts]"]
  node_metrics["Daily Metrics<br/>[metrics.service.ts]"]
  node_rate_shopping["Rate Shopping"]
  node_rate_plans["Rate Plan Governance"]
  node_persistence[("Prisma Persistence<br/>[prisma.service.ts]")]
  node_date_utils["Date Utilities<br/>[date.util.ts]"]
  node_number_utils["Number Utilities<br/>[number.util.ts]"]
end

subgraph group_decisions["Pricing Decisions"]
  node_recommendation_engine["Recommendation Engine"]
  node_recommendation_rules["Pricing Settings"]
  node_alerts["Actionable Alerts<br/>[alerts.service.ts]"]
end

subgraph group_intelligence["Reporting &amp; Intelligence"]
  node_reports["Operational Reports<br/>[reports.service.ts]"]
  node_bi["Revenue BI<br/>[bi.service.ts]"]
  node_executive["Executive Summary"]
end

node_hotel_team(("Hotel Team"))
node_postgres[("PostgreSQL")]

node_hotel_team -->|"uses"| node_angular_app
node_angular_app -->|"routes to"| node_upload_ui
node_angular_app -->|"routes to"| node_recommendations_ui
node_angular_app -->|"routes to"| node_calendar_ui
node_angular_app -->|"routes to"| node_reports_ui
node_angular_app -->|"routes to"| node_auth_ui
node_hotel_team -->|"authenticates via"| node_auth
node_ingestion -->|"updates"| node_market_rates
node_ingestion -->|"calculates"| node_metrics
node_ingestion -->|"generates"| node_recommendation_engine
node_ingestion -->|"updates"| node_alerts
node_recommendation_engine -->|"uses settings"| node_recommendation_rules
node_recommendation_engine -->|"triggers"| node_alerts
node_hotel_context -->|"reads hotel access"| node_persistence
node_auth -->|"reads and writes users"| node_persistence
node_hotel_admin -->|"persists hotels"| node_persistence
node_metrics -->|"reads and writes metrics"| node_persistence
node_market_rates -->|"persists rates"| node_persistence
node_rate_shopping -.->|"stores snapshots"| node_persistence
node_rate_plans -.->|"reads rate plans"| node_persistence
node_recommendation_engine -->|"persists recommendations"| node_persistence
node_alerts -->|"persists alerts"| node_persistence
node_reports -.->|"queries report data"| node_persistence
node_bi -.->|"queries BI data"| node_persistence
node_executive -.->|"queries summaries"| node_persistence
node_ingestion -->|"parses dates"| node_date_utils
node_ingestion -->|"normalizes numbers"| node_number_utils
node_persistence -->|"connects to"| node_postgres
node_hotel_team -->|"submits files"| node_upload_ui
node_hotel_team -->|"reviews pricing"| node_recommendations_ui
node_hotel_team -->|"reviews intelligence"| node_calendar_ui
node_hotel_team -->|"exports reports"| node_reports_ui

click node_angular_app "https://github.com/aleee-lc/rms/blob/main/frontend/src/app/app.component.ts"
click node_upload_ui "https://github.com/aleee-lc/rms/blob/main/frontend/src/app/features/upload/upload-page.component.ts"
click node_recommendations_ui "https://github.com/aleee-lc/rms/blob/main/frontend/src/app/features/recommendations/recommendations-page.component.ts"
click node_calendar_ui "https://github.com/aleee-lc/rms/blob/main/frontend/src/app/features/revenue-calendar/revenue-calendar-page.component.ts"
click node_reports_ui "https://github.com/aleee-lc/rms/blob/main/frontend/src/app/features/reports/reports-page.component.ts"
click node_auth_ui "https://github.com/aleee-lc/rms/blob/main/frontend/src/app/features/login/login-page.component.ts"
click node_auth "https://github.com/aleee-lc/rms/blob/main/src/auth/auth.service.ts"
click node_hotel_admin "https://github.com/aleee-lc/rms/blob/main/src/hotels/hotels.service.ts"
click node_hotel_context "https://github.com/aleee-lc/rms/blob/main/src/common/hotel-context.service.ts"
click node_ingestion "https://github.com/aleee-lc/rms/blob/main/src/ingestion/ingestion.service.ts"
click node_market_rates "https://github.com/aleee-lc/rms/blob/main/src/market/market.service.ts"
click node_metrics "https://github.com/aleee-lc/rms/blob/main/src/metrics/metrics.service.ts"
click node_rate_shopping "https://github.com/aleee-lc/rms/blob/main/src/rate-shopping/rate-shopping.service.ts"
click node_rate_plans "https://github.com/aleee-lc/rms/blob/main/src/rate-plans/rate-plans.service.ts"
click node_recommendation_engine "https://github.com/aleee-lc/rms/blob/main/src/recommendation/recommendation.service.ts"
click node_recommendation_rules "https://github.com/aleee-lc/rms/blob/main/src/recommendation/recommendation-settings.ts"
click node_alerts "https://github.com/aleee-lc/rms/blob/main/src/alerts/alerts.service.ts"
click node_reports "https://github.com/aleee-lc/rms/blob/main/src/reports/reports.service.ts"
click node_bi "https://github.com/aleee-lc/rms/blob/main/src/bi/bi.service.ts"
click node_executive "https://github.com/aleee-lc/rms/blob/main/src/executive/executive.service.ts"
click node_persistence "https://github.com/aleee-lc/rms/blob/main/src/prisma/prisma.service.ts"
click node_date_utils "https://github.com/aleee-lc/rms/blob/main/src/common/utils/date.util.ts"
click node_number_utils "https://github.com/aleee-lc/rms/blob/main/src/common/utils/number.util.ts"

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_angular_app,node_upload_ui,node_recommendations_ui,node_calendar_ui,node_reports_ui,node_auth_ui toneBlue
class node_auth,node_hotel_admin,node_hotel_context,node_postgres toneAmber
class node_ingestion,node_market_rates,node_metrics,node_rate_shopping,node_rate_plans,node_persistence,node_date_utils,node_number_utils toneMint
class node_recommendation_engine,node_recommendation_rules,node_alerts toneRose
class node_reports,node_bi,node_executive,node_hotel_team toneIndigo
```

## Components

### Hotel Team App

- [RevSight App](https://github.com/aleee-lc/rms/blob/main/frontend/src/app/app.component.ts): `frontend/src/app/app.component.ts`
- [Data Upload](https://github.com/aleee-lc/rms/blob/main/frontend/src/app/features/upload/upload-page.component.ts): `frontend/src/app/features/upload/upload-page.component.ts`
- [Recommendations](https://github.com/aleee-lc/rms/blob/main/frontend/src/app/features/recommendations/recommendations-page.component.ts): `frontend/src/app/features/recommendations/recommendations-page.component.ts`
- [Revenue Calendar](https://github.com/aleee-lc/rms/blob/main/frontend/src/app/features/revenue-calendar/revenue-calendar-page.component.ts): `frontend/src/app/features/revenue-calendar/revenue-calendar-page.component.ts`
- [Reports & Exports](https://github.com/aleee-lc/rms/blob/main/frontend/src/app/features/reports/reports-page.component.ts): `frontend/src/app/features/reports/reports-page.component.ts`
- [Login](https://github.com/aleee-lc/rms/blob/main/frontend/src/app/features/login/login-page.component.ts): `frontend/src/app/features/login/login-page.component.ts`

### Identity & Hotels

- [Authentication](https://github.com/aleee-lc/rms/blob/main/src/auth/auth.service.ts): `src/auth/auth.service.ts`
- [Hotel Configuration](https://github.com/aleee-lc/rms/blob/main/src/hotels/hotels.service.ts): `src/hotels/hotels.service.ts`
- [Hotel Access Context](https://github.com/aleee-lc/rms/blob/main/src/common/hotel-context.service.ts): `src/common/hotel-context.service.ts`

### Revenue Data

- [File Ingestion](https://github.com/aleee-lc/rms/blob/main/src/ingestion/ingestion.service.ts): `src/ingestion/ingestion.service.ts`
- [Market & Competitors](https://github.com/aleee-lc/rms/blob/main/src/market/market.service.ts): `src/market/market.service.ts`
- [Daily Metrics](https://github.com/aleee-lc/rms/blob/main/src/metrics/metrics.service.ts): `src/metrics/metrics.service.ts`
- [Rate Shopping](https://github.com/aleee-lc/rms/blob/main/src/rate-shopping/rate-shopping.service.ts): `src/rate-shopping/rate-shopping.service.ts`
- [Rate Plan Governance](https://github.com/aleee-lc/rms/blob/main/src/rate-plans/rate-plans.service.ts): `src/rate-plans/rate-plans.service.ts`
- [Prisma Persistence](https://github.com/aleee-lc/rms/blob/main/src/prisma/prisma.service.ts): `src/prisma/prisma.service.ts`
- [Date Utilities](https://github.com/aleee-lc/rms/blob/main/src/common/utils/date.util.ts): `src/common/utils/date.util.ts`
- [Number Utilities](https://github.com/aleee-lc/rms/blob/main/src/common/utils/number.util.ts): `src/common/utils/number.util.ts`

### Pricing Decisions

- [Recommendation Engine](https://github.com/aleee-lc/rms/blob/main/src/recommendation/recommendation.service.ts): `src/recommendation/recommendation.service.ts`
- [Pricing Settings](https://github.com/aleee-lc/rms/blob/main/src/recommendation/recommendation-settings.ts): `src/recommendation/recommendation-settings.ts`
- [Actionable Alerts](https://github.com/aleee-lc/rms/blob/main/src/alerts/alerts.service.ts): `src/alerts/alerts.service.ts`

### Reporting & Intelligence

- [Operational Reports](https://github.com/aleee-lc/rms/blob/main/src/reports/reports.service.ts): `src/reports/reports.service.ts`
- [Revenue BI](https://github.com/aleee-lc/rms/blob/main/src/bi/bi.service.ts): `src/bi/bi.service.ts`
- [Executive Summary](https://github.com/aleee-lc/rms/blob/main/src/executive/executive.service.ts): `src/executive/executive.service.ts`

### Other components

- **Hotel Team**
- **PostgreSQL**

## Connections

- Hotel Team → RevSight App: uses (evidence: `README.md`)
- RevSight App → Data Upload: routes to
- RevSight App → Recommendations: routes to
- RevSight App → Revenue Calendar: routes to
- RevSight App → Reports & Exports: routes to
- RevSight App → Login: routes to
- Hotel Team → Authentication: authenticates via (evidence: `README.md`)
- File Ingestion → Market & Competitors: updates (evidence: `src/ingestion/ingestion.service.ts`)
- File Ingestion → Daily Metrics: calculates (evidence: `src/ingestion/ingestion.service.ts`)
- File Ingestion → Recommendation Engine: generates (evidence: `src/ingestion/ingestion.service.ts`)
- File Ingestion → Actionable Alerts: updates (evidence: `src/ingestion/ingestion.service.ts`)
- Recommendation Engine → Pricing Settings: uses settings (evidence: `src/recommendation/recommendation.service.ts`)
- Recommendation Engine → Actionable Alerts: triggers (evidence: `src/recommendation/recommendation.service.ts`)
- Hotel Access Context → Prisma Persistence: reads hotel access (evidence: `src/common/hotel-context.service.ts`)
- Authentication → Prisma Persistence: reads and writes users (evidence: `src/auth/auth.service.ts`)
- Hotel Configuration → Prisma Persistence: persists hotels (evidence: `src/hotels/hotels.service.ts`)
- Daily Metrics → Prisma Persistence: reads and writes metrics (evidence: `src/metrics/metrics.service.ts`)
- Market & Competitors → Prisma Persistence: persists rates (evidence: `src/market/market.service.ts`)
- Rate Shopping → Prisma Persistence: stores snapshots
- Rate Plan Governance → Prisma Persistence: reads rate plans
- Recommendation Engine → Prisma Persistence: persists recommendations (evidence: `src/recommendation/recommendation.service.ts`)
- Actionable Alerts → Prisma Persistence: persists alerts (evidence: `src/alerts/alerts.service.ts`)
- Operational Reports → Prisma Persistence: queries report data
- Revenue BI → Prisma Persistence: queries BI data
- Executive Summary → Prisma Persistence: queries summaries
- File Ingestion → Date Utilities: parses dates (evidence: `src/ingestion/ingestion.service.ts`)
- File Ingestion → Number Utilities: normalizes numbers (evidence: `src/ingestion/ingestion.service.ts`)
- Prisma Persistence → PostgreSQL: connects to (evidence: `README.md`)
- Hotel Team → Data Upload: submits files (evidence: `README.md`)
- Hotel Team → Recommendations: reviews pricing (evidence: `README.md`)
- Hotel Team → Revenue Calendar: reviews intelligence (evidence: `README.md`)
- Hotel Team → Reports & Exports: exports reports (evidence: `README.md`)
