# Smart Weighbridge — Cloud Go-Live Runbook
*Full system (console + slip app) live in the cloud, viewable from any device. Grounded in the Woestalleen commissioning (site PC already weighing on COM4).*

## The shape (one hard rule: the weigh is captured on site)
- **Site PC (stays)** — reads the indicator (COM4), runs the Scale Reader + watchdog, does the live weigh-in / weigh-out. This cannot move to the cloud: the scale is a physical cable.
- **Cloud host (new)** — runs the FULL Smart Weighbridge app: console (orders, transporters, drivers, tickets, reports, density) **and** the slip app, with role logins. Served on one web address.
- **Sync agent (new, on the site PC)** — pushes every ticket/slip to the cloud the instant it is saved; queues and catches up if the line drops. Nothing lost; weighing works offline.
- **Anyone, anywhere** — opens the one web address on any phone/laptop, logs in, sees their role view. No Tailscale, no node login.

## STEP 1 — YOURS (needs your account/card; I cannot buy these)
1. **Domain** — register **weighbridge.veralogix.co.za** (or your choice) at a SA registrar — e.g. domains.co.za, Afrihost, or Xneelo. ~R100–R250/year.
   - Already own veralogix.co.za? Then just add the sub-domain **weighbridge.** (free) — no new purchase.
2. **Cloud host** — open an account and create one small server. Recommended, cheapest-first:
   - A small **VPS** (DigitalOcean / Hetzner / Afrihost Cloud) — ~R150–R400/month, full control. **Recommended.**
   - Or a managed app platform (Render, Railway) — a little more, less setup.
3. Give me: the host login method you want me to use (you create the server and hand me access), and confirm the domain.
   - *Payment and the account stay in your name; I never hold your card.*

## STEP 2 onward — MINE (I execute once STEP 1 exists; no more decisions from you)
4. Deploy the **full app** (console + slip app) to the host; point the domain at it; HTTPS on.
5. Stand up the **database** and the **role logins** (driver / client-admin / super-admin); load your transporters/drivers.
6. Install the **sync agent** on the site PC (needs the site-PC access we are sorting) and prove a live ticket appears in the cloud within seconds.
7. **Security**: HTTPS, per-role access, backups, and the data-protection basics (the data now leaves site).
8. **Go-live test**: weigh a truck on site → ticket + slip appear in the cloud → open on a phone off any network → reports export (Excel/CSV/PDF). Sign-off.

## Cost summary (yours, monthly)
- Domain: ~R100–R250 **/year** (or free sub-domain if you own veralogix.co.za).
- Host: ~R150–R400 **/month**.
- No per-user fees in this design.

## What is NOT needed for this go-live
- Booms and cameras/ANPR are a **separate on-site automation track** — the cloud system (console + slips + reports, viewable anywhere) goes live without them.
