# th3sabbir/house-rental-system architecture

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

## Overview

AmarThikana is a PHP/MySQL rental marketplace for tenants, landlords, and administrators. Tenants discover and inspect rentals, then pursue tours, applications, favorites, and landlord communication; landlords manage listings and tour requests, while admins moderate users and properties and view system analytics. The graph preserves these documented product areas and the sampled authentication, property, and database layers. Many pages and integrations were not sampled, so their relationships are included only where the README documents the workflow.

Main entry points: [`fullstack/config/database.php`](https://github.com/th3sabbir/house-rental-system/blob/main/fullstack/config/database.php) (Database Access), [`fullstack/login.php`](https://github.com/th3sabbir/house-rental-system/blob/main/fullstack/login.php) (Sign In and Signup), [`fullstack/api/properties_handler.php`](https://github.com/th3sabbir/house-rental-system/blob/main/fullstack/api/properties_handler.php) (Property Operations), [`fullstack/index.php`](https://github.com/th3sabbir/house-rental-system/blob/main/fullstack/index.php) (Rental Home)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Rental Discovery"]
  node_home["Rental Home<br/>[index.php]"]
  node_search["Search Results<br/>[search-result.php]"]
  node_property_pages["Property Details"]
end

subgraph group_identity["Accounts and Access"]
  node_auth_ui["Sign In and Signup<br/>[login.php]"]
  node_login_handler["Login Handler<br/>[login_handler.php]"]
  node_signup_handler["Signup Handler<br/>[signup_handler.php]"]
  node_auth["Authentication<br/>[auth.php]"]
end

subgraph group_rental_ops["Rental Operations"]
  node_tenant_portal["Tenant Portal<br/>[index.php]"]
  node_landlord_portal["Landlord Portal<br/>[index.php]"]
  node_property_api["Property Operations"]
  node_tour_requests["Tours and Applications<br/>[tour-property.php]"]
  node_messaging["Messaging<br/>[messages.php]"]
  node_contact["Contact Requests"]
end

subgraph group_admin["Administration"]
  node_admin_portal["Admin Dashboard<br/>[dashboard.php]"]
  node_admin_property["Property Moderation<br/>[edit-property.php]"]
  node_database_config["Database Access<br/>[database.php]"]
  node_rental_data[("Rental Data")]
  node_shared_functions["Shared Utilities<br/>[functions.php]"]
end

node_tenant(("Tenant"))
node_landlord(("Landlord"))
node_administrator(("Administrator"))

node_tenant -->|"find rentals"| node_home
node_home -->|"searches listings"| node_search
node_search -->|"opens details"| node_property_pages
node_tenant -->|"views rentals"| node_property_pages
node_tenant -->|"requests tours"| node_tour_requests
node_tenant -->|"messages landlords"| node_messaging
node_landlord -->|"manages rentals"| node_landlord_portal
node_landlord_portal -.->|"manages listings"| node_property_api
node_landlord -->|"handles requests"| node_tour_requests
node_tenant -.->|"manages account"| node_tenant_portal
node_tenant -->|"registers or signs in"| node_auth_ui
node_landlord -->|"registers or signs in"| node_auth_ui
node_auth_ui -.->|"submits login"| node_login_handler
node_auth_ui -.->|"submits signup"| node_signup_handler
node_login_handler -->|"authenticates"| node_auth
node_signup_handler -->|"registers user"| node_auth
node_auth -->|"connects through"| node_database_config
node_property_api -->|"loads connection"| node_database_config
node_home -->|"loads connection"| node_database_config
node_search -->|"loads connection"| node_database_config
node_database_config -->|"connects to"| node_rental_data
node_property_api -->|"uses utilities"| node_shared_functions
node_administrator -->|"reviews system"| node_admin_portal
node_admin_portal -->|"moderates listings"| node_admin_property
node_administrator -.->|"moderates listings"| node_property_api
node_administrator -->|"handles inquiries"| node_contact
node_landlord -->|"communicates with tenants"| node_messaging

click node_home "https://github.com/th3sabbir/house-rental-system/blob/main/fullstack/index.php"
click node_search "https://github.com/th3sabbir/house-rental-system/blob/main/fullstack/search-result.php"
click node_property_pages "https://github.com/th3sabbir/house-rental-system/blob/main/fullstack/property-details.php"
click node_auth_ui "https://github.com/th3sabbir/house-rental-system/blob/main/fullstack/login.php"
click node_login_handler "https://github.com/th3sabbir/house-rental-system/blob/main/fullstack/api/login_handler.php"
click node_signup_handler "https://github.com/th3sabbir/house-rental-system/blob/main/fullstack/api/signup_handler.php"
click node_auth "https://github.com/th3sabbir/house-rental-system/blob/main/fullstack/includes/auth.php"
click node_tenant_portal "https://github.com/th3sabbir/house-rental-system/blob/main/fullstack/tenant/index.php"
click node_landlord_portal "https://github.com/th3sabbir/house-rental-system/blob/main/fullstack/landlord/index.php"
click node_property_api "https://github.com/th3sabbir/house-rental-system/blob/main/fullstack/api/properties_handler.php"
click node_tour_requests "https://github.com/th3sabbir/house-rental-system/blob/main/fullstack/tour-property.php"
click node_messaging "https://github.com/th3sabbir/house-rental-system/blob/main/fullstack/messages.php"
click node_contact "https://github.com/th3sabbir/house-rental-system/blob/main/fullstack/api/contact_handler.php"
click node_admin_portal "https://github.com/th3sabbir/house-rental-system/blob/main/fullstack/admin/dashboard.php"
click node_admin_property "https://github.com/th3sabbir/house-rental-system/blob/main/fullstack/admin/edit-property.php"
click node_database_config "https://github.com/th3sabbir/house-rental-system/blob/main/fullstack/config/database.php"
click node_shared_functions "https://github.com/th3sabbir/house-rental-system/blob/main/fullstack/includes/functions.php"

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_home,node_search,node_property_pages toneBlue
class node_auth_ui,node_login_handler,node_signup_handler,node_auth toneAmber
class node_tenant_portal,node_landlord_portal,node_property_api,node_tour_requests,node_messaging,node_contact toneMint
class node_admin_portal,node_admin_property,node_database_config,node_rental_data,node_shared_functions toneRose
class node_tenant,node_landlord,node_administrator toneIndigo
```

## Components

### Rental Discovery

- [Rental Home](https://github.com/th3sabbir/house-rental-system/blob/main/fullstack/index.php): `fullstack/index.php`
- [Search Results](https://github.com/th3sabbir/house-rental-system/blob/main/fullstack/search-result.php): `fullstack/search-result.php`
- [Property Details](https://github.com/th3sabbir/house-rental-system/blob/main/fullstack/property-details.php): `fullstack/property-details.php`

### Accounts and Access

- [Sign In and Signup](https://github.com/th3sabbir/house-rental-system/blob/main/fullstack/login.php): `fullstack/login.php`
- [Login Handler](https://github.com/th3sabbir/house-rental-system/blob/main/fullstack/api/login_handler.php): `fullstack/api/login_handler.php`
- [Signup Handler](https://github.com/th3sabbir/house-rental-system/blob/main/fullstack/api/signup_handler.php): `fullstack/api/signup_handler.php`
- [Authentication](https://github.com/th3sabbir/house-rental-system/blob/main/fullstack/includes/auth.php): `fullstack/includes/auth.php`

### Rental Operations

- [Tenant Portal](https://github.com/th3sabbir/house-rental-system/blob/main/fullstack/tenant/index.php): `fullstack/tenant/index.php`
- [Landlord Portal](https://github.com/th3sabbir/house-rental-system/blob/main/fullstack/landlord/index.php): `fullstack/landlord/index.php`
- [Property Operations](https://github.com/th3sabbir/house-rental-system/blob/main/fullstack/api/properties_handler.php): `fullstack/api/properties_handler.php`
- [Tours and Applications](https://github.com/th3sabbir/house-rental-system/blob/main/fullstack/tour-property.php): `fullstack/tour-property.php`
- [Messaging](https://github.com/th3sabbir/house-rental-system/blob/main/fullstack/messages.php): `fullstack/messages.php`
- [Contact Requests](https://github.com/th3sabbir/house-rental-system/blob/main/fullstack/api/contact_handler.php): `fullstack/api/contact_handler.php`

### Administration

- [Admin Dashboard](https://github.com/th3sabbir/house-rental-system/blob/main/fullstack/admin/dashboard.php): `fullstack/admin/dashboard.php`
- [Property Moderation](https://github.com/th3sabbir/house-rental-system/blob/main/fullstack/admin/edit-property.php): `fullstack/admin/edit-property.php`
- [Database Access](https://github.com/th3sabbir/house-rental-system/blob/main/fullstack/config/database.php): `fullstack/config/database.php`
- **Rental Data**
- [Shared Utilities](https://github.com/th3sabbir/house-rental-system/blob/main/fullstack/includes/functions.php): `fullstack/includes/functions.php`

### Other components

- **Tenant**
- **Landlord**
- **Administrator**

## Connections

- Tenant → Rental Home: find rentals
- Rental Home → Search Results: searches listings
- Search Results → Property Details: opens details
- Tenant → Property Details: views rentals
- Tenant → Tours and Applications: requests tours
- Tenant → Messaging: messages landlords
- Landlord → Landlord Portal: manages rentals
- Landlord Portal → Property Operations: manages listings
- Landlord → Tours and Applications: handles requests
- Tenant → Tenant Portal: manages account
- Tenant → Sign In and Signup: registers or signs in
- Landlord → Sign In and Signup: registers or signs in
- Sign In and Signup → Login Handler: submits login
- Sign In and Signup → Signup Handler: submits signup
- Login Handler → Authentication: authenticates (evidence: `fullstack/api/login_handler.php`)
- Signup Handler → Authentication: registers user (evidence: `fullstack/api/signup_handler.php`)
- Authentication → Database Access: connects through (evidence: `fullstack/includes/auth.php`)
- Property Operations → Database Access: loads connection (evidence: `fullstack/api/properties_handler.php`)
- Rental Home → Database Access: loads connection (evidence: `fullstack/index.php`)
- Search Results → Database Access: loads connection (evidence: `fullstack/search-result.php`)
- Database Access → Rental Data: connects to (evidence: `fullstack/config/database.php`)
- Property Operations → Shared Utilities: uses utilities (evidence: `fullstack/api/properties_handler.php`)
- Administrator → Admin Dashboard: reviews system
- Admin Dashboard → Property Moderation: moderates listings
- Administrator → Property Operations: moderates listings
- Administrator → Contact Requests: handles inquiries
- Landlord → Messaging: communicates with tenants
