# mirak10/cms architecture

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

- Interactive diagram: https://gitdiagram.com/mirak10/cms
- Repository: https://github.com/mirak10/cms

## Overview

This is a JavaFX clinic appointment-management application. Patients browse doctors and available slots, create an appointment, then pay; doctors and administrators review appointments and change their status, while administrators also manage doctors and slots. The graph separates UI, appointment and payment workflows, practice management, and persistence. Some subsystem links are based on SOURCE INDEX references rather than excerpts; uncertain booking-service persistence is therefore not asserted.

Main entry points: [`src/controller/patient/PatientAppointmentController.java`](https://github.com/mirak10/cms/blob/master/src/controller/patient/PatientAppointmentController.java) (Patient appointments), [`src/controller/LoginController.java`](https://github.com/mirak10/cms/blob/master/src/controller/LoginController.java) (Login and signup), [`src/service/AppointmentServiceImpl.java`](https://github.com/mirak10/cms/blob/master/src/service/AppointmentServiceImpl.java) (Appointment lifecycle), [`src/ui/SceneNavigator.java`](https://github.com/mirak10/cms/blob/master/src/ui/SceneNavigator.java) (Scene navigation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["User interface"]
  node_app["Application entry<br/>[Main.java]"]
  node_navigation["Scene navigation"]
  node_auth_ui["Login and signup"]
  node_patient_ui["Patient appointments"]
  node_doctor_ui["Doctor appointments"]
  node_admin_ui["Admin appointment management"]
  node_admin_dash["Admin dashboard"]
end

subgraph group_appointments["Appointments and payment"]
  node_booking["Appointment booking"]
  node_appointment_service["Appointment lifecycle"]
  node_appointment_state["Appointment states"]
  node_payment_ui["Payment screen"]
  node_payment_service["Payment processing"]
  node_payment_methods["Payment strategies"]
end

subgraph group_practice["Clinic management"]
  node_doctor_admin["Doctor and slot management"]
  node_doctor_service["Doctor service<br/>[DoctorService.java]"]
  node_doctor_builder["Doctor builder<br/>[DoctorBuilder.java]"]
  node_notifications["Notification service"]
end

subgraph group_data["Persistence and domain"]
  node_appointment_model["Appointment model<br/>[Appointment.java]"]
  node_doctor_model["Doctor model<br/>[Doctor.java]"]
  node_user_model["User model<br/>[User.java]"]
  node_appointment_dao[("Appointment storage")]
  node_doctor_dao[("Doctor storage<br/>[DoctorDao.java]")]
  node_slot_dao[("Doctor slot storage<br/>[DoctorSlotDao.java]")]
  node_user_dao[("User storage<br/>[UserDao.java]")]
  node_notification_dao[("Notification storage")]
  node_payment_dao[("Payment storage<br/>[PaymentDao.java]")]
  node_database[("SQLite connection<br/>[DatabaseUtil.java]")]
  node_user_session["User session<br/>[UserSession.java]"]
end

node_patient(("Patient"))
node_doctor_actor(("Doctor"))
node_admin_actor(("Administrator"))

node_app -->|"sets stage"| node_navigation
node_patient -->|"signs in"| node_auth_ui
node_doctor_actor -->|"signs in"| node_auth_ui
node_admin_actor -->|"signs in"| node_auth_ui
node_auth_ui -->|"authenticates via"| node_user_dao
node_auth_ui -->|"sets session"| node_user_session
node_auth_ui -->|"switches scene"| node_navigation
node_patient -->|"chooses appointment"| node_patient_ui
node_patient_ui -->|"loads doctors"| node_doctor_dao
node_patient_ui -->|"loads and books slots"| node_slot_dao
node_patient_ui -->|"creates appointment"| node_booking
node_patient_ui -->|"creates"| node_appointment_model
node_patient_ui -->|"reads patient"| node_user_session
node_patient_ui -->|"opens payment"| node_navigation
node_booking -->|"accepts"| node_appointment_model
node_payment_ui -->|"processes payment"| node_payment_service
node_payment_service -->|"uses strategy"| node_payment_methods
node_payment_ui -->|"saves payment"| node_payment_dao
node_payment_ui -->|"confirms appointment"| node_appointment_service
node_payment_ui -->|"returns dashboard"| node_navigation
node_doctor_actor -->|"reviews appointments"| node_doctor_ui
node_doctor_ui -->|"loads appointments"| node_appointment_dao
node_doctor_ui -->|"changes status"| node_appointment_service
node_admin_actor -->|"manages appointments"| node_admin_ui
node_admin_ui -->|"changes appointments"| node_appointment_service
node_admin_actor -.->|"opens dashboard"| node_admin_dash
node_admin_dash -.->|"switches scene"| node_navigation
node_admin_actor -->|"manages doctors"| node_doctor_admin
node_doctor_admin -->|"reads doctors"| node_doctor_dao
node_doctor_admin -->|"manages slots"| node_slot_dao
node_doctor_service -->|"saves doctor"| node_doctor_dao
node_doctor_service -->|"builds doctor"| node_doctor_builder
node_doctor_builder -->|"constructs"| node_doctor_model
node_appointment_service -->|"persists changes"| node_appointment_dao
node_appointment_service -->|"updates state"| node_appointment_state
node_appointment_service -->|"notifies"| node_notifications
node_notifications -->|"stores notifications"| node_notification_dao
node_appointment_dao -->|"opens connection"| node_database
node_doctor_dao -->|"opens connection"| node_database
node_slot_dao -->|"opens connection"| node_database
node_user_dao -->|"opens connection"| node_database
node_notification_dao -->|"opens connection"| node_database

click node_app "https://github.com/mirak10/cms/blob/master/src/Main.java"
click node_navigation "https://github.com/mirak10/cms/blob/master/src/ui/SceneNavigator.java"
click node_auth_ui "https://github.com/mirak10/cms/blob/master/src/controller/LoginController.java"
click node_patient_ui "https://github.com/mirak10/cms/blob/master/src/controller/patient/PatientAppointmentController.java"
click node_doctor_ui "https://github.com/mirak10/cms/blob/master/src/controller/doctor/DoctorAppointmentsController.java"
click node_admin_ui "https://github.com/mirak10/cms/blob/master/src/controller/admin/ManageAppointmentController.java"
click node_admin_dash "https://github.com/mirak10/cms/blob/master/src/controller/admin/AdminDashboardController.java"
click node_booking "https://github.com/mirak10/cms/blob/master/src/service/AppointmentBookingServiceImpl.java"
click node_appointment_service "https://github.com/mirak10/cms/blob/master/src/service/AppointmentServiceImpl.java"
click node_appointment_state "https://github.com/mirak10/cms/blob/master/src/pattern/state/AppointmentContext.java"
click node_payment_ui "https://github.com/mirak10/cms/blob/master/src/controller/PaymentController.java"
click node_payment_service "https://github.com/mirak10/cms/blob/master/src/service/PaymentService.java"
click node_payment_methods "https://github.com/mirak10/cms/blob/master/src/pattern/strategy/PaymentStrategy.java"
click node_doctor_admin "https://github.com/mirak10/cms/blob/master/src/controller/admin/ManageDoctorSlotsController.java"
click node_doctor_service "https://github.com/mirak10/cms/blob/master/src/service/DoctorService.java"
click node_doctor_builder "https://github.com/mirak10/cms/blob/master/src/pattern/builder/DoctorBuilder.java"
click node_notifications "https://github.com/mirak10/cms/blob/master/src/pattern/observer/NotificationService.java"
click node_appointment_model "https://github.com/mirak10/cms/blob/master/src/model/Appointment.java"
click node_doctor_model "https://github.com/mirak10/cms/blob/master/src/model/Doctor.java"
click node_user_model "https://github.com/mirak10/cms/blob/master/src/model/User.java"
click node_appointment_dao "https://github.com/mirak10/cms/blob/master/src/dao/AppointmentDao.java"
click node_doctor_dao "https://github.com/mirak10/cms/blob/master/src/dao/DoctorDao.java"
click node_slot_dao "https://github.com/mirak10/cms/blob/master/src/dao/DoctorSlotDao.java"
click node_user_dao "https://github.com/mirak10/cms/blob/master/src/dao/UserDao.java"
click node_notification_dao "https://github.com/mirak10/cms/blob/master/src/dao/NotificationDao.java"
click node_payment_dao "https://github.com/mirak10/cms/blob/master/src/dao/PaymentDao.java"
click node_database "https://github.com/mirak10/cms/blob/master/src/util/DatabaseUtil.java"
click node_user_session "https://github.com/mirak10/cms/blob/master/src/util/UserSession.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_navigation,node_auth_ui,node_patient_ui,node_doctor_ui,node_admin_ui,node_admin_dash toneBlue
class node_booking,node_appointment_service,node_appointment_state,node_payment_ui,node_payment_service,node_payment_methods toneAmber
class node_doctor_admin,node_doctor_service,node_doctor_builder,node_notifications toneMint
class node_appointment_model,node_doctor_model,node_user_model,node_appointment_dao,node_doctor_dao,node_slot_dao,node_user_dao,node_notification_dao,node_payment_dao,node_database,node_user_session toneRose
class node_patient,node_doctor_actor,node_admin_actor toneIndigo
```

## Components

### User interface

- [Application entry](https://github.com/mirak10/cms/blob/master/src/Main.java): `src/Main.java`
- [Scene navigation](https://github.com/mirak10/cms/blob/master/src/ui/SceneNavigator.java): `src/ui/SceneNavigator.java`
- [Login and signup](https://github.com/mirak10/cms/blob/master/src/controller/LoginController.java): `src/controller/LoginController.java`
- [Patient appointments](https://github.com/mirak10/cms/blob/master/src/controller/patient/PatientAppointmentController.java): `src/controller/patient/PatientAppointmentController.java`
- [Doctor appointments](https://github.com/mirak10/cms/blob/master/src/controller/doctor/DoctorAppointmentsController.java): `src/controller/doctor/DoctorAppointmentsController.java`
- [Admin appointment management](https://github.com/mirak10/cms/blob/master/src/controller/admin/ManageAppointmentController.java): `src/controller/admin/ManageAppointmentController.java`
- [Admin dashboard](https://github.com/mirak10/cms/blob/master/src/controller/admin/AdminDashboardController.java): `src/controller/admin/AdminDashboardController.java`

### Appointments and payment

- [Appointment booking](https://github.com/mirak10/cms/blob/master/src/service/AppointmentBookingServiceImpl.java): `src/service/AppointmentBookingServiceImpl.java`
- [Appointment lifecycle](https://github.com/mirak10/cms/blob/master/src/service/AppointmentServiceImpl.java): `src/service/AppointmentServiceImpl.java`
- [Appointment states](https://github.com/mirak10/cms/blob/master/src/pattern/state/AppointmentContext.java): `src/pattern/state/AppointmentContext.java`
- [Payment screen](https://github.com/mirak10/cms/blob/master/src/controller/PaymentController.java): `src/controller/PaymentController.java`
- [Payment processing](https://github.com/mirak10/cms/blob/master/src/service/PaymentService.java): `src/service/PaymentService.java`
- [Payment strategies](https://github.com/mirak10/cms/blob/master/src/pattern/strategy/PaymentStrategy.java): `src/pattern/strategy/PaymentStrategy.java`

### Clinic management

- [Doctor and slot management](https://github.com/mirak10/cms/blob/master/src/controller/admin/ManageDoctorSlotsController.java): `src/controller/admin/ManageDoctorSlotsController.java`
- [Doctor service](https://github.com/mirak10/cms/blob/master/src/service/DoctorService.java): `src/service/DoctorService.java`
- [Doctor builder](https://github.com/mirak10/cms/blob/master/src/pattern/builder/DoctorBuilder.java): `src/pattern/builder/DoctorBuilder.java`
- [Notification service](https://github.com/mirak10/cms/blob/master/src/pattern/observer/NotificationService.java): `src/pattern/observer/NotificationService.java`

### Persistence and domain

- [Appointment model](https://github.com/mirak10/cms/blob/master/src/model/Appointment.java): `src/model/Appointment.java`
- [Doctor model](https://github.com/mirak10/cms/blob/master/src/model/Doctor.java): `src/model/Doctor.java`
- [User model](https://github.com/mirak10/cms/blob/master/src/model/User.java): `src/model/User.java`
- [Appointment storage](https://github.com/mirak10/cms/blob/master/src/dao/AppointmentDao.java): `src/dao/AppointmentDao.java`
- [Doctor storage](https://github.com/mirak10/cms/blob/master/src/dao/DoctorDao.java): `src/dao/DoctorDao.java`
- [Doctor slot storage](https://github.com/mirak10/cms/blob/master/src/dao/DoctorSlotDao.java): `src/dao/DoctorSlotDao.java`
- [User storage](https://github.com/mirak10/cms/blob/master/src/dao/UserDao.java): `src/dao/UserDao.java`
- [Notification storage](https://github.com/mirak10/cms/blob/master/src/dao/NotificationDao.java): `src/dao/NotificationDao.java`
- [Payment storage](https://github.com/mirak10/cms/blob/master/src/dao/PaymentDao.java): `src/dao/PaymentDao.java`
- [SQLite connection](https://github.com/mirak10/cms/blob/master/src/util/DatabaseUtil.java): `src/util/DatabaseUtil.java`
- [User session](https://github.com/mirak10/cms/blob/master/src/util/UserSession.java): `src/util/UserSession.java`

### Other components

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

## Connections

- Application entry → Scene navigation: sets stage (evidence: `src/Main.java`)
- Patient → Login and signup: signs in (evidence: `src/controller/LoginController.java`)
- Doctor → Login and signup: signs in (evidence: `src/controller/LoginController.java`)
- Administrator → Login and signup: signs in (evidence: `src/controller/LoginController.java`)
- Login and signup → User storage: authenticates via
- Login and signup → User session: sets session (evidence: `src/controller/LoginController.java`)
- Login and signup → Scene navigation: switches scene (evidence: `src/controller/LoginController.java`)
- Patient → Patient appointments: chooses appointment (evidence: `src/controller/patient/PatientAppointmentController.java`)
- Patient appointments → Doctor storage: loads doctors (evidence: `src/controller/patient/PatientAppointmentController.java`)
- Patient appointments → Doctor slot storage: loads and books slots (evidence: `src/controller/patient/PatientAppointmentController.java`)
- Patient appointments → Appointment booking: creates appointment (evidence: `src/controller/patient/PatientAppointmentController.java`)
- Patient appointments → Appointment model: creates (evidence: `src/controller/patient/PatientAppointmentController.java`)
- Patient appointments → User session: reads patient (evidence: `src/controller/patient/PatientAppointmentController.java`)
- Patient appointments → Scene navigation: opens payment (evidence: `src/controller/patient/PatientAppointmentController.java`)
- Appointment booking → Appointment model: accepts
- Payment screen → Payment processing: processes payment (evidence: `src/controller/PaymentController.java`)
- Payment processing → Payment strategies: uses strategy (evidence: `src/service/PaymentService.java`)
- Payment screen → Payment storage: saves payment (evidence: `src/controller/PaymentController.java`)
- Payment screen → Appointment lifecycle: confirms appointment (evidence: `src/controller/PaymentController.java`)
- Payment screen → Scene navigation: returns dashboard (evidence: `src/controller/PaymentController.java`)
- Doctor → Doctor appointments: reviews appointments (evidence: `src/controller/doctor/DoctorAppointmentsController.java`)
- Doctor appointments → Appointment storage: loads appointments (evidence: `src/controller/doctor/DoctorAppointmentsController.java`)
- Doctor appointments → Appointment lifecycle: changes status (evidence: `src/controller/doctor/DoctorAppointmentsController.java`)
- Administrator → Admin appointment management: manages appointments (evidence: `src/controller/admin/ManageAppointmentController.java`)
- Admin appointment management → Appointment lifecycle: changes appointments (evidence: `src/controller/admin/ManageAppointmentController.java`)
- Administrator → Admin dashboard: opens dashboard
- Admin dashboard → Scene navigation: switches scene
- Administrator → Doctor and slot management: manages doctors (evidence: `src/controller/admin/ManageDoctorSlotsController.java`)
- Doctor and slot management → Doctor storage: reads doctors (evidence: `src/controller/admin/ManageDoctorSlotsController.java`)
- Doctor and slot management → Doctor slot storage: manages slots (evidence: `src/controller/admin/ManageDoctorSlotsController.java`)
- Doctor service → Doctor storage: saves doctor (evidence: `src/service/DoctorService.java`)
- Doctor service → Doctor builder: builds doctor (evidence: `src/service/DoctorService.java`)
- Doctor builder → Doctor model: constructs (evidence: `src/pattern/builder/ConcreteDoctorBuilder.java`)
- Appointment lifecycle → Appointment storage: persists changes (evidence: `src/service/AppointmentServiceImpl.java`)
- Appointment lifecycle → Appointment states: updates state (evidence: `src/service/AppointmentServiceImpl.java`)
- Appointment lifecycle → Notification service: notifies (evidence: `src/service/AppointmentServiceImpl.java`)
- Notification service → Notification storage: stores notifications
- Appointment storage → SQLite connection: opens connection (evidence: `src/dao/AppointmentDao.java`)
- Doctor storage → SQLite connection: opens connection (evidence: `src/dao/DoctorDao.java`)
- Doctor slot storage → SQLite connection: opens connection (evidence: `src/dao/DoctorSlotDao.java`)
- User storage → SQLite connection: opens connection (evidence: `src/dao/UserDao.java`)
- Notification storage → SQLite connection: opens connection (evidence: `src/dao/NotificationDao.java`)
