How ssathwick007-creator/ghostqueue works
GhostQueue is a hospital appointment and clinical-intelligence desktop application. Admins, doctors, and patients use role-specific interfaces to manage appointments and patients; the system predicts no-show risk, maintains a standby queue, and proposes slot reallocations that require administrator approval. The README also documents reminders, analytics, and configurable facility settings. Several domain modules are represented by their exact tree paths but were not sampled, so their internal call relationships are not asserted.
Main entry points: controller Admin operations UI · AppointmentService.java Appointment services · ReallocationService.java Reallocation approval · PredictionService.java Prediction workflow
Components 21
Role-Based Experience
- JavaFX application
src/main/java/com/ghostqueue/MainApp.java - Admin operations UI
src/main/java/com/ghostqueue/controller - Doctor portal
src/main/java/com/ghostqueue/controller/doctor - Patient portal
src/main/java/com/ghostqueue/controller/patient
Clinical Operations
- Appointment services
src/main/java/com/ghostqueue/service/AppointmentService.java - Waiting queue
src/main/java/com/ghostqueue/service/QueueService.java - Reminders & outreach
src/main/java/com/ghostqueue/service/ReminderService.java - Analytics & reporting
src/main/java/com/ghostqueue/service/AnalyticsService.java - Facility settings
src/main/java/com/ghostqueue/service/SettingsService.java - Clinical domain records
src/main/java/com/ghostqueue/model
Prediction & Reallocation
- No-show prediction
src/main/java/com/ghostqueue/prediction/PredictionEngine.java - Prediction workflow
src/main/java/com/ghostqueue/service/PredictionService.java - Reallocation approval
src/main/java/com/ghostqueue/service/ReallocationService.java - Candidate matching
src/main/java/com/ghostqueue/scheduling/ReallocationEngine.java
Persistence & Configuration
- Clinical repositories
src/main/java/com/ghostqueue/repository - Prediction repository
src/main/java/com/ghostqueue/prediction/PredictionRepository.java - Supabase data backend
src/main/java/com/ghostqueue/repository/supabase
Identity & Notifications
- Supabase authentication
src/main/java/com/ghostqueue/supabase/SupabaseAuthService.java - Session management
src/main/java/com/ghostqueue/supabase/SessionManager.java - In-app notifications
src/main/java/com/ghostqueue/service/NotificationService.java
Other components
- Hospital users
Connections 31
- Hospital users → JavaFX application: use
- JavaFX application → Admin operations UI: hosts
- Hospital users → Admin operations UI: manage operations
- Hospital users → Doctor portal: use portal
- Hospital users → Patient portal: book appointments
- Admin operations UI → Appointment services: manage bookings
src/main/java/com/ghostqueue/controller/AppointmentsController.java - Doctor portal → Appointment services: manage schedules
- Patient portal → Appointment services: request bookings
- Appointment services → Clinical repositories: read and write
src/main/java/com/ghostqueue/service/AppointmentService.java - Appointment services → Clinical domain records: handle appointments
src/main/java/com/ghostqueue/service/AppointmentService.java - Admin operations UI → Prediction workflow: review risk
src/main/java/com/ghostqueue/controller/PredictionController.java - Prediction workflow → Appointment services: load appointments
src/main/java/com/ghostqueue/service/PredictionService.java - Prediction workflow → No-show prediction: run inference
src/main/java/com/ghostqueue/service/PredictionService.java - Prediction workflow → Prediction repository: persist results
src/main/java/com/ghostqueue/service/PredictionService.java - Prediction repository → Supabase data backend: store predictions
- Admin operations UI → Reallocation approval: review suggestions
src/main/java/com/ghostqueue/controller/ReallocationController.java - Reallocation approval → Candidate matching: rank candidates
src/main/java/com/ghostqueue/service/ReallocationService.java - Reallocation approval → Appointment services: inspect slots
src/main/java/com/ghostqueue/service/ReallocationService.java - Reallocation approval → Waiting queue: update candidate status
src/main/java/com/ghostqueue/service/ReallocationService.java - Reallocation approval → Clinical repositories: record approval
src/main/java/com/ghostqueue/service/ReallocationService.java - Admin operations UI → Waiting queue: manage standby pool
- Admin operations UI → Reminders & outreach: coordinate outreach
- Admin operations UI → Analytics & reporting: review reports
- Admin operations UI → Facility settings: configure facility
- Facility settings → Prediction workflow: set risk thresholds
- Supabase authentication → Session management: establish session
src/main/java/com/ghostqueue/supabase/SupabaseAuthService.java - Admin operations UI → Supabase authentication: authenticate
- Doctor portal → Supabase authentication: authenticate
- Patient portal → Supabase authentication: authenticate
- Doctor portal → In-app notifications: receive updates
src/main/java/com/ghostqueue/controller/doctor/DoctorAppointmentsController.java - Patient portal → In-app notifications: receive updates
src/main/java/com/ghostqueue/controller/patient/PatientBookAppointmentController.java