# kesaruhasun/honda_leda architecture

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

- Interactive diagram: https://gitdiagram.com/kesaruhasun/honda_leda
- Repository: https://github.com/kesaruhasun/honda_leda

## Overview

PulseOS is a hospital-management and electronic-health-record platform. Users enter through public or authenticated portals; staff workflows manage patients, appointments and clinical orders, then laboratory results, prescriptions, dispensing and billing, with notifications and role-based access across the system. The graph preserves the README’s major clinical, operational and financial capabilities. Source excerpts support selected service-to-service interactions; frontend-to-backend links and several unsampled subsystem details are left unverified rather than inferred.

Main entry points: [`frontend/src/services/api.ts`](https://github.com/kesaruhasun/honda_leda/blob/main/frontend/src/services/api.ts) (API Client), [`backend/src/main/java/com/pulseos/billing/BillingService.java`](https://github.com/kesaruhasun/honda_leda/blob/main/backend/src/main/java/com/pulseos/billing/BillingService.java) (Invoices & Payments), [`backend/src/main/java/com/pulseos/notification/NotificationService.java`](https://github.com/kesaruhasun/honda_leda/blob/main/backend/src/main/java/com/pulseos/notification/NotificationService.java) (Notifications), [`frontend/src/App.tsx`](https://github.com/kesaruhasun/honda_leda/blob/main/frontend/src/App.tsx) (Application Router)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Portals &amp; Access"]
  node_app["Application Router<br/>[App.tsx]"]
  node_patientportal["Patient Portal"]
  node_staffviews["Staff Workspaces"]
  node_api["API Client<br/>[api.ts]"]
end

subgraph group_clinical["Clinical Operations"]
  node_patient["Patient Records"]
  node_patientstore[("Patient Store")]
  node_appointments["Appointments"]
  node_doctors["Doctor Roster<br/>[DoctorService.java]"]
  node_admin["Operations Dashboard"]
end

subgraph group_care["Diagnostics &amp; Pharmacy"]
  node_laboratory["Laboratory Worklist"]
  node_pharmacy["Pharmacy &amp; Prescriptions"]
end

subgraph group_finance["Billing &amp; Notifications"]
  node_billing["Invoices &amp; Payments"]
  node_payhere{{"PayHere Gateway"}}
  node_notifications["Notifications"]
  node_notificationstore[("Notification Audit")]
end

subgraph group_platform["Shared Backend"]
  node_auth["Authentication<br/>[AuthService.java]"]
  node_staffstore[("Staff Records")]
  node_database[("Hospital Data")]
end

node_user(("Patients &amp; Staff"))

node_user -->|"opens"| node_app
node_app -->|"routes to"| node_patientportal
node_app -->|"routes to"| node_staffviews
node_patientportal -.->|"requests data"| node_api
node_staffviews -.->|"requests data"| node_api
node_api -.->|"API access"| node_auth
node_api -.->|"API access"| node_patient
node_api -.->|"API access"| node_appointments
node_api -.->|"API access"| node_doctors
node_api -.->|"API access"| node_laboratory
node_api -.->|"API access"| node_pharmacy
node_api -.->|"API access"| node_billing
node_patient -.->|"reads and writes"| node_patientstore
node_auth -->|"looks up staff"| node_staffstore
node_auth -->|"looks up patients"| node_patientstore
node_appointments -->|"uses roster"| node_doctors
node_appointments -->|"sends confirmations"| node_notifications
node_laboratory -->|"uses patient records"| node_patientstore
node_pharmacy -->|"creates invoice items"| node_billing
node_billing -.->|"processes payment"| node_payhere
node_billing -->|"sends updates"| node_notifications
node_notifications -->|"records events"| node_notificationstore
node_notifications -.->|"emails alerts"| node_user
node_admin -->|"loads operations data"| node_api

click node_app "https://github.com/kesaruhasun/honda_leda/blob/main/frontend/src/App.tsx"
click node_patientportal "https://github.com/kesaruhasun/honda_leda/blob/main/frontend/src/views/PatientPortalView.tsx"
click node_staffviews "https://github.com/kesaruhasun/honda_leda/tree/main/frontend/src/views"
click node_api "https://github.com/kesaruhasun/honda_leda/blob/main/frontend/src/services/api.ts"
click node_auth "https://github.com/kesaruhasun/honda_leda/blob/main/backend/src/main/java/com/pulseos/security/AuthService.java"
click node_patient "https://github.com/kesaruhasun/honda_leda/blob/main/backend/src/main/java/com/pulseos/patient/PatientService.java"
click node_patientstore "https://github.com/kesaruhasun/honda_leda/blob/main/backend/src/main/java/com/pulseos/patient/PatientRepository.java"
click node_appointments "https://github.com/kesaruhasun/honda_leda/blob/main/backend/src/main/java/com/pulseos/appointment/AppointmentService.java"
click node_doctors "https://github.com/kesaruhasun/honda_leda/blob/main/backend/src/main/java/com/pulseos/doctor/DoctorService.java"
click node_laboratory "https://github.com/kesaruhasun/honda_leda/blob/main/backend/src/main/java/com/pulseos/laboratory/LaboratoryService.java"
click node_pharmacy "https://github.com/kesaruhasun/honda_leda/blob/main/backend/src/main/java/com/pulseos/pharmacy/PharmacyService.java"
click node_billing "https://github.com/kesaruhasun/honda_leda/blob/main/backend/src/main/java/com/pulseos/billing/BillingService.java"
click node_notifications "https://github.com/kesaruhasun/honda_leda/blob/main/backend/src/main/java/com/pulseos/notification/NotificationService.java"
click node_notificationstore "https://github.com/kesaruhasun/honda_leda/blob/main/backend/src/main/java/com/pulseos/notification/NotificationRepository.java"
click node_admin "https://github.com/kesaruhasun/honda_leda/blob/main/frontend/src/views/ManagerDashboardView.tsx"
click node_staffstore "https://github.com/kesaruhasun/honda_leda/blob/main/backend/src/main/java/com/pulseos/common/EmployeeRepository.java"
click node_database "https://github.com/kesaruhasun/honda_leda/tree/main/backend/src/main/java/com/pulseos"

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_app,node_patientportal,node_staffviews,node_api toneBlue
class node_patient,node_patientstore,node_appointments,node_doctors,node_admin toneAmber
class node_laboratory,node_pharmacy toneMint
class node_billing,node_payhere,node_notifications,node_notificationstore toneRose
class node_auth,node_staffstore,node_database,node_user toneIndigo
```

## Components

### Portals & Access

- [Application Router](https://github.com/kesaruhasun/honda_leda/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Patient Portal](https://github.com/kesaruhasun/honda_leda/blob/main/frontend/src/views/PatientPortalView.tsx): `frontend/src/views/PatientPortalView.tsx`
- [Staff Workspaces](https://github.com/kesaruhasun/honda_leda/tree/main/frontend/src/views): `frontend/src/views`
- [API Client](https://github.com/kesaruhasun/honda_leda/blob/main/frontend/src/services/api.ts): `frontend/src/services/api.ts`

### Clinical Operations

- [Patient Records](https://github.com/kesaruhasun/honda_leda/blob/main/backend/src/main/java/com/pulseos/patient/PatientService.java): `backend/src/main/java/com/pulseos/patient/PatientService.java`
- [Patient Store](https://github.com/kesaruhasun/honda_leda/blob/main/backend/src/main/java/com/pulseos/patient/PatientRepository.java): `backend/src/main/java/com/pulseos/patient/PatientRepository.java`
- [Appointments](https://github.com/kesaruhasun/honda_leda/blob/main/backend/src/main/java/com/pulseos/appointment/AppointmentService.java): `backend/src/main/java/com/pulseos/appointment/AppointmentService.java`
- [Doctor Roster](https://github.com/kesaruhasun/honda_leda/blob/main/backend/src/main/java/com/pulseos/doctor/DoctorService.java): `backend/src/main/java/com/pulseos/doctor/DoctorService.java`
- [Operations Dashboard](https://github.com/kesaruhasun/honda_leda/blob/main/frontend/src/views/ManagerDashboardView.tsx): `frontend/src/views/ManagerDashboardView.tsx`

### Diagnostics & Pharmacy

- [Laboratory Worklist](https://github.com/kesaruhasun/honda_leda/blob/main/backend/src/main/java/com/pulseos/laboratory/LaboratoryService.java): `backend/src/main/java/com/pulseos/laboratory/LaboratoryService.java`
- [Pharmacy & Prescriptions](https://github.com/kesaruhasun/honda_leda/blob/main/backend/src/main/java/com/pulseos/pharmacy/PharmacyService.java): `backend/src/main/java/com/pulseos/pharmacy/PharmacyService.java`

### Billing & Notifications

- [Invoices & Payments](https://github.com/kesaruhasun/honda_leda/blob/main/backend/src/main/java/com/pulseos/billing/BillingService.java): `backend/src/main/java/com/pulseos/billing/BillingService.java`
- **PayHere Gateway**
- [Notifications](https://github.com/kesaruhasun/honda_leda/blob/main/backend/src/main/java/com/pulseos/notification/NotificationService.java): `backend/src/main/java/com/pulseos/notification/NotificationService.java`
- [Notification Audit](https://github.com/kesaruhasun/honda_leda/blob/main/backend/src/main/java/com/pulseos/notification/NotificationRepository.java): `backend/src/main/java/com/pulseos/notification/NotificationRepository.java`

### Shared Backend

- [Authentication](https://github.com/kesaruhasun/honda_leda/blob/main/backend/src/main/java/com/pulseos/security/AuthService.java): `backend/src/main/java/com/pulseos/security/AuthService.java`
- [Staff Records](https://github.com/kesaruhasun/honda_leda/blob/main/backend/src/main/java/com/pulseos/common/EmployeeRepository.java): `backend/src/main/java/com/pulseos/common/EmployeeRepository.java`
- [Hospital Data](https://github.com/kesaruhasun/honda_leda/tree/main/backend/src/main/java/com/pulseos): `backend/src/main/java/com/pulseos`

### Other components

- **Patients & Staff**

## Connections

- Patients & Staff → Application Router: opens (evidence: `frontend/src/App.tsx`)
- Application Router → Patient Portal: routes to (evidence: `frontend/src/App.tsx`)
- Application Router → Staff Workspaces: routes to (evidence: `frontend/src/App.tsx`)
- Patient Portal → API Client: requests data
- Staff Workspaces → API Client: requests data (evidence: `frontend/src/views/ManagerDashboardView.tsx`)
- API Client → Authentication: API access
- API Client → Patient Records: API access
- API Client → Appointments: API access
- API Client → Doctor Roster: API access
- API Client → Laboratory Worklist: API access
- API Client → Pharmacy & Prescriptions: API access
- API Client → Invoices & Payments: API access
- Patient Records → Patient Store: reads and writes
- Authentication → Staff Records: looks up staff (evidence: `backend/src/main/java/com/pulseos/security/AuthService.java`)
- Authentication → Patient Store: looks up patients (evidence: `backend/src/main/java/com/pulseos/security/AuthService.java`)
- Appointments → Doctor Roster: uses roster (evidence: `backend/src/main/java/com/pulseos/appointment/AppointmentService.java`)
- Appointments → Notifications: sends confirmations (evidence: `backend/src/main/java/com/pulseos/appointment/AppointmentService.java`)
- Laboratory Worklist → Patient Store: uses patient records (evidence: `backend/src/main/java/com/pulseos/laboratory/LaboratoryService.java`)
- Pharmacy & Prescriptions → Invoices & Payments: creates invoice items (evidence: `backend/src/main/java/com/pulseos/pharmacy/PharmacyService.java`)
- Invoices & Payments → PayHere Gateway: processes payment
- Invoices & Payments → Notifications: sends updates (evidence: `backend/src/main/java/com/pulseos/billing/BillingService.java`)
- Notifications → Notification Audit: records events (evidence: `backend/src/main/java/com/pulseos/notification/NotificationService.java`)
- Notifications → Patients & Staff: emails alerts
- Operations Dashboard → API Client: loads operations data (evidence: `frontend/src/views/ManagerDashboardView.tsx`)
