← back to reference index

Walk-in queue HintayOS

 

TV board ↗ Self check-in kiosk ↗ Customer join page ↗ QR poster Phone app History & insights Queue settings
Live demo — open the customer join page or the kiosk in another tab and join; the ticket appears here. Call it and the TV board shows it and reads it aloud (turn on sound on the board once). Nothing leaves this browser.

Waiting

Called

Done today

Left or removed

Each service has its own line and ticket series; each window or station serves the lines set in Queue settings (D94). HintayOS works on its own: Serve closes the ticket with no booking. With ReserbaOS on, services set to “seat at a table” get Seat, which creates a normal Booking (§12, D75). BentaOS can open an order; SukiOS marks members.

Implementation notes for Cursor

Entities: QueueService and QueueCounter (D94); WaitlistEntry (+ D93 ticket_no, source, notify_via; + D94 queue_service_id, counter_id, transferred_from_service_id), QueueSettings, Booking as checked_in (§5.3b).

Key states: I'm at (counter per device, open/closed); Call next = oldest waiting ticket across the counter's services; call a specific ticket to my counter; Call again (re-announces on the board); Serve; Seat (only seat_at_table services, ReserbaOS on) with 409 alternatives; Transfer to another service keeping the number (back of line, or front); Remove with a reason; no-response flag; pause joining; live updates.

Events: waitlist.called (with counter) drives the board and voice; waitlist.ready goes by the customer's chosen channel (push/email; SMS only if on); waitlist.transferred.

Priority lane (D95): WaitlistEntry.priority_type (senior / pwd / pregnant, set by the customer or staff; ID checked at the window). Call next: a priority-lane counter takes priority tickets first; otherwise the Location rule applies (priority first, or one priority after every N regular at that counter). Voice says

Forbidden inventions: No wait-time prediction. No automatic removal. No names on the board or in the voice.

ldquo;Priority, number

Forbidden inventions: No wait-time prediction. No automatic removal. No names on the board or in the voice.

hellip;

Forbidden inventions: No wait-time prediction. No automatic removal. No names on the board or in the voice.

rdquo;.

Forbidden inventions: No wait-time prediction. No automatic removal. No names on the board or in the voice.

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