CliniQ is an all‑in‑one clinic management system designed to streamline patient intake, queue prioritization, and wait‑time estimation. Built during McHacks 12, this project combines a web frontend, backend APIs, and data‑driven logic to improve clinic operations and patient experience.

Clinics often struggle with long waiting times, inefficient triage, and poor communication with patients. CliniQ addresses these challenges by:

• Allowing patients to submit symptoms digitally
• Automatically prioritizing patients based on severity and wait time
• Providing clinics with a real‑time queue dashboard
• Estimating wait times and notifying patients when they are next

• Symptom‑based patient triage
• Dynamic queue prioritization
• Estimated wait‑time calculation
• Clinic dashboard for admitting and dismissing patients
• Email notifications to patients
• Full‑stack architecture (frontend, backend, database)

Frontend

• React
• HTML / CSS / JavaScript

Backend

• Python
• Flask

Database

• PostgreSQL

APIs & Services

• RESTful API
• OpenAI API (for prioritization logic)

mchacks/
├── backend/          # Flask backend & API logic
├── frontend/         # React frontend
├── requirements.txt
├── package.json
├── README.md
└── ...

git clone https://github.com/4yushP4tel/mchacks.git
cd mchacks

Create and activate a virtual environment:

macOS / Linux

python3 -m venv .venv
source .venv/bin/activate

Windows (PowerShell)

py -m venv .venv
.venv\Scripts\Activate.ps1

Install dependencies:

pip install --upgrade pip
pip install -r requirements.txt

Create a PostgreSQL database:

createdb cliniq_db

Set your database connection string (example):

DATABASE_URL=postgresql://username:password@localhost:5432/cliniq_db

Apply any schema or migrations provided in the backend directory.

cd frontend
npm install
npm start

The frontend will run at:
👉 http://localhost:3000

1. Start the backend server:

cd backend
python app.py

2. Start the frontend (npm start)
3. Open your browser and interact with the system as a patient or clinic admin

1. Patient submits symptoms through the frontend
2. Backend evaluates severity and priority
3. Patient is placed into a ranked queue
4. Clinic staff manage admissions via dashboard
5. Notifications are sent when patients are next

Built during McHacks 12 and submitted on Devpost.

Team Members

• Ayush Patel
• David Preda
• Jimmy Zhang
• Isaiah Abella

Devpost submission:
https://devpost.com/software/cliniq-c702a8