# soulaimenx1/luxuarycars architecture

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

- Interactive diagram: https://gitdiagram.com/soulaimenx1/luxuarycars
- Repository: https://github.com/soulaimenx1/luxuarycars

## Overview

LUXUAR is a luxury-car rental platform: customers browse vehicles, check availability, request reservations, and proceed through payment and rental; staff administer approvals, fleet operations, and returns. The NestJS API and Next.js application are the documented backend and frontend, with PostgreSQL, Stripe, and SMTP as platform dependencies. The graph preserves documented capabilities and sampled controller/service relationships. Several feature modules are listed in the tree but were not sampled, so their internal links are left dashed and unverified rather than inferred.

Main entry points: [`frontend/src/app`](https://github.com/soulaimenx1/luxuarycars/tree/main/frontend/src/app) (Rental web app), [`backend/src/dashboard/dashboard-intelligence.service.ts`](https://github.com/soulaimenx1/luxuarycars/blob/main/backend/src/dashboard/dashboard-intelligence.service.ts) (Operations dashboard), [`backend/src/finance/finance.service.ts`](https://github.com/soulaimenx1/luxuarycars/blob/main/backend/src/finance/finance.service.ts) (Payments and deposits), [`backend/src/auth/auth.service.ts`](https://github.com/soulaimenx1/luxuarycars/blob/main/backend/src/auth/auth.service.ts) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_journey["Customer rental journey"]
  node_web["Rental web app"]
  node_vehicles["Vehicle catalog"]
  node_availability["Availability checks"]
  node_reservations["Reservations"]
  node_finance["Payments and deposits<br/>[finance.service.ts]"]
end

subgraph group_fleet["Fleet operations"]
  node_rentals["Rental management<br/>[rentals.service.ts]"]
  node_returns["Rental returns<br/>[returns.service.ts]"]
  node_movements["Vehicle movements"]
  node_locations["Locations"]
  node_zones["Zones and pricing rules<br/>[zones.service.ts]"]
end

subgraph group_identity["Identity and messaging"]
  node_auth["Authentication<br/>[auth.service.ts]"]
  node_users[("User accounts<br/>[user.entity.ts]")]
  node_inbox["Notification inbox<br/>[inbox.service.ts]"]
  node_email["Email outbox"]
end

subgraph group_admin["Administration and intelligence"]
  node_approval["Reservation approvals"]
  node_dashboard["Operations dashboard"]
  node_maintenance["Fleet maintenance insights"]
  node_risk["Operations risk monitor"]
  node_demand["Pricing demand insights"]
end

node_customer(("Customer"))
node_stripe["Stripe"]
node_smtp["SMTP email"]
node_admin(("Admin staff"))
node_postgres[("PostgreSQL")]

node_customer -.->|"uses"| node_web
node_web -.->|"browses"| node_vehicles
node_web -.->|"checks dates"| node_availability
node_web -.->|"requests booking"| node_reservations
node_web -.->|"pays"| node_finance
node_finance -.->|"charges via"| node_stripe
node_web -.->|"views rentals"| node_rentals
node_web -.->|"authenticates"| node_auth
node_auth -->|"looks up"| node_users
node_admin -.->|"uses"| node_web
node_web -.->|"administers bookings"| node_approval
node_approval -->|"notifies"| node_inbox
node_auth -->|"creates notices"| node_inbox
node_inbox -->|"queues email"| node_email
node_email -.->|"sends mail"| node_smtp
node_web -.->|"records return"| node_returns
node_web -.->|"manages movement"| node_movements
node_web -.->|"manages locations"| node_locations
node_web -.->|"manages zones"| node_zones
node_web -.->|"views intelligence"| node_dashboard
node_dashboard -->|"requests insights"| node_maintenance
node_dashboard -->|"requests insights"| node_demand
node_dashboard -->|"requests overview"| node_risk
node_reservations -.->|"persists data"| node_postgres
node_vehicles -.->|"persists fleet"| node_postgres
node_finance -.->|"records payments"| node_postgres

click node_web "https://github.com/soulaimenx1/luxuarycars/tree/main/frontend/src/app"
click node_vehicles "https://github.com/soulaimenx1/luxuarycars/blob/main/backend/src/vehicles/vehicles.service.ts"
click node_availability "https://github.com/soulaimenx1/luxuarycars/blob/main/backend/src/availability/availability.service.ts"
click node_reservations "https://github.com/soulaimenx1/luxuarycars/blob/main/backend/src/reservations/reservations.service.ts"
click node_finance "https://github.com/soulaimenx1/luxuarycars/blob/main/backend/src/finance/finance.service.ts"
click node_rentals "https://github.com/soulaimenx1/luxuarycars/blob/main/backend/src/rentals/rentals.service.ts"
click node_returns "https://github.com/soulaimenx1/luxuarycars/blob/main/backend/src/returns/returns.service.ts"
click node_movements "https://github.com/soulaimenx1/luxuarycars/blob/main/backend/src/vehicle-movements/vehicle-movements.service.ts"
click node_locations "https://github.com/soulaimenx1/luxuarycars/blob/main/backend/src/locations/locations.service.ts"
click node_zones "https://github.com/soulaimenx1/luxuarycars/blob/main/backend/src/zones/zones.service.ts"
click node_auth "https://github.com/soulaimenx1/luxuarycars/blob/main/backend/src/auth/auth.service.ts"
click node_users "https://github.com/soulaimenx1/luxuarycars/blob/main/backend/src/users/entities/user.entity.ts"
click node_inbox "https://github.com/soulaimenx1/luxuarycars/blob/main/backend/src/notifications/inbox.service.ts"
click node_email "https://github.com/soulaimenx1/luxuarycars/blob/main/backend/src/notifications/email-outbox.service.ts"
click node_approval "https://github.com/soulaimenx1/luxuarycars/blob/main/backend/src/reservations/reservations-admin.service.ts"
click node_dashboard "https://github.com/soulaimenx1/luxuarycars/blob/main/backend/src/dashboard/dashboard-intelligence.service.ts"
click node_maintenance "https://github.com/soulaimenx1/luxuarycars/blob/main/backend/src/dashboard/fleet-maintenance-intelligence.service.ts"
click node_risk "https://github.com/soulaimenx1/luxuarycars/blob/main/backend/src/dashboard/operations-risk-monitor.service.ts"
click node_demand "https://github.com/soulaimenx1/luxuarycars/blob/main/backend/src/dashboard/pricing-demand-intelligence.service.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_web,node_vehicles,node_availability,node_reservations,node_finance toneBlue
class node_rentals,node_returns,node_movements,node_locations,node_zones,node_postgres toneAmber
class node_auth,node_users,node_inbox,node_email toneMint
class node_approval,node_dashboard,node_maintenance,node_risk,node_demand toneRose
class node_customer,node_stripe,node_smtp,node_admin toneIndigo
```

## Components

### Customer rental journey

- [Rental web app](https://github.com/soulaimenx1/luxuarycars/tree/main/frontend/src/app): `frontend/src/app`
- [Vehicle catalog](https://github.com/soulaimenx1/luxuarycars/blob/main/backend/src/vehicles/vehicles.service.ts): `backend/src/vehicles/vehicles.service.ts`
- [Availability checks](https://github.com/soulaimenx1/luxuarycars/blob/main/backend/src/availability/availability.service.ts): `backend/src/availability/availability.service.ts`
- [Reservations](https://github.com/soulaimenx1/luxuarycars/blob/main/backend/src/reservations/reservations.service.ts): `backend/src/reservations/reservations.service.ts`
- [Payments and deposits](https://github.com/soulaimenx1/luxuarycars/blob/main/backend/src/finance/finance.service.ts): `backend/src/finance/finance.service.ts`

### Fleet operations

- [Rental management](https://github.com/soulaimenx1/luxuarycars/blob/main/backend/src/rentals/rentals.service.ts): `backend/src/rentals/rentals.service.ts`
- [Rental returns](https://github.com/soulaimenx1/luxuarycars/blob/main/backend/src/returns/returns.service.ts): `backend/src/returns/returns.service.ts`
- [Vehicle movements](https://github.com/soulaimenx1/luxuarycars/blob/main/backend/src/vehicle-movements/vehicle-movements.service.ts): `backend/src/vehicle-movements/vehicle-movements.service.ts`
- [Locations](https://github.com/soulaimenx1/luxuarycars/blob/main/backend/src/locations/locations.service.ts): `backend/src/locations/locations.service.ts`
- [Zones and pricing rules](https://github.com/soulaimenx1/luxuarycars/blob/main/backend/src/zones/zones.service.ts): `backend/src/zones/zones.service.ts`

### Identity and messaging

- [Authentication](https://github.com/soulaimenx1/luxuarycars/blob/main/backend/src/auth/auth.service.ts): `backend/src/auth/auth.service.ts`
- [User accounts](https://github.com/soulaimenx1/luxuarycars/blob/main/backend/src/users/entities/user.entity.ts): `backend/src/users/entities/user.entity.ts`
- [Notification inbox](https://github.com/soulaimenx1/luxuarycars/blob/main/backend/src/notifications/inbox.service.ts): `backend/src/notifications/inbox.service.ts`
- [Email outbox](https://github.com/soulaimenx1/luxuarycars/blob/main/backend/src/notifications/email-outbox.service.ts): `backend/src/notifications/email-outbox.service.ts`

### Administration and intelligence

- [Reservation approvals](https://github.com/soulaimenx1/luxuarycars/blob/main/backend/src/reservations/reservations-admin.service.ts): `backend/src/reservations/reservations-admin.service.ts`
- [Operations dashboard](https://github.com/soulaimenx1/luxuarycars/blob/main/backend/src/dashboard/dashboard-intelligence.service.ts): `backend/src/dashboard/dashboard-intelligence.service.ts`
- [Fleet maintenance insights](https://github.com/soulaimenx1/luxuarycars/blob/main/backend/src/dashboard/fleet-maintenance-intelligence.service.ts): `backend/src/dashboard/fleet-maintenance-intelligence.service.ts`
- [Operations risk monitor](https://github.com/soulaimenx1/luxuarycars/blob/main/backend/src/dashboard/operations-risk-monitor.service.ts): `backend/src/dashboard/operations-risk-monitor.service.ts`
- [Pricing demand insights](https://github.com/soulaimenx1/luxuarycars/blob/main/backend/src/dashboard/pricing-demand-intelligence.service.ts): `backend/src/dashboard/pricing-demand-intelligence.service.ts`

### Other components

- **Customer**
- **Stripe**
- **SMTP email**
- **Admin staff**
- **PostgreSQL**

## Connections

- Customer → Rental web app: uses
- Rental web app → Vehicle catalog: browses
- Rental web app → Availability checks: checks dates
- Rental web app → Reservations: requests booking
- Rental web app → Payments and deposits: pays
- Payments and deposits → Stripe: charges via
- Rental web app → Rental management: views rentals
- Rental web app → Authentication: authenticates
- Authentication → User accounts: looks up (evidence: `backend/src/auth/auth.service.ts`)
- Admin staff → Rental web app: uses
- Rental web app → Reservation approvals: administers bookings
- Reservation approvals → Notification inbox: notifies (evidence: `backend/src/reservations/reservations-admin.controller.ts`)
- Authentication → Notification inbox: creates notices (evidence: `backend/src/auth/auth.service.ts`)
- Notification inbox → Email outbox: queues email (evidence: `backend/src/notifications/inbox.service.ts`)
- Email outbox → SMTP email: sends mail
- Rental web app → Rental returns: records return
- Rental web app → Vehicle movements: manages movement
- Rental web app → Locations: manages locations
- Rental web app → Zones and pricing rules: manages zones
- Rental web app → Operations dashboard: views intelligence
- Operations dashboard → Fleet maintenance insights: requests insights (evidence: `backend/src/dashboard/dashboard.controller.ts`)
- Operations dashboard → Pricing demand insights: requests insights (evidence: `backend/src/dashboard/dashboard.controller.ts`)
- Operations dashboard → Operations risk monitor: requests overview (evidence: `backend/src/dashboard/dashboard.controller.ts`)
- Reservations → PostgreSQL: persists data
- Vehicle catalog → PostgreSQL: persists fleet
- Payments and deposits → PostgreSQL: records payments
