B
BISA Documentation
Open Dashboard →
Live System

BISA Queue Management

Complete guide for Super Admins, Facility Admins, Front Desk Staff, and Patients. Use this documentation for demos, onboarding, and training.

1. System Overview

BISA is a multi-tenant queue management platform designed for healthcare facilities — clinics, hospitals, pharmacies, and specialist centres. It eliminates long waiting lines by giving patients a numbered ticket and a real-time view of how busy a facility is, whether they are physically present or booking from their phone.

Facilities manage their own departments, service queues, and staff through a shared web dashboard. Patients use a lightweight Progressive Web App called SeeMe to browse facilities, check congestion, and book a queue slot online before they arrive.

What BISA solves

  • ✓ Patients no longer queue for hours at the gate
  • ✓ Facilities know exactly how many people are waiting
  • ✓ Online pre-booking reduces walk-in congestion
  • ✓ Every ticket is tracked from issue to service
  • ✓ Clinics can define their own services and rules

How it works (in brief)

  1. Facility opens its queue for the day
  2. Patient gets a ticket (kiosk or SeeMe app)
  3. Front desk calls next patient by ticket number
  4. Patient is served and ticket is closed

2. Roles & Key Concepts

SUPER ADMIN

Manages the entire platform. Adds facilities (tenants), creates facility admin accounts, and controls global system settings and lookup values.

FACILITY ADMIN

One per facility. Configures departments, service categories, operating parameters, and staff accounts for their clinic.

FRONT DESK

Day-to-day staff. Opens queues each morning, monitors the live queue, calls patients, records service, and closes the queue.

PATIENT

Uses the SeeMe app to find facilities, check live congestion, and book a queue slot online. Can also walk in and use the kiosk.

Key Concepts

Facility (Tenant)A hospital, clinic, or health centre onboarded as a client. Each has its own departments, staff, and parameters.
DepartmentA division within a facility (e.g. OPD, Pharmacy, Eye Clinic). Contains one or more service categories.
Service CategoryA specific type of service within a department (e.g. General Consultation). Has a ticket prefix (e.g. "A") and average service time.
QueueCreated each day when front desk opens a service. Holds all tickets for that service that day.
TicketA unique numbered slot (e.g. A-007) issued to a patient. Tracks their position and estimated wait time.
KioskA touch-screen tablet or monitor at the facility entrance running the BISA kiosk PWA. Walk-in patients get their ticket here.
SUPER ADMIN

3. Super Admin Guide

Login URL: bisa.tiwaak.com — use your Super Admin email and password.

3.1 Adding a New Facility (Tenant Onboarding)

Each client organisation is a facility in BISA. Follow these steps to onboard a new clinic or hospital.

1

Go to Facilities

In the left sidebar click Facilities. You will see a list of all registered tenants.

2

Click "Add Facility"

Click the Add Facility button in the top-right corner of the page.

3

Fill in the facility details

Facility NameFull legal name, e.g. Vision Eye Clinic
SlugShort URL-safe identifier, e.g. vision-eye
Facility TypeHospital / Clinic / Pharmacy / Specialist — choose from list
AddressPhysical address of the facility
PhoneMain contact number
CoordinatesLatitude & Longitude (used for "Near Me" search in SeeMe)
4

Save

Click Save. The facility is now registered and appears in the list. It has no staff or departments yet — the facility admin will add those.

3.2 Creating the Facility Admin Account

Every facility needs at least one Admin user who can configure it. You create this account from the Facility detail page.

1

Open the facility

From the Facilities list, click the facility name to open its detail page.

2

Go to the Staff tab

Click the Staff tab inside the facility detail view.

3

Click "Add Staff"

Fill in:

Full NameThe admin's name
EmailTheir work email address — this is their login username
RoleSelect Admin
PasswordA temporary password — share it securely with the admin
4

Share credentials

Send the facility admin their email and temporary password. They should change it on first login. Login URL: bisa.tiwaak.com

Note: A facility can have multiple Admin users. You can add more from the same Staff tab later.
FACILITY ADMIN

4. Facility Admin Guide

Login URL: bisa.tiwaak.com — use the email and password provided by your Super Admin. Change your password on first login.

4.1 First Login & Password Change

1

Visit bisa.tiwaak.com

Enter your email and the temporary password you received.

2

Change your password

Click your role label in the bottom-left of the sidebar → Change password. Set a strong personal password.

3

Explore the admin menu

