# vishal-3600/real-estate-management-system architecture

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

- Interactive diagram: https://gitdiagram.com/vishal-3600/real-estate-management-system
- Repository: https://github.com/vishal-3600/real-estate-management-system

## Overview

This is a full-stack real-estate marketplace for sale, rental and PG listings, with role-aware access, bookings and a Razorpay payment structure. The user journey runs from React listing/search and property detail pages through authenticated REST calls to Spring controllers, services and MySQL-backed repositories; users can register or log in, then create bookings and inspect them. The README also describes PG inventory and transactional updates, though no separate room/bed module appears in the tree. Edges reflect excerpted calls, SOURCE INDEX references or documented architecture; unsampled details are not inferred.

Main entry points: [`frontend/src/services/api.js`](https://github.com/vishal-3600/real-estate-management-system/blob/main/frontend/src/services/api.js) (API client), [`frontend/src/main.jsx`](https://github.com/vishal-3600/real-estate-management-system/blob/main/frontend/src/main.jsx) (Route application), [`backend/src/main/java/com/realestate/repository/UserRepository.java`](https://github.com/vishal-3600/real-estate-management-system/blob/main/backend/src/main/java/com/realestate/repository/UserRepository.java) (User repository), [`backend/src/main/java/com/realestate/service/BookingService.java`](https://github.com/vishal-3600/real-estate-management-system/blob/main/backend/src/main/java/com/realestate/service/BookingService.java) (Booking service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["React application"]
  node_app["Route application<br/>[main.jsx]"]
  node_auth_ui["Auth state<br/>[AuthContext.jsx]"]
  node_listing_ui["Listing search<br/>[Home.jsx]"]
  node_property_ui["Property details"]
  node_booking_ui["My bookings<br/>[Bookings.jsx]"]
  node_api_client["API client<br/>[api.js]"]
end

subgraph group_api["Spring REST API"]
  node_auth_controller["Auth endpoints"]
  node_property_controller["Property endpoints"]
  node_booking_controller["Booking endpoints"]
  node_payment_controller["Payment endpoints"]
end

subgraph group_identity["Identity and access"]
  node_auth_service["Auth service<br/>[AuthService.java]"]
  node_jwt_service["JWT service<br/>[JwtService.java]"]
  node_jwt_filter["JWT filter<br/>[JwtAuthFilter.java]"]
  node_security_config["Security rules"]
end

subgraph group_market["Property and booking"]
  node_property_service["Property service"]
  node_booking_service["Booking service"]
end

subgraph group_data["Persistence and payments"]
  node_property_repo["Property repository"]
  node_booking_repo["Booking repository"]
  node_user_repo["User repository"]
  node_mysql[("MySQL database<br/>[schema.sql]")]
  node_razorpay_service["Razorpay service"]
end

node_visitor(("Customer or owner"))
node_razorpay(("Razorpay"))

node_visitor -->|"uses"| node_app
node_app -->|"provides context"| node_auth_ui
node_app -->|"routes to"| node_listing_ui
node_app -->|"routes to"| node_property_ui
node_app -->|"routes to"| node_booking_ui
node_listing_ui -->|"requests listings"| node_api_client
node_property_ui -->|"requests property"| node_api_client
node_booking_ui -->|"requests bookings"| node_api_client
node_auth_ui -->|"authenticates via"| node_api_client
node_api_client -->|"calls REST API"| node_property_controller
node_api_client -->|"calls REST API"| node_auth_controller
node_api_client -->|"calls REST API"| node_booking_controller
node_auth_controller -->|"delegates to"| node_auth_service
node_property_controller -->|"delegates to"| node_property_service
node_booking_controller -->|"delegates to"| node_booking_service
node_payment_controller -->|"delegates to"| node_razorpay_service
node_auth_service -->|"reads and saves users"| node_user_repo
node_auth_service -->|"generates token"| node_jwt_service
node_security_config -->|"registers filter"| node_jwt_filter
node_jwt_filter -->|"validates token"| node_jwt_service
node_jwt_filter -->|"loads user"| node_user_repo
node_property_service -->|"searches and saves"| node_property_repo
node_property_service -->|"loads owner"| node_user_repo
node_booking_service -->|"checks and updates"| node_property_repo
node_booking_service -->|"loads customer"| node_user_repo
node_booking_service -->|"saves and queries"| node_booking_repo
node_property_repo -->|"persists entities"| node_mysql
node_booking_repo -->|"persists entities"| node_mysql
node_user_repo -->|"persists entities"| node_mysql
node_razorpay_service -.->|"creates and verifies payments"| node_razorpay

click node_app "https://github.com/vishal-3600/real-estate-management-system/blob/main/frontend/src/main.jsx"
click node_auth_ui "https://github.com/vishal-3600/real-estate-management-system/blob/main/frontend/src/context/AuthContext.jsx"
click node_listing_ui "https://github.com/vishal-3600/real-estate-management-system/blob/main/frontend/src/pages/Home.jsx"
click node_property_ui "https://github.com/vishal-3600/real-estate-management-system/blob/main/frontend/src/pages/PropertyDetails.jsx"
click node_booking_ui "https://github.com/vishal-3600/real-estate-management-system/blob/main/frontend/src/pages/Bookings.jsx"
click node_api_client "https://github.com/vishal-3600/real-estate-management-system/blob/main/frontend/src/services/api.js"
click node_auth_controller "https://github.com/vishal-3600/real-estate-management-system/blob/main/backend/src/main/java/com/realestate/controller/AuthController.java"
click node_property_controller "https://github.com/vishal-3600/real-estate-management-system/blob/main/backend/src/main/java/com/realestate/controller/PropertyController.java"
click node_booking_controller "https://github.com/vishal-3600/real-estate-management-system/blob/main/backend/src/main/java/com/realestate/controller/BookingController.java"
click node_payment_controller "https://github.com/vishal-3600/real-estate-management-system/blob/main/backend/src/main/java/com/realestate/controller/PaymentController.java"
click node_auth_service "https://github.com/vishal-3600/real-estate-management-system/blob/main/backend/src/main/java/com/realestate/service/AuthService.java"
click node_jwt_service "https://github.com/vishal-3600/real-estate-management-system/blob/main/backend/src/main/java/com/realestate/security/JwtService.java"
click node_jwt_filter "https://github.com/vishal-3600/real-estate-management-system/blob/main/backend/src/main/java/com/realestate/security/JwtAuthFilter.java"
click node_security_config "https://github.com/vishal-3600/real-estate-management-system/blob/main/backend/src/main/java/com/realestate/security/SecurityConfig.java"
click node_property_service "https://github.com/vishal-3600/real-estate-management-system/blob/main/backend/src/main/java/com/realestate/service/PropertyService.java"
click node_booking_service "https://github.com/vishal-3600/real-estate-management-system/blob/main/backend/src/main/java/com/realestate/service/BookingService.java"
click node_property_repo "https://github.com/vishal-3600/real-estate-management-system/blob/main/backend/src/main/java/com/realestate/repository/PropertyRepository.java"
click node_booking_repo "https://github.com/vishal-3600/real-estate-management-system/blob/main/backend/src/main/java/com/realestate/repository/BookingRepository.java"
click node_user_repo "https://github.com/vishal-3600/real-estate-management-system/blob/main/backend/src/main/java/com/realestate/repository/UserRepository.java"
click node_mysql "https://github.com/vishal-3600/real-estate-management-system/blob/main/database/schema.sql"
click node_razorpay_service "https://github.com/vishal-3600/real-estate-management-system/blob/main/backend/src/main/java/com/realestate/service/RazorpayService.java"

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_app,node_auth_ui,node_listing_ui,node_property_ui,node_booking_ui,node_api_client toneBlue
class node_auth_controller,node_property_controller,node_booking_controller,node_payment_controller toneAmber
class node_auth_service,node_jwt_service,node_jwt_filter,node_security_config toneMint
class node_property_service,node_booking_service toneRose
class node_property_repo,node_booking_repo,node_user_repo,node_mysql,node_razorpay_service,node_visitor,node_razorpay toneIndigo
```

## Components

### React application

- [Route application](https://github.com/vishal-3600/real-estate-management-system/blob/main/frontend/src/main.jsx): `frontend/src/main.jsx`
- [Auth state](https://github.com/vishal-3600/real-estate-management-system/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [Listing search](https://github.com/vishal-3600/real-estate-management-system/blob/main/frontend/src/pages/Home.jsx): `frontend/src/pages/Home.jsx`
- [Property details](https://github.com/vishal-3600/real-estate-management-system/blob/main/frontend/src/pages/PropertyDetails.jsx): `frontend/src/pages/PropertyDetails.jsx`
- [My bookings](https://github.com/vishal-3600/real-estate-management-system/blob/main/frontend/src/pages/Bookings.jsx): `frontend/src/pages/Bookings.jsx`
- [API client](https://github.com/vishal-3600/real-estate-management-system/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`

### Spring REST API

- [Auth endpoints](https://github.com/vishal-3600/real-estate-management-system/blob/main/backend/src/main/java/com/realestate/controller/AuthController.java): `backend/src/main/java/com/realestate/controller/AuthController.java`
- [Property endpoints](https://github.com/vishal-3600/real-estate-management-system/blob/main/backend/src/main/java/com/realestate/controller/PropertyController.java): `backend/src/main/java/com/realestate/controller/PropertyController.java`
- [Booking endpoints](https://github.com/vishal-3600/real-estate-management-system/blob/main/backend/src/main/java/com/realestate/controller/BookingController.java): `backend/src/main/java/com/realestate/controller/BookingController.java`
- [Payment endpoints](https://github.com/vishal-3600/real-estate-management-system/blob/main/backend/src/main/java/com/realestate/controller/PaymentController.java): `backend/src/main/java/com/realestate/controller/PaymentController.java`

### Identity and access

- [Auth service](https://github.com/vishal-3600/real-estate-management-system/blob/main/backend/src/main/java/com/realestate/service/AuthService.java): `backend/src/main/java/com/realestate/service/AuthService.java`
- [JWT service](https://github.com/vishal-3600/real-estate-management-system/blob/main/backend/src/main/java/com/realestate/security/JwtService.java): `backend/src/main/java/com/realestate/security/JwtService.java`
- [JWT filter](https://github.com/vishal-3600/real-estate-management-system/blob/main/backend/src/main/java/com/realestate/security/JwtAuthFilter.java): `backend/src/main/java/com/realestate/security/JwtAuthFilter.java`
- [Security rules](https://github.com/vishal-3600/real-estate-management-system/blob/main/backend/src/main/java/com/realestate/security/SecurityConfig.java): `backend/src/main/java/com/realestate/security/SecurityConfig.java`

### Property and booking

- [Property service](https://github.com/vishal-3600/real-estate-management-system/blob/main/backend/src/main/java/com/realestate/service/PropertyService.java): `backend/src/main/java/com/realestate/service/PropertyService.java`
- [Booking service](https://github.com/vishal-3600/real-estate-management-system/blob/main/backend/src/main/java/com/realestate/service/BookingService.java): `backend/src/main/java/com/realestate/service/BookingService.java`

### Persistence and payments

- [Property repository](https://github.com/vishal-3600/real-estate-management-system/blob/main/backend/src/main/java/com/realestate/repository/PropertyRepository.java): `backend/src/main/java/com/realestate/repository/PropertyRepository.java`
- [Booking repository](https://github.com/vishal-3600/real-estate-management-system/blob/main/backend/src/main/java/com/realestate/repository/BookingRepository.java): `backend/src/main/java/com/realestate/repository/BookingRepository.java`
- [User repository](https://github.com/vishal-3600/real-estate-management-system/blob/main/backend/src/main/java/com/realestate/repository/UserRepository.java): `backend/src/main/java/com/realestate/repository/UserRepository.java`
- [MySQL database](https://github.com/vishal-3600/real-estate-management-system/blob/main/database/schema.sql): `database/schema.sql`
- [Razorpay service](https://github.com/vishal-3600/real-estate-management-system/blob/main/backend/src/main/java/com/realestate/service/RazorpayService.java): `backend/src/main/java/com/realestate/service/RazorpayService.java`

### Other components

- **Customer or owner**
- **Razorpay**

## Connections

- Customer or owner → Route application: uses (evidence: `README.md`)
- Route application → Auth state: provides context (evidence: `frontend/src/main.jsx`)
- Route application → Listing search: routes to (evidence: `frontend/src/main.jsx`)
- Route application → Property details: routes to (evidence: `frontend/src/main.jsx`)
- Route application → My bookings: routes to (evidence: `frontend/src/main.jsx`)
- Listing search → API client: requests listings (evidence: `frontend/src/pages/Home.jsx`)
- Property details → API client: requests property (evidence: `frontend/src/pages/PropertyDetails.jsx`)
- My bookings → API client: requests bookings (evidence: `frontend/src/pages/Bookings.jsx`)
- Auth state → API client: authenticates via (evidence: `frontend/src/pages/Login.jsx`)
- API client → Property endpoints: calls REST API (evidence: `README.md`)
- API client → Auth endpoints: calls REST API (evidence: `README.md`)
- API client → Booking endpoints: calls REST API (evidence: `README.md`)
- Auth endpoints → Auth service: delegates to (evidence: `backend/src/main/java/com/realestate/controller/AuthController.java`)
- Property endpoints → Property service: delegates to (evidence: `backend/src/main/java/com/realestate/controller/PropertyController.java`)
- Booking endpoints → Booking service: delegates to (evidence: `backend/src/main/java/com/realestate/controller/BookingController.java`)
- Payment endpoints → Razorpay service: delegates to (evidence: `backend/src/main/java/com/realestate/controller/PaymentController.java`)
- Auth service → User repository: reads and saves users (evidence: `backend/src/main/java/com/realestate/service/AuthService.java`)
- Auth service → JWT service: generates token (evidence: `backend/src/main/java/com/realestate/service/AuthService.java`)
- Security rules → JWT filter: registers filter (evidence: `backend/src/main/java/com/realestate/security/SecurityConfig.java`)
- JWT filter → JWT service: validates token (evidence: `backend/src/main/java/com/realestate/security/JwtAuthFilter.java`)
- JWT filter → User repository: loads user (evidence: `backend/src/main/java/com/realestate/security/JwtAuthFilter.java`)
- Property service → Property repository: searches and saves (evidence: `backend/src/main/java/com/realestate/service/PropertyService.java`)
- Property service → User repository: loads owner (evidence: `backend/src/main/java/com/realestate/service/PropertyService.java`)
- Booking service → Property repository: checks and updates (evidence: `backend/src/main/java/com/realestate/service/BookingService.java`)
- Booking service → User repository: loads customer (evidence: `backend/src/main/java/com/realestate/service/BookingService.java`)
- Booking service → Booking repository: saves and queries (evidence: `backend/src/main/java/com/realestate/service/BookingService.java`)
- Property repository → MySQL database: persists entities (evidence: `README.md`)
- Booking repository → MySQL database: persists entities (evidence: `README.md`)
- User repository → MySQL database: persists entities (evidence: `README.md`)
- Razorpay service → Razorpay: creates and verifies payments (evidence: `README.md`)
