LaneUP

This is a hobby project for a queue ticketing system. It is currently work in progress.

What does this do?

It allows for queue number to be dispense and be tracked via the users or the admins. Features as follows:

• All for multiple branches and groups, with each group having their own queue
• Supports different interfaces for different users (as mentioned below)
• Run on web interfaces and websockets

Usage

Kiosk
A frontend panel that can dispense queue number (on a kiosk), with a QR code to allow a user to track their queue status on their mobile device

Display Panel
A display that shows all the different groups and their current respective queues

Manager
Managers can use a control panel to call up or delete queue numbers

Admin
Admins to update groups/branches

Installation By docker compose

Requirements

• Node and npm (Download)
• Docker (Download)

Steps

1. Download this repositary
2. Run ./build.sh
3. Go to deployments folder and run docker compose up
4. Go to /install to create a new admin account

Backend Set up

The project consists of 3 separate backend components (services)

• Web Front-end server (built in Sveltekit)
• API + Web Socket server (currently on NodeJS)
• Database on Postgresql

Running Tests

Requirements

• Unit tests have been added for the API server
• Unit tests requires a dummy Postgres database connection
• Tests utilises .env.testing for database connection
• Run npm test under /api folder