# mouleeshwaran-s31/carebridge_system architecture

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

- Interactive diagram: https://gitdiagram.com/mouleeshwaran-s31/carebridge_system
- Repository: https://github.com/mouleeshwaran-s31/carebridge_system

## Overview

CareBridge is a multi-portal public-health platform: citizens and staff authenticate through the shared login, then use role-specific applications for care delivery or health administration. The documented runtime path is the frontends calling a unified REST API backed by PostgreSQL. Government and hospital dashboards cover distinct operational stages; the master-admin portal provisions users and facilities. The README documents the patient app’s booking, records, SOS, and multilingual capabilities, but its Dart source is absent from this tree. Several dashboard-to-API relationships are documented rather than visible in sampled call sites.

Main entry points: [`backend/src/app.js`](https://github.com/mouleeshwaran-s31/carebridge_system/blob/main/backend/src/app.js) (REST API), [`HOSPITAL_DASHBOARD/src/App.jsx`](https://github.com/mouleeshwaran-s31/carebridge_system/blob/main/HOSPITAL_DASHBOARD/src/App.jsx) (Hospital Portal), [`GOVERNMENT_DASHBOARD/src/context/HealthDataContext.tsx`](https://github.com/mouleeshwaran-s31/carebridge_system/blob/main/GOVERNMENT_DASHBOARD/src/context/HealthDataContext.tsx) (Government Data), [`LOGIN/js/auth.js`](https://github.com/mouleeshwaran-s31/carebridge_system/blob/main/LOGIN/js/auth.js) (Common Login)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portals["User Portals"]
  node_patient_app["Patient App"]
  node_login["Common Login<br/>[auth.js]"]
  node_admin_portal["Master Admin<br/>[AdminDashboard.js]"]
  node_admin_store["Admin State<br/>[adminStore.js]"]
end

subgraph group_government["Government Operations"]
  node_gov_app["Government Portal<br/>[App.tsx]"]
  node_gov_data["Government Data"]
  node_gov_surveillance["Disease Surveillance"]
  node_gov_operations["State and District Ops"]
end

subgraph group_hospital["Hospital Care"]
  node_hospital_app["Hospital Portal<br/>[App.jsx]"]
  node_hospital_auth["Hospital Auth<br/>[AuthContext.jsx]"]
  node_hospital_roles["Role Workspaces"]
  node_hospital_care["Clinical Operations"]
end

subgraph group_backend["API Services"]
  node_api_app["REST API<br/>[app.js]"]
  node_api_routes["API Routes<br/>[api.js]"]
  node_gov_controller["Government Controller"]
end

subgraph group_data["Shared Data"]
  node_db_config["Database Access<br/>[db.js]"]
  node_postgres[("PostgreSQL")]
end

node_citizens(("Citizens"))
node_staff(("Health Staff"))

node_citizens -->|"use care services"| node_patient_app
node_staff -->|"sign in"| node_login
node_citizens -->|"authenticate"| node_login
node_login -->|"submit credentials"| node_api_app
node_api_app -->|"issue handoff"| node_login
node_staff -->|"manage platform"| node_admin_portal
node_admin_portal -->|"uses state"| node_admin_store
node_admin_store -->|"fetch and persist"| node_api_app
node_staff -->|"monitor health"| node_gov_app
node_gov_app -->|"provides context"| node_gov_data
node_gov_data -->|"supplies data"| node_gov_surveillance
node_gov_data -.->|"supports workflows"| node_gov_operations
node_gov_data -->|"calls REST API"| node_api_app
node_staff -->|"deliver care"| node_hospital_app
node_hospital_app -->|"provides auth"| node_hospital_auth
node_hospital_app -->|"routes by role"| node_hospital_roles
node_hospital_app -->|"routes care pages"| node_hospital_care
node_hospital_auth -->|"exchanges handoff"| node_api_app
node_hospital_app -.->|"uses REST API"| node_api_app
node_patient_app -.->|"uses REST API"| node_api_app
node_api_app -->|"mounts routes"| node_api_routes
node_api_routes -.->|"dispatches requests"| node_gov_controller
node_gov_controller -->|"queries data"| node_db_config
node_db_config -->|"reads and writes"| node_postgres

click node_patient_app "https://github.com/mouleeshwaran-s31/carebridge_system/tree/main/CARE_BRIDGE"
click node_login "https://github.com/mouleeshwaran-s31/carebridge_system/blob/main/LOGIN/js/auth.js"
click node_admin_portal "https://github.com/mouleeshwaran-s31/carebridge_system/blob/main/ADMIN_DASHBOARD/js/components/admin/AdminDashboard.js"
click node_admin_store "https://github.com/mouleeshwaran-s31/carebridge_system/blob/main/ADMIN_DASHBOARD/js/store/adminStore.js"
click node_gov_app "https://github.com/mouleeshwaran-s31/carebridge_system/blob/main/GOVERNMENT_DASHBOARD/src/App.tsx"
click node_gov_data "https://github.com/mouleeshwaran-s31/carebridge_system/blob/main/GOVERNMENT_DASHBOARD/src/context/HealthDataContext.tsx"
click node_gov_surveillance "https://github.com/mouleeshwaran-s31/carebridge_system/blob/main/GOVERNMENT_DASHBOARD/src/pages/DiseaseSurveillance.tsx"
click node_gov_operations "https://github.com/mouleeshwaran-s31/carebridge_system/tree/main/GOVERNMENT_DASHBOARD/src/pages"
click node_hospital_app "https://github.com/mouleeshwaran-s31/carebridge_system/blob/main/HOSPITAL_DASHBOARD/src/App.jsx"
click node_hospital_auth "https://github.com/mouleeshwaran-s31/carebridge_system/blob/main/HOSPITAL_DASHBOARD/src/context/AuthContext.jsx"
click node_hospital_roles "https://github.com/mouleeshwaran-s31/carebridge_system/tree/main/HOSPITAL_DASHBOARD/src/roles"
click node_hospital_care "https://github.com/mouleeshwaran-s31/carebridge_system/tree/main/HOSPITAL_DASHBOARD/src/pages"
click node_api_app "https://github.com/mouleeshwaran-s31/carebridge_system/blob/main/backend/src/app.js"
click node_api_routes "https://github.com/mouleeshwaran-s31/carebridge_system/blob/main/backend/src/routes/api.js"
click node_gov_controller "https://github.com/mouleeshwaran-s31/carebridge_system/blob/main/backend/src/controllers/governmentController.js"
click node_db_config "https://github.com/mouleeshwaran-s31/carebridge_system/blob/main/backend/src/config/db.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_patient_app,node_login,node_admin_portal,node_admin_store toneBlue
class node_gov_app,node_gov_data,node_gov_surveillance,node_gov_operations toneAmber
class node_hospital_app,node_hospital_auth,node_hospital_roles,node_hospital_care toneMint
class node_api_app,node_api_routes,node_gov_controller toneRose
class node_db_config,node_postgres,node_citizens,node_staff toneIndigo
```

## Components

### User Portals

- [Patient App](https://github.com/mouleeshwaran-s31/carebridge_system/tree/main/CARE_BRIDGE): `CARE_BRIDGE`
- [Common Login](https://github.com/mouleeshwaran-s31/carebridge_system/blob/main/LOGIN/js/auth.js): `LOGIN/js/auth.js`
- [Master Admin](https://github.com/mouleeshwaran-s31/carebridge_system/blob/main/ADMIN_DASHBOARD/js/components/admin/AdminDashboard.js): `ADMIN_DASHBOARD/js/components/admin/AdminDashboard.js`
- [Admin State](https://github.com/mouleeshwaran-s31/carebridge_system/blob/main/ADMIN_DASHBOARD/js/store/adminStore.js): `ADMIN_DASHBOARD/js/store/adminStore.js`

### Government Operations

- [Government Portal](https://github.com/mouleeshwaran-s31/carebridge_system/blob/main/GOVERNMENT_DASHBOARD/src/App.tsx): `GOVERNMENT_DASHBOARD/src/App.tsx`
- [Government Data](https://github.com/mouleeshwaran-s31/carebridge_system/blob/main/GOVERNMENT_DASHBOARD/src/context/HealthDataContext.tsx): `GOVERNMENT_DASHBOARD/src/context/HealthDataContext.tsx`
- [Disease Surveillance](https://github.com/mouleeshwaran-s31/carebridge_system/blob/main/GOVERNMENT_DASHBOARD/src/pages/DiseaseSurveillance.tsx): `GOVERNMENT_DASHBOARD/src/pages/DiseaseSurveillance.tsx`
- [State and District Ops](https://github.com/mouleeshwaran-s31/carebridge_system/tree/main/GOVERNMENT_DASHBOARD/src/pages): `GOVERNMENT_DASHBOARD/src/pages`

### Hospital Care

- [Hospital Portal](https://github.com/mouleeshwaran-s31/carebridge_system/blob/main/HOSPITAL_DASHBOARD/src/App.jsx): `HOSPITAL_DASHBOARD/src/App.jsx`
- [Hospital Auth](https://github.com/mouleeshwaran-s31/carebridge_system/blob/main/HOSPITAL_DASHBOARD/src/context/AuthContext.jsx): `HOSPITAL_DASHBOARD/src/context/AuthContext.jsx`
- [Role Workspaces](https://github.com/mouleeshwaran-s31/carebridge_system/tree/main/HOSPITAL_DASHBOARD/src/roles): `HOSPITAL_DASHBOARD/src/roles`
- [Clinical Operations](https://github.com/mouleeshwaran-s31/carebridge_system/tree/main/HOSPITAL_DASHBOARD/src/pages): `HOSPITAL_DASHBOARD/src/pages`

### API Services

- [REST API](https://github.com/mouleeshwaran-s31/carebridge_system/blob/main/backend/src/app.js): `backend/src/app.js`
- [API Routes](https://github.com/mouleeshwaran-s31/carebridge_system/blob/main/backend/src/routes/api.js): `backend/src/routes/api.js`
- [Government Controller](https://github.com/mouleeshwaran-s31/carebridge_system/blob/main/backend/src/controllers/governmentController.js): `backend/src/controllers/governmentController.js`

### Shared Data

- [Database Access](https://github.com/mouleeshwaran-s31/carebridge_system/blob/main/backend/src/config/db.js): `backend/src/config/db.js`
- **PostgreSQL**

### Other components

- **Citizens**
- **Health Staff**

## Connections

- Citizens → Patient App: use care services
- Health Staff → Common Login: sign in
- Citizens → Common Login: authenticate
- Common Login → REST API: submit credentials (evidence: `LOGIN/js/auth.js`)
- REST API → Common Login: issue handoff (evidence: `LOGIN/js/auth.js`)
- Health Staff → Master Admin: manage platform
- Master Admin → Admin State: uses state (evidence: `ADMIN_DASHBOARD/js/components/admin/AdminDashboard.js`)
- Admin State → REST API: fetch and persist (evidence: `ADMIN_DASHBOARD/js/store/adminStore.js`)
- Health Staff → Government Portal: monitor health
- Government Portal → Government Data: provides context (evidence: `GOVERNMENT_DASHBOARD/src/App.tsx`)
- Government Data → Disease Surveillance: supplies data
- Government Data → State and District Ops: supports workflows (evidence: `GOVERNMENT_DASHBOARD/src/pages/AIPrediction.tsx`)
- Government Data → REST API: calls REST API (evidence: `GOVERNMENT_DASHBOARD/src/context/HealthDataContext.tsx`)
- Health Staff → Hospital Portal: deliver care
- Hospital Portal → Hospital Auth: provides auth (evidence: `HOSPITAL_DASHBOARD/src/main.jsx`)
- Hospital Portal → Role Workspaces: routes by role (evidence: `HOSPITAL_DASHBOARD/src/App.jsx`)
- Hospital Portal → Clinical Operations: routes care pages (evidence: `HOSPITAL_DASHBOARD/src/App.jsx`)
- Hospital Auth → REST API: exchanges handoff (evidence: `HOSPITAL_DASHBOARD/src/context/AuthContext.jsx`)
- Hospital Portal → REST API: uses REST API
- Patient App → REST API: uses REST API
- REST API → API Routes: mounts routes (evidence: `backend/src/app.js`)
- API Routes → Government Controller: dispatches requests
- Government Controller → Database Access: queries data (evidence: `backend/src/controllers/governmentController.js`)
- Database Access → PostgreSQL: reads and writes (evidence: `backend/src/config/db.js`)