Plughub Queueing Management System

A modern, scalable, and user-friendly queueing solution for businesses, clinics, offices, schools, and small service centers.

Plughub Queueing System allows you to manage customer flow smoothly with real-time ticket calling, counter assignments, and live status monitoring. It is designed with clean backend logic and a simple, responsive interface that works on desktop screens, tablets, or display monitors.

Whether you are a business owner, a student creating a capstone project, or a developer looking for a customizable queue platform, this system provides a full working foundation you can deploy instantly or build upon.

🏷 Queue Ticketing

• Auto-generated queue numbers
• Category or service type selection
• Printable ticket with number and timestamp (optional)

🎧 Counter Display & Caller Screen

• Each counter can call “Next”, “Recall”, or “Serve”
• Real-time display of active ticket on screen
• Works with any TV or projector display

📊 Admin Dashboard

• View all active and completed queues
• Monitor counter performance and total served customers
• Create/update/remove Service Categories and Counters

🏢 Multi-Counter, Multi-Service Support

• Add unlimited counters
• Define multiple queue types (e.g., General, Priority, VIP, Billing)

⚙️ Fully Configurable

• Change queue prefixes (A-001, G-005, etc.)
• Change branding, logo, and system name easily
• Built with clean MVC-style structure (easy to modify)

🧑‍💻 Technical Stack

• Backend: Django / Python
• Frontend: HTML, Bootstrap, jQuery
• Database: PostgreSQL (SQLite also supported)
• Server Ready: Works with Nginx + Gunicorn or Apache
• Deployment: Ubuntu / Linux deployment scripts included

📦 Installation Requirements

• Python 3.10+
• PostgreSQL 13+ (or SQLite for testing)
• Linux server / VPS / Local machine
• Git (optional but recommended

📦 Installation & Usage Guide

Plughub Queueing Management System

⚙️ 1. System Requirements

🛠 2. Local Installation (Development Mode)

🔹 Step 1 — Extract Project

Unzip the downloaded package.

Plughub_Queueing/
 ├─ queueing/
 ├─ manage.py
 ├─ requirements.txt
 └─ README.md

🔹 Step 2 — Create Virtual Environment

python3 -m venv venv
source venv/bin/activate     # Windows: venvScriptsactivate

🔹 Step 3 — Install Dependencies

pip install -r requirements.txt

🔹 Step 4 — Create Database

Option A: SQLite (Default – No Setup Needed)

Runs out of the box.

Option B: PostgreSQL

CREATE DATABASE plughub_queueing;
CREATE USER plughub_user WITH PASSWORD 'your_password';
GRANT ALL PRIVILEGES ON DATABASE plughub_queueing TO plughub_user;

Then update .env or settings.py:

DB_NAME=plughub_queueing
DB_USER=plughub_user
DB_PASS=your_password
DB_HOST=localhost
DB_PORT=5432

🔹 Step 5 — Run Migrations

python manage.py migrate
python manage.py collectstatic --noinput

🔹 Step 6 — Create Admin User

python manage.py createsuperuser

🔹 Step 7 — Run Locally

python manage.py runserver

Open in your browser:

👉 http://127.0.0.1:8000

🖥 3. System Usage

🔑 Login as Admin

Visit:

👉 /admin

Use the credentials you created.

From here, you can:

✔ Create service categories
✔ Create counters

1️⃣ Customer taps “Get Ticket”
➡ System prints or displays queue number

2️⃣ Counter clicks “Next” or “Recall”
➡ Display screen updates in real-time

3️⃣ TV or Monitor shows:

Now Serving #

Counter #