You will see: Live Queue, Departments, Service Categories, Staff, and Facility Params in the sidebar.

4.2 Setting Up Departments & Service Categories

Think of departments as the sections of your facility, and service categories as the specific things each section does.

Example:

Department: Outpatient Department (OPD)

↳ Service: General Consultation — prefix: A, avg. time: 15 min

↳ Service: Child Health — prefix: B, avg. time: 10 min

Department: Pharmacy

↳ Service: Prescription Dispensing — prefix: P, avg. time: 5 min

Creating Departments

1

Click Departments in the sidebar → Add Department.

2

Fill in: Name, Code (short tag shown on kiosk, e.g. OPD), Type, and Display Order (order shown on kiosk screen).

3

Save. Repeat for each department.

Creating Service Categories

1

Click Service Categories in the sidebar → Add Service.

2

Fill in:

Namee.g. General Consultation
DepartmentSelect from your departments
Prefix1-3 letter code — tickets will be labelled A-001, A-002…
Avg. Service TimeMinutes per patient — used to calculate estimated wait
Display OrderOrder shown within the department on the kiosk
3

Save. Repeat for every service the facility offers.

4.3 Facility Parameters

Parameters let you tune how the system behaves without touching code. Click Facility Params in the sidebar.

ONLINE_CHECKIN_GRACE_MINS How many extra minutes a patient has to physically arrive and check in after their estimated call time. Default: 30 minutes.
MAX_ACTIVE_ONLINE_TICKETS Maximum online bookings allowed per queue per day. Prevents over-subscription.
KIOSK_PIN The 4–6 digit PIN used to pair the kiosk tablet with this facility. Change it to revoke a tablet's access.
Facility-level parameters override global defaults. If a parameter is not set at facility level, the system uses the global default configured by the Super Admin.

4.4 Creating Staff Accounts

Add every person who will use the dashboard — front desk staff and providers. Click Staff in the sidebar.

1

Click "Add Staff"

2

Fill in the form

Full NameStaff member's name
EmailLogin email address
RoleFront Desk — can open queues and call patients. Provider — clinical staff. Admin — full facility management access.
PasswordTemporary — staff should change it on first login
3

Share login credentials

Staff log in at bisa.tiwaak.com with their email and password.

FRONT DESK

5. Front Desk Staff Guide

Login URL: bisa.tiwaak.com — use your email and password. You will land on the Live Queue screen.

5.1 Opening a Queue for the Day

Queues are opened fresh every morning. No queue = no tickets can be issued. Patients and the kiosk will show services as CLOSED until you open them.

1

Go to Live Queue

Click Live Queue in the sidebar. You will see all the services configured for your facility.

2

Click "Open Queue" next to a service

Each service has an Open Queue button. Clicking it creates a new queue for today and immediately allows patients to receive tickets for that service.

3

Open all services you will run today

You can open one service at a time. If a service will not run today, simply leave it closed.

Once a queue is open, the kiosk will automatically show it and the SeeMe app will display live congestion for that service.

5.2 Operating the Queue (Calling & Serving Patients)

The Live Queue screen is your main workspace during the day. It shows everyone waiting, the currently-serving ticket, and the full history.

1

Call the next patient

Click Call Next. The system picks the next WAITING ticket and marks it as CALLED. The patient's name (if provided) and ticket number are displayed prominently.

2

Patient arrives — mark as Served

When the patient presents themselves, click Served. This closes the ticket and moves to the next in line.

3

Patient does not show — mark as No-Show

If a called patient does not appear within a reasonable time, click No-Show. Their ticket is closed and you can call the next person.

WAITING
Ticket issued, patient waiting their turn
CALLED
You called them — they should approach the desk
SERVED
Attended to — ticket closed successfully

5.3 The Kiosk (Walk-in Ticket Machine)

The kiosk is a touch-screen tablet or monitor placed at your facility entrance. It runs the BISA Kiosk PWA and automatically shows all open queues for your facility.

Setting Up the Kiosk Tablet

1

On the tablet browser, navigate to kiosk.bisa.tiwaak.com.

2

Tap the browser menu → Add to Home Screen to install it as an app (works on Android and iOS).

3

Open the installed app. You will be prompted for a Facility ID and Kiosk PIN. Get these from your Facility Admin (the PIN is set in Facility Params).

4

Once configured, the kiosk is ready. Place it in landscape mode at the entrance.

How Patients Use the Kiosk

1

Patient taps the department they need (e.g. OPD).

2

