iPhone / iPad (Safari)

1. Open https://moyatrace.moyaindustries.com in Safari (not Chrome — Add to Home Screen only works from Safari on iOS).
2. Tap the Share icon (square with an up-arrow) at the bottom of the screen.
3. Scroll down and tap Add to Home Screen.
4. Confirm the name MoyaTrace and tap Add.
5. Launch the new MoyaTrace icon from your home screen — it opens full-screen, no browser bar.

Android (Chrome / Edge / Samsung Internet)

1. Open https://moyatrace.moyaindustries.com in Chrome.
2. Tap the ⋮ menu in the top-right corner.
3. Tap Install app (or Add to Home screen > Install).
4. Confirm Install. The MoyaTrace icon appears on your home screen and app drawer.
5. Open it — Android treats it like a regular app and it works offline for the dashboard.

Online app vs offline dashboard

• Online app (lane scanners, reports, settings, simulator): needs the internet — writes go directly to the cloud database.
• Offline dashboard: once you have opened the dashboard at least once while online, the installed app caches it so you can still view the most recent shift numbers, lane totals, and per-block info if the connection drops. As soon as the network is back, new data syncs automatically.
• Scans done by lane scanners while offline are queued on the device and sent up the moment the connection returns.

LAN dashboard (Pi 5 relay — works with no internet)

On site there is also a local dashboard served by the Pi 5 relay box on the packhouse network. It does not need the internet — it keeps working during ISP outages because every scan is stored on the Pi 5 itself and forwarded to the cloud only when the link returns.

1. Connect your phone, tablet, or PC to the same WiFi/LAN as the Pi 5 (e.g. MoyaTrace network).
2. Open a browser to http://<pi5-ip>:8080/ — for example http://10.139.86.156:8080/. Ask the installer for the exact IP; it is fixed by the router.
3. You'll see live lane totals, per-block info, and a green/red indicator showing whether the Pi is currently reaching the cloud.
4. You can bookmark it or "Add to Home Screen" (iOS/Android) for a one-tap offline icon, exactly like the online app.

Note: the LAN dashboard is read-only operations data — to start/stop shifts, edit settings, or run reports, use the online app at moyatrace.moyaindustries.com.

Carton types

The catalog of carton SKUs used on stickers and matched by the scanner. Each row has:

• Code — the SKU printed on the sticker barcode (e.g. 1NLXC). The scanner reads this prefix off the serial to look up the rest.
• Class — the grade label (e.g. CLASS 1, PREMIUM). Used by the dashboard and reports for the per-class breakdown and % of total.
• Target content (kg) — the fruit weight you're aiming for, excluding packaging. Default 17.5 kg.
• Packaging (kg) — empty carton + liner weight. This is subtracted from the gross scale reading to derive the true content weight stored against each scan.
• Tolerance ±kg — how far from target counts as "in spec". Underweight/overweight totals on the dashboard use this number.
• Active switch — turn off a SKU to hide it from stickers and reject incoming scans for it.

Click Save on a row after editing. Codes are uppercased automatically.

Packhouse & wages

• Packhouse name — shown at the top of the dashboard and on the header of every exported PDF report. Set this once when you commission the system.
• Hourly wage — the per-hour rate used to compute the live cost-per-carton figure on the dashboard and reports.
• Performance pay — when enabled, hours over target add bonus hours to the wage calc; when disabled, pay is just shift hours + credit hours.

Live cost per carton

The dashboard shows a live Cost / carton figure (green stat box). Without performance pay:

cost/carton = (staff × hourly rate × elapsed hrs) ÷ cartons packed

With performance pay on, workers earn bonus hours for output above target pace:

bonus hrs = max(0, (cartons − target × elapsed hrs) ÷ target)
pay hrs   = elapsed hrs + bonus hrs + credit hrs
cost/carton = (staff × hourly × pay hrs) ÷ cartons

Once a lane is ahead of target, cost per carton locks at a constant floor:(staff × hourly) ÷ target/hr— going faster does not reduce it further.

Lunch break: the 11:30–12:00 window is automatically excluded from elapsed hrs, so target counts and cost-per-carton reflect only paid working time.

Lane status

One row per lane (A–E). For each lane:

• Target cartons/hr — used as the benchmark on the dashboard speedometer and to flag under-performing lanes.
• Staff count per position — the system adds together all positions: Arrivals + Cutters + Packers + Loadmasters + QC + Departures. Update each position count to match the actual number of people on the floor so the cost-per-carton calculation is accurate.
• Credit hrs — extra paid hours not from packing (e.g. pre-shift cleaning, training). Added to the wage base.
• Enabled switch — when off, that lane is excluded from dashboard totals, reports, and cost-per-carton. Use this if a lane is down for maintenance.

The dashboard's Per orchard block card reads each lane's current block, which is set from the Dashboard (not Settings) so block changes mid-shift don't need a manager.

Staff names

Assign a name to each lane × packer position (e.g. LA-P3 = "John Smith"). Reports then show real names instead of LA-P3 codes. Names are optional — an empty slot just shows the code.

Loadmaster Nodes (LoRa scanner hardware)

Each LoRa scanner node (NLM1, NLM2, …) is a Pi that runs at the end of the conveyor belt. It scans carton barcodes wirelessly via LoRa radio to the master Pi. The Loadmaster Nodes table shows:

• Scanner ID — the node identifier (e.g. NLM1, NLM2).
• Status — green Online if a scan was received in the last 3 minutes, amber Stale (3–30 min), red Offline if over 30 minutes with no scans. Scans made while offline are stored on the node and delivered automatically when the link is restored.
• Last scan — timestamp of the most recent carton scanned by that node.

Shift notifications

The Shift notifications card on Settings lets each manager device receive a push notification the moment a shift starts or ends. Alerts arrive even if MoyaTrace is closed, and tapping them opens the relevant page (Dashboard for start, Reports for end).

• Open Settings on the device you want to receive alerts.
• In the Shift notifications card tap Enable notifications and allow the browser prompt.
• Use Send test to confirm delivery, or Disable to stop alerts on that device.
• Every manager who enables it on their own phone/tablet gets both alerts — start and end.