← back to reference index

Queue

HintayOS Owner & Manager D93

How customers join the walk-in queue at each branch: QR code, kiosk, ticket numbers, quoted waits and the TV board.

Who can change this: the Owner, and Managers for their Locations. Managers can also change the day-to-day switches (joining open, which service points are open, voice, logo, “Next up”) on the TV board with their POS PIN (⚙ at the bottom right) and in the HintayOS phone app. Staff can run the queue but not change settings. Every change is logged with who made it (D96).
STATUS: interactive demo — switches marked “live” change the demo queue on this browser (join page, kiosk, board). Nothing is saved to a server.
Settings are per Location (QueueSettings).

Business setup · D95 · start from a template, then change anything

Template

A template fills in services, ticket letters, windows, wording and the priority lane for that kind of business. Everything below stays editable. Applying one replaces the services and windows; tickets already issued today keep their numbers. live

Logo live

PNG, JPG, WebP or SVG up to 2 MB; square works best. By default this is the business logo from General; uploading here changes it for the queue screens only. Without a logo, your initials are shown.

Changing the word renames numbered points (“Window 2” → “Teller 2”) and is used for new ones. Names you typed yourself (“Loans Desk”, “X-ray Room”) are kept. The TV board and the voice say each point's name.

Priority lane · D95 · RA 9994 (senior citizens), RA 10754 (PWD)

Who can use it

Calling order

Windows marked Priority lane below always take priority tickets first, then regular ones when no priority customer is waiting. Queue history counts priority tickets separately.

How customers join

Self-join follows the Location's opening hours on Resources. One active ticket per phone, email or mobile per Location; joining again returns the same ticket.

Services (lines) · D94

ServicePrefixNext ticketAsk party sizeSeat at a tableQuoted waitActive

Each service has its own line and ticket series (e.g. C-001 for Check-up, L-001 for Laboratory), restarting every day at opening. With more than one active service, customers pick one on the join page and kiosk. Quoted waits are the business's estimate (party-size bands 15 / 20 / 30 min agreed in D93 for dine-in); HintayOS doesn't predict waits (§12). “Seat at a table” uses ReserbaOS tables. live

Windows (service points) · D94

Name (said aloud)ServesStaff nowPriority laneOpen

Where customers go when called: Teller 3, Window 5, Consultation Room 2, Pharmacy Window, Reception. Staff pick “I'm at” on the queue screen and press Call next, which takes the next ticket from the services that point serves (priority rules above apply). The board and the voice say the window. live

Calling parties

Flag a called party as “no response” after10 min · set on Location rules

How customers can choose to be told · the customer picks one when they join

The “it's your turn” message (waitlist.ready) always goes by the channel the customer chose. Wording: Message templates. Parties with no contact are called out loud and shown on the TV board.

TV board

schedhubph.com/d/q/k7Qm…2Xa Open board ↗

Open this link on any smart TV or a laptop connected to a TV. It's read-only and needs no sign-in, so keep it private; make a new link if it leaks.

🔒 Ticket numbers only. The board never shows names or contact details, so other guests can't see who is waiting (D93, Data Privacy Act). There is no setting to turn names on.

Voice announcements · D94 · played by the TV board

Use {ticket} and {counter}. The TV board speaks with the voices built into its browser (free, no internet needed once open). Chrome or Edge on a laptop, mini-PC or Android TV works best. If a TV has no Filipino voice, it says the English phrase only. Browsers need one tap on the board to allow sound. Test voice plays on this device.

QR code for this Location

Customers scan this to reach the join page for Main Branch.

Regenerate if someone is misusing the code (for example sharing it online to join from home). Old posters stop working.

With your other modules

ReserbaOS on: Seat picks a free table and creates a checked-in Booking. Off: staff Serve the party with no booking.

SukiOS on: members are marked in the queue when their mobile matches, and served walk-ins count as visits.

BentaOS on: seating or serving can open an order for the party.

BisnesOS on: the staff member who served the party is recorded.

Integrations run only when both modules are on (Modules, INTEGRATION.md).

Implementation notes for Cursor

D96 access and branding: Owner + Manager (their Locations) edit Queue settings; Managers can also change is_open, QueueCounter.is_open, voice on/language, show_logo and board_show_next from the board (unlock with their POS PIN, 60 s idle lock, queue_settings.updated logged with the staff id and via = board) and from the phone app (via = app). Logo: Business.logo_url by default, optional QueueSettings.display_logo_url (StoredFile, image only, 2 MB, resized to 320 px), show_logo default true; shown on board, join page, kiosk, poster and printed ticket.

D95 set-up: templates (bank, government office, clinic/hospital, restaurant, custom) only pre-fill QueueService/QueueCounter rows and settings; nothing is locked to a template. QueueSettings.point_noun (default “Window”), priority_enabled, priority_types (senior / pwd / pregnant), priority_rule (first / alternate), priority_every; QueueCounter.is_priority_lane.

D94 entities: QueueService (per Location: name, prefix unique per Location, ask_party_size, seat_at_table, quote_bands JSON or quote_minutes, is_active, sort, optional service_id → ReserbaOS Service) and QueueCounter (name, is_open, current_staff_id, many-to-many queue_service_ids). A service can't be deleted while it has tickets today; deactivate it instead.

Voice (D94): voice_enabled (default true), voice_languages (en_fil / en / fil), voice_number_style (digits / number), voice_repeat (1–2), voice_phrase_en, voice_phrase_fil (placeholders {ticket}, {counter} only; nothing else is rendered). Spoken by the board's browser (Web Speech API).

Entity: QueueSettings (one per Location): is_open, self_join_enabled, kiosk_enabled, max_party_size, max_waiting, stop_before_close_minutes, send_joined, sms_enabled (default false), board_show_next (the board never shows names), join_token and board_token (random, rotatable; store a hash). No-response timeout stays on Location.waitlist_notify_timeout_minutes.

Rules: Owner/Manager for their Locations; changes logged queue_settings.updated; rotating a token is logged and invalidates the old one at once.

Governs: §12 (D93, D94, D95), §20, INTEGRATION.md §3–4.