Updc admin: Create UPila how-to guide (first UPDC web service)

2026-07-02T10:10:27Z

Create UPila how-to guide (first UPDC web service)

New page

'''UPila''' (from ''"UP"'' + ''"pila"'', Filipino for ''queue/line'') is a live queue-management web app for UPDC. One organizer creates a queue; participants join from their phones by scanning a QR code and watch their ticket number and position update in real time; the organizer advances the "Now Serving" number; and a big-screen board shows the current ticket.

<blockquote>'''Site URL:''' replace <code><UPILA_URL></code> below with the actual address of the UPila site (e.g. <code>https://upila.up.edu.ph</code>). Wherever you see <code><UPILA_URL></code>, use that address.</blockquote>

== Who can do what ==

{| class="wikitable"
|-
! Role !! Needs to sign in? !! Can do
|-
| '''Participant''' (person in line) || No login || Join a queue, see their ticket & position, leave the queue
|-
| '''Organizer''' (staff running a window) || '''UP Mail''' (<code>@up.edu.ph</code>) || Create a queue, advance "Next", clear or delete their own queue
|-
| '''Superadmin''' || UP Mail on the allowlist || View a read-only dashboard of all queues + history
|}

* Only '''UP Mail''' (<code>@up.edu.ph</code>) Google accounts can create or manage queues.
* Each queue is '''owned by the organizer who created it''' — only that same account can manage it.
* Participants '''do not''' log in; joining is anonymous and quick.

== For Organizers ==

=== 1. Sign in ===
# Open '''<code><UPILA_URL></code>'''.
# Click '''Sign in with UP Mail''' and choose your <code>@up.edu.ph</code> Google account.
#* Non-UP accounts are rejected automatically.

=== 2. Create a queue ===
# After signing in, click '''Create Queue'''.
# Type a '''queue name''' (e.g. ''"Registrar Window 1"'') and click '''Confirm Queue'''.
# You are taken to the queue's '''Options''' page.

=== 3. The Options page — 4 links ===
The Options page (<code><UPILA_URL>/queue/<id>/options</code>) has four buttons. Each opens in a new tab:

{| class="wikitable"
|-
! Button !! What it's for !! Who opens it
|-
| '''Admin Page''' || Control panel — advance "Next", clear, or delete the queue || Organizer (you)
|-
| '''Display Page''' || Full-screen "Now Serving" board for a TV/monitor || Put on a big screen
|-
| '''QR Page''' || Shows the queue name + a QR code || Print or display so people can scan to join
|-
| '''User Page''' || The join screen || This is what participants see after scanning
|}

<blockquote>'''Tip:''' Open '''Display''' on the big screen, print or show the '''QR''' for people to scan, and keep the '''Admin''' tab on your own device.</blockquote>

=== 4. Run the queue (Admin Page) ===
On the '''Admin Page''' (<code><UPILA_URL>/queue/<id>/admin</code>) you'll see:
* '''Now Serving''' — the current ticket.
* '''Queue Line''' — everyone currently waiting, in order.
* Action buttons:
** '''Next''' — serve the front person and move to the next ticket.
** '''Clear''' — empty the line but keep the queue (and its name).
** '''Delete''' — remove the queue entirely.

<blockquote>'''Note:''' You must be '''signed in as the organizer who created the queue'''. If you see ''"you are not the organizer"'', you're on a queue someone else created. If you see ''"Sign in required / session expired"'', sign in again.</blockquote>

== For Participants (people joining the line) ==

No app and no login needed — just a phone browser.

# '''Scan the QR code''' shown by the organizer (or open the link they share).
# Tap '''Join'''.
# You'll get a '''ticket''' (3 letters, e.g. <code>CVN</code>) and see:
#* '''Now Serving''' — the ticket currently being served.
#* '''How many people are ahead of you''', updating automatically.
# When it's your turn, the screen shows '''"It's your turn!"''' — proceed to the counter.
# Need to leave the line? Tap '''Leave queue'''.

<blockquote>Your place is remembered on that same phone/browser. If you close the tab and reopen the same link, you keep your ticket.</blockquote>

== For Superadmins (read-only dashboard) ==

# Sign in with a UP Mail that's on the superadmin allowlist.
# Open '''<code><UPILA_URL>/superadmin</code>'''.
# You'll see all queues with aggregate stats (joined / served / cancelled) and per-queue history.

The dashboard is '''view-only''' — it does not let you change any live queue.

== FAQ / Troubleshooting ==

; "Sign in with UP Mail" is rejected.
: Only <code>@up.edu.ph</code> Google accounts are allowed. Make sure you picked your UP Mail account, not a personal Gmail.

; I can't manage a queue — it says I'm not the organizer.
: Queues are tied to the account that created them. Sign in with the same UP Mail you used to create it, or ask that organizer to make changes.

; A participant's ticket disappeared / reset.
: Tickets are tied to the participant's browser. Clearing browser data, switching phones, or the organizer using '''Clear/Delete''' will reset it.

; The QR code doesn't open the right queue.
: Regenerate it from the '''QR Page''' of that specific queue. Each QR is unique to one queue.

; The Display board isn't updating.
: It refreshes automatically. If it looks stuck, reload the page.

== Good to know ==

* '''Real-time:''' ticket numbers and positions update live; no need to refresh.
* '''Privacy:''' participants are anonymous — no name or email is collected when joining.
* '''One organizer per queue:''' only the creator can manage it; there's no shared admin password.

UPila - Revision history

Updc admin: Create UPila how-to guide (first UPDC web service)