# raviprassand/ai-powered-ehealth-appointment-scheduling-agent architecture

> Architecture diagram of the GitHub repository raviprassand/ai-powered-ehealth-appointment-scheduling-agent, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/raviprassand/ai-powered-ehealth-appointment-scheduling-agent
- Repository: https://github.com/raviprassand/ai-powered-ehealth-appointment-scheduling-agent
- Video tour (about a minute): https://gitdiagram.com/raviprassand/ai-powered-ehealth-appointment-scheduling-agent/video

## Overview

This repository contains documentation and integration notes, not the backend or frontend source branches. The documented user journey is a patient using the portal and conversational booking agent; backend AI interprets requests and retrieves patient context, while deterministic rules validate bookings and confirmed appointments and notifications are persisted for portal display. The graph reflects README-described capabilities only; implementation paths and internal call ownership cannot be verified from this tree.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portal["Patient Portal"]
  node_portal["Patient Portal"]
end

subgraph group_backend["Backend Services"]
  node_booking_agent["Booking Agent"]
  node_rest_api["REST APIs"]
  node_validation["Booking Validation"]
  node_doctor_selection["Doctor Selection"]
end

subgraph group_ai["AI Capabilities"]
  node_intent["Intent Extraction"]
  node_rag["Patient Context RAG"]
end

subgraph group_records["Clinical Data"]
  node_appointments[("Appointments")]
  node_notifications[("Doctor Notifications")]
  node_patient_records[("Patient Records")]
end

node_patient(("Patient"))
node_doctor(("Doctor"))

node_patient -->|"uses"| node_portal
node_portal -->|"calls"| node_rest_api
node_rest_api -->|"exposes booking"| node_booking_agent
node_booking_agent -->|"extracts intent"| node_intent
node_booking_agent -->|"retrieves context"| node_rag
node_booking_agent -->|"validates booking"| node_validation
node_validation -->|"selects doctor"| node_doctor_selection
node_doctor_selection -->|"uses family doctor"| node_doctor
node_rag -->|"retrieves data"| node_patient_records
node_validation -->|"stores confirmed"| node_appointments
node_booking_agent -->|"creates notifications"| node_notifications
node_portal -->|"views appointments"| node_appointments
node_portal -->|"views notifications"| node_notifications

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_portal toneBlue
class node_booking_agent,node_rest_api,node_validation,node_doctor_selection toneAmber
class node_intent,node_rag toneMint
class node_appointments,node_notifications,node_patient_records toneRose
class node_patient,node_doctor toneIndigo
```

## Components

### Patient Portal

- **Patient Portal**

### Backend Services

- **Booking Agent**
- **REST APIs**
- **Booking Validation**
- **Doctor Selection**

### AI Capabilities

- **Intent Extraction**
- **Patient Context RAG**

### Clinical Data

- **Appointments**
- **Doctor Notifications**
- **Patient Records**

### Other components

- **Patient**
- **Doctor**

## Connections

- Patient → Patient Portal: uses (evidence: `README.md`)
- Patient Portal → REST APIs: calls (evidence: `README.md`)
- REST APIs → Booking Agent: exposes booking (evidence: `README.md`)
- Booking Agent → Intent Extraction: extracts intent (evidence: `README.md`)
- Booking Agent → Patient Context RAG: retrieves context (evidence: `README.md`)
- Booking Agent → Booking Validation: validates booking (evidence: `README.md`)
- Booking Validation → Doctor Selection: selects doctor (evidence: `README.md`)
- Doctor Selection → Doctor: uses family doctor (evidence: `README.md`)
- Patient Context RAG → Patient Records: retrieves data (evidence: `README.md`)
- Booking Validation → Appointments: stores confirmed (evidence: `README.md`)
- Booking Agent → Doctor Notifications: creates notifications (evidence: `README.md`)
- Patient Portal → Appointments: views appointments (evidence: `README.md`)
- Patient Portal → Doctor Notifications: views notifications (evidence: `README.md`)
