# karunakara1817/mediconnect-appointment-system architecture

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

- Interactive diagram: https://gitdiagram.com/karunakara1817/mediconnect-appointment-system
- Repository: https://github.com/karunakara1817/mediconnect-appointment-system

## Overview

MediConnect is a role-secured healthcare platform for patient, doctor, and administrator portals. Users authenticate, discover approved doctors and available appointment slots, book or manage appointments, while doctors maintain profiles and availability and administrators manage platform records and doctor approval. The React client calls a Spring Boot API backed by PostgreSQL; the API can dispatch email alerts through a separate Node notification service. The graph preserves README-described capabilities whose implementation was not sampled; those connections are shown only where documented or evidenced by the source index.

Main entry points: [`mediconnect/src/main/java/com/mediconnect/controller`](https://github.com/karunakara1817/mediconnect-appointment-system/tree/main/mediconnect/src/main/java/com/mediconnect/controller) (REST API), [`mediconnect-frontend/src/App.jsx`](https://github.com/karunakara1817/mediconnect-appointment-system/blob/main/mediconnect-frontend/src/App.jsx) (Portal routing), [`mediconnect/src/main/java/com/mediconnect/service/AuthService.java`](https://github.com/karunakara1817/mediconnect-appointment-system/blob/main/mediconnect/src/main/java/com/mediconnect/service/AuthService.java) (Authentication), [`mediconnect/src/main/java/com/mediconnect/service/NotificationService.java`](https://github.com/karunakara1817/mediconnect-appointment-system/blob/main/mediconnect/src/main/java/com/mediconnect/service/NotificationService.java) (Notification records and dispatch)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web portals"]
  node_patients["Patient portal"]
  node_doctors["Doctor portal"]
  node_admins["Admin portal"]
  node_directory["Doctor directory<br/>[DoctorsPage.jsx]"]
  node_routing["Portal routing<br/>[App.jsx]"]
end

subgraph group_identity["Identity and access"]
  node_authstate["Session context<br/>[AuthContext.jsx]"]
  node_httpclient["API client<br/>[axiosClient.js]"]
  node_authservice["Authentication<br/>[AuthService.java]"]
  node_security["JWT and authorization"]
end

subgraph group_care["Care workflows"]
  node_appointments["Appointment scheduling"]
  node_doctorservice["Doctor profiles and availability<br/>[DoctorService.java]"]
  node_patientservice["Patient profiles"]
end

subgraph group_platform["Platform services"]
  node_api["REST API"]
  node_adminservice["Administration<br/>[AdminService.java]"]
end

subgraph group_integrations["Persistence and alerts"]
  node_notifications["Notification records and dispatch"]
  node_database[("PostgreSQL")]
  node_mailer["Email notification service<br/>[server.js]"]
end

node_actor(("Patients, doctors, admins"))

node_actor -->|"uses portals"| node_routing
node_routing -->|"routes to"| node_patients
node_routing -->|"routes to"| node_doctors
node_routing -->|"routes to"| node_admins
node_routing -->|"routes to"| node_directory
node_routing -->|"checks session"| node_authstate
node_authstate -->|"validates session"| node_httpclient
node_httpclient -->|"sends REST requests"| node_api
node_api -->|"delegates auth"| node_authservice
node_api -->|"delegates scheduling"| node_appointments
node_api -->|"delegates doctor operations"| node_doctorservice
node_api -->|"delegates patient operations"| node_patientservice
node_api -->|"delegates administration"| node_adminservice
node_api -.->|"delegates notifications"| node_notifications
node_authservice -->|"loads users and issues JWT"| node_security
node_authservice -->|"reads and saves accounts"| node_database
node_appointments -->|"reads and writes appointments"| node_database
node_doctorservice -->|"reads and writes doctor data"| node_database
node_adminservice -->|"manages platform records"| node_database
node_patientservice -.->|"manages patient profiles"| node_database
node_notifications -->|"stores notification records"| node_database
node_notifications -->|"posts email alert"| node_mailer
node_mailer -.->|"sends email"| node_database

click node_patients "https://github.com/karunakara1817/mediconnect-appointment-system/blob/main/mediconnect-frontend/src/pages/PatientDashboardPage.jsx"
click node_doctors "https://github.com/karunakara1817/mediconnect-appointment-system/blob/main/mediconnect-frontend/src/pages/DoctorDashboardPage.jsx"
click node_admins "https://github.com/karunakara1817/mediconnect-appointment-system/blob/main/mediconnect-frontend/src/pages/AdminDashboardPage.jsx"
click node_directory "https://github.com/karunakara1817/mediconnect-appointment-system/blob/main/mediconnect-frontend/src/pages/DoctorsPage.jsx"
click node_routing "https://github.com/karunakara1817/mediconnect-appointment-system/blob/main/mediconnect-frontend/src/App.jsx"
click node_authstate "https://github.com/karunakara1817/mediconnect-appointment-system/blob/main/mediconnect-frontend/src/context/AuthContext.jsx"
click node_httpclient "https://github.com/karunakara1817/mediconnect-appointment-system/blob/main/mediconnect-frontend/src/api/axiosClient.js"
click node_api "https://github.com/karunakara1817/mediconnect-appointment-system/tree/main/mediconnect/src/main/java/com/mediconnect/controller"
click node_authservice "https://github.com/karunakara1817/mediconnect-appointment-system/blob/main/mediconnect/src/main/java/com/mediconnect/service/AuthService.java"
click node_appointments "https://github.com/karunakara1817/mediconnect-appointment-system/blob/main/mediconnect/src/main/java/com/mediconnect/service/AppointmentService.java"
click node_doctorservice "https://github.com/karunakara1817/mediconnect-appointment-system/blob/main/mediconnect/src/main/java/com/mediconnect/service/DoctorService.java"
click node_adminservice "https://github.com/karunakara1817/mediconnect-appointment-system/blob/main/mediconnect/src/main/java/com/mediconnect/service/AdminService.java"
click node_patientservice "https://github.com/karunakara1817/mediconnect-appointment-system/blob/main/mediconnect/src/main/java/com/mediconnect/service/PatientService.java"
click node_notifications "https://github.com/karunakara1817/mediconnect-appointment-system/blob/main/mediconnect/src/main/java/com/mediconnect/service/NotificationService.java"
click node_security "https://github.com/karunakara1817/mediconnect-appointment-system/tree/main/mediconnect/src/main/java/com/mediconnect/security"
click node_mailer "https://github.com/karunakara1817/mediconnect-appointment-system/blob/main/mediconnect-notification-service/src/server.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_patients,node_doctors,node_admins,node_directory,node_routing toneBlue
class node_authstate,node_httpclient,node_authservice,node_security toneAmber
class node_appointments,node_doctorservice,node_patientservice toneMint
class node_api,node_adminservice toneRose
class node_notifications,node_database,node_mailer,node_actor toneIndigo
```

## Components

### Web portals

- [Patient portal](https://github.com/karunakara1817/mediconnect-appointment-system/blob/main/mediconnect-frontend/src/pages/PatientDashboardPage.jsx): `mediconnect-frontend/src/pages/PatientDashboardPage.jsx`
- [Doctor portal](https://github.com/karunakara1817/mediconnect-appointment-system/blob/main/mediconnect-frontend/src/pages/DoctorDashboardPage.jsx): `mediconnect-frontend/src/pages/DoctorDashboardPage.jsx`
- [Admin portal](https://github.com/karunakara1817/mediconnect-appointment-system/blob/main/mediconnect-frontend/src/pages/AdminDashboardPage.jsx): `mediconnect-frontend/src/pages/AdminDashboardPage.jsx`
- [Doctor directory](https://github.com/karunakara1817/mediconnect-appointment-system/blob/main/mediconnect-frontend/src/pages/DoctorsPage.jsx): `mediconnect-frontend/src/pages/DoctorsPage.jsx`
- [Portal routing](https://github.com/karunakara1817/mediconnect-appointment-system/blob/main/mediconnect-frontend/src/App.jsx): `mediconnect-frontend/src/App.jsx`

### Identity and access

- [Session context](https://github.com/karunakara1817/mediconnect-appointment-system/blob/main/mediconnect-frontend/src/context/AuthContext.jsx): `mediconnect-frontend/src/context/AuthContext.jsx`
- [API client](https://github.com/karunakara1817/mediconnect-appointment-system/blob/main/mediconnect-frontend/src/api/axiosClient.js): `mediconnect-frontend/src/api/axiosClient.js`
- [Authentication](https://github.com/karunakara1817/mediconnect-appointment-system/blob/main/mediconnect/src/main/java/com/mediconnect/service/AuthService.java): `mediconnect/src/main/java/com/mediconnect/service/AuthService.java`
- [JWT and authorization](https://github.com/karunakara1817/mediconnect-appointment-system/tree/main/mediconnect/src/main/java/com/mediconnect/security): `mediconnect/src/main/java/com/mediconnect/security`

### Care workflows

- [Appointment scheduling](https://github.com/karunakara1817/mediconnect-appointment-system/blob/main/mediconnect/src/main/java/com/mediconnect/service/AppointmentService.java): `mediconnect/src/main/java/com/mediconnect/service/AppointmentService.java`
- [Doctor profiles and availability](https://github.com/karunakara1817/mediconnect-appointment-system/blob/main/mediconnect/src/main/java/com/mediconnect/service/DoctorService.java): `mediconnect/src/main/java/com/mediconnect/service/DoctorService.java`
- [Patient profiles](https://github.com/karunakara1817/mediconnect-appointment-system/blob/main/mediconnect/src/main/java/com/mediconnect/service/PatientService.java): `mediconnect/src/main/java/com/mediconnect/service/PatientService.java`

### Platform services

- [REST API](https://github.com/karunakara1817/mediconnect-appointment-system/tree/main/mediconnect/src/main/java/com/mediconnect/controller): `mediconnect/src/main/java/com/mediconnect/controller`
- [Administration](https://github.com/karunakara1817/mediconnect-appointment-system/blob/main/mediconnect/src/main/java/com/mediconnect/service/AdminService.java): `mediconnect/src/main/java/com/mediconnect/service/AdminService.java`

### Persistence and alerts

- [Notification records and dispatch](https://github.com/karunakara1817/mediconnect-appointment-system/blob/main/mediconnect/src/main/java/com/mediconnect/service/NotificationService.java): `mediconnect/src/main/java/com/mediconnect/service/NotificationService.java`
- **PostgreSQL**
- [Email notification service](https://github.com/karunakara1817/mediconnect-appointment-system/blob/main/mediconnect-notification-service/src/server.js): `mediconnect-notification-service/src/server.js`

### Other components

- **Patients, doctors, admins**

## Connections

- Patients, doctors, admins → Portal routing: uses portals (evidence: `README.md`)
- Portal routing → Patient portal: routes to (evidence: `mediconnect-frontend/src/App.jsx`)
- Portal routing → Doctor portal: routes to (evidence: `mediconnect-frontend/src/App.jsx`)
- Portal routing → Admin portal: routes to (evidence: `mediconnect-frontend/src/App.jsx`)
- Portal routing → Doctor directory: routes to (evidence: `mediconnect-frontend/src/App.jsx`)
- Portal routing → Session context: checks session (evidence: `mediconnect-frontend/src/App.jsx`)
- Session context → API client: validates session (evidence: `mediconnect-frontend/src/context/AuthContext.jsx`)
- API client → REST API: sends REST requests (evidence: `README.md`)
- REST API → Authentication: delegates auth
- REST API → Appointment scheduling: delegates scheduling (evidence: `mediconnect/src/main/java/com/mediconnect/controller/AppointmentController.java`)
- REST API → Doctor profiles and availability: delegates doctor operations (evidence: `mediconnect/src/main/java/com/mediconnect/controller/DoctorController.java`)
- REST API → Patient profiles: delegates patient operations (evidence: `mediconnect/src/main/java/com/mediconnect/controller/PatientController.java`)
- REST API → Administration: delegates administration
- REST API → Notification records and dispatch: delegates notifications (evidence: `mediconnect/src/main/java/com/mediconnect/controller/NotificationController.java`)
- Authentication → JWT and authorization: loads users and issues JWT (evidence: `mediconnect/src/main/java/com/mediconnect/service/AuthService.java`)
- Authentication → PostgreSQL: reads and saves accounts (evidence: `mediconnect/src/main/java/com/mediconnect/service/AuthService.java`)
- Appointment scheduling → PostgreSQL: reads and writes appointments (evidence: `mediconnect/src/main/java/com/mediconnect/service/AppointmentService.java`)
- Doctor profiles and availability → PostgreSQL: reads and writes doctor data (evidence: `mediconnect/src/main/java/com/mediconnect/service/DoctorService.java`)
- Administration → PostgreSQL: manages platform records (evidence: `mediconnect/src/main/java/com/mediconnect/service/AdminService.java`)
- Patient profiles → PostgreSQL: manages patient profiles
- Notification records and dispatch → PostgreSQL: stores notification records (evidence: `mediconnect/src/main/java/com/mediconnect/service/NotificationService.java`)
- Notification records and dispatch → Email notification service: posts email alert (evidence: `mediconnect/src/main/java/com/mediconnect/service/NotificationService.java`)
- Email notification service → PostgreSQL: sends email
