Saturday Wash Queue

What It Is

The problem it solves: replacing a Saturday wash process that was a bit chaotic, not fair to the staff or the members. Members physically arrive at the garage, scan a QR code, pick a time slot, and receive SMS updates when their car is up next and when it's ready. Staff manage the queue from their phones without any manual data entry.

The Five Views

Architecture

Everything runs on Cloudflare infrastructure. There is no traditional backend server. The Worker is a serverless function that wakes up only when a request hits it.

Why This Stack

How It Works — The Core Concept

The entire live queue is one JSON blob stored in Cloudflare KV under the key WASH_QUEUE_STATE. It contains all 15 slots and their current data. Every action in the app reads this blob, updates the relevant slot, and writes it back.

{
  "sessionDate": "2026-06-07",
  "slots": [
    {
      "id": 1, "slotTime": "10:00 AM", "statusIndex": 4,
      "memberName": "Sarah M.", "vehicle": "2022 Porsche 911 GT3",
      "memberPhone": "5865550101", "droppedOffAt": "2026-06-07T14:05:00Z",
      "washStartedAt": "2026-06-07T15:05:00Z",
      "washDoneAt": "2026-06-07T15:38:00Z",
      "bookingToken": "k4xm92bq", "notifiedUpNext": true, "notifiedDone": true
    },
    ... 14 more slots
  ]
}

Slot Status Values

Member Booking Flow

1. Scan QR code at the garage — or navigate directly to the URL. GPS check runs immediately on page load (prompts browser permission).
2. View the queue — available slots show in black with "Tap to book". Claimed slots show "Claimed". Time-expired slots show "Unavailable".
3. Tap an available slot — geo validation runs (200m if QR, 500m if direct URL). If not within range, an error message appears. No form opens.
4. Fill in the form — name, vehicle, mobile number, optional notes for staff.
5. Submit — worker validates slot is still available, generates a booking token, saves to KV. If slot was taken in the meantime, an error message appears.
6. Receive confirmation SMS — "Your OOOG wash is booked — Slot X · est. TIME. Need to swap, cancel or message staff? [manage link]"

Staff Queue Management

Opening the Day

1. Go to /?view=staff — enter the staff PIN.
2. Tap Est. Wait / Car chip (top left) — set the expected wash duration (20, 30, 45, or 60 min). This drives the estimated wait time members see.
3. Tap Open Queue — members can now see and book slots. Nothing is automated — the queue only opens when staff opens it.

Working the Queue

Tap any slot row to open the detail sheet. Available actions depend on the slot's current status:

Admin Tab

Accessible as a tab within the staff view. Provides: summary stats, force status override for any slot, manual SMS resend, and the weekly reset.

Member Booking Management

Every booking generates a unique 8-character token stored in KV. The token is sent to the member in their confirmation SMS as a link: https://ooog-wash-queue.pages.dev/?manage=TOKEN

From the manage page, members can:

• Swap to any available non-expired slot — auto-executes if the current wash hasn't started
• Request cancellation with a reason — staff must confirm before the slot is freed
• Message staff — one-way, posts to Slack and is appended to the slot notes in KV

The manage link expires (shows "Your wash is complete") when staff marks the slot Done or Cancelled. Time of day is not a factor — expiry is purely status-based.

Saturday Morning Runbook

Data Layer

Live State — Cloudflare KV

KV holds the current Saturday's queue as a single JSON blob. Reads are edge-cached and near-instant. There are no rate limits relevant to this use case.

Permanent Archive — Cloudflare D1

D1 is a SQLite database. One record is written per active slot at end-of-day reset. Never modified after writing.

SELECT slot_num, member_name, vehicle, status,
       dropped_off_at, wash_started_at, wash_done_at, wash_duration_mins
FROM wash_sessions
WHERE session_date = '2026-06-07'
ORDER BY slot_num;

The wash_duration_mins column is the number of minutes between wash start and wash done — calculated automatically at reset time.

Data Journey

Notifications

SMS (SimpleTexting)

Slack (#saturday-wash)

Every meaningful action posts to Slack: booking, Up Next, Washing, Done, cancellation, swap, force override, queue open/close, reset. Staff can monitor the full day without opening the app.

Geo-Gate & QR Code

The geo check prevents members from booking from home. It runs twice — once client-side (fails fast before form opens) and once server-side (worker validates on every QUEUED registration).

The QR code URL posted in the Cole Street garage:

https://ooog-wash-queue.pages.dev/?qr=ooog-saturday-wash

The token ooog-saturday-wash is hardcoded in both the HTML and the worker. To change it, update both const QR_TOKEN values and regenerate the QR code.

Worker API Routes

Deployment

HTML App (Cloudflare Pages)

1. Edit saturday-wash.html (the source of truth)
2. Run: cp saturday-wash.html deploy/index.html
3. Upload the deploy/ folder to Cloudflare Dashboard → Workers & Pages → ooog-wash-queue → Upload assets

Worker (Cloudflare Worker)

1. Edit ooog-member-tools-worker.js
2. Open Cloudflare Dashboard → Workers & Pages → ooog-member-tools → Edit Code
3. Select all → paste full file contents → Save and Deploy
4. Ensure format is set to ES Module (not Service Worker)

Secrets Required in Worker

Common Issues & Fixes

Member says they didn't get a text

1. Check the phone number was entered correctly during booking.
2. Check SimpleTexting account → Messages for any send errors.
3. Use the Admin tab → Manual SMS Resend to force-send the Up Next or Done text.
4. If booking confirmation is missing, the slot can still be worked normally — texts only require a valid phone number in the slot.

Member can't book — "too far from garage" error

1. Ask them to step outside the building — indoor GPS is often inaccurate.
2. Ask them to check Location is enabled for their browser (Chrome: tap padlock → Site Settings → Location → Allow).
3. If still blocked, use Staff manual add on their behalf.

Staff can't manually add a member — nothing happens

This was a known bug (fixed). Ensure the latest worker and HTML are deployed. The issue was a reference to a removed HTML element (ma-keytag) that silently crashed the submit function.

Queue shows "ask staff" for estimated wait time

Staff haven't set the wait time, or the embed view is showing stale data. Staff should tap the Est. Wait / Car chip and set a value. This was also a fixed bug where the embed view didn't read the wait time correctly — ensure latest HTML is deployed.

Worker returns 429 (rate limited)

This cannot happen with the current architecture — 429s were from the old Monday.com integration. KV has no relevant rate limits for this use case. If a 429 appears, check which API is being called.

Reset fails — "Cannot reset — wash in progress"

One or more slots has status In Progress (Washing). Open the staff view, find the slot, and mark it Done or Cancelled before running reset.

D1 archive shows no data after reset

Check the D1 console — if wash_sessions table exists but has no rows, run the reset again with an active booking. If table doesn't exist, run the CREATE TABLE SQL in D1 console (see CLAUDE.md).

What to Watch

Rotating Secrets & Keys

All secrets are stored as encrypted environment variables in the Cloudflare Worker — never in the HTML or code. To rotate a key:

1. Get the new key from the relevant service (SimpleTexting, Slack, Anthropic, Monday).
2. Go to Cloudflare Dashboard → Workers & Pages → ooog-member-tools → Settings → Variables.
3. Edit the encrypted variable, paste the new value, save.
4. No redeployment needed — the worker picks up the new value immediately on the next request.