# sayinanger/clinicfamily architecture

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

- Interactive diagram: https://gitdiagram.com/sayinanger/clinicfamily
- Repository: https://github.com/sayinanger/clinicfamily

## Overview

Clinicfamily is a React frontend for clinic appointments through LINE LIFF, plus a staff administration site. Patients enter through LIFF, complete privacy consent and profile steps, then book, review, cancel, or reschedule appointments; staff authenticate before managing appointments and slots or viewing statistics. Both areas use a shared API layer, which can switch between server requests and in-memory mock data. The graph follows documented routes and visible imports/calls; backend API details are limited to the frontend contract, and unsampled pages are represented by their indexed modules.

Main entry points: [`client/src/App.jsx`](https://github.com/sayinanger/clinicfamily/blob/main/client/src/App.jsx) (Route Dispatcher), [`client/src/lib/api.js`](https://github.com/sayinanger/clinicfamily/blob/main/client/src/lib/api.js) (API Client), [`client/src/layouts/LiffLayout.jsx`](https://github.com/sayinanger/clinicfamily/blob/main/client/src/layouts/LiffLayout.jsx) (LIFF Gate), [`client/src/pages/liff/LiffBooking.jsx`](https://github.com/sayinanger/clinicfamily/blob/main/client/src/pages/liff/LiffBooking.jsx) (Booking Flow)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_patient["Patient LIFF"]
  node_liff_layout["LIFF Gate<br/>[LiffLayout.jsx]"]
  node_pdpa["Privacy Consent<br/>[LiffPdpa.jsx]"]
  node_profile["Patient Profile<br/>[LiffProfile.jsx]"]
  node_home["Patient Home<br/>[LiffHome.jsx]"]
  node_booking["Booking Flow<br/>[LiffBooking.jsx]"]
  node_calendar["Booking Calendar"]
  node_appointment["Appointment Actions"]
  node_popup["Confirmation Popups<br/>[Popup.jsx]"]
end

subgraph group_staff["Staff Admin"]
  node_admin_login["Staff Login<br/>[AdminLogin.jsx]"]
  node_admin_layout["Staff Session Gate<br/>[AdminLayout.jsx]"]
  node_admin_appointments["Appointment Management"]
  node_date_picker["Staff Date Picker<br/>[DatePickerBox.jsx]"]
  node_admin_slots["Slot Management<br/>[AdminSlots.jsx]"]
  node_admin_stats["Clinic Statistics<br/>[AdminStats.jsx]"]
end

subgraph group_shared["Shared Frontend Services"]
  node_api["API Client<br/>[api.js]"]
  node_mock[("Mock API Data<br/>[mock.js]")]
  node_format["Thai Formatting<br/>[format.js]"]
end

subgraph group_runtime["Runtime Integrations"]
  node_app["Route Dispatcher<br/>[App.jsx]"]
  node_liff["LIFF Integration<br/>[liff.js]"]
end

node_patient_actor(("Patient"))
node_staff_actor(("Clinic Staff"))
node_line{{"LINE LIFF"}}
node_backend{{"Clinic API Server"}}

node_patient_actor -->|"opens patient routes"| node_app
node_staff_actor -->|"opens admin routes"| node_app
node_app -->|"routes through"| node_liff_layout
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_pdpa
node_app -->|"routes to"| node_profile
node_app -->|"routes to"| node_booking
node_app -->|"routes to"| node_appointment
node_liff_layout -->|"initializes"| node_liff
node_liff_layout -->|"loads patient state"| node_api
node_liff_layout -->|"gates patient pages"| node_pdpa
node_pdpa -->|"saves consent"| node_api
node_profile -->|"reads and saves profile"| node_api
node_home -->|"loads home data"| node_api
node_booking -->|"holds and books slots"| node_api
node_booking -->|"renders calendar"| node_calendar
node_booking -->|"shows confirmations"| node_popup
node_appointment -->|"loads and changes appointment"| node_api
node_appointment -->|"shows confirmations"| node_popup
node_appointment -->|"closes LIFF window"| node_liff
node_app -->|"routes to"| node_admin_login
node_app -->|"routes through"| node_admin_layout
node_app -->|"routes to"| node_admin_appointments
node_app -->|"routes to"| node_admin_slots
node_app -->|"routes to"| node_admin_stats
node_admin_login -->|"authenticates staff"| node_api
node_admin_layout -->|"checks and ends session"| node_api
node_admin_appointments -->|"loads and updates appointments"| node_api
node_admin_appointments -->|"uses date picker"| node_date_picker
node_admin_slots -->|"manages slots"| node_api
node_admin_slots -->|"uses date picker"| node_date_picker
node_admin_stats -->|"loads statistics"| node_api
node_admin_appointments -->|"formats dates"| node_format
node_admin_stats -->|"formats chart labels"| node_format
node_api -->|"dispatches mock requests"| node_mock
node_api -->|"sends HTTP requests"| node_backend
node_liff -->|"initializes and reads profile"| node_line
node_liff -->|"sets LINE token"| node_api

click node_app "https://github.com/sayinanger/clinicfamily/blob/main/client/src/App.jsx"
click node_liff_layout "https://github.com/sayinanger/clinicfamily/blob/main/client/src/layouts/LiffLayout.jsx"
click node_pdpa "https://github.com/sayinanger/clinicfamily/blob/main/client/src/pages/liff/LiffPdpa.jsx"
click node_profile "https://github.com/sayinanger/clinicfamily/blob/main/client/src/pages/liff/LiffProfile.jsx"
click node_home "https://github.com/sayinanger/clinicfamily/blob/main/client/src/pages/liff/LiffHome.jsx"
click node_booking "https://github.com/sayinanger/clinicfamily/blob/main/client/src/pages/liff/LiffBooking.jsx"
click node_calendar "https://github.com/sayinanger/clinicfamily/blob/main/client/src/components/BookingCalendar.jsx"
click node_appointment "https://github.com/sayinanger/clinicfamily/blob/main/client/src/pages/liff/LiffAppointment.jsx"
click node_popup "https://github.com/sayinanger/clinicfamily/blob/main/client/src/components/Popup.jsx"
click node_admin_login "https://github.com/sayinanger/clinicfamily/blob/main/client/src/pages/admin/AdminLogin.jsx"
click node_admin_layout "https://github.com/sayinanger/clinicfamily/blob/main/client/src/layouts/AdminLayout.jsx"
click node_admin_appointments "https://github.com/sayinanger/clinicfamily/blob/main/client/src/pages/admin/AdminAppointments.jsx"
click node_date_picker "https://github.com/sayinanger/clinicfamily/blob/main/client/src/components/DatePickerBox.jsx"
click node_admin_slots "https://github.com/sayinanger/clinicfamily/blob/main/client/src/pages/admin/AdminSlots.jsx"
click node_admin_stats "https://github.com/sayinanger/clinicfamily/blob/main/client/src/pages/admin/AdminStats.jsx"
click node_api "https://github.com/sayinanger/clinicfamily/blob/main/client/src/lib/api.js"
click node_mock "https://github.com/sayinanger/clinicfamily/blob/main/client/src/lib/mock.js"
click node_format "https://github.com/sayinanger/clinicfamily/blob/main/client/src/lib/format.js"
click node_liff "https://github.com/sayinanger/clinicfamily/blob/main/client/src/lib/liff.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_liff_layout,node_pdpa,node_profile,node_home,node_booking,node_calendar,node_appointment,node_popup toneBlue
class node_admin_login,node_admin_layout,node_admin_appointments,node_date_picker,node_admin_slots,node_admin_stats toneAmber
class node_api,node_mock,node_format,node_backend toneMint
class node_app,node_liff toneRose
class node_patient_actor,node_staff_actor,node_line toneIndigo
```

## Components

### Patient LIFF

- [LIFF Gate](https://github.com/sayinanger/clinicfamily/blob/main/client/src/layouts/LiffLayout.jsx): `client/src/layouts/LiffLayout.jsx`
- [Privacy Consent](https://github.com/sayinanger/clinicfamily/blob/main/client/src/pages/liff/LiffPdpa.jsx): `client/src/pages/liff/LiffPdpa.jsx`
- [Patient Profile](https://github.com/sayinanger/clinicfamily/blob/main/client/src/pages/liff/LiffProfile.jsx): `client/src/pages/liff/LiffProfile.jsx`
- [Patient Home](https://github.com/sayinanger/clinicfamily/blob/main/client/src/pages/liff/LiffHome.jsx): `client/src/pages/liff/LiffHome.jsx`
- [Booking Flow](https://github.com/sayinanger/clinicfamily/blob/main/client/src/pages/liff/LiffBooking.jsx): `client/src/pages/liff/LiffBooking.jsx`
- [Booking Calendar](https://github.com/sayinanger/clinicfamily/blob/main/client/src/components/BookingCalendar.jsx): `client/src/components/BookingCalendar.jsx`
- [Appointment Actions](https://github.com/sayinanger/clinicfamily/blob/main/client/src/pages/liff/LiffAppointment.jsx): `client/src/pages/liff/LiffAppointment.jsx`
- [Confirmation Popups](https://github.com/sayinanger/clinicfamily/blob/main/client/src/components/Popup.jsx): `client/src/components/Popup.jsx`

### Staff Admin

- [Staff Login](https://github.com/sayinanger/clinicfamily/blob/main/client/src/pages/admin/AdminLogin.jsx): `client/src/pages/admin/AdminLogin.jsx`
- [Staff Session Gate](https://github.com/sayinanger/clinicfamily/blob/main/client/src/layouts/AdminLayout.jsx): `client/src/layouts/AdminLayout.jsx`
- [Appointment Management](https://github.com/sayinanger/clinicfamily/blob/main/client/src/pages/admin/AdminAppointments.jsx): `client/src/pages/admin/AdminAppointments.jsx`
- [Staff Date Picker](https://github.com/sayinanger/clinicfamily/blob/main/client/src/components/DatePickerBox.jsx): `client/src/components/DatePickerBox.jsx`
- [Slot Management](https://github.com/sayinanger/clinicfamily/blob/main/client/src/pages/admin/AdminSlots.jsx): `client/src/pages/admin/AdminSlots.jsx`
- [Clinic Statistics](https://github.com/sayinanger/clinicfamily/blob/main/client/src/pages/admin/AdminStats.jsx): `client/src/pages/admin/AdminStats.jsx`

### Shared Frontend Services

- [API Client](https://github.com/sayinanger/clinicfamily/blob/main/client/src/lib/api.js): `client/src/lib/api.js`
- [Mock API Data](https://github.com/sayinanger/clinicfamily/blob/main/client/src/lib/mock.js): `client/src/lib/mock.js`
- [Thai Formatting](https://github.com/sayinanger/clinicfamily/blob/main/client/src/lib/format.js): `client/src/lib/format.js`

### Runtime Integrations

- [Route Dispatcher](https://github.com/sayinanger/clinicfamily/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [LIFF Integration](https://github.com/sayinanger/clinicfamily/blob/main/client/src/lib/liff.js): `client/src/lib/liff.js`

### Other components

- **Patient**
- **Clinic Staff**
- **LINE LIFF**
- **Clinic API Server**

## Connections

- Patient → Route Dispatcher: opens patient routes (evidence: `README.md`)
- Clinic Staff → Route Dispatcher: opens admin routes (evidence: `README.md`)
- Route Dispatcher → LIFF Gate: routes through (evidence: `client/src/App.jsx`)
- Route Dispatcher → Patient Home: routes to (evidence: `client/src/App.jsx`)
- Route Dispatcher → Privacy Consent: routes to (evidence: `client/src/App.jsx`)
- Route Dispatcher → Patient Profile: routes to (evidence: `client/src/App.jsx`)
- Route Dispatcher → Booking Flow: routes to (evidence: `client/src/App.jsx`)
- Route Dispatcher → Appointment Actions: routes to (evidence: `client/src/App.jsx`)
- LIFF Gate → LIFF Integration: initializes (evidence: `client/src/layouts/LiffLayout.jsx`)
- LIFF Gate → API Client: loads patient state (evidence: `client/src/layouts/LiffLayout.jsx`)
- LIFF Gate → Privacy Consent: gates patient pages (evidence: `client/src/App.jsx`)
- Privacy Consent → API Client: saves consent (evidence: `client/src/pages/liff/LiffPdpa.jsx`)
- Patient Profile → API Client: reads and saves profile (evidence: `client/src/pages/liff/LiffProfile.jsx`)
- Patient Home → API Client: loads home data (evidence: `client/src/pages/liff/LiffHome.jsx`)
- Booking Flow → API Client: holds and books slots (evidence: `client/src/pages/liff/LiffBooking.jsx`)
- Booking Flow → Booking Calendar: renders calendar (evidence: `client/src/pages/liff/LiffBooking.jsx`)
- Booking Flow → Confirmation Popups: shows confirmations (evidence: `client/src/pages/liff/LiffBooking.jsx`)
- Appointment Actions → API Client: loads and changes appointment (evidence: `client/src/pages/liff/LiffAppointment.jsx`)
- Appointment Actions → Confirmation Popups: shows confirmations (evidence: `client/src/pages/liff/LiffAppointment.jsx`)
- Appointment Actions → LIFF Integration: closes LIFF window (evidence: `client/src/pages/liff/LiffAppointment.jsx`)
- Route Dispatcher → Staff Login: routes to (evidence: `client/src/App.jsx`)
- Route Dispatcher → Staff Session Gate: routes through (evidence: `client/src/App.jsx`)
- Route Dispatcher → Appointment Management: routes to (evidence: `client/src/App.jsx`)
- Route Dispatcher → Slot Management: routes to (evidence: `client/src/App.jsx`)
- Route Dispatcher → Clinic Statistics: routes to (evidence: `client/src/App.jsx`)
- Staff Login → API Client: authenticates staff (evidence: `client/src/pages/admin/AdminLogin.jsx`)
- Staff Session Gate → API Client: checks and ends session (evidence: `client/src/layouts/AdminLayout.jsx`)
- Appointment Management → API Client: loads and updates appointments (evidence: `client/src/pages/admin/AdminAppointments.jsx`)
- Appointment Management → Staff Date Picker: uses date picker (evidence: `client/src/pages/admin/AdminAppointments.jsx`)
- Slot Management → API Client: manages slots (evidence: `client/src/pages/admin/AdminSlots.jsx`)
- Slot Management → Staff Date Picker: uses date picker (evidence: `client/src/pages/admin/AdminSlots.jsx`)
- Clinic Statistics → API Client: loads statistics (evidence: `client/src/pages/admin/AdminStats.jsx`)
- Appointment Management → Thai Formatting: formats dates (evidence: `client/src/pages/admin/AdminAppointments.jsx`)
- Clinic Statistics → Thai Formatting: formats chart labels (evidence: `client/src/pages/admin/AdminStats.jsx`)
- API Client → Mock API Data: dispatches mock requests (evidence: `client/src/lib/api.js`)
- API Client → Clinic API Server: sends HTTP requests (evidence: `client/src/lib/api.js`)
- LIFF Integration → LINE LIFF: initializes and reads profile (evidence: `client/src/lib/liff.js`)
- LIFF Integration → API Client: sets LINE token (evidence: `client/src/lib/liff.js`)
