# khderalromi/rentiful_server architecture

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

- Interactive diagram: https://gitdiagram.com/khderalromi/rentiful_server
- Repository: https://github.com/khderalromi/rentiful_server

## Overview

This is a rental-property management API: tenants and managers use authenticated HTTP endpoints to find and manage listings, submit applications, approve them into leases, and handle lease payments. The graph separates authentication, property discovery, tenancy workflows, and MongoDB-backed domain models. The source excerpts show application approval creating a lease and property operations using location and review data; payment and several other controller details were not excerpted, so their internal relationships are not inferred.

Main entry points: [`src/controllers/AuthController.ts`](https://github.com/khderalromi/rentiful_server/blob/main/src/controllers/AuthController.ts) (Authentication), [`src/index.ts`](https://github.com/khderalromi/rentiful_server/blob/main/src/index.ts) (Express API), [`src/controllers/PropertiesController.ts`](https://github.com/khderalromi/rentiful_server/blob/main/src/controllers/PropertiesController.ts) (Property operations), [`src/routes/PropertiesRoutes.ts`](https://github.com/khderalromi/rentiful_server/blob/main/src/routes/PropertiesRoutes.ts) (Property routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and identity"]
  node_api["Express API<br/>[index.ts]"]
  node_user_routes["User routes<br/>[UserRoutes.ts]"]
  node_auth["Authentication<br/>[AuthController.ts]"]
end

subgraph group_marketplace["Property marketplace"]
  node_property_routes["Property routes"]
  node_property_controller["Property operations"]
  node_review_routes["Review routes<br/>[ReviewsRoutes.ts]"]
  node_review_controller["Review creation"]
end

subgraph group_tenancy["Rental lifecycle"]
  node_application_routes["Application routes"]
  node_application_controller["Application workflow"]
  node_lease_routes["Lease routes<br/>[LeaseRoutes.ts]"]
  node_lease_controller["Lease operations<br/>[LeaseController.ts]"]
  node_payment_routes["Payment routes<br/>[PaymentRoutes.ts]"]
  node_payment_controller["Payment operations"]
  node_tenant_routes["Tenant routes<br/>[TenantRoutes.ts]"]
  node_tenant_controller["Tenant operations"]
end

subgraph group_data["Domain data"]
  node_application_model[("Applications")]
  node_lease_model[("Leases<br/>[Leases.model.ts]")]
  node_payment_model[("Payments<br/>[Payment.model.ts]")]
  node_property_model[("Properties<br/>[Property.model.ts]")]
  node_location_model[("Locations<br/>[Location.model.ts]")]
  node_review_model[("Reviews<br/>[reviews.model.ts]")]
  node_manager_model[("Manager accounts<br/>[Manager.model.ts]")]
  node_tenant_model[("Tenant accounts<br/>[Tenant.model.ts]")]
end

node_client(("Tenant or manager"))

node_client -.->|"sends HTTP"| node_api
node_api -->|"mounts routes"| node_user_routes
node_api -->|"mounts routes"| node_property_routes
node_api -->|"mounts routes"| node_tenant_routes
node_api -->|"mounts routes"| node_application_routes
node_api -->|"mounts routes"| node_lease_routes
node_api -->|"mounts routes"| node_payment_routes
node_user_routes -->|"dispatches to"| node_auth
node_property_routes -->|"protects routes"| node_auth
node_property_routes -->|"dispatches to"| node_property_controller
node_property_routes -->|"mounts nested routes"| node_review_routes
node_review_routes -->|"protects routes"| node_auth
node_review_routes -->|"dispatches to"| node_review_controller
node_review_routes -->|"dispatches to"| node_property_controller
node_application_routes -->|"protects routes"| node_auth
node_application_routes -->|"dispatches to"| node_application_controller
node_application_routes -->|"mounts nested routes"| node_lease_routes
node_lease_routes -->|"protects routes"| node_auth
node_lease_routes -->|"dispatches to"| node_lease_controller
node_payment_routes -->|"protects routes"| node_auth
node_payment_routes -->|"dispatches to"| node_payment_controller
node_tenant_routes -->|"protects routes"| node_auth
node_tenant_routes -->|"dispatches to"| node_tenant_controller
node_auth -->|"reads and writes"| node_manager_model
node_auth -->|"reads"| node_tenant_model
node_property_controller -->|"queries and updates"| node_property_model
node_property_controller -->|"queries and updates"| node_location_model
node_property_controller -->|"queries"| node_review_model
node_review_controller -->|"creates"| node_review_model
node_application_controller -->|"queries and updates"| node_application_model
node_application_controller -->|"finds manager listings"| node_property_model
node_application_controller -->|"checks and creates leases"| node_lease_model
node_lease_controller -->|"uses"| node_application_model
node_lease_controller -->|"uses"| node_lease_model
node_payment_controller -->|"uses"| node_payment_model
node_payment_controller -->|"uses"| node_lease_model
node_tenant_controller -->|"uses"| node_tenant_model

click node_api "https://github.com/khderalromi/rentiful_server/blob/main/src/index.ts"
click node_user_routes "https://github.com/khderalromi/rentiful_server/blob/main/src/routes/UserRoutes.ts"
click node_auth "https://github.com/khderalromi/rentiful_server/blob/main/src/controllers/AuthController.ts"
click node_property_routes "https://github.com/khderalromi/rentiful_server/blob/main/src/routes/PropertiesRoutes.ts"
click node_property_controller "https://github.com/khderalromi/rentiful_server/blob/main/src/controllers/PropertiesController.ts"
click node_review_routes "https://github.com/khderalromi/rentiful_server/blob/main/src/routes/ReviewsRoutes.ts"
click node_review_controller "https://github.com/khderalromi/rentiful_server/blob/main/src/controllers/ReviewsController.ts"
click node_application_routes "https://github.com/khderalromi/rentiful_server/blob/main/src/routes/ApplicationRoutes.ts"
click node_application_controller "https://github.com/khderalromi/rentiful_server/blob/main/src/controllers/ApplicationController.ts"
click node_lease_routes "https://github.com/khderalromi/rentiful_server/blob/main/src/routes/LeaseRoutes.ts"
click node_lease_controller "https://github.com/khderalromi/rentiful_server/blob/main/src/controllers/LeaseController.ts"
click node_payment_routes "https://github.com/khderalromi/rentiful_server/blob/main/src/routes/PaymentRoutes.ts"
click node_payment_controller "https://github.com/khderalromi/rentiful_server/blob/main/src/controllers/PaymentController.ts"
click node_tenant_routes "https://github.com/khderalromi/rentiful_server/blob/main/src/routes/TenantRoutes.ts"
click node_tenant_controller "https://github.com/khderalromi/rentiful_server/blob/main/src/controllers/TenantController.ts"
click node_application_model "https://github.com/khderalromi/rentiful_server/blob/main/src/models/Application.model.ts"
click node_lease_model "https://github.com/khderalromi/rentiful_server/blob/main/src/models/Leases.model.ts"
click node_payment_model "https://github.com/khderalromi/rentiful_server/blob/main/src/models/Payment.model.ts"
click node_property_model "https://github.com/khderalromi/rentiful_server/blob/main/src/models/Property.model.ts"
click node_location_model "https://github.com/khderalromi/rentiful_server/blob/main/src/models/Location.model.ts"
click node_review_model "https://github.com/khderalromi/rentiful_server/blob/main/src/models/reviews.model.ts"
click node_manager_model "https://github.com/khderalromi/rentiful_server/blob/main/src/models/Manager.model.ts"
click node_tenant_model "https://github.com/khderalromi/rentiful_server/blob/main/src/models/Tenant.model.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_api,node_user_routes,node_auth toneBlue
class node_property_routes,node_property_controller,node_review_routes,node_review_controller toneAmber
class node_application_routes,node_application_controller,node_lease_routes,node_lease_controller,node_payment_routes,node_payment_controller,node_tenant_routes,node_tenant_controller toneMint
class node_application_model,node_lease_model,node_payment_model,node_property_model,node_location_model,node_review_model,node_manager_model,node_tenant_model toneRose
class node_client toneIndigo
```

## Components

### API and identity

- [Express API](https://github.com/khderalromi/rentiful_server/blob/main/src/index.ts): `src/index.ts`
- [User routes](https://github.com/khderalromi/rentiful_server/blob/main/src/routes/UserRoutes.ts): `src/routes/UserRoutes.ts`
- [Authentication](https://github.com/khderalromi/rentiful_server/blob/main/src/controllers/AuthController.ts): `src/controllers/AuthController.ts`

### Property marketplace

- [Property routes](https://github.com/khderalromi/rentiful_server/blob/main/src/routes/PropertiesRoutes.ts): `src/routes/PropertiesRoutes.ts`
- [Property operations](https://github.com/khderalromi/rentiful_server/blob/main/src/controllers/PropertiesController.ts): `src/controllers/PropertiesController.ts`
- [Review routes](https://github.com/khderalromi/rentiful_server/blob/main/src/routes/ReviewsRoutes.ts): `src/routes/ReviewsRoutes.ts`
- [Review creation](https://github.com/khderalromi/rentiful_server/blob/main/src/controllers/ReviewsController.ts): `src/controllers/ReviewsController.ts`

### Rental lifecycle

- [Application routes](https://github.com/khderalromi/rentiful_server/blob/main/src/routes/ApplicationRoutes.ts): `src/routes/ApplicationRoutes.ts`
- [Application workflow](https://github.com/khderalromi/rentiful_server/blob/main/src/controllers/ApplicationController.ts): `src/controllers/ApplicationController.ts`
- [Lease routes](https://github.com/khderalromi/rentiful_server/blob/main/src/routes/LeaseRoutes.ts): `src/routes/LeaseRoutes.ts`
- [Lease operations](https://github.com/khderalromi/rentiful_server/blob/main/src/controllers/LeaseController.ts): `src/controllers/LeaseController.ts`
- [Payment routes](https://github.com/khderalromi/rentiful_server/blob/main/src/routes/PaymentRoutes.ts): `src/routes/PaymentRoutes.ts`
- [Payment operations](https://github.com/khderalromi/rentiful_server/blob/main/src/controllers/PaymentController.ts): `src/controllers/PaymentController.ts`
- [Tenant routes](https://github.com/khderalromi/rentiful_server/blob/main/src/routes/TenantRoutes.ts): `src/routes/TenantRoutes.ts`
- [Tenant operations](https://github.com/khderalromi/rentiful_server/blob/main/src/controllers/TenantController.ts): `src/controllers/TenantController.ts`

### Domain data

- [Applications](https://github.com/khderalromi/rentiful_server/blob/main/src/models/Application.model.ts): `src/models/Application.model.ts`
- [Leases](https://github.com/khderalromi/rentiful_server/blob/main/src/models/Leases.model.ts): `src/models/Leases.model.ts`
- [Payments](https://github.com/khderalromi/rentiful_server/blob/main/src/models/Payment.model.ts): `src/models/Payment.model.ts`
- [Properties](https://github.com/khderalromi/rentiful_server/blob/main/src/models/Property.model.ts): `src/models/Property.model.ts`
- [Locations](https://github.com/khderalromi/rentiful_server/blob/main/src/models/Location.model.ts): `src/models/Location.model.ts`
- [Reviews](https://github.com/khderalromi/rentiful_server/blob/main/src/models/reviews.model.ts): `src/models/reviews.model.ts`
- [Manager accounts](https://github.com/khderalromi/rentiful_server/blob/main/src/models/Manager.model.ts): `src/models/Manager.model.ts`
- [Tenant accounts](https://github.com/khderalromi/rentiful_server/blob/main/src/models/Tenant.model.ts): `src/models/Tenant.model.ts`

### Other components

- **Tenant or manager**

## Connections

- Tenant or manager → Express API: sends HTTP
- Express API → User routes: mounts routes (evidence: `src/index.ts`)
- Express API → Property routes: mounts routes (evidence: `src/index.ts`)
- Express API → Tenant routes: mounts routes (evidence: `src/index.ts`)
- Express API → Application routes: mounts routes (evidence: `src/index.ts`)
- Express API → Lease routes: mounts routes (evidence: `src/index.ts`)
- Express API → Payment routes: mounts routes (evidence: `src/index.ts`)
- User routes → Authentication: dispatches to (evidence: `src/routes/UserRoutes.ts`)
- Property routes → Authentication: protects routes (evidence: `src/routes/PropertiesRoutes.ts`)
- Property routes → Property operations: dispatches to (evidence: `src/routes/PropertiesRoutes.ts`)
- Property routes → Review routes: mounts nested routes (evidence: `src/routes/PropertiesRoutes.ts`)
- Review routes → Authentication: protects routes (evidence: `src/routes/ReviewsRoutes.ts`)
- Review routes → Review creation: dispatches to (evidence: `src/routes/ReviewsRoutes.ts`)
- Review routes → Property operations: dispatches to (evidence: `src/routes/ReviewsRoutes.ts`)
- Application routes → Authentication: protects routes (evidence: `src/routes/ApplicationRoutes.ts`)
- Application routes → Application workflow: dispatches to (evidence: `src/routes/ApplicationRoutes.ts`)
- Application routes → Lease routes: mounts nested routes (evidence: `src/routes/ApplicationRoutes.ts`)
- Lease routes → Authentication: protects routes (evidence: `src/routes/LeaseRoutes.ts`)
- Lease routes → Lease operations: dispatches to (evidence: `src/routes/LeaseRoutes.ts`)
- Payment routes → Authentication: protects routes (evidence: `src/routes/PaymentRoutes.ts`)
- Payment routes → Payment operations: dispatches to (evidence: `src/routes/PaymentRoutes.ts`)
- Tenant routes → Authentication: protects routes (evidence: `src/routes/TenantRoutes.ts`)
- Tenant routes → Tenant operations: dispatches to (evidence: `src/routes/TenantRoutes.ts`)
- Authentication → Manager accounts: reads and writes (evidence: `src/controllers/AuthController.ts`)
- Authentication → Tenant accounts: reads (evidence: `src/controllers/AuthController.ts`)
- Property operations → Properties: queries and updates (evidence: `src/controllers/PropertiesController.ts`)
- Property operations → Locations: queries and updates (evidence: `src/controllers/PropertiesController.ts`)
- Property operations → Reviews: queries (evidence: `src/controllers/PropertiesController.ts`)
- Review creation → Reviews: creates (evidence: `src/controllers/ReviewsController.ts`)
- Application workflow → Applications: queries and updates (evidence: `src/controllers/ApplicationController.ts`)
- Application workflow → Properties: finds manager listings (evidence: `src/controllers/ApplicationController.ts`)
- Application workflow → Leases: checks and creates leases (evidence: `src/controllers/ApplicationController.ts`)
- Lease operations → Applications: uses (evidence: `src/controllers/LeaseController.ts`)
- Lease operations → Leases: uses (evidence: `src/controllers/LeaseController.ts`)
- Payment operations → Payments: uses (evidence: `src/controllers/PaymentController.ts`)
- Payment operations → Leases: uses (evidence: `src/controllers/PaymentController.ts`)
- Tenant operations → Tenant accounts: uses (evidence: `src/controllers/TenantController.ts`)
