Documentation

Everything you need to know about using the Dran queue management dashboard.

Getting started

Dran is a queue management system for organizations that serve customers in person — hospitals, barbershops, government offices, or any place where people wait in line.

How the system works

1

Organization setup

An admin creates services (e.g. "Haircuts", "Consultation") for your organization.

2

Customer joins queue

Customers join through a public-facing page and receive a ticket number.

3

Staff serves tickets

Staff members log into this dashboard, open a service, and call tickets one by one.

4

Live displays

TVs or monitors in the waiting area can be paired to show live queue status.


Your first day — step by step

New to Dran? Follow these steps to get up and running:

1

Log in

Use the email and password your admin gave you. You'll land on the dashboard.

2

Set your name & room number

Go to Account in the sidebar. Set your display name and room/counter number so customers know where to find you.

3

Pick your service

On the dashboard, click "Open service dashboard" on the service you'll be working today.

4

Start calling tickets

Hit "Call Next" to pull the next customer. That's it — you're live!

Don't see any services?

Services only appear if your role is in the service's "allowed roles" list. Ask your admin to add you.


Working the queue

This is where the main work happens. When you open a service, you see the live ticket queue.

Ticket workflow

waiting serving done

Tickets can also be set to hold (paused) or cancelled at any point.

Ticket statuses explained

StatusWhat it means
waitingCustomer is in line, waiting to be called
servingCurrently being served by you
holdPaused — customer stepped away or needs extra time
doneService completed
cancelledCustomer left or ticket was cancelled

How to call the next person

1

Click "Call Next"

The system automatically marks your current ticket as done and pulls the next waiting ticket.

2

Customer appears on your screen

The ticket card updates with the new customer's number and any form details they submitted.

3

Serve the customer

When done, click "Call Next" again — or manually change the ticket status using the dropdown in the table.

Reordering tickets

Need to bump someone up? Drag and drop rows in the queue table to reorder tickets manually.

Filters & priority

Use the filter dropdowns to show only certain statuses or priorities. Tickets can be normal, high, or very high priority. Click "Reset" to return to the default view.


Admin setup workflow

Admin only

If you're setting up a new organization, follow these steps:

1

Set up your organization

Go to Manage Organization in the sidebar. Update your org name and any settings.

2

Create services

Services are created in PocketBase. Set a name, description, and link to your organization.

3

Configure each service

Go to Manage This Service to set up allowed roles, weekly schedule, and the customer intake form.

4

Add your staff

Go to Manage Staff to invite existing users or create new accounts with the right roles.

5

Pair displays (optional)

Go to Manage Displays to pair TVs or monitors in your waiting area.


Manage staff

Admin only

Add people to your organization and manage their roles.

Adding a new team member

1

Choose method

Invite Existing User — paste their User ID if they already have a Dran account.
Create New User — fill out name, email, password, and role for a brand-new account.

2

Set a role

Pick from defaults (admin, staff, operator, viewer) or type any custom role like "doctor" or "cashier".

3

Save the password

If creating a new user, make sure to copy the generated password before submitting — you won't see it again.

Changing roles

For each staff member, type or select a new role in the input field next to their name. The change saves immediately. You cannot change your own role.

Removing a member

Click "Remove" to revoke organization access. This doesn't delete their account — they can be re-invited later.


Service settings

Admin only

Each service has its own configuration page.

Basic info

  • Service name — displayed everywhere in the dashboard.
  • Description — a helpful description for staff members.

Allowed roles

Control which roles can access this service. Check defaults or type custom roles (comma-separated). Admin is always included.

How it works

If someone's role isn't in the allowed list, they won't see the service on their dashboard. Use this to restrict services to specific teams.

Weekly schedule

Set opening and closing hours for each day. The schedule determines whether the service shows as "open" or "closed" to customers. Open time must be earlier than close time.

Form builder

Design a custom intake form that customers fill out when joining the queue.

1

Add fields

Click the buttons to add field types: Text, Textarea, Email, Number, Select, or Checkbox.

2

Configure each field

Set a label (what the customer sees) and a unique name (internal key). Expand "Advanced settings" for placeholder text, required toggle, and select options.

3

Save

Click "Save service" at the bottom to persist your form schema, schedule, and all settings.


Displays

Admin only

Pair screens in your waiting area to show live queue information to customers.

Pairing a display

1

Open live display on the TV

Navigate to the live display page on your TV or monitor — it will show a QR code.

2

Scan or enter manually

In Manage Displays, either scan the QR code with your camera or type in the hash and token.

3

Name & save

Give it a name (e.g. "Lobby TV") and click "Add display". It goes live immediately.


Account

Your account page lets you update:

  • Display name — shown on service dashboards when you're serving a customer.
  • Room number — your counter or room so customers know where to go.

Read-only info (email, role, organization) is shown in the sidebar panel.


Roles & permissions

Roles control what you can see and do.

RoleWhat they can do
adminEverything — manage org, staff, services, displays, and work the queue
staffWork the queue on services they're assigned to
operatorWork the queue on assigned services
viewerView queue status (read-only) on assigned services
customAdmins can create any role name — custom roles work like staff

Only admins see the "Administrator" section in the sidebar.


Frequently asked questions