How dhwrwm/rental-platform works
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: prisma.service.ts Prisma access · listings.service.ts Listing management · bookings.service.ts Booking lifecycle · auth.service.ts Token and session logic
Components 22
Web dashboard
- Listing screens
apps/web/src/features/listings - Listing client
apps/web/src/features/listings/api/listings-api.ts - Auth forms
apps/web/src/features/auth/components/auth-form.tsx
Identity and users
- Auth routes
apps/api/src/auth/auth.controller.ts - Token and session logic
apps/api/src/auth/auth.service.ts - User management
apps/api/src/users/users.service.ts - Agent management
apps/api/src/agents/agents.service.ts
Listing management
- Listing routes
apps/api/src/listings/listings.controller.ts - Listing management
apps/api/src/listings/listings.service.ts - Availability routes
apps/api/src/listing-availability/listing-availability.controller.ts - Availability management
apps/api/src/listing-availability/listing-availability.service.ts - Rate routes
apps/api/src/listing-rates/listing-rates.controller.ts - Rate management
apps/api/src/listing-rates/listing-rates.service.ts
Booking and pricing
- Booking routes
apps/api/src/bookings/bookings.controller.ts - Booking lifecycle
apps/api/src/bookings/bookings.service.ts - Quote pricing
apps/api/src/common/pricing/pricing.service.ts
Persistence and media
- Prisma access
apps/api/src/common/prisma/prisma.service.ts - PostgreSQL
- Image storage
apps/api/src/storage/storage.service.ts
Other components
- Dashboard user
- NestJS API
apps/api/src/main.ts - S3-compatible store
Connections 24
- 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
apps/api/src/auth/auth.controller.ts - Token and session logic → User management: looks up users
apps/api/src/auth/auth.service.ts - Token and session logic → Prisma access: stores refresh tokens
apps/api/src/auth/auth.service.ts - User management → Prisma access: queries users
apps/api/src/users/users.service.ts - Agent management → Prisma access: queries agents
apps/api/src/agents/agents.service.ts - Listing routes → Listing management: delegates to
apps/api/src/listings/listings.controller.ts - Listing management → Prisma access: reads and writes
apps/api/src/listings/listings.service.ts - Listing management → Image storage: uploads images
apps/api/src/listings/listings.service.ts - Listing management → S3-compatible store: stores images
- Availability routes → Availability management: delegates to
apps/api/src/listing-availability/listing-availability.controller.ts - Rate routes → Rate management: delegates to
apps/api/src/listing-rates/listing-rates.controller.ts - Rate management → Prisma access: reads and writes
apps/api/src/listing-rates/listing-rates.service.ts - Booking routes → Booking lifecycle: delegates to
apps/api/src/bookings/bookings.controller.ts - Booking lifecycle → Quote pricing: requests quotes
apps/api/src/bookings/bookings.service.ts - Booking lifecycle → Prisma access: reads and writes
apps/api/src/bookings/bookings.service.ts - Booking lifecycle → Availability management: records booked dates
apps/api/src/bookings/bookings.service.ts - Quote pricing → Prisma access: reads pricing data
apps/api/src/common/pricing/pricing.service.ts - Prisma access → PostgreSQL: persists data
- Image storage → S3-compatible store: uploads and deletes
apps/api/src/storage/storage.service.ts