Start here
The whole job in five lines. Fold this away once you know it.
- Friday: open Hand out. Everyone marked ● Ready gets their prize; ask for the badge number, then tap Hand out. Print list gives you a sheet with a signature column.
- “Not at gate yet…” means they scanned but the morning gate report never showed them clocked in that day. Hand it out if you know they worked; void it if they didn't. After 3 days the app voids it on its own.
- Not picked up (bottom of Hand out) keeps Ready wins from earlier weeks. Still theirs if they turn up.
- Prizes is the shelf: real counts, add or retire a prize, how many of each level go out a week. People is for the odd question: look anyone up by name or badge, see their scans, release a badge.
- Something's off? No gate report by 9 AM → System → upload the CSV from the email. A worker says it doesn't work → People tab, look them up. Anything else → the developer (see HANDOFF.md in the code repo).
Needs a look
The last name typed didn't match the gate list. Looks right? Tap it. Wrong person? Release the badge.| Worker | What they typed |
|---|
Odds
Each level hands out a set number a week. Under 1 means one every so many weeks: 0.25 is one a month, 0.5 one every two weeks. The odds on every spin adjust to what is still to give and how many scans are still expected, so the week's prizes spread across the week. A level with nothing on the shelf can't be won.
| Level | Per week | This week | On the shelf | Odds on the next spin |
|---|
Inventory
| Prize | On the shelf | Won |
|---|
Look someone up
Rarely needed. Someone says “I scanned and nothing happened”: find them here and see their scans and prizes. A badge stuck on a wrong or lost phone: Release badge, and they set it up again next time they scan (workers can also just type their badge on the new phone). “Add phone” lets a person log in with a phone number instead of the badge. Admins set the role here (worker, manager, admin).| Worker | Set up on a phone | Scans | Wins | |
|---|---|---|---|---|
| Type a name or badge number. | ||||
Add a person
For office staff who never swipe the gate, so the gate report never adds them. Their cell number becomes their badge: they log in with it plus their last name, then the manager PIN. Anyone who swipes the gate is already in the list above — just search and set the role.
Prizes to hand out
Pickup is Friday. When you give someone their prize, tap “Hand out”. Use the arrows for an earlier week.
“Waiting on gate” means this person scanned, but the gate report for that day has not shown them clocked in yet. Hand it out if you know they worked; otherwise wait for the next report. “Ready” means the gate confirmed it.
| Worker | Prize | Status | Signature |
|---|
Not picked up
Ready wins from earlier weeks that nobody collected. Hand it out if they turn up. After two weeks a “Back on the shelf” button appears: it puts the item back in the pool — tap it only when the item is actually there.
| Worker | Prize | Won |
|---|
Scanned, not at the gate
Same week as the Hand out tab.
| Worker | Day | Prize | Status |
|---|
Upload a gate report
Only if the ~8 AM email didn't arrive (one per site: 5030 and 8134). Recent reports are listed inside.
| When | Source | Site | Rows | New | Matched |
|---|
Setup
Who has access, the PIN, site names, emails, the activity log
Managers
Sites
Give gate site codes a name.
| Code | Name | Swipes |
|---|
Manager PIN
One PIN unlocks every manager and admin badge.
Sticker scan
Off: tapping Scan spins straight away. On: the phone's camera opens first and the wheel only spins once it has read the sticker on a hard hat. One camera step, no second scan, and the stickers already printed work as they are. Takes effect on the next scan.
Emails
The app can send two emails. Both are off until you type addresses here. One-time setup per address: the app can only deliver to an address that has confirmed once with Cloudflare (the developer adds it under Email Routing, the person clicks the confirmation email).
1. Friday pickup list — Fridays 9:30 AM, after the morning gate report: who is Ready, who is still waiting on the gate, anything not picked up, what's running low.
2. Missing gate report alert — weekdays 9:00 AM, only if no report has arrived that morning. Addresses here switch it on; empty switches it off. Saved with the same Save button.
Activity
Every change made on this page, newest first. Nothing here can be edited or deleted.
| When | Who | Action | Detail |
|---|---|---|---|
| Loading… | |||
Before launch
One tap the night before the crew start: every demo scan and demo person goes, shelf counts go back to what is loaded, the yellow test button disappears. Real employees, prizes, settings, managers and admins stay.
Wipe demo activity. Employees and swipe reports stay unless you choose everything.