# shubham-raj-dev/urbanshift-project architecture

> Architecture diagram of the GitHub repository shubham-raj-dev/urbanshift-project, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/shubham-raj-dev/urbanshift-project
- Repository: https://github.com/shubham-raj-dev/urbanshift-project

## Overview

UrbanShift combines property buying, selling, and renting with relocation bookings, provider coordination, chat, and payment. The user-facing flow runs from React routing and role-aware screens to Django REST endpoints, persisted domain records, and external authentication, email, image, and payment services. The README identifies capabilities whose implementation was not sampled; those are represented at subsystem level where the tree supports a path. Edges cite visible calls or README statements; unsampled relationships are omitted rather than inferred.

Main entry points: [`frontend/src/App.js`](https://github.com/shubham-raj-dev/urbanshift-project/blob/main/frontend/src/App.js) (React routes), [`backend/payments/views.py`](https://github.com/shubham-raj-dev/urbanshift-project/blob/main/backend/payments/views.py) (Payment processing), [`backend/properties/views.py`](https://github.com/shubham-raj-dev/urbanshift-project/blob/main/backend/properties/views.py) (Property listings and leads), [`backend/relocation/views.py`](https://github.com/shubham-raj-dev/urbanshift-project/blob/main/backend/relocation/views.py) (Move requests and reviews)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web experience"]
  node_reactapp["React routes<br/>[App.js]"]
  node_propertyui["Property browsing<br/>[Properties.js]"]
  node_detailui["Property details<br/>[PropertyDetail.js]"]
  node_listingui["Create listing<br/>[AddProperty.js]"]
  node_sellerui["Seller dashboard<br/>[SellerDashboard.js]"]
  node_accountui["Account screens<br/>[Register.js]"]
  node_moverui["Mover services<br/>[PackersMovers.js]"]
  node_bookingui["Move booking<br/>[BookMovers.js]"]
  node_movehistory["Move history<br/>[MyMoves.js]"]
  node_companyui["Company dashboard"]
  node_chatui["Live chat<br/>[Chat.js]"]
  node_theme["Theme preferences<br/>[ThemeContext.js]"]
end

subgraph group_identity["Accounts"]
  node_usersapi["Authentication and profiles<br/>[views.py]"]
  node_userrecords[("User records<br/>[models.py]")]
  node_userformat["User serialization<br/>[serializers.py]"]
  node_email["Email notifications<br/>[utils_email.py]"]
end

subgraph group_realestate["Property marketplace"]
  node_propertiesapi["Property listings and leads<br/>[views.py]"]
  node_propertyrecords[("Property records<br/>[models.py]")]
end

subgraph group_moving["Relocation services"]
  node_relocationapi["Move requests and reviews<br/>[views.py]"]
  node_moverecords[("Move records<br/>[models.py]")]
  node_chatbackend["WebSocket chat<br/>[consumers.py]"]
  node_chatroutes["Chat socket routing<br/>[routing.py]"]
end

subgraph group_platform["Platform services"]
  node_paymentsapi["Payment processing<br/>[views.py]"]
  node_transactions[("Transactions<br/>[models.py]")]
end

node_visitor(("Buyer, seller, renter"))
node_razorpay["Razorpay"]
node_firebase["Firebase Google Auth"]
node_cloudinary["Cloudinary image storage"]
node_postgres[("PostgreSQL")]
node_admin(("Admin"))

node_visitor -->|"uses"| node_reactapp
node_reactapp -->|"provides theme"| node_theme
node_reactapp -->|"routes to"| node_propertyui
node_reactapp -->|"routes to"| node_detailui
node_reactapp -->|"routes to"| node_listingui
node_reactapp -->|"routes to"| node_sellerui
node_reactapp -->|"routes to"| node_accountui
node_reactapp -.->|"routes to"| node_moverui
node_reactapp -.->|"routes to"| node_bookingui
node_reactapp -->|"routes to"| node_movehistory
node_reactapp -->|"routes to"| node_companyui
node_reactapp -.->|"routes to"| node_chatui
node_propertyui -.->|"requests listings"| node_propertiesapi
node_detailui -.->|"requests property"| node_propertiesapi
node_listingui -.->|"submits listing"| node_propertiesapi
node_sellerui -.->|"manages listings"| node_propertiesapi
node_bookingui -.->|"submits booking"| node_relocationapi
node_movehistory -.->|"reads bookings"| node_relocationapi
node_companyui -.->|"manages requests"| node_relocationapi
node_chatui -.->|"opens chat"| node_chatbackend
node_chatroutes -->|"routes socket"| node_chatbackend
node_accountui -->|"authenticates with"| node_firebase
node_accountui -->|"posts Google token"| node_usersapi
node_usersapi -->|"serializes users"| node_userformat
node_userformat -->|"creates and updates"| node_userrecords
node_usersapi -->|"sends notifications"| node_email
node_propertiesapi -->|"reads and writes"| node_propertyrecords
node_propertiesapi -->|"notifies users"| node_email
node_relocationapi -->|"reads and updates"| node_moverecords
node_relocationapi -->|"sends notifications"| node_email
node_detailui -.->|"starts payment"| node_paymentsapi
node_paymentsapi -->|"creates and verifies"| node_razorpay
node_paymentsapi -->|"records payment"| node_transactions
node_paymentsapi -->|"marks move paid"| node_moverecords
node_paymentsapi -->|"marks property sold"| node_propertyrecords
node_paymentsapi -->|"sends receipt notices"| node_email
node_listingui -.->|"uploads images"| node_cloudinary
node_admin -.->|"reviews listings"| node_propertyrecords
node_admin -.->|"verifies sellers"| node_userrecords
node_userrecords -.->|"persists"| node_postgres
node_propertyrecords -.->|"persists"| node_postgres
node_moverecords -.->|"persists"| node_postgres
node_transactions -.->|"persists"| node_postgres

click node_reactapp "https://github.com/shubham-raj-dev/urbanshift-project/blob/main/frontend/src/App.js"
click node_propertyui "https://github.com/shubham-raj-dev/urbanshift-project/blob/main/frontend/src/components/Properties.js"
click node_detailui "https://github.com/shubham-raj-dev/urbanshift-project/blob/main/frontend/src/components/PropertyDetail.js"
click node_listingui "https://github.com/shubham-raj-dev/urbanshift-project/blob/main/frontend/src/components/AddProperty.js"
click node_sellerui "https://github.com/shubham-raj-dev/urbanshift-project/blob/main/frontend/src/components/SellerDashboard.js"
click node_accountui "https://github.com/shubham-raj-dev/urbanshift-project/blob/main/frontend/src/components/Register.js"
click node_moverui "https://github.com/shubham-raj-dev/urbanshift-project/blob/main/frontend/src/components/PackersMovers.js"
click node_bookingui "https://github.com/shubham-raj-dev/urbanshift-project/blob/main/frontend/src/components/BookMovers.js"
click node_movehistory "https://github.com/shubham-raj-dev/urbanshift-project/blob/main/frontend/src/components/MyMoves.js"
click node_companyui "https://github.com/shubham-raj-dev/urbanshift-project/blob/main/frontend/src/components/CompanyDashboard.js"
click node_chatui "https://github.com/shubham-raj-dev/urbanshift-project/blob/main/frontend/src/components/Chat.js"
click node_theme "https://github.com/shubham-raj-dev/urbanshift-project/blob/main/frontend/src/context/ThemeContext.js"
click node_usersapi "https://github.com/shubham-raj-dev/urbanshift-project/blob/main/backend/users/views.py"
click node_userrecords "https://github.com/shubham-raj-dev/urbanshift-project/blob/main/backend/users/models.py"
click node_userformat "https://github.com/shubham-raj-dev/urbanshift-project/blob/main/backend/users/serializers.py"
click node_email "https://github.com/shubham-raj-dev/urbanshift-project/blob/main/backend/users/utils_email.py"
click node_propertiesapi "https://github.com/shubham-raj-dev/urbanshift-project/blob/main/backend/properties/views.py"
click node_propertyrecords "https://github.com/shubham-raj-dev/urbanshift-project/blob/main/backend/properties/models.py"
click node_relocationapi "https://github.com/shubham-raj-dev/urbanshift-project/blob/main/backend/relocation/views.py"
click node_moverecords "https://github.com/shubham-raj-dev/urbanshift-project/blob/main/backend/relocation/models.py"
click node_chatbackend "https://github.com/shubham-raj-dev/urbanshift-project/blob/main/backend/chat/consumers.py"
click node_chatroutes "https://github.com/shubham-raj-dev/urbanshift-project/blob/main/backend/chat/routing.py"
click node_paymentsapi "https://github.com/shubham-raj-dev/urbanshift-project/blob/main/backend/payments/views.py"
click node_transactions "https://github.com/shubham-raj-dev/urbanshift-project/blob/main/backend/payments/models.py"

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_reactapp,node_propertyui,node_detailui,node_listingui,node_sellerui,node_accountui,node_moverui,node_bookingui,node_movehistory,node_companyui,node_chatui,node_theme toneBlue
class node_usersapi,node_userrecords,node_userformat,node_email,node_cloudinary,node_postgres toneAmber
class node_propertiesapi,node_propertyrecords toneMint
class node_relocationapi,node_moverecords,node_chatbackend,node_chatroutes toneRose
class node_paymentsapi,node_transactions,node_visitor,node_razorpay,node_firebase,node_admin toneIndigo
```

## Components

### Web experience

- [React routes](https://github.com/shubham-raj-dev/urbanshift-project/blob/main/frontend/src/App.js): `frontend/src/App.js`
- [Property browsing](https://github.com/shubham-raj-dev/urbanshift-project/blob/main/frontend/src/components/Properties.js): `frontend/src/components/Properties.js`
- [Property details](https://github.com/shubham-raj-dev/urbanshift-project/blob/main/frontend/src/components/PropertyDetail.js): `frontend/src/components/PropertyDetail.js`
- [Create listing](https://github.com/shubham-raj-dev/urbanshift-project/blob/main/frontend/src/components/AddProperty.js): `frontend/src/components/AddProperty.js`
- [Seller dashboard](https://github.com/shubham-raj-dev/urbanshift-project/blob/main/frontend/src/components/SellerDashboard.js): `frontend/src/components/SellerDashboard.js`
- [Account screens](https://github.com/shubham-raj-dev/urbanshift-project/blob/main/frontend/src/components/Register.js): `frontend/src/components/Register.js`
- [Mover services](https://github.com/shubham-raj-dev/urbanshift-project/blob/main/frontend/src/components/PackersMovers.js): `frontend/src/components/PackersMovers.js`
- [Move booking](https://github.com/shubham-raj-dev/urbanshift-project/blob/main/frontend/src/components/BookMovers.js): `frontend/src/components/BookMovers.js`
- [Move history](https://github.com/shubham-raj-dev/urbanshift-project/blob/main/frontend/src/components/MyMoves.js): `frontend/src/components/MyMoves.js`
- [Company dashboard](https://github.com/shubham-raj-dev/urbanshift-project/blob/main/frontend/src/components/CompanyDashboard.js): `frontend/src/components/CompanyDashboard.js`
- [Live chat](https://github.com/shubham-raj-dev/urbanshift-project/blob/main/frontend/src/components/Chat.js): `frontend/src/components/Chat.js`
- [Theme preferences](https://github.com/shubham-raj-dev/urbanshift-project/blob/main/frontend/src/context/ThemeContext.js): `frontend/src/context/ThemeContext.js`

### Accounts

- [Authentication and profiles](https://github.com/shubham-raj-dev/urbanshift-project/blob/main/backend/users/views.py): `backend/users/views.py`
- [User records](https://github.com/shubham-raj-dev/urbanshift-project/blob/main/backend/users/models.py): `backend/users/models.py`
- [User serialization](https://github.com/shubham-raj-dev/urbanshift-project/blob/main/backend/users/serializers.py): `backend/users/serializers.py`
- [Email notifications](https://github.com/shubham-raj-dev/urbanshift-project/blob/main/backend/users/utils_email.py): `backend/users/utils_email.py`

### Property marketplace

- [Property listings and leads](https://github.com/shubham-raj-dev/urbanshift-project/blob/main/backend/properties/views.py): `backend/properties/views.py`
- [Property records](https://github.com/shubham-raj-dev/urbanshift-project/blob/main/backend/properties/models.py): `backend/properties/models.py`

### Relocation services

- [Move requests and reviews](https://github.com/shubham-raj-dev/urbanshift-project/blob/main/backend/relocation/views.py): `backend/relocation/views.py`
- [Move records](https://github.com/shubham-raj-dev/urbanshift-project/blob/main/backend/relocation/models.py): `backend/relocation/models.py`
- [WebSocket chat](https://github.com/shubham-raj-dev/urbanshift-project/blob/main/backend/chat/consumers.py): `backend/chat/consumers.py`
- [Chat socket routing](https://github.com/shubham-raj-dev/urbanshift-project/blob/main/backend/chat/routing.py): `backend/chat/routing.py`

### Platform services

- [Payment processing](https://github.com/shubham-raj-dev/urbanshift-project/blob/main/backend/payments/views.py): `backend/payments/views.py`
- [Transactions](https://github.com/shubham-raj-dev/urbanshift-project/blob/main/backend/payments/models.py): `backend/payments/models.py`

### Other components

- **Buyer, seller, renter**
- **Razorpay**
- **Firebase Google Auth**
- **Cloudinary image storage**
- **PostgreSQL**
- **Admin**

## Connections

- Buyer, seller, renter → React routes: uses (evidence: `README.md`)
- React routes → Theme preferences: provides theme (evidence: `frontend/src/App.js`)
- React routes → Property browsing: routes to (evidence: `frontend/src/App.js`)
- React routes → Property details: routes to (evidence: `frontend/src/App.js`)
- React routes → Create listing: routes to (evidence: `frontend/src/App.js`)
- React routes → Seller dashboard: routes to (evidence: `frontend/src/App.js`)
- React routes → Account screens: routes to (evidence: `frontend/src/App.js`)
- React routes → Mover services: routes to (evidence: `frontend/src/App.js`)
- React routes → Move booking: routes to (evidence: `frontend/src/App.js`)
- React routes → Move history: routes to (evidence: `frontend/src/App.js`)
- React routes → Company dashboard: routes to (evidence: `frontend/src/App.js`)
- React routes → Live chat: routes to (evidence: `frontend/src/App.js`)
- Property browsing → Property listings and leads: requests listings
- Property details → Property listings and leads: requests property
- Create listing → Property listings and leads: submits listing
- Seller dashboard → Property listings and leads: manages listings
- Move booking → Move requests and reviews: submits booking
- Move history → Move requests and reviews: reads bookings
- Company dashboard → Move requests and reviews: manages requests
- Live chat → WebSocket chat: opens chat
- Chat socket routing → WebSocket chat: routes socket (evidence: `backend/chat/routing.py`)
- Account screens → Firebase Google Auth: authenticates with
- Account screens → Authentication and profiles: posts Google token
- Authentication and profiles → User serialization: serializes users (evidence: `backend/users/views.py`)
- User serialization → User records: creates and updates (evidence: `backend/users/serializers.py`)
- Authentication and profiles → Email notifications: sends notifications (evidence: `backend/users/views.py`)
- Property listings and leads → Property records: reads and writes (evidence: `backend/properties/views.py`)
- Property listings and leads → Email notifications: notifies users (evidence: `backend/properties/views.py`)
- Move requests and reviews → Move records: reads and updates (evidence: `backend/relocation/views.py`)
- Move requests and reviews → Email notifications: sends notifications (evidence: `backend/relocation/views.py`)
- Property details → Payment processing: starts payment
- Payment processing → Razorpay: creates and verifies (evidence: `backend/payments/views.py`)
- Payment processing → Transactions: records payment (evidence: `backend/payments/views.py`)
- Payment processing → Move records: marks move paid (evidence: `backend/payments/views.py`)
- Payment processing → Property records: marks property sold (evidence: `backend/payments/views.py`)
- Payment processing → Email notifications: sends receipt notices (evidence: `backend/payments/views.py`)
- Create listing → Cloudinary image storage: uploads images
- Admin → Property records: reviews listings
- Admin → User records: verifies sellers
- User records → PostgreSQL: persists
- Property records → PostgreSQL: persists
- Move records → PostgreSQL: persists
- Transactions → PostgreSQL: persists