If the department has multiple services, they choose the specific service.

3

They optionally enter their name and tap Get My Ticket.

4

The screen shows their ticket number (e.g. A-007), their position, and estimated wait. They note it down or print it (if a printer is connected).

Offline mode: The kiosk can issue tickets even without internet. Tickets are queued locally and synced automatically when the connection is restored.

5.4 Closing the Queue at End of Day

1

When the last patient has been served, go to Live Queue.

2

Click Close Queue next to each service. This stops new tickets from being issued (kiosk and SeeMe app will show the service as CLOSED).

Important: Always close the queue at end of day. If left open, patients can still book online and the kiosk will still issue tickets the following morning until you close it.
PATIENT

6. Patient Guide — SeeMe App

SeeMe is the free patient-facing app. It runs on any smartphone browser — no app store download required. Patients open seeme.bisa.tiwaak.com in their browser and can optionally install it as an icon on their home screen.

6.1 Getting the App onto Your Phone

Android (Chrome)

1

Open Chrome and go to seeme.bisa.tiwaak.com.

2

Tap the three-dot menu in the top-right.

3

Tap Add to Home screen.

4

Tap Add. The SeeMe icon appears on your home screen.

iPhone / iPad (Safari)

1

Open Safari and go to seeme.bisa.tiwaak.com.

2

Tap the Share button (box with arrow) at the bottom.

3

Scroll and tap Add to Home Screen.

4

Tap Add. The SeeMe icon appears on your home screen.

6.2 Creating an Account

You only need an account to book a ticket online. You can browse facilities and see queue congestion without signing in.

Your phone number is your identity — there is no email required.

1

Open the SeeMe app. Tap the Account tab at the bottom.

2

Tap Create account.

3

Enter your phone number in international format (e.g. +233501234567), an optional name, and choose a password (at least 8 characters).

4

Tap Create Account. You are automatically logged in.

No SMS verification is required. Your phone number and password are all you need to log back in on any device.

6.3 Finding a Facility

1

Browse all facilities

The Explore home screen lists all registered facilities. You can search by name using the search bar at the top.

2

Find facilities near you

Tap Near me and allow location access. The app will show facilities within 50 km sorted by distance.

3

Read the congestion indicator

Low — 0–5 waiting Moderate — 6–15 waiting Busy — 16+ waiting
4

Tap a facility to see its services

The facility detail page shows all open services with live stats: currently serving number, people waiting, and estimated wait time. This refreshes every 30 seconds automatically.

6.4 Booking a Queue Ticket Online

Online booking lets you secure a place in the queue before you leave home. You still need to physically arrive before your check-in deadline.

1

Find the service and tap "Book My Spot"

The button only appears for open queues. If the button shows Queue is closed, the facility has not yet opened that service today.

2

Log in or create an account if prompted

Booking requires a SeeMe account. After logging in you will be taken straight back to the booking confirmation screen.

3

Review and confirm

The confirmation screen shows facility, service, estimated wait, and your name. Tap Confirm Booking.

4

Receive your ticket

The app shows your ticket number (e.g. A-012), your position in the queue, estimated wait, and a check-in deadline. Screenshot or memorise your ticket number.

⚠ Important — Check-in Deadline

Your ticket has a deadline by which you must physically arrive at the facility and show your ticket number to reception. If you do not arrive by the deadline, your ticket is automatically cancelled and your spot is forfeited.

The deadline is calculated as: your estimated call time + the facility's grace period (typically 30 minutes).

6.5 Arriving at the Facility & Checking In

1

Arrive before your deadline

Check your ticket deadline in the SeeMe app under My Tickets. Plan your journey accordingly.

2

Show your ticket number to reception

Show the front desk your ticket code (e.g. A-012) from the My Tickets screen. The front desk will confirm your check-in.

3

Take a seat and wait

The front desk will call your ticket number when it is your turn. Keep an eye on the display screen (if the facility has one) or listen for your number to be called.

6.6 Managing Your Tickets

Tap My Tickets in the bottom navigation to see all your tickets.

Waiting

You are in the queue. Your position and estimated wait are shown.

You're up!

The front desk has called your number. Go to the desk immediately.

Served

Your visit is complete.

Expired

You missed your check-in deadline. The ticket was cancelled automatically.

Cancelling a Ticket

If your plans change and you cannot attend, tap Cancel Ticket on any WAITING ticket. This frees your spot for other patients. You can only have one active ticket at a time — cancel an existing one before booking another facility.