# davidpark04/hospital-reservation architecture

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

- Interactive diagram: https://gitdiagram.com/davidpark04/hospital-reservation
- Repository: https://github.com/davidpark04/hospital-reservation

## Overview

This is a React/Spring hospital-search and simulated-booking service. Users search by symptoms and region (AI-assisted or direct), inspect hospital details and provenance, choose a sample clinician and slot, then authenticate and confirm a reservation; members can manage reservations and accounts. The graph includes the documented admin and catalog capabilities. Source excerpts show the chat-to-search and booking flows; some controllers and subsystems are represented from the README and source index, so their internal call paths are not inferred.

Main entry points: [`frontend/src/App.tsx`](https://github.com/davidpark04/hospital-reservation/blob/main/frontend/src/App.tsx) (React application), [`backend/src/main/java/kr/dmu/hospital/integration/ChatService.java`](https://github.com/davidpark04/hospital-reservation/blob/main/backend/src/main/java/kr/dmu/hospital/integration/ChatService.java) (AI symptom search), [`backend/src/main/java/kr/dmu/hospital/auth/AuthController.java`](https://github.com/davidpark04/hospital-reservation/blob/main/backend/src/main/java/kr/dmu/hospital/auth/AuthController.java) (Authentication API), [`backend/src/main/java/kr/dmu/hospital/member/MemberService.java`](https://github.com/davidpark04/hospital-reservation/blob/main/backend/src/main/java/kr/dmu/hospital/member/MemberService.java) (Member management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_app["React application<br/>[App.tsx]"]
  node_api["API client<br/>[api.ts]"]
  node_location["Hospital map"]
  node_authui["Social profile UI<br/>[SocialProfile.tsx]"]
end

subgraph group_identity["Identity and accounts"]
  node_authapi["Authentication API"]
  node_social["Social login"]
  node_withdraw["Social withdrawal"]
  node_members["Member management<br/>[MemberService.java]"]
end

subgraph group_discovery["Hospital discovery"]
  node_chat["AI symptom search<br/>[ChatService.java]"]
  node_hospitals["Hospital search and detail"]
  node_catalog["Hospital catalog"]
  node_departments["Department directory<br/>[Departments.java]"]
end

subgraph group_booking["Booking lifecycle"]
  node_bookingapi["Booking endpoints"]
  node_booking["Reservations and slots"]
end

subgraph group_data["Data and integrations"]
  node_mongo[("MongoDB")]
  node_hira["HIRA hospital API"]
  node_openai["OpenAI"]
  node_kakao["Kakao Maps SDK"]
  node_oauth["Google / Kakao OAuth"]
end

node_user(("Patient"))

node_user -->|"uses"| node_app
node_app -->|"requests"| node_api
node_api -->|"calls API"| node_authapi
node_app -->|"renders"| node_authui
node_authui -->|"submits profile"| node_api
node_authapi -.->|"social sign-in"| node_social
node_social -->|"reads / stages"| node_mongo
node_authapi -->|"authorizes"| node_oauth
node_withdraw -->|"verifies withdrawal"| node_members
node_members -->|"cancels reservations"| node_booking
node_members -.->|"updates members"| node_mongo
node_app -->|"submits symptoms"| node_chat
node_chat -->|"extracts conditions"| node_openai
node_chat -->|"searches candidates"| node_hospitals
node_hospitals -->|"queries catalog"| node_catalog
node_catalog -->|"reads catalog"| node_mongo
node_hospitals -->|"loads details"| node_hira
node_chat -->|"resolves specialty"| node_departments
node_app -->|"confirms slot"| node_bookingapi
node_bookingapi -->|"dispatches requests"| node_booking
node_booking -->|"stores reservations"| node_mongo
node_app -->|"shows hospital map"| node_location
node_location -->|"loads map"| node_kakao
node_user -->|"enters account details"| node_authui

click node_app "https://github.com/davidpark04/hospital-reservation/blob/main/frontend/src/App.tsx"
click node_api "https://github.com/davidpark04/hospital-reservation/blob/main/frontend/src/api.ts"
click node_location "https://github.com/davidpark04/hospital-reservation/blob/main/frontend/src/HospitalLocation.tsx"
click node_authui "https://github.com/davidpark04/hospital-reservation/blob/main/frontend/src/SocialProfile.tsx"
click node_authapi "https://github.com/davidpark04/hospital-reservation/blob/main/backend/src/main/java/kr/dmu/hospital/auth/AuthController.java"
click node_social "https://github.com/davidpark04/hospital-reservation/blob/main/backend/src/main/java/kr/dmu/hospital/auth/SocialMemberService.java"
click node_withdraw "https://github.com/davidpark04/hospital-reservation/blob/main/backend/src/main/java/kr/dmu/hospital/auth/SocialWithdrawalService.java"
click node_members "https://github.com/davidpark04/hospital-reservation/blob/main/backend/src/main/java/kr/dmu/hospital/member/MemberService.java"
click node_chat "https://github.com/davidpark04/hospital-reservation/blob/main/backend/src/main/java/kr/dmu/hospital/integration/ChatService.java"
click node_hospitals "https://github.com/davidpark04/hospital-reservation/blob/main/backend/src/main/java/kr/dmu/hospital/integration/HospitalService.java"
click node_catalog "https://github.com/davidpark04/hospital-reservation/blob/main/backend/src/main/java/kr/dmu/hospital/integration/HospitalCatalog.java"
click node_departments "https://github.com/davidpark04/hospital-reservation/blob/main/backend/src/main/java/kr/dmu/hospital/integration/Departments.java"
click node_bookingapi "https://github.com/davidpark04/hospital-reservation/blob/main/backend/src/main/java/kr/dmu/hospital/booking/BookingController.java"
click node_booking "https://github.com/davidpark04/hospital-reservation/blob/main/backend/src/main/java/kr/dmu/hospital/booking/BookingService.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_app,node_api,node_location,node_authui toneBlue
class node_authapi,node_social,node_withdraw,node_members toneAmber
class node_chat,node_hospitals,node_catalog,node_departments toneMint
class node_bookingapi,node_booking toneRose
class node_mongo,node_hira,node_openai,node_kakao,node_oauth,node_user toneIndigo
```

## Components

### Web experience

- [React application](https://github.com/davidpark04/hospital-reservation/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [API client](https://github.com/davidpark04/hospital-reservation/blob/main/frontend/src/api.ts): `frontend/src/api.ts`
- [Hospital map](https://github.com/davidpark04/hospital-reservation/blob/main/frontend/src/HospitalLocation.tsx): `frontend/src/HospitalLocation.tsx`
- [Social profile UI](https://github.com/davidpark04/hospital-reservation/blob/main/frontend/src/SocialProfile.tsx): `frontend/src/SocialProfile.tsx`

### Identity and accounts

- [Authentication API](https://github.com/davidpark04/hospital-reservation/blob/main/backend/src/main/java/kr/dmu/hospital/auth/AuthController.java): `backend/src/main/java/kr/dmu/hospital/auth/AuthController.java`
- [Social login](https://github.com/davidpark04/hospital-reservation/blob/main/backend/src/main/java/kr/dmu/hospital/auth/SocialMemberService.java): `backend/src/main/java/kr/dmu/hospital/auth/SocialMemberService.java`
- [Social withdrawal](https://github.com/davidpark04/hospital-reservation/blob/main/backend/src/main/java/kr/dmu/hospital/auth/SocialWithdrawalService.java): `backend/src/main/java/kr/dmu/hospital/auth/SocialWithdrawalService.java`
- [Member management](https://github.com/davidpark04/hospital-reservation/blob/main/backend/src/main/java/kr/dmu/hospital/member/MemberService.java): `backend/src/main/java/kr/dmu/hospital/member/MemberService.java`

### Hospital discovery

- [AI symptom search](https://github.com/davidpark04/hospital-reservation/blob/main/backend/src/main/java/kr/dmu/hospital/integration/ChatService.java): `backend/src/main/java/kr/dmu/hospital/integration/ChatService.java`
- [Hospital search and detail](https://github.com/davidpark04/hospital-reservation/blob/main/backend/src/main/java/kr/dmu/hospital/integration/HospitalService.java): `backend/src/main/java/kr/dmu/hospital/integration/HospitalService.java`
- [Hospital catalog](https://github.com/davidpark04/hospital-reservation/blob/main/backend/src/main/java/kr/dmu/hospital/integration/HospitalCatalog.java): `backend/src/main/java/kr/dmu/hospital/integration/HospitalCatalog.java`
- [Department directory](https://github.com/davidpark04/hospital-reservation/blob/main/backend/src/main/java/kr/dmu/hospital/integration/Departments.java): `backend/src/main/java/kr/dmu/hospital/integration/Departments.java`

### Booking lifecycle

- [Booking endpoints](https://github.com/davidpark04/hospital-reservation/blob/main/backend/src/main/java/kr/dmu/hospital/booking/BookingController.java): `backend/src/main/java/kr/dmu/hospital/booking/BookingController.java`
- [Reservations and slots](https://github.com/davidpark04/hospital-reservation/blob/main/backend/src/main/java/kr/dmu/hospital/booking/BookingService.java): `backend/src/main/java/kr/dmu/hospital/booking/BookingService.java`

### Data and integrations

- **MongoDB**
- **HIRA hospital API**
- **OpenAI**
- **Kakao Maps SDK**
- **Google / Kakao OAuth**

### Other components

- **Patient**

## Connections

- Patient → React application: uses (evidence: `README.md`)
- React application → API client: requests (evidence: `frontend/src/App.tsx`)
- API client → Authentication API: calls API (evidence: `README.md`)
- React application → Social profile UI: renders (evidence: `frontend/src/App.tsx`)
- Social profile UI → API client: submits profile (evidence: `frontend/src/SocialProfile.tsx`)
- Authentication API → Social login: social sign-in
- Social login → MongoDB: reads / stages (evidence: `backend/src/main/java/kr/dmu/hospital/auth/SocialMemberService.java`)
- Authentication API → Google / Kakao OAuth: authorizes (evidence: `README.md`)
- Social withdrawal → Member management: verifies withdrawal (evidence: `backend/src/main/java/kr/dmu/hospital/auth/SocialWithdrawalService.java`)
- Member management → Reservations and slots: cancels reservations (evidence: `backend/src/main/java/kr/dmu/hospital/member/MemberService.java`)
- Member management → MongoDB: updates members
- React application → AI symptom search: submits symptoms (evidence: `README.md`)
- AI symptom search → OpenAI: extracts conditions (evidence: `backend/src/main/java/kr/dmu/hospital/integration/ChatService.java`)
- AI symptom search → Hospital search and detail: searches candidates (evidence: `backend/src/main/java/kr/dmu/hospital/integration/ChatService.java`)
- Hospital search and detail → Hospital catalog: queries catalog (evidence: `backend/src/main/java/kr/dmu/hospital/integration/HospitalService.java`)
- Hospital catalog → MongoDB: reads catalog (evidence: `README.md`)
- Hospital search and detail → HIRA hospital API: loads details (evidence: `backend/src/main/java/kr/dmu/hospital/integration/HospitalService.java`)
- AI symptom search → Department directory: resolves specialty (evidence: `backend/src/main/java/kr/dmu/hospital/integration/ChatService.java`)
- React application → Booking endpoints: confirms slot (evidence: `frontend/src/App.tsx`)
- Booking endpoints → Reservations and slots: dispatches requests (evidence: `backend/src/main/java/kr/dmu/hospital/booking/BookingController.java`)
- Reservations and slots → MongoDB: stores reservations (evidence: `README.md`)
- React application → Hospital map: shows hospital map (evidence: `frontend/src/App.tsx`)
- Hospital map → Kakao Maps SDK: loads map (evidence: `frontend/src/HospitalLocation.tsx`)
- Patient → Social profile UI: enters account details (evidence: `README.md`)
