# omarabdullatif6/real-estate-market-place-api architecture

> Architecture diagram of the GitHub repository omarabdullatif6/real-estate-market-place-api, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/omarabdullatif6/real-estate-market-place-api
- Repository: https://github.com/omarabdullatif6/real-estate-market-place-api

## Overview

This is a NestJS property-marketplace API: users authenticate, browse or manage property listings, and sellers can submit identity requests for review. Admins moderate listings and requests and manage users. The graph highlights the route-to-service workflow and its main domain models, with image, geocoding, and mail integrations. Relationships are based on the supplied excerpts and SOURCE INDEX; unsampled subsystem behavior is represented conservatively.

Main entry points: [`src/app.module.ts`](https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/app.module.ts) (Application Modules), [`src/users/users.service.ts`](https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/users/users.service.ts) (User Operations), [`src/request/requests.service.ts`](https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/request/requests.service.ts) (Verification Requests), [`src/listings/listings.service.ts`](https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/listings/listings.service.ts) (Listing Operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_bootstrap["HTTP Bootstrap<br/>[main.ts]"]
  node_appmodule["Application Modules<br/>[app.module.ts]"]
end

subgraph group_identity["Identity and Users"]
  node_authcontroller["Auth Routes<br/>[auth.controller.ts]"]
  node_authservice["Authentication<br/>[auth.service.ts]"]
  node_authguard["JWT Guard<br/>[auth.guard.ts]"]
  node_userscontroller["User Routes"]
  node_userservice["User Operations<br/>[users.service.ts]"]
  node_usermodel[("User Records<br/>[users.model.ts]")]
  node_favorites["Favorites Provider"]
end

subgraph group_marketplace["Property Listings"]
  node_listingscontroller["Listing Routes"]
  node_listingservice["Listing Operations"]
  node_listingmodel[("Listing Records<br/>[listings.model.ts]")]
end

subgraph group_moderation["Review and Administration"]
  node_requestcontroller["Request Routes"]
  node_requestservice["Verification Requests"]
  node_requestmodel[("Request Records<br/>[requests.model.ts]")]
  node_admincontroller["Admin Routes"]
  node_adminservice["Admin Operations<br/>[admins.service.ts]"]
end

subgraph group_integrations["External Services"]
  node_cloudinary["Cloudinary Media"]
  node_geocoding["Geocoding"]
  node_mail["Email Delivery<br/>[mail.service.ts]"]
end

node_client(("API Client"))

node_client -->|"sends requests"| node_bootstrap
node_bootstrap -->|"starts"| node_appmodule
node_appmodule -->|"registers"| node_authcontroller
node_appmodule -->|"registers"| node_userscontroller
node_appmodule -->|"registers"| node_listingscontroller
node_appmodule -->|"registers"| node_requestcontroller
node_appmodule -->|"registers"| node_admincontroller
node_authcontroller -->|"delegates to"| node_authservice
node_authservice -->|"reads and writes"| node_usermodel
node_authservice -->|"sends mail"| node_mail
node_authguard -->|"validates token"| node_client
node_userscontroller -->|"delegates to"| node_userservice
node_userscontroller -->|"uses"| node_favorites
node_userservice -->|"reads and writes"| node_usermodel
node_userservice -->|"accesses listings"| node_listingmodel
node_userservice -->|"checks requests"| node_requestservice
node_userservice -->|"uses media"| node_cloudinary
node_listingscontroller -->|"delegates to"| node_listingservice
node_listingservice -->|"reads and writes"| node_listingmodel
node_listingservice -->|"uploads media"| node_cloudinary
node_listingservice -->|"geocodes locations"| node_geocoding
node_requestcontroller -->|"delegates to"| node_requestservice
node_requestservice -->|"reads and writes"| node_requestmodel
node_requestservice -->|"uploads documents"| node_cloudinary
node_admincontroller -->|"delegates to"| node_adminservice
node_admincontroller -->|"manages requests"| node_requestservice
node_adminservice -->|"manages users"| node_usermodel
node_adminservice -->|"moderates listings"| node_listingmodel
node_adminservice -->|"reviews requests"| node_requestmodel

click node_bootstrap "https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/main.ts"
click node_appmodule "https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/app.module.ts"
click node_authcontroller "https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/auth/auth.controller.ts"
click node_authservice "https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/auth/auth.service.ts"
click node_authguard "https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/auth/guards/auth.guard.ts"
click node_userscontroller "https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/users/users.controller.ts"
click node_userservice "https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/users/users.service.ts"
click node_usermodel "https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/users/users.model.ts"
click node_favorites "https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/users/favorites.provider.ts"
click node_listingscontroller "https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/listings/listings.controller.ts"
click node_listingservice "https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/listings/listings.service.ts"
click node_listingmodel "https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/listings/listings.model.ts"
click node_requestcontroller "https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/request/requests.controller.ts"
click node_requestservice "https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/request/requests.service.ts"
click node_requestmodel "https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/request/requests.model.ts"
click node_admincontroller "https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/admins/admins.controller.ts"
click node_adminservice "https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/admins/admins.service.ts"
click node_cloudinary "https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/cloudinary/cloudinary.service.ts"
click node_geocoding "https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/common/services/geocoding.service.ts"
click node_mail "https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/mail/mail.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_bootstrap,node_appmodule,node_client toneBlue
class node_authcontroller,node_authservice,node_authguard,node_userscontroller,node_userservice,node_usermodel,node_favorites toneAmber
class node_listingscontroller,node_listingservice,node_listingmodel toneMint
class node_requestcontroller,node_requestservice,node_requestmodel,node_admincontroller,node_adminservice toneRose
class node_cloudinary,node_geocoding,node_mail toneIndigo
```

## Components

### Application

- [HTTP Bootstrap](https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/main.ts): `src/main.ts`
- [Application Modules](https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/app.module.ts): `src/app.module.ts`

### Identity and Users

- [Auth Routes](https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/auth/auth.controller.ts): `src/auth/auth.controller.ts`
- [Authentication](https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/auth/auth.service.ts): `src/auth/auth.service.ts`
- [JWT Guard](https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/auth/guards/auth.guard.ts): `src/auth/guards/auth.guard.ts`
- [User Routes](https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/users/users.controller.ts): `src/users/users.controller.ts`
- [User Operations](https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/users/users.service.ts): `src/users/users.service.ts`
- [User Records](https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/users/users.model.ts): `src/users/users.model.ts`
- [Favorites Provider](https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/users/favorites.provider.ts): `src/users/favorites.provider.ts`

### Property Listings

- [Listing Routes](https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/listings/listings.controller.ts): `src/listings/listings.controller.ts`
- [Listing Operations](https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/listings/listings.service.ts): `src/listings/listings.service.ts`
- [Listing Records](https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/listings/listings.model.ts): `src/listings/listings.model.ts`

### Review and Administration

- [Request Routes](https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/request/requests.controller.ts): `src/request/requests.controller.ts`
- [Verification Requests](https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/request/requests.service.ts): `src/request/requests.service.ts`
- [Request Records](https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/request/requests.model.ts): `src/request/requests.model.ts`
- [Admin Routes](https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/admins/admins.controller.ts): `src/admins/admins.controller.ts`
- [Admin Operations](https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/admins/admins.service.ts): `src/admins/admins.service.ts`

### External Services

- [Cloudinary Media](https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/cloudinary/cloudinary.service.ts): `src/cloudinary/cloudinary.service.ts`
- [Geocoding](https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/common/services/geocoding.service.ts): `src/common/services/geocoding.service.ts`
- [Email Delivery](https://github.com/omarabdullatif6/real-estate-market-place-api/blob/master/src/mail/mail.service.ts): `src/mail/mail.service.ts`

### Other components

- **API Client**

## Connections

- API Client → HTTP Bootstrap: sends requests (evidence: `src/main.ts`)
- HTTP Bootstrap → Application Modules: starts (evidence: `src/main.ts`)
- Application Modules → Auth Routes: registers (evidence: `src/app.module.ts`)
- Application Modules → User Routes: registers (evidence: `src/app.module.ts`)
- Application Modules → Listing Routes: registers (evidence: `src/app.module.ts`)
- Application Modules → Request Routes: registers (evidence: `src/app.module.ts`)
- Application Modules → Admin Routes: registers (evidence: `src/app.module.ts`)
- Auth Routes → Authentication: delegates to (evidence: `src/auth/auth.controller.ts`)
- Authentication → User Records: reads and writes (evidence: `src/auth/auth.service.ts`)
- Authentication → Email Delivery: sends mail (evidence: `src/auth/auth.service.ts`)
- JWT Guard → API Client: validates token (evidence: `src/auth/guards/auth.guard.ts`)
- User Routes → User Operations: delegates to (evidence: `src/users/users.controller.ts`)
- User Routes → Favorites Provider: uses (evidence: `src/users/users.controller.ts`)
- User Operations → User Records: reads and writes (evidence: `src/users/users.service.ts`)
- User Operations → Listing Records: accesses listings (evidence: `src/users/users.service.ts`)
- User Operations → Verification Requests: checks requests (evidence: `src/users/users.service.ts`)
- User Operations → Cloudinary Media: uses media (evidence: `src/users/users.service.ts`)
- Listing Routes → Listing Operations: delegates to (evidence: `src/listings/listings.controller.ts`)
- Listing Operations → Listing Records: reads and writes (evidence: `src/listings/listings.service.ts`)
- Listing Operations → Cloudinary Media: uploads media (evidence: `src/listings/listings.service.ts`)
- Listing Operations → Geocoding: geocodes locations (evidence: `src/listings/listings.service.ts`)
- Request Routes → Verification Requests: delegates to (evidence: `src/request/requests.controller.ts`)
- Verification Requests → Request Records: reads and writes (evidence: `src/request/requests.service.ts`)
- Verification Requests → Cloudinary Media: uploads documents (evidence: `src/request/requests.service.ts`)
- Admin Routes → Admin Operations: delegates to (evidence: `src/admins/admins.controller.ts`)
- Admin Routes → Verification Requests: manages requests (evidence: `src/admins/admins.controller.ts`)
- Admin Operations → User Records: manages users (evidence: `src/admins/admins.service.ts`)
- Admin Operations → Listing Records: moderates listings (evidence: `src/admins/admins.service.ts`)
- Admin Operations → Request Records: reviews requests (evidence: `src/admins/admins.service.ts`)
