SmartQueue AI

SmartQueue AI is a production-ready queue management SaaS for hospitals, clinics, banks, government offices, salons, restaurants, and service centers.

Features

• Multi-organization queue operations
• Staff, branch, department, service, and counter management
• Real-time queue updates
• Customer notifications
• Analytics and reporting
• Production deployment support

Screenshots

Screenshots and product walkthroughs can be added here for release marketing and open-source discovery.

Installation

Backend

1. Create a Python virtual environment.
2. Install dependencies from backend/requirements.txt.
3. Configure environment variables in backend/.env.
4. Run database migrations.
5. Start the Django application.

Frontend

1. Install dependencies in frontend/.
2. Configure the API base URL.
3. Run the Next.js development or production build.

Docker setup

• docker-compose.yml contains the local application stack.
• backend/Dockerfile builds the production backend image.

Environment variables

See backend/.env.example for the backend contract and the frontend README settings for API connectivity.

Deployment

• Render configuration: render.yaml
• Vercel configuration: vercel.json

Architecture

• backend/ contains the Django + DRF API
• frontend/ contains the Next.js application
• docs/ contains API and deployment documentation

API overview

Key API groups include:

• Auth
• Organizations
• Branches
• Services
• Counters
• Staff
• Queues
• Notifications
• Reports
• Analytics

Folder structure

• backend/
• frontend/
• docs/

Contributing

See CONTRIBUTING.md for local workflow and review expectations.