# ph-tejas/backend architecture

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

- Interactive diagram: https://gitdiagram.com/ph-tejas/backend
- Repository: https://github.com/ph-tejas/backend

## Overview

This is a blood-donation platform backend: hospitals create requests, the service finds nearby compatible donors, notifies them in real time, and records donor responses or completed donations. Authentication supports both donors and hospitals; separate APIs manage profiles, availability, hospital listings, and emergency requests. MongoDB models hold users, hospitals, and requests, while startup connects the database and seeds sample accounts. The README is empty; relationships below are limited to the sampled source and SOURCE INDEX references.

Main entry points: [`server.js`](https://github.com/ph-tejas/backend/blob/main/server.js) (HTTP and sockets), [`routes/bloodRequests.js`](https://github.com/ph-tejas/backend/blob/main/routes/bloodRequests.js) (Request matching and response), [`middleware/auth.js`](https://github.com/ph-tejas/backend/blob/main/middleware/auth.js) (Token authentication), [`models/User.js`](https://github.com/ph-tejas/backend/blob/main/models/User.js) (Donor records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["API and startup"]
  node_api["HTTP and sockets<br/>[server.js]"]
  node_database_config["Database connection<br/>[database.js]"]
  node_seed["Sample data seeding<br/>[start-with-data.js]"]
end

subgraph group_identity["Identity and profiles"]
  node_auth_routes["Registration and login<br/>[auth.js]"]
  node_auth_middleware["Token authentication<br/>[auth.js]"]
  node_user_routes["Donor profiles<br/>[users.js]"]
  node_hospital_routes["Hospital profiles and directory<br/>[hospitals.js]"]
end

subgraph group_donation["Donation workflows"]
  node_request_routes["Request matching and response<br/>[bloodRequests.js]"]
end

subgraph group_data["Persistence"]
  node_user_model[("Donor records<br/>[User.js]")]
  node_hospital_model[("Hospital records<br/>[Hospital.js]")]
  node_request_model[("Blood request records<br/>[BloodRequest.js]")]
end

node_donor(("Donor"))
node_hospital_actor(("Hospital"))
node_mongo[("MongoDB")]

node_donor -.->|"uses API"| node_api
node_hospital_actor -.->|"uses API"| node_api
node_api -->|"connects database"| node_database_config
node_api -->|"mounts routes"| node_auth_routes
node_api -->|"mounts routes"| node_user_routes
node_api -->|"mounts routes"| node_hospital_routes
node_api -->|"mounts routes"| node_request_routes
node_api -->|"seeds data"| node_seed
node_database_config -->|"connects to"| node_mongo
node_seed -->|"creates records"| node_user_model
node_seed -->|"creates records"| node_hospital_model
node_auth_routes -->|"reads and writes"| node_user_model
node_auth_routes -->|"reads and writes"| node_hospital_model
node_auth_routes -->|"checks identity"| node_auth_middleware
node_auth_middleware -->|"looks up donor"| node_user_model
node_auth_middleware -->|"looks up hospital"| node_hospital_model
node_user_routes -->|"protects routes"| node_auth_middleware
node_user_routes -->|"reads and updates"| node_user_model
node_hospital_routes -->|"protects routes"| node_auth_middleware
node_hospital_routes -->|"reads and updates"| node_hospital_model
node_request_routes -->|"protects routes"| node_auth_middleware
node_request_routes -->|"creates and updates"| node_request_model
node_request_routes -->|"matches donors"| node_user_model
node_request_routes -->|"loads hospital"| node_hospital_model
node_request_routes -->|"emits notifications"| node_api

click node_api "https://github.com/ph-tejas/backend/blob/main/server.js"
click node_database_config "https://github.com/ph-tejas/backend/blob/main/config/database.js"
click node_seed "https://github.com/ph-tejas/backend/blob/main/start-with-data.js"
click node_auth_routes "https://github.com/ph-tejas/backend/blob/main/routes/auth.js"
click node_auth_middleware "https://github.com/ph-tejas/backend/blob/main/middleware/auth.js"
click node_user_routes "https://github.com/ph-tejas/backend/blob/main/routes/users.js"
click node_hospital_routes "https://github.com/ph-tejas/backend/blob/main/routes/hospitals.js"
click node_user_model "https://github.com/ph-tejas/backend/blob/main/models/User.js"
click node_hospital_model "https://github.com/ph-tejas/backend/blob/main/models/Hospital.js"
click node_request_model "https://github.com/ph-tejas/backend/blob/main/models/BloodRequest.js"
click node_request_routes "https://github.com/ph-tejas/backend/blob/main/routes/bloodRequests.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_api,node_database_config,node_seed toneBlue
class node_auth_routes,node_auth_middleware,node_user_routes,node_hospital_routes,node_mongo toneAmber
class node_request_routes toneMint
class node_user_model,node_hospital_model,node_request_model toneRose
class node_donor,node_hospital_actor toneIndigo
```

## Components

### API and startup

- [HTTP and sockets](https://github.com/ph-tejas/backend/blob/main/server.js): `server.js`
- [Database connection](https://github.com/ph-tejas/backend/blob/main/config/database.js): `config/database.js`
- [Sample data seeding](https://github.com/ph-tejas/backend/blob/main/start-with-data.js): `start-with-data.js`

### Identity and profiles

- [Registration and login](https://github.com/ph-tejas/backend/blob/main/routes/auth.js): `routes/auth.js`
- [Token authentication](https://github.com/ph-tejas/backend/blob/main/middleware/auth.js): `middleware/auth.js`
- [Donor profiles](https://github.com/ph-tejas/backend/blob/main/routes/users.js): `routes/users.js`
- [Hospital profiles and directory](https://github.com/ph-tejas/backend/blob/main/routes/hospitals.js): `routes/hospitals.js`

### Donation workflows

- [Request matching and response](https://github.com/ph-tejas/backend/blob/main/routes/bloodRequests.js): `routes/bloodRequests.js`

### Persistence

- [Donor records](https://github.com/ph-tejas/backend/blob/main/models/User.js): `models/User.js`
- [Hospital records](https://github.com/ph-tejas/backend/blob/main/models/Hospital.js): `models/Hospital.js`
- [Blood request records](https://github.com/ph-tejas/backend/blob/main/models/BloodRequest.js): `models/BloodRequest.js`

### Other components

- **Donor**
- **Hospital**
- **MongoDB**

## Connections

- Donor → HTTP and sockets: uses API
- Hospital → HTTP and sockets: uses API
- HTTP and sockets → Database connection: connects database (evidence: `server.js`)
- HTTP and sockets → Registration and login: mounts routes (evidence: `server.js`)
- HTTP and sockets → Donor profiles: mounts routes (evidence: `server.js`)
- HTTP and sockets → Hospital profiles and directory: mounts routes (evidence: `server.js`)
- HTTP and sockets → Request matching and response: mounts routes (evidence: `server.js`)
- HTTP and sockets → Sample data seeding: seeds data (evidence: `server.js`)
- Database connection → MongoDB: connects to (evidence: `config/database.js`)
- Sample data seeding → Donor records: creates records (evidence: `start-with-data.js`)
- Sample data seeding → Hospital records: creates records (evidence: `start-with-data.js`)
- Registration and login → Donor records: reads and writes (evidence: `routes/auth.js`)
- Registration and login → Hospital records: reads and writes (evidence: `routes/auth.js`)
- Registration and login → Token authentication: checks identity (evidence: `routes/auth.js`)
- Token authentication → Donor records: looks up donor (evidence: `middleware/auth.js`)
- Token authentication → Hospital records: looks up hospital (evidence: `middleware/auth.js`)
- Donor profiles → Token authentication: protects routes (evidence: `routes/users.js`)
- Donor profiles → Donor records: reads and updates (evidence: `routes/users.js`)
- Hospital profiles and directory → Token authentication: protects routes (evidence: `routes/hospitals.js`)
- Hospital profiles and directory → Hospital records: reads and updates (evidence: `routes/hospitals.js`)
- Request matching and response → Token authentication: protects routes (evidence: `routes/bloodRequests.js`)
- Request matching and response → Blood request records: creates and updates (evidence: `routes/bloodRequests.js`)
- Request matching and response → Donor records: matches donors (evidence: `routes/bloodRequests.js`)
- Request matching and response → Hospital records: loads hospital (evidence: `routes/bloodRequests.js`)
- Request matching and response → HTTP and sockets: emits notifications (evidence: `routes/bloodRequests.js`)
