# pankajmutha14/doctor-appointment-app architecture

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

- Interactive diagram: https://gitdiagram.com/pankajmutha14/doctor-appointment-app
- Repository: https://github.com/pankajmutha14/doctor-appointment-app

## Overview

This repository is a Spring-based appointment-booking system split into doctor search, booking, patient lookup, and payment services, with a Eureka service-discovery application. The visible user flow supports searching available doctors and requesting a booking by doctor, patient, date, and time; payment is implemented as a separate Stripe checkout capability, but no booking-to-payment call is shown. Edges reflect sampled code or explicit client configuration; source for Eureka wiring and service persistence configuration was not sampled.

Main entry points: [`doctor-service/src/main/java/com/doctor_service/controller/SearchController.java`](https://github.com/pankajmutha14/doctor-appointment-app/blob/main/doctor-service/src/main/java/com/doctor_service/controller/SearchController.java) (Doctor search API), [`booking-service/src/main/java/com/booking_service/controller/BookingController.java`](https://github.com/pankajmutha14/doctor-appointment-app/blob/main/booking-service/src/main/java/com/booking_service/controller/BookingController.java) (Booking API), [`payment-service/src/main/java/com/payment_service/controller/ProductCheckoutController.java`](https://github.com/pankajmutha14/doctor-appointment-app/blob/main/payment-service/src/main/java/com/payment_service/controller/ProductCheckoutController.java) (Checkout API), [`payment-service/src/main/java/com/payment_service/service/StripeService.java`](https://github.com/pankajmutha14/doctor-appointment-app/blob/main/payment-service/src/main/java/com/payment_service/service/StripeService.java) (Stripe session service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_search["Doctor search"]
  node_search_api["Doctor search API"]
  node_doctor_repo["Doctor repository"]
  node_slots_repo["Slot repository"]
  node_doctor_entity["Doctor schedule model<br/>[Doctor.java]"]
  node_search_result["Search result DTO"]
end

subgraph group_booking["Appointment booking"]
  node_booking_api["Booking API"]
  node_doctor_client["Doctor client<br/>[DoctorClient.java]"]
  node_patient_client["Patient client<br/>[PatientClient.java]"]
  node_booking_model["Booking confirmation"]
end

subgraph group_patient["Patient records"]
  node_patient_api["Patient lookup API"]
  node_patient_repo["Patient repository"]
  node_patient_model["Patient record<br/>[Patient.java]"]
end

subgraph group_payment["Payment checkout"]
  node_checkout_api["Checkout API"]
  node_stripe_service["Stripe session service<br/>[StripeService.java]"]
  node_product_request["Checkout request"]
  node_stripe_response["Checkout response"]
end

subgraph group_discovery["Service discovery"]
  node_eureka["Eureka server"]
end

node_user(("User"))
node_stripe["Stripe"]

node_user -->|"searches"| node_search_api
node_search_api -->|"queries doctors"| node_doctor_repo
node_search_api -->|"loads slots"| node_slots_repo
node_search_api -->|"reads schedules"| node_doctor_entity
node_search_api -->|"builds results"| node_search_result
node_user -->|"requests booking"| node_booking_api
node_booking_api -->|"fetches patient"| node_patient_client
node_patient_client -->|"calls lookup"| node_patient_api
node_booking_api -->|"fetches doctor"| node_doctor_client
node_doctor_client -.->|"calls doctor service"| node_search_api
node_booking_api -->|"builds confirmation"| node_booking_model
node_patient_api -->|"looks up patient"| node_patient_repo
node_patient_repo -->|"loads entity"| node_patient_model
node_user -->|"starts checkout"| node_checkout_api
node_checkout_api -->|"accepts request"| node_product_request
node_checkout_api -->|"creates session"| node_stripe_service
node_stripe_service -->|"creates session"| node_stripe
node_stripe_service -->|"returns session details"| node_stripe_response
node_stripe_response -->|"returns response"| node_checkout_api

click node_search_api "https://github.com/pankajmutha14/doctor-appointment-app/blob/main/doctor-service/src/main/java/com/doctor_service/controller/SearchController.java"
click node_doctor_repo "https://github.com/pankajmutha14/doctor-appointment-app/blob/main/doctor-service/src/main/java/com/doctor_service/repository/DoctorRepository.java"
click node_slots_repo "https://github.com/pankajmutha14/doctor-appointment-app/blob/main/doctor-service/src/main/java/com/doctor_service/repository/TimeSlotsRepository.java"
click node_doctor_entity "https://github.com/pankajmutha14/doctor-appointment-app/blob/main/doctor-service/src/main/java/com/doctor_service/entity/Doctor.java"
click node_search_result "https://github.com/pankajmutha14/doctor-appointment-app/blob/main/doctor-service/src/main/java/com/doctor_service/dto/SearchResultDto.java"
click node_booking_api "https://github.com/pankajmutha14/doctor-appointment-app/blob/main/booking-service/src/main/java/com/booking_service/controller/BookingController.java"
click node_doctor_client "https://github.com/pankajmutha14/doctor-appointment-app/blob/main/booking-service/src/main/java/com/booking_service/client/DoctorClient.java"
click node_patient_client "https://github.com/pankajmutha14/doctor-appointment-app/blob/main/booking-service/src/main/java/com/booking_service/client/PatientClient.java"
click node_booking_model "https://github.com/pankajmutha14/doctor-appointment-app/blob/main/booking-service/src/main/java/com/booking_service/entity/BookingConfirmation.java"
click node_patient_api "https://github.com/pankajmutha14/doctor-appointment-app/blob/main/patient-service/src/main/java/com/patient_service/controller/PatientController.java"
click node_patient_repo "https://github.com/pankajmutha14/doctor-appointment-app/blob/main/patient-service/src/main/java/com/patient_service/repository/PatientRepository.java"
click node_patient_model "https://github.com/pankajmutha14/doctor-appointment-app/blob/main/patient-service/src/main/java/com/patient_service/entity/Patient.java"
click node_checkout_api "https://github.com/pankajmutha14/doctor-appointment-app/blob/main/payment-service/src/main/java/com/payment_service/controller/ProductCheckoutController.java"
click node_stripe_service "https://github.com/pankajmutha14/doctor-appointment-app/blob/main/payment-service/src/main/java/com/payment_service/service/StripeService.java"
click node_product_request "https://github.com/pankajmutha14/doctor-appointment-app/blob/main/payment-service/src/main/java/com/payment_service/dto/ProductRequest.java"
click node_stripe_response "https://github.com/pankajmutha14/doctor-appointment-app/blob/main/payment-service/src/main/java/com/payment_service/dto/StripeResponse.java"
click node_eureka "https://github.com/pankajmutha14/doctor-appointment-app/blob/main/eureka/src/main/java/com/eureka/EurekaApplication.java"

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_search_api,node_doctor_repo,node_slots_repo,node_doctor_entity,node_search_result,node_user toneBlue
class node_booking_api,node_doctor_client,node_patient_client,node_booking_model toneAmber
class node_patient_api,node_patient_repo,node_patient_model toneMint
class node_checkout_api,node_stripe_service,node_product_request,node_stripe_response toneRose
class node_eureka,node_stripe toneIndigo
```

## Components

### Doctor search

- [Doctor search API](https://github.com/pankajmutha14/doctor-appointment-app/blob/main/doctor-service/src/main/java/com/doctor_service/controller/SearchController.java): `doctor-service/src/main/java/com/doctor_service/controller/SearchController.java`
- [Doctor repository](https://github.com/pankajmutha14/doctor-appointment-app/blob/main/doctor-service/src/main/java/com/doctor_service/repository/DoctorRepository.java): `doctor-service/src/main/java/com/doctor_service/repository/DoctorRepository.java`
- [Slot repository](https://github.com/pankajmutha14/doctor-appointment-app/blob/main/doctor-service/src/main/java/com/doctor_service/repository/TimeSlotsRepository.java): `doctor-service/src/main/java/com/doctor_service/repository/TimeSlotsRepository.java`
- [Doctor schedule model](https://github.com/pankajmutha14/doctor-appointment-app/blob/main/doctor-service/src/main/java/com/doctor_service/entity/Doctor.java): `doctor-service/src/main/java/com/doctor_service/entity/Doctor.java`
- [Search result DTO](https://github.com/pankajmutha14/doctor-appointment-app/blob/main/doctor-service/src/main/java/com/doctor_service/dto/SearchResultDto.java): `doctor-service/src/main/java/com/doctor_service/dto/SearchResultDto.java`

### Appointment booking

- [Booking API](https://github.com/pankajmutha14/doctor-appointment-app/blob/main/booking-service/src/main/java/com/booking_service/controller/BookingController.java): `booking-service/src/main/java/com/booking_service/controller/BookingController.java`
- [Doctor client](https://github.com/pankajmutha14/doctor-appointment-app/blob/main/booking-service/src/main/java/com/booking_service/client/DoctorClient.java): `booking-service/src/main/java/com/booking_service/client/DoctorClient.java`
- [Patient client](https://github.com/pankajmutha14/doctor-appointment-app/blob/main/booking-service/src/main/java/com/booking_service/client/PatientClient.java): `booking-service/src/main/java/com/booking_service/client/PatientClient.java`
- [Booking confirmation](https://github.com/pankajmutha14/doctor-appointment-app/blob/main/booking-service/src/main/java/com/booking_service/entity/BookingConfirmation.java): `booking-service/src/main/java/com/booking_service/entity/BookingConfirmation.java`

### Patient records

- [Patient lookup API](https://github.com/pankajmutha14/doctor-appointment-app/blob/main/patient-service/src/main/java/com/patient_service/controller/PatientController.java): `patient-service/src/main/java/com/patient_service/controller/PatientController.java`
- [Patient repository](https://github.com/pankajmutha14/doctor-appointment-app/blob/main/patient-service/src/main/java/com/patient_service/repository/PatientRepository.java): `patient-service/src/main/java/com/patient_service/repository/PatientRepository.java`
- [Patient record](https://github.com/pankajmutha14/doctor-appointment-app/blob/main/patient-service/src/main/java/com/patient_service/entity/Patient.java): `patient-service/src/main/java/com/patient_service/entity/Patient.java`

### Payment checkout

- [Checkout API](https://github.com/pankajmutha14/doctor-appointment-app/blob/main/payment-service/src/main/java/com/payment_service/controller/ProductCheckoutController.java): `payment-service/src/main/java/com/payment_service/controller/ProductCheckoutController.java`
- [Stripe session service](https://github.com/pankajmutha14/doctor-appointment-app/blob/main/payment-service/src/main/java/com/payment_service/service/StripeService.java): `payment-service/src/main/java/com/payment_service/service/StripeService.java`
- [Checkout request](https://github.com/pankajmutha14/doctor-appointment-app/blob/main/payment-service/src/main/java/com/payment_service/dto/ProductRequest.java): `payment-service/src/main/java/com/payment_service/dto/ProductRequest.java`
- [Checkout response](https://github.com/pankajmutha14/doctor-appointment-app/blob/main/payment-service/src/main/java/com/payment_service/dto/StripeResponse.java): `payment-service/src/main/java/com/payment_service/dto/StripeResponse.java`

### Service discovery

- [Eureka server](https://github.com/pankajmutha14/doctor-appointment-app/blob/main/eureka/src/main/java/com/eureka/EurekaApplication.java): `eureka/src/main/java/com/eureka/EurekaApplication.java`

### Other components

- **User**
- **Stripe**

## Connections

- User → Doctor search API: searches (evidence: `doctor-service/src/main/java/com/doctor_service/controller/SearchController.java`)
- Doctor search API → Doctor repository: queries doctors (evidence: `doctor-service/src/main/java/com/doctor_service/controller/SearchController.java`)
- Doctor search API → Slot repository: loads slots (evidence: `doctor-service/src/main/java/com/doctor_service/controller/SearchController.java`)
- Doctor search API → Doctor schedule model: reads schedules (evidence: `doctor-service/src/main/java/com/doctor_service/controller/SearchController.java`)
- Doctor search API → Search result DTO: builds results (evidence: `doctor-service/src/main/java/com/doctor_service/controller/SearchController.java`)
- User → Booking API: requests booking (evidence: `booking-service/src/main/java/com/booking_service/controller/BookingController.java`)
- Booking API → Patient client: fetches patient (evidence: `booking-service/src/main/java/com/booking_service/controller/BookingController.java`)
- Patient client → Patient lookup API: calls lookup (evidence: `booking-service/src/main/java/com/booking_service/client/PatientClient.java`)
- Booking API → Doctor client: fetches doctor (evidence: `booking-service/src/main/java/com/booking_service/controller/BookingController.java`)
- Doctor client → Doctor search API: calls doctor service (evidence: `booking-service/src/main/java/com/booking_service/client/DoctorClient.java`)
- Booking API → Booking confirmation: builds confirmation (evidence: `booking-service/src/main/java/com/booking_service/controller/BookingController.java`)
- Patient lookup API → Patient repository: looks up patient (evidence: `patient-service/src/main/java/com/patient_service/controller/PatientController.java`)
- Patient repository → Patient record: loads entity (evidence: `patient-service/src/main/java/com/patient_service/repository/PatientRepository.java`)
- User → Checkout API: starts checkout (evidence: `payment-service/src/main/java/com/payment_service/controller/ProductCheckoutController.java`)
- Checkout API → Checkout request: accepts request (evidence: `payment-service/src/main/java/com/payment_service/controller/ProductCheckoutController.java`)
- Checkout API → Stripe session service: creates session (evidence: `payment-service/src/main/java/com/payment_service/controller/ProductCheckoutController.java`)
- Stripe session service → Stripe: creates session (evidence: `payment-service/src/main/java/com/payment_service/service/StripeService.java`)
- Stripe session service → Checkout response: returns session details (evidence: `payment-service/src/main/java/com/payment_service/service/StripeService.java`)
- Checkout response → Checkout API: returns response (evidence: `payment-service/src/main/java/com/payment_service/controller/ProductCheckoutController.java`)
