# adityakamble69/lifeline architecture

> Architecture diagram of the GitHub repository adityakamble69/lifeline, 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/adityakamble69/lifeline
- Repository: https://github.com/adityakamble69/lifeline

## Overview

Lifeline is a blood-donor network scaffold: its intended workflow connects donors and people or organizations needing blood, including through donation camps. The present runtime is a Next.js frontend and Express API; the README says they communicate locally, but Supabase is not yet provisioned. The graph preserves the documented domain and the substantial admin capabilities visible in the tree. Relationships between unsampled feature modules are omitted or shown as unverified; the sampled request and profile flows have clearer routing and service evidence.

Main entry points: [`backend/src/routes/index.js`](https://github.com/adityakamble69/lifeline/blob/main/backend/src/routes/index.js) (API route registry), [`backend/src/services/auth.service.js`](https://github.com/adityakamble69/lifeline/blob/main/backend/src/services/auth.service.js) (Identity sync), [`backend/src/routes/adminRequests.routes.js`](https://github.com/adityakamble69/lifeline/blob/main/backend/src/routes/adminRequests.routes.js) (Request admin routes), [`backend/src/controllers/me.controller.js`](https://github.com/adityakamble69/lifeline/blob/main/backend/src/controllers/me.controller.js) (Profile API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Web experience"]
  node_web_app["Web application"]
  node_donor_portal["Donor portal"]
  node_public_discovery["Public discovery"]
  node_admin_ui["Admin console"]
end

subgraph group_api["API and identity"]
  node_api_server["Express API<br/>[server.js]"]
  node_api_routes["API route registry<br/>[index.js]"]
  node_auth_gate["Authentication<br/>[requireAuth.js]"]
  node_identity_sync["Identity sync<br/>[auth.service.js]"]
  node_user_records["User records<br/>[user.repository.js]"]
end

subgraph group_donor_domain["Donor services"]
  node_profile_api["Profile API<br/>[me.controller.js]"]
  node_profile_service["Profile services<br/>[me.service.js]"]
  node_profile_data["Profile data access<br/>[me.repository.js]"]
  node_donor_camps["Camp discovery and signup"]
  node_blood_requests["Blood requests<br/>[requests.routes.js]"]
end

subgraph group_admin_domain["Organization admin"]
  node_admin_requests_route["Request admin routes"]
  node_admin_requests_controller["Request review"]
  node_admin_requests_service["Request workflows"]
  node_admin_requests_data["Request data access"]
  node_admin_capabilities["Admin operations"]
  node_export_data["Data export"]
end

node_people(("Donors and requesters"))
node_clerk["Clerk identity"]
node_supabase[("Supabase database")]

node_people -->|"use"| node_web_app
node_web_app -->|"calls health endpoint"| node_api_server
node_api_server -->|"mounts API routes"| node_api_routes
node_api_routes -->|"registers routes"| node_blood_requests
node_api_routes -->|"registers routes"| node_admin_requests_route
node_admin_requests_route -->|"guards requests"| node_auth_gate
node_admin_requests_route -->|"dispatches"| node_admin_requests_controller
node_admin_requests_controller -->|"calls"| node_admin_requests_service
node_admin_requests_service -->|"uses"| node_admin_requests_data
node_auth_gate -->|"synchronizes user"| node_identity_sync
node_identity_sync -->|"fetches identity"| node_clerk
node_identity_sync -->|"finds or inserts"| node_user_records
node_user_records -->|"reads and writes"| node_supabase
node_api_routes -->|"registers profile routes"| node_profile_api
node_profile_api -->|"calls"| node_profile_service
node_profile_service -->|"uses"| node_profile_data
node_donor_portal -.->|"uses profile endpoints"| node_profile_api
node_donor_portal -.->|"offers camp signup"| node_donor_camps
node_public_discovery -.->|"supports request discovery"| node_blood_requests
node_admin_ui -.->|"manages operations"| node_admin_capabilities
node_admin_ui -.->|"requests exports"| node_export_data

click node_web_app "https://github.com/adityakamble69/lifeline/tree/main/frontend/src/app"
click node_donor_portal "https://github.com/adityakamble69/lifeline/tree/main/frontend/src/app/dashboard"
click node_public_discovery "https://github.com/adityakamble69/lifeline/tree/main/frontend/src/app/camps"
click node_admin_ui "https://github.com/adityakamble69/lifeline/tree/main/frontend/src/app/admin"
click node_api_server "https://github.com/adityakamble69/lifeline/blob/main/backend/src/server.js"
click node_api_routes "https://github.com/adityakamble69/lifeline/blob/main/backend/src/routes/index.js"
click node_auth_gate "https://github.com/adityakamble69/lifeline/blob/main/backend/src/middleware/requireAuth.js"
click node_identity_sync "https://github.com/adityakamble69/lifeline/blob/main/backend/src/services/auth.service.js"
click node_user_records "https://github.com/adityakamble69/lifeline/blob/main/backend/src/repositories/user.repository.js"
click node_profile_api "https://github.com/adityakamble69/lifeline/blob/main/backend/src/controllers/me.controller.js"
click node_profile_service "https://github.com/adityakamble69/lifeline/blob/main/backend/src/services/me.service.js"
click node_profile_data "https://github.com/adityakamble69/lifeline/blob/main/backend/src/repositories/me.repository.js"
click node_donor_camps "https://github.com/adityakamble69/lifeline/tree/main/frontend/src/app/dashboard/camps"
click node_blood_requests "https://github.com/adityakamble69/lifeline/blob/main/backend/src/routes/requests.routes.js"
click node_admin_requests_route "https://github.com/adityakamble69/lifeline/blob/main/backend/src/routes/adminRequests.routes.js"
click node_admin_requests_controller "https://github.com/adityakamble69/lifeline/blob/main/backend/src/controllers/adminRequests.controller.js"
click node_admin_requests_service "https://github.com/adityakamble69/lifeline/blob/main/backend/src/services/adminRequests.service.js"
click node_admin_requests_data "https://github.com/adityakamble69/lifeline/blob/main/backend/src/repositories/adminRequests.repository.js"
click node_admin_capabilities "https://github.com/adityakamble69/lifeline/tree/main/backend/src/controllers"
click node_export_data "https://github.com/adityakamble69/lifeline/blob/main/backend/src/repositories/adminExport.repository.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_web_app,node_donor_portal,node_public_discovery,node_admin_ui toneBlue
class node_api_server,node_api_routes,node_auth_gate,node_identity_sync,node_user_records,node_supabase toneAmber
class node_profile_api,node_profile_service,node_profile_data,node_donor_camps,node_blood_requests,node_people toneMint
class node_admin_requests_route,node_admin_requests_controller,node_admin_requests_service,node_admin_requests_data,node_admin_capabilities,node_export_data toneRose
class node_clerk toneIndigo
```

## Components

### Web experience

- [Web application](https://github.com/adityakamble69/lifeline/tree/main/frontend/src/app): `frontend/src/app`
- [Donor portal](https://github.com/adityakamble69/lifeline/tree/main/frontend/src/app/dashboard): `frontend/src/app/dashboard`
- [Public discovery](https://github.com/adityakamble69/lifeline/tree/main/frontend/src/app/camps): `frontend/src/app/camps`
- [Admin console](https://github.com/adityakamble69/lifeline/tree/main/frontend/src/app/admin): `frontend/src/app/admin`

### API and identity

- [Express API](https://github.com/adityakamble69/lifeline/blob/main/backend/src/server.js): `backend/src/server.js`
- [API route registry](https://github.com/adityakamble69/lifeline/blob/main/backend/src/routes/index.js): `backend/src/routes/index.js`
- [Authentication](https://github.com/adityakamble69/lifeline/blob/main/backend/src/middleware/requireAuth.js): `backend/src/middleware/requireAuth.js`
- [Identity sync](https://github.com/adityakamble69/lifeline/blob/main/backend/src/services/auth.service.js): `backend/src/services/auth.service.js`
- [User records](https://github.com/adityakamble69/lifeline/blob/main/backend/src/repositories/user.repository.js): `backend/src/repositories/user.repository.js`

### Donor services

- [Profile API](https://github.com/adityakamble69/lifeline/blob/main/backend/src/controllers/me.controller.js): `backend/src/controllers/me.controller.js`
- [Profile services](https://github.com/adityakamble69/lifeline/blob/main/backend/src/services/me.service.js): `backend/src/services/me.service.js`
- [Profile data access](https://github.com/adityakamble69/lifeline/blob/main/backend/src/repositories/me.repository.js): `backend/src/repositories/me.repository.js`
- [Camp discovery and signup](https://github.com/adityakamble69/lifeline/tree/main/frontend/src/app/dashboard/camps): `frontend/src/app/dashboard/camps`
- [Blood requests](https://github.com/adityakamble69/lifeline/blob/main/backend/src/routes/requests.routes.js): `backend/src/routes/requests.routes.js`

### Organization admin

- [Request admin routes](https://github.com/adityakamble69/lifeline/blob/main/backend/src/routes/adminRequests.routes.js): `backend/src/routes/adminRequests.routes.js`
- [Request review](https://github.com/adityakamble69/lifeline/blob/main/backend/src/controllers/adminRequests.controller.js): `backend/src/controllers/adminRequests.controller.js`
- [Request workflows](https://github.com/adityakamble69/lifeline/blob/main/backend/src/services/adminRequests.service.js): `backend/src/services/adminRequests.service.js`
- [Request data access](https://github.com/adityakamble69/lifeline/blob/main/backend/src/repositories/adminRequests.repository.js): `backend/src/repositories/adminRequests.repository.js`
- [Admin operations](https://github.com/adityakamble69/lifeline/tree/main/backend/src/controllers): `backend/src/controllers`
- [Data export](https://github.com/adityakamble69/lifeline/blob/main/backend/src/repositories/adminExport.repository.js): `backend/src/repositories/adminExport.repository.js`

### Other components

- **Donors and requesters**
- **Clerk identity**
- **Supabase database**

## Connections

- Donors and requesters → Web application: use (evidence: `README.md`)
- Web application → Express API: calls health endpoint (evidence: `README.md`)
- Express API → API route registry: mounts API routes (evidence: `backend/src/server.js`)
- API route registry → Blood requests: registers routes (evidence: `backend/src/routes/index.js`)
- API route registry → Request admin routes: registers routes (evidence: `backend/src/routes/index.js`)
- Request admin routes → Authentication: guards requests (evidence: `backend/src/routes/adminRequests.routes.js`)
- Request admin routes → Request review: dispatches (evidence: `backend/src/routes/adminRequests.routes.js`)
- Request review → Request workflows: calls (evidence: `backend/src/controllers/adminRequests.controller.js`)
- Request workflows → Request data access: uses (evidence: `backend/src/services/adminRequests.service.js`)
- Authentication → Identity sync: synchronizes user (evidence: `backend/src/middleware/requireAuth.js`)
- Identity sync → Clerk identity: fetches identity (evidence: `backend/src/services/auth.service.js`)
- Identity sync → User records: finds or inserts (evidence: `backend/src/services/auth.service.js`)
- User records → Supabase database: reads and writes (evidence: `backend/src/repositories/user.repository.js`)
- API route registry → Profile API: registers profile routes (evidence: `backend/src/routes/index.js`)
- Profile API → Profile services: calls (evidence: `backend/src/controllers/me.controller.js`)
- Profile services → Profile data access: uses (evidence: `backend/src/services/me.service.js`)
- Donor portal → Profile API: uses profile endpoints
- Donor portal → Camp discovery and signup: offers camp signup
- Public discovery → Blood requests: supports request discovery
- Admin console → Admin operations: manages operations
- Admin console → Data export: requests exports
