# priyanshu-18-soni/societypro_mern architecture

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

- Interactive diagram: https://gitdiagram.com/priyanshu-18-soni/societypro_mern
- Repository: https://github.com/priyanshu-18-soni/societypro_mern

## Overview

SocietyPro is a multi-tenant residential-society management application for owners, committee members, and residents. Users register or sign in, then access role-protected society administration, resident and committee management, maintenance billing and payments, complaints, notices, and treasury views. The backend exposes corresponding API route families and controller-backed domain operations; payment processing integrates Razorpay and records captured income in the ledger. The supplied README is empty, so capability coverage comes from the route and frontend indexes. Some frontend pages and backend controllers were not sampled; their internal links are omitted where unsupported.

Main entry points: [`frontend/src/App.jsx`](https://github.com/priyanshu-18-soni/societypro_mern/blob/main/frontend/src/App.jsx) (Application routes), [`backend/server.js`](https://github.com/priyanshu-18-soni/societypro_mern/blob/main/backend/server.js) (HTTP server), [`backend/middleware`](https://github.com/priyanshu-18-soni/societypro_mern/tree/main/backend/middleware) (Tenant and access checks), [`backend/validations/schemas.js`](https://github.com/priyanshu-18-soni/societypro_mern/blob/main/backend/validations/schemas.js) (Request validation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_app["Application routes<br/>[App.jsx]"]
  node_api_client["API client<br/>[axiosInstance.js]"]
  node_dashboard["Dashboard<br/>[Dashboard.jsx]"]
end

subgraph group_identity["Identity and access"]
  node_auth_ui["Session context<br/>[AuthContext.jsx]"]
  node_protected["Route protection<br/>[ProtectedRoute.jsx]"]
  node_login["Login and registration<br/>[Login.jsx]"]
  node_pending["Pending approval"]
  node_server["HTTP server<br/>[server.js]"]
  node_auth_routes["Authentication routes<br/>[authRoutes.js]"]
  node_auth_controller["Authentication operations<br/>[authController.js]"]
  node_access["Tenant and access checks"]
  node_validation["Request validation<br/>[schemas.js]"]
end

subgraph group_administration["Society administration"]
  node_society_ui["Society management"]
  node_committee_ui["Committee management"]
  node_resident_ui["Resident management"]
  node_society_routes["Society routes<br/>[societyRoutes.js]"]
  node_society_controller["Society operations"]
  node_user_routes["Resident routes<br/>[userRoutes.js]"]
  node_user_controller["Resident operations<br/>[userController.js]"]
  node_committee_routes["Committee routes<br/>[committeeRoutes.js]"]
  node_committee_controller["Committee operations"]
end

subgraph group_community["Community services"]
  node_complaints_ui["Complaints<br/>[Complaints.jsx]"]
  node_notices_ui["Notices<br/>[Notices.jsx]"]
  node_complaint_routes["Complaint routes<br/>[complaintRoutes.js]"]
  node_complaint_controller["Complaint operations"]
  node_notice_routes["Notice routes<br/>[noticeRoutes.js]"]
  node_notice_controller["Notice operations"]
end

subgraph group_finance["Billing and treasury"]
  node_payments_ui["Payments<br/>[Payments.jsx]"]
  node_ledger_ui["Treasury ledger<br/>[Ledger.jsx]"]
  node_payment_routes["Payment routes<br/>[paymentRoutes.js]"]
  node_payment_controller["Billing and payment"]
  node_razorpay["Razorpay"]
  node_finance_routes["Finance routes<br/>[financeRoutes.js]"]
end

node_resident(("Society users"))

node_resident -->|"uses"| node_app
node_app -->|"provides session"| node_auth_ui
node_app -->|"guards routes"| node_protected
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_pending
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_society_ui
node_app -->|"routes to"| node_committee_ui
node_app -->|"routes to"| node_resident_ui
node_app -->|"routes to"| node_payments_ui
node_app -->|"routes to"| node_complaints_ui
node_app -->|"routes to"| node_notices_ui
node_app -->|"routes to"| node_ledger_ui
node_payments_ui -->|"uses"| node_api_client
node_society_ui -->|"uses"| node_api_client
node_server -->|"mounts"| node_auth_routes
node_server -->|"mounts"| node_society_routes
node_server -->|"mounts"| node_user_routes
node_server -->|"mounts"| node_committee_routes
node_server -->|"mounts"| node_complaint_routes
node_server -->|"mounts"| node_notice_routes
node_server -->|"mounts"| node_payment_routes
node_server -->|"mounts"| node_finance_routes
node_auth_routes -->|"dispatches"| node_auth_controller
node_auth_routes -->|"applies"| node_access
node_auth_routes -->|"validates with"| node_validation
node_society_routes -->|"dispatches"| node_society_controller
node_society_routes -->|"applies"| node_access
node_user_routes -->|"dispatches"| node_user_controller
node_user_routes -->|"applies"| node_access
node_committee_routes -->|"dispatches"| node_committee_controller
node_committee_routes -->|"applies"| node_access
node_committee_routes -->|"validates with"| node_validation
node_complaint_routes -->|"dispatches"| node_complaint_controller
node_complaint_routes -->|"applies"| node_access
node_complaint_routes -->|"validates with"| node_validation
node_notice_routes -->|"dispatches"| node_notice_controller
node_notice_routes -->|"applies"| node_access
node_notice_routes -->|"validates with"| node_validation
node_payment_routes -->|"dispatches"| node_payment_controller
node_payment_routes -->|"applies"| node_access
node_payment_routes -->|"validates with"| node_validation
node_payment_controller -->|"creates orders"| node_razorpay
node_finance_routes -->|"applies"| node_access

click node_app "https://github.com/priyanshu-18-soni/societypro_mern/blob/main/frontend/src/App.jsx"
click node_auth_ui "https://github.com/priyanshu-18-soni/societypro_mern/blob/main/frontend/src/context/AuthContext.jsx"
click node_protected "https://github.com/priyanshu-18-soni/societypro_mern/blob/main/frontend/src/components/ProtectedRoute.jsx"
click node_api_client "https://github.com/priyanshu-18-soni/societypro_mern/blob/main/frontend/src/api/axiosInstance.js"
click node_login "https://github.com/priyanshu-18-soni/societypro_mern/blob/main/frontend/src/pages/Login.jsx"
click node_pending "https://github.com/priyanshu-18-soni/societypro_mern/blob/main/frontend/src/pages/PendingApproval.jsx"
click node_dashboard "https://github.com/priyanshu-18-soni/societypro_mern/blob/main/frontend/src/pages/Dashboard.jsx"
click node_society_ui "https://github.com/priyanshu-18-soni/societypro_mern/blob/main/frontend/src/pages/SocietyManagement.jsx"
click node_committee_ui "https://github.com/priyanshu-18-soni/societypro_mern/blob/main/frontend/src/pages/CommitteeManagement.jsx"
click node_resident_ui "https://github.com/priyanshu-18-soni/societypro_mern/blob/main/frontend/src/pages/ResidentManagement.jsx"
click node_payments_ui "https://github.com/priyanshu-18-soni/societypro_mern/blob/main/frontend/src/pages/Payments.jsx"
click node_complaints_ui "https://github.com/priyanshu-18-soni/societypro_mern/blob/main/frontend/src/pages/Complaints.jsx"
click node_notices_ui "https://github.com/priyanshu-18-soni/societypro_mern/blob/main/frontend/src/pages/Notices.jsx"
click node_ledger_ui "https://github.com/priyanshu-18-soni/societypro_mern/blob/main/frontend/src/pages/Ledger.jsx"
click node_server "https://github.com/priyanshu-18-soni/societypro_mern/blob/main/backend/server.js"
click node_auth_routes "https://github.com/priyanshu-18-soni/societypro_mern/blob/main/backend/routes/authRoutes.js"
click node_auth_controller "https://github.com/priyanshu-18-soni/societypro_mern/blob/main/backend/controllers/authController.js"
click node_access "https://github.com/priyanshu-18-soni/societypro_mern/tree/main/backend/middleware"
click node_validation "https://github.com/priyanshu-18-soni/societypro_mern/blob/main/backend/validations/schemas.js"
click node_society_routes "https://github.com/priyanshu-18-soni/societypro_mern/blob/main/backend/routes/societyRoutes.js"
click node_society_controller "https://github.com/priyanshu-18-soni/societypro_mern/blob/main/backend/controllers/societyController.js"
click node_user_routes "https://github.com/priyanshu-18-soni/societypro_mern/blob/main/backend/routes/userRoutes.js"
click node_user_controller "https://github.com/priyanshu-18-soni/societypro_mern/blob/main/backend/controllers/userController.js"
click node_committee_routes "https://github.com/priyanshu-18-soni/societypro_mern/blob/main/backend/routes/committeeRoutes.js"
click node_committee_controller "https://github.com/priyanshu-18-soni/societypro_mern/blob/main/backend/controllers/committeeController.js"
click node_complaint_routes "https://github.com/priyanshu-18-soni/societypro_mern/blob/main/backend/routes/complaintRoutes.js"
click node_complaint_controller "https://github.com/priyanshu-18-soni/societypro_mern/blob/main/backend/controllers/complaintController.js"
click node_notice_routes "https://github.com/priyanshu-18-soni/societypro_mern/blob/main/backend/routes/noticeRoutes.js"
click node_notice_controller "https://github.com/priyanshu-18-soni/societypro_mern/blob/main/backend/controllers/noticeController.js"
click node_payment_routes "https://github.com/priyanshu-18-soni/societypro_mern/blob/main/backend/routes/paymentRoutes.js"
click node_payment_controller "https://github.com/priyanshu-18-soni/societypro_mern/blob/main/backend/controllers/paymentController.js"
click node_finance_routes "https://github.com/priyanshu-18-soni/societypro_mern/blob/main/backend/routes/financeRoutes.js"

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_api_client,node_dashboard,node_resident toneBlue
class node_auth_ui,node_protected,node_login,node_pending,node_server,node_auth_routes,node_auth_controller,node_access,node_validation toneAmber
class node_society_ui,node_committee_ui,node_resident_ui,node_society_routes,node_society_controller,node_user_routes,node_user_controller,node_committee_routes,node_committee_controller toneMint
class node_complaints_ui,node_notices_ui,node_complaint_routes,node_complaint_controller,node_notice_routes,node_notice_controller toneRose
class node_payments_ui,node_ledger_ui,node_payment_routes,node_payment_controller,node_razorpay,node_finance_routes toneIndigo
```

## Components

### Web application

- [Application routes](https://github.com/priyanshu-18-soni/societypro_mern/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [API client](https://github.com/priyanshu-18-soni/societypro_mern/blob/main/frontend/src/api/axiosInstance.js): `frontend/src/api/axiosInstance.js`
- [Dashboard](https://github.com/priyanshu-18-soni/societypro_mern/blob/main/frontend/src/pages/Dashboard.jsx): `frontend/src/pages/Dashboard.jsx`

### Identity and access

- [Session context](https://github.com/priyanshu-18-soni/societypro_mern/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [Route protection](https://github.com/priyanshu-18-soni/societypro_mern/blob/main/frontend/src/components/ProtectedRoute.jsx): `frontend/src/components/ProtectedRoute.jsx`
- [Login and registration](https://github.com/priyanshu-18-soni/societypro_mern/blob/main/frontend/src/pages/Login.jsx): `frontend/src/pages/Login.jsx`
- [Pending approval](https://github.com/priyanshu-18-soni/societypro_mern/blob/main/frontend/src/pages/PendingApproval.jsx): `frontend/src/pages/PendingApproval.jsx`
- [HTTP server](https://github.com/priyanshu-18-soni/societypro_mern/blob/main/backend/server.js): `backend/server.js`
- [Authentication routes](https://github.com/priyanshu-18-soni/societypro_mern/blob/main/backend/routes/authRoutes.js): `backend/routes/authRoutes.js`
- [Authentication operations](https://github.com/priyanshu-18-soni/societypro_mern/blob/main/backend/controllers/authController.js): `backend/controllers/authController.js`
- [Tenant and access checks](https://github.com/priyanshu-18-soni/societypro_mern/tree/main/backend/middleware): `backend/middleware`
- [Request validation](https://github.com/priyanshu-18-soni/societypro_mern/blob/main/backend/validations/schemas.js): `backend/validations/schemas.js`

### Society administration

- [Society management](https://github.com/priyanshu-18-soni/societypro_mern/blob/main/frontend/src/pages/SocietyManagement.jsx): `frontend/src/pages/SocietyManagement.jsx`
- [Committee management](https://github.com/priyanshu-18-soni/societypro_mern/blob/main/frontend/src/pages/CommitteeManagement.jsx): `frontend/src/pages/CommitteeManagement.jsx`
- [Resident management](https://github.com/priyanshu-18-soni/societypro_mern/blob/main/frontend/src/pages/ResidentManagement.jsx): `frontend/src/pages/ResidentManagement.jsx`
- [Society routes](https://github.com/priyanshu-18-soni/societypro_mern/blob/main/backend/routes/societyRoutes.js): `backend/routes/societyRoutes.js`
- [Society operations](https://github.com/priyanshu-18-soni/societypro_mern/blob/main/backend/controllers/societyController.js): `backend/controllers/societyController.js`
- [Resident routes](https://github.com/priyanshu-18-soni/societypro_mern/blob/main/backend/routes/userRoutes.js): `backend/routes/userRoutes.js`
- [Resident operations](https://github.com/priyanshu-18-soni/societypro_mern/blob/main/backend/controllers/userController.js): `backend/controllers/userController.js`
- [Committee routes](https://github.com/priyanshu-18-soni/societypro_mern/blob/main/backend/routes/committeeRoutes.js): `backend/routes/committeeRoutes.js`
- [Committee operations](https://github.com/priyanshu-18-soni/societypro_mern/blob/main/backend/controllers/committeeController.js): `backend/controllers/committeeController.js`

### Community services

- [Complaints](https://github.com/priyanshu-18-soni/societypro_mern/blob/main/frontend/src/pages/Complaints.jsx): `frontend/src/pages/Complaints.jsx`
- [Notices](https://github.com/priyanshu-18-soni/societypro_mern/blob/main/frontend/src/pages/Notices.jsx): `frontend/src/pages/Notices.jsx`
- [Complaint routes](https://github.com/priyanshu-18-soni/societypro_mern/blob/main/backend/routes/complaintRoutes.js): `backend/routes/complaintRoutes.js`
- [Complaint operations](https://github.com/priyanshu-18-soni/societypro_mern/blob/main/backend/controllers/complaintController.js): `backend/controllers/complaintController.js`
- [Notice routes](https://github.com/priyanshu-18-soni/societypro_mern/blob/main/backend/routes/noticeRoutes.js): `backend/routes/noticeRoutes.js`
- [Notice operations](https://github.com/priyanshu-18-soni/societypro_mern/blob/main/backend/controllers/noticeController.js): `backend/controllers/noticeController.js`

### Billing and treasury

- [Payments](https://github.com/priyanshu-18-soni/societypro_mern/blob/main/frontend/src/pages/Payments.jsx): `frontend/src/pages/Payments.jsx`
- [Treasury ledger](https://github.com/priyanshu-18-soni/societypro_mern/blob/main/frontend/src/pages/Ledger.jsx): `frontend/src/pages/Ledger.jsx`
- [Payment routes](https://github.com/priyanshu-18-soni/societypro_mern/blob/main/backend/routes/paymentRoutes.js): `backend/routes/paymentRoutes.js`
- [Billing and payment](https://github.com/priyanshu-18-soni/societypro_mern/blob/main/backend/controllers/paymentController.js): `backend/controllers/paymentController.js`
- **Razorpay**
- [Finance routes](https://github.com/priyanshu-18-soni/societypro_mern/blob/main/backend/routes/financeRoutes.js): `backend/routes/financeRoutes.js`

### Other components

- **Society users**

## Connections

- Society users → Application routes: uses (evidence: `frontend/src/App.jsx`)
- Application routes → Session context: provides session (evidence: `frontend/src/App.jsx`)
- Application routes → Route protection: guards routes (evidence: `frontend/src/App.jsx`)
- Application routes → Login and registration: routes to (evidence: `frontend/src/App.jsx`)
- Application routes → Pending approval: routes to (evidence: `frontend/src/App.jsx`)
- Application routes → Dashboard: routes to (evidence: `frontend/src/App.jsx`)
- Application routes → Society management: routes to (evidence: `frontend/src/App.jsx`)
- Application routes → Committee management: routes to (evidence: `frontend/src/App.jsx`)
- Application routes → Resident management: routes to (evidence: `frontend/src/App.jsx`)
- Application routes → Payments: routes to (evidence: `frontend/src/App.jsx`)
- Application routes → Complaints: routes to (evidence: `frontend/src/App.jsx`)
- Application routes → Notices: routes to (evidence: `frontend/src/App.jsx`)
- Application routes → Treasury ledger: routes to (evidence: `frontend/src/App.jsx`)
- Payments → API client: uses (evidence: `frontend/src/pages/Payments.jsx`)
- Society management → API client: uses (evidence: `frontend/src/pages/SocietyManagement.jsx`)
- HTTP server → Authentication routes: mounts (evidence: `backend/server.js`)
- HTTP server → Society routes: mounts (evidence: `backend/server.js`)
- HTTP server → Resident routes: mounts (evidence: `backend/server.js`)
- HTTP server → Committee routes: mounts (evidence: `backend/server.js`)
- HTTP server → Complaint routes: mounts (evidence: `backend/server.js`)
- HTTP server → Notice routes: mounts (evidence: `backend/server.js`)
- HTTP server → Payment routes: mounts (evidence: `backend/server.js`)
- HTTP server → Finance routes: mounts (evidence: `backend/server.js`)
- Authentication routes → Authentication operations: dispatches (evidence: `backend/routes/authRoutes.js`)
- Authentication routes → Tenant and access checks: applies (evidence: `backend/routes/authRoutes.js`)
- Authentication routes → Request validation: validates with (evidence: `backend/routes/authRoutes.js`)
- Society routes → Society operations: dispatches (evidence: `backend/routes/societyRoutes.js`)
- Society routes → Tenant and access checks: applies (evidence: `backend/routes/societyRoutes.js`)
- Resident routes → Resident operations: dispatches (evidence: `backend/routes/userRoutes.js`)
- Resident routes → Tenant and access checks: applies (evidence: `backend/routes/userRoutes.js`)
- Committee routes → Committee operations: dispatches (evidence: `backend/routes/committeeRoutes.js`)
- Committee routes → Tenant and access checks: applies (evidence: `backend/routes/committeeRoutes.js`)
- Committee routes → Request validation: validates with (evidence: `backend/routes/committeeRoutes.js`)
- Complaint routes → Complaint operations: dispatches (evidence: `backend/routes/complaintRoutes.js`)
- Complaint routes → Tenant and access checks: applies (evidence: `backend/routes/complaintRoutes.js`)
- Complaint routes → Request validation: validates with (evidence: `backend/routes/complaintRoutes.js`)
- Notice routes → Notice operations: dispatches (evidence: `backend/routes/noticeRoutes.js`)
- Notice routes → Tenant and access checks: applies (evidence: `backend/routes/noticeRoutes.js`)
- Notice routes → Request validation: validates with (evidence: `backend/routes/noticeRoutes.js`)
- Payment routes → Billing and payment: dispatches (evidence: `backend/routes/paymentRoutes.js`)
- Payment routes → Tenant and access checks: applies (evidence: `backend/routes/paymentRoutes.js`)
- Payment routes → Request validation: validates with (evidence: `backend/routes/paymentRoutes.js`)
- Billing and payment → Razorpay: creates orders (evidence: `backend/controllers/paymentController.js`)
- Finance routes → Tenant and access checks: applies (evidence: `backend/routes/financeRoutes.js`)
