# rupa3670/real-estate-server architecture

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

- Interactive diagram: https://gitdiagram.com/rupa3670/real-estate-server
- Repository: https://github.com/rupa3670/real-estate-server

## Overview

This is a Real Estate Server API for managing users and project operations. The principal workflow is an authenticated client request routed through Express, checked by authentication/role middleware, handled by a controller and service, and answered from domain data. The code excerpts confirm this flow for authentication and engineer management; the source index documents the other route and service modules, but their internal behavior is not fully shown. The README is empty, so capability coverage and relationships are based on the source index and excerpts.

Main entry points: [`src/server.ts`](https://github.com/rupa3670/real-estate-server/blob/main/src/server.ts) (Express Server), [`src/middleware/auth.ts`](https://github.com/rupa3670/real-estate-server/blob/main/src/middleware/auth.ts) (Auth and Roles), [`src/routers/auth.routers.ts`](https://github.com/rupa3670/real-estate-server/blob/main/src/routers/auth.routers.ts) (Auth Routes), [`src/models/User.ts`](https://github.com/rupa3670/real-estate-server/blob/main/src/models/User.ts) (User Records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API Layer"]
  node_server["Express Server<br/>[server.ts]"]
  node_authroutes["Auth Routes<br/>[auth.routers.ts]"]
  node_useroutes["User Routes<br/>[user.routers.ts]"]
  node_dashroutes["Dashboard Routes"]
  node_projectroutes["Project Routes<br/>[project.routers.ts]"]
  node_fundroutes["Fund Request Routes"]
  node_expenseroutes["Expense Routes<br/>[expense.routers.ts]"]
  node_paymentroutes["Payment Routes<br/>[payment.router.ts]"]
  node_engineerroutes["Engineer Routes<br/>[engineer.router.ts]"]
  node_masonroutes["Mason Routes<br/>[meson.router.ts]"]
end

subgraph group_identity["Identity and Access"]
  node_auth["Authentication<br/>[auth.service.ts]"]
  node_authguard["Auth and Roles<br/>[auth.ts]"]
  node_userservice["User Management<br/>[user.service.ts]"]
end

subgraph group_operations["Project Operations"]
  node_dashboard["Dashboard"]
  node_projects["Project Management<br/>[project.service.ts]"]
  node_engineers["Engineer Management<br/>[enginer.service.ts]"]
  node_masons["Mason Management<br/>[mason.service.ts]"]
end

subgraph group_finance["Finance and Workforce"]
  node_funds["Fund Requests"]
  node_expenses["Expense Management<br/>[expense.service.ts]"]
  node_payments["Payments<br/>[payment.service.ts]"]
end

subgraph group_data["Domain Data"]
  node_userdb[("User Records<br/>[User.ts]")]
  node_projectdb[("Project Records<br/>[Projects.ts]")]
  node_funddb[("Fund Request Records<br/>[FundRequest.ts]")]
  node_expensedb[("Expense Records<br/>[Expense.ts]")]
  node_paymentdb[("Payment Records<br/>[Payment.ts]")]
  node_engineerdb[("Engineer Records<br/>[Engineer.ts]")]
  node_masondb[("Mason Records<br/>[Mason.ts]")]
end

node_client(("API Client"))

node_client -->|"sends requests"| node_server
node_server -->|"mounts auth"| node_authroutes
node_server -->|"mounts users"| node_useroutes
node_server -->|"mounts dashboard"| node_dashroutes
node_server -->|"mounts projects"| node_projectroutes
node_server -->|"mounts requests"| node_fundroutes
node_server -->|"mounts expenses"| node_expenseroutes
node_server -->|"mounts payments"| node_paymentroutes
node_server -->|"mounts engineers"| node_engineerroutes
node_server -->|"mounts masons"| node_masonroutes
node_authroutes -->|"routes login"| node_auth
node_authroutes -->|"guards profile"| node_authguard
node_useroutes -->|"applies auth"| node_authguard
node_dashroutes -->|"applies auth"| node_authguard
node_projectroutes -->|"applies auth"| node_authguard
node_fundroutes -->|"applies auth"| node_authguard
node_expenseroutes -->|"applies auth"| node_authguard
node_paymentroutes -->|"applies auth"| node_authguard
node_engineerroutes -->|"applies roles"| node_authguard
node_masonroutes -->|"applies auth"| node_authguard
node_auth -->|"reads users"| node_userdb
node_authguard -->|"checks account"| node_userdb
node_userservice -->|"manages records"| node_userdb
node_funds -->|"reads and writes"| node_funddb
node_funds -->|"checks projects"| node_projectdb
node_expenses -->|"reads and writes"| node_expensedb
node_expenses -->|"checks projects"| node_projectdb
node_payments -->|"reads and writes"| node_paymentdb
node_payments -->|"checks requests"| node_funddb
node_engineers -->|"manages records"| node_engineerdb
node_masons -->|"manages records"| node_masondb

click node_server "https://github.com/rupa3670/real-estate-server/blob/main/src/server.ts"
click node_authroutes "https://github.com/rupa3670/real-estate-server/blob/main/src/routers/auth.routers.ts"
click node_useroutes "https://github.com/rupa3670/real-estate-server/blob/main/src/routers/user.routers.ts"
click node_dashroutes "https://github.com/rupa3670/real-estate-server/blob/main/src/routers/dashboard.routers.ts"
click node_projectroutes "https://github.com/rupa3670/real-estate-server/blob/main/src/routers/project.routers.ts"
click node_fundroutes "https://github.com/rupa3670/real-estate-server/blob/main/src/routers/fundRequest.routers.ts"
click node_expenseroutes "https://github.com/rupa3670/real-estate-server/blob/main/src/routers/expense.routers.ts"
click node_paymentroutes "https://github.com/rupa3670/real-estate-server/blob/main/src/routers/payment.router.ts"
click node_engineerroutes "https://github.com/rupa3670/real-estate-server/blob/main/src/routers/engineer.router.ts"
click node_masonroutes "https://github.com/rupa3670/real-estate-server/blob/main/src/routers/meson.router.ts"
click node_auth "https://github.com/rupa3670/real-estate-server/blob/main/src/services/auth.service.ts"
click node_authguard "https://github.com/rupa3670/real-estate-server/blob/main/src/middleware/auth.ts"
click node_userservice "https://github.com/rupa3670/real-estate-server/blob/main/src/services/user.service.ts"
click node_dashboard "https://github.com/rupa3670/real-estate-server/blob/main/src/services/dashboard.service.ts"
click node_projects "https://github.com/rupa3670/real-estate-server/blob/main/src/services/project.service.ts"
click node_funds "https://github.com/rupa3670/real-estate-server/blob/main/src/services/fundRequest.service.ts"
click node_expenses "https://github.com/rupa3670/real-estate-server/blob/main/src/services/expense.service.ts"
click node_payments "https://github.com/rupa3670/real-estate-server/blob/main/src/services/payment.service.ts"
click node_engineers "https://github.com/rupa3670/real-estate-server/blob/main/src/services/enginer.service.ts"
click node_masons "https://github.com/rupa3670/real-estate-server/blob/main/src/services/mason.service.ts"
click node_userdb "https://github.com/rupa3670/real-estate-server/blob/main/src/models/User.ts"
click node_projectdb "https://github.com/rupa3670/real-estate-server/blob/main/src/models/Projects.ts"
click node_funddb "https://github.com/rupa3670/real-estate-server/blob/main/src/models/FundRequest.ts"
click node_expensedb "https://github.com/rupa3670/real-estate-server/blob/main/src/models/Expense.ts"
click node_paymentdb "https://github.com/rupa3670/real-estate-server/blob/main/src/models/Payment.ts"
click node_engineerdb "https://github.com/rupa3670/real-estate-server/blob/main/src/models/Engineer.ts"
click node_masondb "https://github.com/rupa3670/real-estate-server/blob/main/src/models/Mason.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_server,node_authroutes,node_useroutes,node_dashroutes,node_projectroutes,node_fundroutes,node_expenseroutes,node_paymentroutes,node_engineerroutes,node_masonroutes,node_client toneBlue
class node_auth,node_authguard,node_userservice toneAmber
class node_dashboard,node_projects,node_engineers,node_masons toneMint
class node_funds,node_expenses,node_payments toneRose
class node_userdb,node_projectdb,node_funddb,node_expensedb,node_paymentdb,node_engineerdb,node_masondb toneIndigo
```

## Components

### API Layer

- [Express Server](https://github.com/rupa3670/real-estate-server/blob/main/src/server.ts): `src/server.ts`
- [Auth Routes](https://github.com/rupa3670/real-estate-server/blob/main/src/routers/auth.routers.ts): `src/routers/auth.routers.ts`
- [User Routes](https://github.com/rupa3670/real-estate-server/blob/main/src/routers/user.routers.ts): `src/routers/user.routers.ts`
- [Dashboard Routes](https://github.com/rupa3670/real-estate-server/blob/main/src/routers/dashboard.routers.ts): `src/routers/dashboard.routers.ts`
- [Project Routes](https://github.com/rupa3670/real-estate-server/blob/main/src/routers/project.routers.ts): `src/routers/project.routers.ts`
- [Fund Request Routes](https://github.com/rupa3670/real-estate-server/blob/main/src/routers/fundRequest.routers.ts): `src/routers/fundRequest.routers.ts`
- [Expense Routes](https://github.com/rupa3670/real-estate-server/blob/main/src/routers/expense.routers.ts): `src/routers/expense.routers.ts`
- [Payment Routes](https://github.com/rupa3670/real-estate-server/blob/main/src/routers/payment.router.ts): `src/routers/payment.router.ts`
- [Engineer Routes](https://github.com/rupa3670/real-estate-server/blob/main/src/routers/engineer.router.ts): `src/routers/engineer.router.ts`
- [Mason Routes](https://github.com/rupa3670/real-estate-server/blob/main/src/routers/meson.router.ts): `src/routers/meson.router.ts`

### Identity and Access

- [Authentication](https://github.com/rupa3670/real-estate-server/blob/main/src/services/auth.service.ts): `src/services/auth.service.ts`
- [Auth and Roles](https://github.com/rupa3670/real-estate-server/blob/main/src/middleware/auth.ts): `src/middleware/auth.ts`
- [User Management](https://github.com/rupa3670/real-estate-server/blob/main/src/services/user.service.ts): `src/services/user.service.ts`

### Project Operations

- [Dashboard](https://github.com/rupa3670/real-estate-server/blob/main/src/services/dashboard.service.ts): `src/services/dashboard.service.ts`
- [Project Management](https://github.com/rupa3670/real-estate-server/blob/main/src/services/project.service.ts): `src/services/project.service.ts`
- [Engineer Management](https://github.com/rupa3670/real-estate-server/blob/main/src/services/enginer.service.ts): `src/services/enginer.service.ts`
- [Mason Management](https://github.com/rupa3670/real-estate-server/blob/main/src/services/mason.service.ts): `src/services/mason.service.ts`

### Finance and Workforce

- [Fund Requests](https://github.com/rupa3670/real-estate-server/blob/main/src/services/fundRequest.service.ts): `src/services/fundRequest.service.ts`
- [Expense Management](https://github.com/rupa3670/real-estate-server/blob/main/src/services/expense.service.ts): `src/services/expense.service.ts`
- [Payments](https://github.com/rupa3670/real-estate-server/blob/main/src/services/payment.service.ts): `src/services/payment.service.ts`

### Domain Data

- [User Records](https://github.com/rupa3670/real-estate-server/blob/main/src/models/User.ts): `src/models/User.ts`
- [Project Records](https://github.com/rupa3670/real-estate-server/blob/main/src/models/Projects.ts): `src/models/Projects.ts`
- [Fund Request Records](https://github.com/rupa3670/real-estate-server/blob/main/src/models/FundRequest.ts): `src/models/FundRequest.ts`
- [Expense Records](https://github.com/rupa3670/real-estate-server/blob/main/src/models/Expense.ts): `src/models/Expense.ts`
- [Payment Records](https://github.com/rupa3670/real-estate-server/blob/main/src/models/Payment.ts): `src/models/Payment.ts`
- [Engineer Records](https://github.com/rupa3670/real-estate-server/blob/main/src/models/Engineer.ts): `src/models/Engineer.ts`
- [Mason Records](https://github.com/rupa3670/real-estate-server/blob/main/src/models/Mason.ts): `src/models/Mason.ts`

### Other components

- **API Client**

## Connections

- API Client → Express Server: sends requests (evidence: `src/server.ts`)
- Express Server → Auth Routes: mounts auth (evidence: `src/server.ts`)
- Express Server → User Routes: mounts users (evidence: `src/server.ts`)
- Express Server → Dashboard Routes: mounts dashboard (evidence: `src/server.ts`)
- Express Server → Project Routes: mounts projects (evidence: `src/server.ts`)
- Express Server → Fund Request Routes: mounts requests (evidence: `src/server.ts`)
- Express Server → Expense Routes: mounts expenses (evidence: `src/server.ts`)
- Express Server → Payment Routes: mounts payments (evidence: `src/server.ts`)
- Express Server → Engineer Routes: mounts engineers (evidence: `src/server.ts`)
- Express Server → Mason Routes: mounts masons (evidence: `src/server.ts`)
- Auth Routes → Authentication: routes login (evidence: `src/routers/auth.routers.ts`)
- Auth Routes → Auth and Roles: guards profile (evidence: `src/routers/auth.routers.ts`)
- User Routes → Auth and Roles: applies auth (evidence: `src/routers/user.routers.ts`)
- Dashboard Routes → Auth and Roles: applies auth (evidence: `src/routers/dashboard.routers.ts`)
- Project Routes → Auth and Roles: applies auth (evidence: `src/routers/project.routers.ts`)
- Fund Request Routes → Auth and Roles: applies auth (evidence: `src/routers/fundRequest.routers.ts`)
- Expense Routes → Auth and Roles: applies auth (evidence: `src/routers/expense.routers.ts`)
- Payment Routes → Auth and Roles: applies auth (evidence: `src/routers/payment.router.ts`)
- Engineer Routes → Auth and Roles: applies roles (evidence: `src/routers/engineer.router.ts`)
- Mason Routes → Auth and Roles: applies auth (evidence: `src/routers/meson.router.ts`)
- Authentication → User Records: reads users (evidence: `src/services/auth.service.ts`)
- Auth and Roles → User Records: checks account (evidence: `src/middleware/auth.ts`)
- User Management → User Records: manages records (evidence: `src/services/user.service.ts`)
- Fund Requests → Fund Request Records: reads and writes (evidence: `src/services/fundRequest.service.ts`)
- Fund Requests → Project Records: checks projects (evidence: `src/services/fundRequest.service.ts`)
- Expense Management → Expense Records: reads and writes (evidence: `src/services/expense.service.ts`)
- Expense Management → Project Records: checks projects (evidence: `src/services/expense.service.ts`)
- Payments → Payment Records: reads and writes (evidence: `src/services/payment.service.ts`)
- Payments → Fund Request Records: checks requests (evidence: `src/services/payment.service.ts`)
- Engineer Management → Engineer Records: manages records (evidence: `src/services/enginer.service.ts`)
- Mason Management → Mason Records: manages records (evidence: `src/services/mason.service.ts`)
