# dhwrwm/rental-platform architecture

> Architecture diagram of the GitHub repository dhwrwm/rental-platform, 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/dhwrwm/rental-platform
- Repository: https://github.com/dhwrwm/rental-platform

## Overview

Rental Platform is a web app and NestJS API for managing rental listings and bookings. The primary workflow is an operator using the dashboard to create or edit listings, with API services handling listing details, photos, rates, and availability; renters can request booking quotes and bookings. Authentication and agent/user administration are supporting capabilities. The graph follows relationships shown in the supplied excerpts, SOURCE INDEX, or README; several frontend-to-API details and unsampled domain implementations are documented only at a high level, so their links are omitted rather than inferred.

Main entry points: [`apps/api/src/common/prisma/prisma.service.ts`](https://github.com/dhwrwm/rental-platform/blob/main/apps/api/src/common/prisma/prisma.service.ts) (Prisma access), [`apps/api/src/listings/listings.service.ts`](https://github.com/dhwrwm/rental-platform/blob/main/apps/api/src/listings/listings.service.ts) (Listing management), [`apps/api/src/bookings/bookings.service.ts`](https://github.com/dhwrwm/rental-platform/blob/main/apps/api/src/bookings/bookings.service.ts) (Booking lifecycle), [`apps/api/src/auth/auth.service.ts`](https://github.com/dhwrwm/rental-platform/blob/main/apps/api/src/auth/auth.service.ts) (Token and session logic)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web dashboard"]
  node_web_listings["Listing screens"]
  node_web_listing_api["Listing client<br/>[listings-api.ts]"]
  node_web_auth["Auth forms<br/>[auth-form.tsx]"]
end

subgraph group_identity["Identity and users"]
  node_auth_routes["Auth routes<br/>[auth.controller.ts]"]
  node_auth_logic["Token and session logic<br/>[auth.service.ts]"]
  node_user_service["User management<br/>[users.service.ts]"]
  node_agent_management["Agent management<br/>[agents.service.ts]"]
end

subgraph group_catalog["Listing management"]
  node_listing_routes["Listing routes"]
  node_listing_logic["Listing management"]
  node_availability_routes["Availability routes"]
  node_availability_logic["Availability management"]
  node_rate_routes["Rate routes"]
  node_rate_logic["Rate management"]
end

subgraph group_booking["Booking and pricing"]
  node_booking_routes["Booking routes"]
  node_booking_logic["Booking lifecycle"]
  node_pricing["Quote pricing<br/>[pricing.service.ts]"]
end

subgraph group_platform["Persistence and media"]
  node_prisma["Prisma access<br/>[prisma.service.ts]"]
  node_database[("PostgreSQL")]
  node_media_storage["Image storage<br/>[storage.service.ts]"]
end

node_operator(("Dashboard user"))
node_api["NestJS API<br/>[main.ts]"]
node_object_store[("S3-compatible store")]

node_operator -->|"manages listings"| node_web_listings
node_web_listings -.->|"uses client"| node_web_listing_api
node_web_listing_api -.->|"requests listings"| node_listing_routes
node_web_auth -.->|"authenticates"| node_auth_routes
node_api -.->|"routes requests"| node_auth_routes
node_auth_routes -->|"delegates to"| node_auth_logic
node_auth_logic -->|"looks up users"| node_user_service
node_auth_logic -->|"stores refresh tokens"| node_prisma
node_user_service -->|"queries users"| node_prisma
node_agent_management -->|"queries agents"| node_prisma
node_listing_routes -->|"delegates to"| node_listing_logic
node_listing_logic -->|"reads and writes"| node_prisma
node_listing_logic -->|"uploads images"| node_media_storage
node_listing_logic -.->|"stores images"| node_object_store
node_availability_routes -->|"delegates to"| node_availability_logic
node_rate_routes -->|"delegates to"| node_rate_logic
node_rate_logic -->|"reads and writes"| node_prisma
node_booking_routes -->|"delegates to"| node_booking_logic
node_booking_logic -->|"requests quotes"| node_pricing
node_booking_logic -->|"reads and writes"| node_prisma
node_booking_logic -->|"records booked dates"| node_availability_logic
node_pricing -->|"reads pricing data"| node_prisma
node_prisma -.->|"persists data"| node_database
node_media_storage -->|"uploads and deletes"| node_object_store

click node_web_listings "https://github.com/dhwrwm/rental-platform/tree/main/apps/web/src/features/listings"
click node_web_listing_api "https://github.com/dhwrwm/rental-platform/blob/main/apps/web/src/features/listings/api/listings-api.ts"
click node_web_auth "https://github.com/dhwrwm/rental-platform/blob/main/apps/web/src/features/auth/components/auth-form.tsx"
click node_api "https://github.com/dhwrwm/rental-platform/blob/main/apps/api/src/main.ts"
click node_auth_routes "https://github.com/dhwrwm/rental-platform/blob/main/apps/api/src/auth/auth.controller.ts"
click node_auth_logic "https://github.com/dhwrwm/rental-platform/blob/main/apps/api/src/auth/auth.service.ts"
click node_user_service "https://github.com/dhwrwm/rental-platform/blob/main/apps/api/src/users/users.service.ts"
click node_agent_management "https://github.com/dhwrwm/rental-platform/blob/main/apps/api/src/agents/agents.service.ts"
click node_listing_routes "https://github.com/dhwrwm/rental-platform/blob/main/apps/api/src/listings/listings.controller.ts"
click node_listing_logic "https://github.com/dhwrwm/rental-platform/blob/main/apps/api/src/listings/listings.service.ts"
click node_availability_routes "https://github.com/dhwrwm/rental-platform/blob/main/apps/api/src/listing-availability/listing-availability.controller.ts"
click node_availability_logic "https://github.com/dhwrwm/rental-platform/blob/main/apps/api/src/listing-availability/listing-availability.service.ts"
click node_rate_routes "https://github.com/dhwrwm/rental-platform/blob/main/apps/api/src/listing-rates/listing-rates.controller.ts"
click node_rate_logic "https://github.com/dhwrwm/rental-platform/blob/main/apps/api/src/listing-rates/listing-rates.service.ts"
click node_booking_routes "https://github.com/dhwrwm/rental-platform/blob/main/apps/api/src/bookings/bookings.controller.ts"
click node_booking_logic "https://github.com/dhwrwm/rental-platform/blob/main/apps/api/src/bookings/bookings.service.ts"
click node_pricing "https://github.com/dhwrwm/rental-platform/blob/main/apps/api/src/common/pricing/pricing.service.ts"
click node_prisma "https://github.com/dhwrwm/rental-platform/blob/main/apps/api/src/common/prisma/prisma.service.ts"
click node_media_storage "https://github.com/dhwrwm/rental-platform/blob/main/apps/api/src/storage/storage.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_listings,node_web_listing_api,node_web_auth,node_operator toneBlue
class node_auth_routes,node_auth_logic,node_user_service,node_agent_management,node_object_store toneAmber
class node_listing_routes,node_listing_logic,node_availability_routes,node_availability_logic,node_rate_routes,node_rate_logic,node_api toneMint
class node_booking_routes,node_booking_logic,node_pricing toneRose
class node_prisma,node_database,node_media_storage toneIndigo
```

## Components

### Web dashboard

- [Listing screens](https://github.com/dhwrwm/rental-platform/tree/main/apps/web/src/features/listings): `apps/web/src/features/listings`
- [Listing client](https://github.com/dhwrwm/rental-platform/blob/main/apps/web/src/features/listings/api/listings-api.ts): `apps/web/src/features/listings/api/listings-api.ts`
- [Auth forms](https://github.com/dhwrwm/rental-platform/blob/main/apps/web/src/features/auth/components/auth-form.tsx): `apps/web/src/features/auth/components/auth-form.tsx`

### Identity and users

- [Auth routes](https://github.com/dhwrwm/rental-platform/blob/main/apps/api/src/auth/auth.controller.ts): `apps/api/src/auth/auth.controller.ts`
- [Token and session logic](https://github.com/dhwrwm/rental-platform/blob/main/apps/api/src/auth/auth.service.ts): `apps/api/src/auth/auth.service.ts`
- [User management](https://github.com/dhwrwm/rental-platform/blob/main/apps/api/src/users/users.service.ts): `apps/api/src/users/users.service.ts`
- [Agent management](https://github.com/dhwrwm/rental-platform/blob/main/apps/api/src/agents/agents.service.ts): `apps/api/src/agents/agents.service.ts`

### Listing management

- [Listing routes](https://github.com/dhwrwm/rental-platform/blob/main/apps/api/src/listings/listings.controller.ts): `apps/api/src/listings/listings.controller.ts`
- [Listing management](https://github.com/dhwrwm/rental-platform/blob/main/apps/api/src/listings/listings.service.ts): `apps/api/src/listings/listings.service.ts`
- [Availability routes](https://github.com/dhwrwm/rental-platform/blob/main/apps/api/src/listing-availability/listing-availability.controller.ts): `apps/api/src/listing-availability/listing-availability.controller.ts`
- [Availability management](https://github.com/dhwrwm/rental-platform/blob/main/apps/api/src/listing-availability/listing-availability.service.ts): `apps/api/src/listing-availability/listing-availability.service.ts`
- [Rate routes](https://github.com/dhwrwm/rental-platform/blob/main/apps/api/src/listing-rates/listing-rates.controller.ts): `apps/api/src/listing-rates/listing-rates.controller.ts`
- [Rate management](https://github.com/dhwrwm/rental-platform/blob/main/apps/api/src/listing-rates/listing-rates.service.ts): `apps/api/src/listing-rates/listing-rates.service.ts`

### Booking and pricing

- [Booking routes](https://github.com/dhwrwm/rental-platform/blob/main/apps/api/src/bookings/bookings.controller.ts): `apps/api/src/bookings/bookings.controller.ts`
- [Booking lifecycle](https://github.com/dhwrwm/rental-platform/blob/main/apps/api/src/bookings/bookings.service.ts): `apps/api/src/bookings/bookings.service.ts`
- [Quote pricing](https://github.com/dhwrwm/rental-platform/blob/main/apps/api/src/common/pricing/pricing.service.ts): `apps/api/src/common/pricing/pricing.service.ts`

### Persistence and media

- [Prisma access](https://github.com/dhwrwm/rental-platform/blob/main/apps/api/src/common/prisma/prisma.service.ts): `apps/api/src/common/prisma/prisma.service.ts`
- **PostgreSQL**
- [Image storage](https://github.com/dhwrwm/rental-platform/blob/main/apps/api/src/storage/storage.service.ts): `apps/api/src/storage/storage.service.ts`

### Other components

- **Dashboard user**
- [NestJS API](https://github.com/dhwrwm/rental-platform/blob/main/apps/api/src/main.ts): `apps/api/src/main.ts`
- **S3-compatible store**

## Connections

- Dashboard user → Listing screens: manages listings
- Listing screens → Listing client: uses client
- Listing client → Listing routes: requests listings
- Auth forms → Auth routes: authenticates
- NestJS API → Auth routes: routes requests
- Auth routes → Token and session logic: delegates to (evidence: `apps/api/src/auth/auth.controller.ts`)
- Token and session logic → User management: looks up users (evidence: `apps/api/src/auth/auth.service.ts`)
- Token and session logic → Prisma access: stores refresh tokens (evidence: `apps/api/src/auth/auth.service.ts`)
- User management → Prisma access: queries users (evidence: `apps/api/src/users/users.service.ts`)
- Agent management → Prisma access: queries agents (evidence: `apps/api/src/agents/agents.service.ts`)
- Listing routes → Listing management: delegates to (evidence: `apps/api/src/listings/listings.controller.ts`)
- Listing management → Prisma access: reads and writes (evidence: `apps/api/src/listings/listings.service.ts`)
- Listing management → Image storage: uploads images (evidence: `apps/api/src/listings/listings.service.ts`)
- Listing management → S3-compatible store: stores images
- Availability routes → Availability management: delegates to (evidence: `apps/api/src/listing-availability/listing-availability.controller.ts`)
- Rate routes → Rate management: delegates to (evidence: `apps/api/src/listing-rates/listing-rates.controller.ts`)
- Rate management → Prisma access: reads and writes (evidence: `apps/api/src/listing-rates/listing-rates.service.ts`)
- Booking routes → Booking lifecycle: delegates to (evidence: `apps/api/src/bookings/bookings.controller.ts`)
- Booking lifecycle → Quote pricing: requests quotes (evidence: `apps/api/src/bookings/bookings.service.ts`)
- Booking lifecycle → Prisma access: reads and writes (evidence: `apps/api/src/bookings/bookings.service.ts`)
- Booking lifecycle → Availability management: records booked dates (evidence: `apps/api/src/bookings/bookings.service.ts`)
- Quote pricing → Prisma access: reads pricing data (evidence: `apps/api/src/common/pricing/pricing.service.ts`)
- Prisma access → PostgreSQL: persists data
- Image storage → S3-compatible store: uploads and deletes (evidence: `apps/api/src/storage/storage.service.ts`)
