Gerona RHU Queue Management System

A real-time queue management system tailored for the Gerona Rural Health Unit. Designed for facility staff and patients, it streamlines patient flow and reduces wait times through organized ticketing.

---

✨ Features

• Real-Time Queue Tracking via Laravel Reverb WebSockets
• Dedicated Desktop Clients for Staff and Kiosk Interfaces
• Integrated Management Dashboard for complete queue oversight

---

Languages & Tools (⌐■_■)

---

🚀 Getting Started

Prerequisites

• PHP 8.3 or higher
• Composer
• Node.js & npm

Installation

git clone <repository-url>
cd gerona-rhu

# Install PHP dependencies
composer install

# Install frontend dependencies
npm install

# Setup environment variables
cp .env.example .env
php artisan key:generate

# Run database migrations
php artisan migrate --force

Environment Variables

APP_NAME=
APP_ENV=
APP_KEY=
APP_URL=
DB_CONNECTION=

Run

Server:

# Start the web server and websocket service
Start-RHU-Server.bat

(Alternatively, run npm run dev to start Vite, Laravel, and Reverb concurrently)

Desktop Clients:

# To start the Staff Interface
cd desktop-staff
npm install
npm start

# To start the Kiosk Interface
cd ../desktop-kiosk
npm install
npm start

---

📄 License

Copyright (c) 2026 Allen Icee Dequiros

This project is shared for portfolio, educational, and learning purposes.

You are welcome to study the codebase and use it as inspiration for your own projects.

Copying substantial portions of this project, redistributing it, submitting it as your own work, or creating direct clones is not permitted without explicit permission.

If this project inspires your work, please build your own implementation rather than copying the source code.

All rights reserved.