MCR Dispatch β€” Help

10 Oct 2026  Β·  mcrdispatch.net ← Back to App

Quick start

1. Open mcrdispatch.net. Use the username and PIN an admin gave you. Same login works on the board and Admin. If the page asks for a login and you do not have a PIN, ask an admin β€” the public site will not guess it.
2. Confirm Region and Dispatch Date. The board opens on your home state. Next to the date is a Tomorrow button (it says Monday on Saturday or Sunday). Tap it once to jump to the next workday; the button then shows that weekday (Wed, Thu…).
3. Load the day’s list. Dispatch lists arrive automatically by email. When a new one is in, a gold πŸ“¬ New dispatch received banner appears at the top of the board β€” tap Load, then Generate Dispatches. Review the cards. Reassign if the map looks wrong.
4. Send the day with βœ… Messages then Copy Message on each tech and send it from your own phone. πŸ“€ Send and πŸ“± Text this stop still email the technician, but text delivery to Verizon phones is currently blocked by the carrier, so do not rely on the text part. Use Copy Message for anything urgent.
5. Look up any site. Tap a site name on a stop card (on the board, the State Console or Saturday On-Call) to open its history: recent visits, ticket emails, closing notes, and shipments. It looks the same on every page. See Site History.
6. Testing-station / OTC close-outs (the old Blue Folder log): sidebar ⏱ Service responses, or Admin β†’ Service responses. Michigan testing is the default filter because that is what gets billed. Click a column header to sort β€” Arrival starts newest first.

Want a different view of the same day? Compact Summary (next to Messages) lists the stops in a short form you can work from while dragging work orders onto the Salesforce console. πŸ“ State Console shows any state and date without running a dispatch. Print this page from the button at the top if you want paper. The rest of this file is the longer reference.

⚑ Quick Reference

The short version. Every row below links to the full section if you need more.

I want to...Do this
Run today's normal dispatchGenerate Dispatches β†’ review/reassign β†’ βœ… Messages or πŸ“€ Send. See Daily Dispatch.
Handle a trouble ticket right nowTrouble tickets arrive by email and are added to the site’s board entry automatically. SLA deadline is calculated automatically. See Urgent Dispatch.
Text one trouble stop to the assigned techOn that stop card tap πŸ“± Text this stop. Edit the draft, Confirm Send. See Text this stop.
See a second ticket at a site already on the boardAmber chip ⚠ Another ticket today β€” tap for WO / notes. Red SLA line sits under the restock. Do not assign a second tech.
Collect a technician's cell carrierAdmin β†’ Technicians β†’ Carrier dropdown, or pick the carrier on the Text this stop sheet. Both save number@vtext.com on their card.
Jump the board to tomorrowTap Tomorrow next to Dispatch Date (says Monday on the weekend). The button then shows the weekday you landed on.
See testing-station close-outs (old Blue Folder)Sidebar ⏱ Service responses. Click headers to sort. CSV / Excel for billing.
See where everyone is today, at a glanceπŸ—ΊοΈ Map View on the dispatch board (today's board only), or the πŸ“ State Console for any saved date, any state. See State Console.
Check if today's routes are efficient🧭 Analyze Routes (dispatch board or State Console) -- suggests specific stop swaps with the mileage each one saves. See AI Assistant.
Move a stop with a typed/spoken commandType or dictate into the AI command bar, e.g. "move stop 2 from Robert to Sean." See AI Assistant.
Work a state I don't normally coverOpen that state's πŸ“ State Console first -- shows who's out, recent tickets, and restock status without needing the full dispatch workflow.
See a site's past visits, notes, or ticket emailsTap the site name on any stop card. Same popup on the board, State Console and Saturday On-Call. See Site History.
Record that a site was restocked (outside a normal ticket)Open the site's history popup and tap βœ… Mark Restocked. Add an optional note. See Site History.
Check for stale/unaddressed trouble ticketsWatchdog Log (button next to the state selector, or /watchdog/:state) -- every open trouble/install/site-survey ticket for a state, sorted by urgency.
Undo something I just did↩ Undo in the Session Actions list at the bottom -- only works until you refresh the page. See Session Actions.
Add/edit a location or technicianAdmin Panel β†’ Locations or Technicians tab. See Admin Panel.
Add a single new tech/location to the distance matrixJust save them with a real address -- a prompt offers to add them right there, or use βž• Quick Add on the Distance Matrix tab any time after. See Admin Panel.
Work Saturday on-call ticketsOpen πŸ“ž Saturday On-Call from the board. Assign only after you choose a tech. See Saturday On-Call.
Add a dispatcher login or change a PINAdmin Panel β†’ Users (admin role), or check This employee is also a dispatcher on the Technicians tab. See Admin Panel.

πŸ†• What's New

Updated 10 October 2026. Print this page (button top right) if you want a paper copy.

Site history is the same everywhere

Tapping a site name now opens the same history popup on the dispatch board, the State Console and Saturday On-Call. It shows past visits with their closing notes, the emails behind tickets, shipments with tracking links, and has βœ… Mark Restocked, Load more and Print. See Site History.

Visit history cleanup

Hundreds of past visits that had been filed under the wrong store were moved to the right one (Palm Beach, Broward and Lee County in Florida; several Michigan, Indiana, Colorado, Georgia, Minnesota and Nevada stores). A few site names were corrected so look-alike stores no longer get mixed up. If a store's history still looks wrong, tell an admin which site and visit.

Blue Folder is closed

OTC / testing-station close-outs and those calendar entries now live in the app. Use ⏱ Service responses for ITI times and miles (default filter: Michigan testing). Click any column header to sort; Arrival defaults to newest first. Ordinary kiosk restocks and trouble tickets were never Blue Folder β€” still planned here, still dropped in Salesforce.

Tomorrow / Monday date button

Next to Dispatch Date. Weekdays it is Tomorrow. Saturday or Sunday it is Monday. After you tap it, the label becomes the weekday of the date now on the board (Wed, Thu…). Set the date back to today and it returns to Tomorrow / Monday.

Carrier sheet on Text this stop

If a tech has no carrier, the sheet asks for their cell and a dropdown: Verizon, T-Mobile, AT&T, Sprint, or type the full gateway. Picking a listed carrier builds number@vtext.com (etc.) and always saves it on their technician card. Email only is still there if you only need this one message.

Text this stop (trouble tickets)

Each assigned trouble WO on the board has πŸ“± Text this stop under Done / Cancel. Restocks stay on the big Messages list. The draft names the site, WO, issue, and SLA. If the site was already a restock, the wording is that a trouble ticket was added to that restock β€” same truck, now timed. There is no β€œplease acknowledge”; replies to the carrier gateway do not come back into the app.

The text includes a short link mcrdispatch.net/ack?t=…. When the technician taps it they see a one-line confirmation page. The stop card gets a green βœ“ confirmed receipt line. The first tap can ping the on-call dispatcher; a second tap does not.

If that technician has no carrier on file, the sheet above appears. Fill Carrier once and both Text this stop and Watchdog use it.

Same site, restock plus trouble

The board still shows one stop per site. If a morning restock was completed and an afternoon trouble WO lands, the board now prefers the open ticket over the completed restock so the WO does not vanish. The restock details stay on the card; the red SLA / Due line is added underneath. A second unrelated WO the same day is the amber ⚠ Another ticket today β€” tap for WO / notes chip (opens site history). Do not assign a second technician β€” they are already going.

Watchdog uses the technician card

Notifications still control who is on, which states, and active hours. The actual SMS address now comes from the matching technician card (or the dispatcher login’s linked technician) when that gateway is valid. Office-only logins with no technician row still use the number typed on Notifications.

Mileage log (technicians)

Technicians with the tech role land on the mileage page only β€” not the dispatch board. Dispatchers can open it from the sidebar. Drafts survive a refresh. Export matches the company mileage spreadsheet. The spreadsheet remains the backup.

Board login and home state

Opening the dispatch board now asks for the same username and PIN as Admin. The region list is limited to that person's territories (admins see every state). The board opens on the last state they used, or their first territory if they have no last-used state. Switch user is at the top for a shared tablet. The splash stays up until the board has actually loaded, so the empty map/cards should not flash on a fresh start.

Saturday On-Call page

A dedicated Saturday console (/saturday-oncall, also linked from the board) shows only trouble tickets due that Saturday across coverage states. Closest on-call house is a suggestion until you tap Assign. Reassign defaults to that day's on-call list; Show all techs is the escape hatch. Message sends a short SMS ("details in email") plus a full email. After a real assignment, the text includes a tap-to-confirm link; when the tech taps it the card shows βœ“ Received and today's on-call dispatcher gets a ping. There is no Sunday coverage -- the date picker skips Sunday. Add ?preview=1 for demo tickets; demo texts are stamped TEST β€” DO NOT DISPATCH and do not write assignments.

User management in Admin

Admins get a Users tab to add logins, change PINs, edit territories/role, and deactivate people who leave. Show unmasks a PIN when someone calls. Anyone can use Change my PIN on the Admin login screen if they still know the old one. On the Technicians tab, This employee is also a dispatcher creates the login and links it to that employee profile so Saturday alerts use the same phone/carrier.

Quick Add for the Distance Matrix

Saving a new technician or location (or editing one's address) on the Admin Panel now offers to add it to that state's distance matrix right then -- a small popup with an Add to matrix button, no need to know the Distance Matrix tab exists. It shows the real price before anything runs (typically a dollar or less for one tech or one site, since it only prices that one new item against everything already built), asks for the admin password, then handles geocoding, drive-time, and -- for a new location -- site-to-site distances automatically. The same guided flow is also available any time from the Distance Matrix tab itself under βž• Quick Add, without needing to have just saved something. See Admin Panel for the full rundown, including how this differs from the state-wide build tools.

Armored Truck Meet Tracking (cash-side tickets)

A "Big Kahuna" (cash-side) trouble ticket that needs an armored-carrier technician on site no longer runs against the standard 4-hour SLA clock -- the app now tracks the real back-and-forth negotiation with the carrier's regional branch instead. See Armored Truck Meets below for the full explanation.

State Console

A separate at-a-glance page for one state at a time -- πŸ“ State Console from the dispatch board, or navigate to state.html directly. Shows who's out today, a map of any saved date's routes (independent of whatever date the dispatch board has open), recent trouble/maintenance tickets, and closed-ticket sync status, without needing to run a full dispatch. Remembers the last state you viewed there. See State Console below for the full rundown.

AI Dispatch Assistant is live

The command bar (dispatch board and State Console) now takes typed or dictated natural-language commands -- "move stop 2 from Robert to Sean" -- and applies them directly to the board. The dedicated 🧭 Analyze Routes button scans the current day's board and suggests specific one-stop swaps between techs, each with the net mileage it would save and its own Apply/Revert button. See AI Assistant below.

Watchdog Log

A per-state page listing every open trouble, install, and site-survey ticket -- including ones that never got a matching site code, which previously were only visible via SMS alert with no way to track or revisit them. Sorted by urgency; anything more than 4 days past its own deadline drops off as stale rather than cluttering the list indefinitely.

Trouble-ticket SLA is now calculated, not read from the email

The app now computes the real SLA itself, rather than relying on the ticket's stated priority -- 4 business hours, 8am-5pm, in the site's own local timezone, honoring Saturday coverage where it applies and excluding it where it doesn't. Email-stated deadlines still apply for same-day restock requests and scheduled site-survey meet times.

More states online

Idaho, Mississippi, Oregon, Nevada, Ohio, Indiana, and California have all been added since the last update, alongside the existing GA/FL/CO/MI/SC/NC/MN/IL/WV coverage. California in particular is a large territory -- 290 locations and 15 technicians -- so if you're covering it for the first time, the State Console is the fastest way to get oriented before touching the full dispatch workflow.

Map View

Tap πŸ—ΊοΈ Map View above the generated dispatches to see every tech's route plotted geographically, color-coded per tech, with a legend showing stop counts. Useful for spotting stops that are geographically close but assigned to different techs -- something that isn't always obvious from the text list alone, especially for anyone covering a state they don't know well.

Route Button Goes Straight to Maps

πŸ—ΊοΈ Route on a tech's card now opens Google Maps directly with that tech's full route, no extra tap or popup in the way.

Cluster Tool

The πŸ“ pin icon next to Route lets you tag a tech's stops with a shared cluster name (e.g. "South Atlanta") for the corridor/preemptive-restock banner. A checklist lets you include or exclude specific stops -- useful when one stop is a genuine outlier (e.g. Sean has a Macon call mixed in with several South Atlanta stops).

Unmatched Sites -- SA Numbers & Map Lookup

The Admin Panel's Unmatched Sites tool now shows the Salesforce SA number(s) tied to each unresolved name, and a πŸ“ Locate via Maps button that geocodes the raw name and shows the nearest existing site with a real-world distance -- a much stronger signal than name-similarity alone for telling apart two differently-worded records of the same site, or two similarly-named but genuinely different sites.

Technician Numbering

Each tech's card now shows a small # number and a colored dot matching their route color on the Map View, making it easy to cross-reference a tech's stops between the list and the map at a glance.

Security Hardening

Individual logins have been added per person.

Inbound Dispatch via Email

Forward any dispatch list or trouble/maintenance ticket email to dispatch@mcrdispatch.net. What happens next depends on the type:

Note: the banner checks whether the cached list's own date has already passed before showing it as "new." If it looks like an already-handled list (e.g. opening the app for the first time in a few days), you'll get a confirmation prompt before it reloads, since reprocessing an old list unnecessarily is easy to do by mistake. Reloading is safe either way -- any stop still open for a site gets updated in place rather than duplicated.

Trouble Ticket SMS Alerts

When a trouble ticket is forwarded to dispatch@mcrdispatch.net, an alert is sent automatically to configured recipients (set per-state, per-person, with active-hours windows in Admin β†’ Notifications) with the WO number, site name, issue, and SLA deadline. Text alerts to Verizon phones are currently blocked by the carrier, so check the Watchdog page for new troubles until that is restored.

Technician Availability Board

The availability panel shows all techs with real-time status. Comp days and Saturday on-call rules apply automatically. Tap Mark Out to manually mark a tech unavailable for unscheduled absences β€” the dispatch engine routes around them immediately.

Logging In

The dispatch board requires a username and PIN (same credentials as Admin). After sign-in, the board opens on your home state. The session lasts for that browser tab; use Switch user when handing off a shared tablet.

Admin Panel uses the same login. Forgot PIN: an admin can Show or Change PIN on the Users tab. If you remember the current PIN, Change my PIN on the Admin login screen is enough β€” no email reset.

Technicians with a mileage-only login skip the board and land on the mileage page. Dispatchers should not use those accounts.

Credentials are not published on this page. Ask an admin if you were pointed at the site without a PIN.

Daily Dispatch β€” Standard (Next Day)

Step 1 β€” Check date and region.
Confirm the Region and Dispatch Date are correct at the top of the screen.
The date defaults to the next business day automatically. Friday defaults to Monday. Saturday defaults to today (urgent mode).
Use Tomorrow (or Monday on the weekend) to jump forward without opening the date picker.
Step 2 β€” Review technician availability.
The board auto-marks comp days from the on-call schedule.
Tap Mark Out to manually mark a tech unavailable. Tap again to restore.
Step 3 β€” Generate.
Tap Generate Dispatches.
Step 4 β€” Review and adjust.
Use the Reassign dropdown on any stop to move it to a different tech.
After reassigning, a prompt asks if you want to save the new tech as permanent primary for that location.
If a location has no fallback and the primary is out, a queue prompt cycles through each affected location asking who should cover.
Step 5 β€” Send messages.
Tap βœ… Messages to generate tech text messages, then Copy Message for each tech and send manually -- or tap πŸ“€ Send on a tech's card to email them directly. The text part of Send is currently blocked for Verizon phones, so Copy Message is the reliable way to reach a tech by text. Set each tech's carrier and SMS address in Admin β†’ Technicians for when text delivery is restored.
Step 6 β€” Print or open Restock Tracker.
Tap Print Dispatch Summary at the top to open a printable summary in a new tab.
Tap πŸ“Š Restock Tracker (desktop) or πŸ“„ Report (mobile) next to the Messages button for quick access to the restock tracker or a mobile-friendly route report.

Dispatch Card Controls

Each tech's card shows a # number and a colored dot -- the same color used for that tech's route on Map View, so you can cross-reference between the list and the map at a glance. Each stop within a card is also numbered.

ControlWhat it does
πŸ—ΊοΈ RouteOpens Google Maps directly with all of that tech's stops in order.
↻ SortRe-sorts a tech's stops by distance -- useful after a stop gets reassigned to them, since it doesn't slot into route order automatically.
πŸ“ ClusterTags selected stops with a shared cluster name for the corridor/preemptive-restock banner. Shows a checklist so you can exclude an outlier stop from the group.
β–² / β–ΌReorder stops within a tech's list before generating messages or a route.
ReassignMove a stop to a different tech. Prompts to save the change as permanent.
β†’ TomorrowPushes a same-day stop to the next day. Only appears on TODAY-flagged stops.
βœ“ DoneMarks a stop completed and moves it to the Session Actions list below.
βœ— CancelMarks a stop canceled and moves it to the Session Actions list below.
πŸ“± Text this stopOn a trouble WO: draft a short text for that one site. See Text this stop.

Stop Badges

BadgeMeaning
TROUBLE / SLATimed ticket. That is the one that needs a same-day response. Ordinary restocks on today's list are already due today β€” they no longer all wear a SAME DAY badge.
Right FormsRight-side (previous year) registration forms requested. Confirm tech is carrying them. GA SK/BK only.
ReassignedStop was moved from its default tech this session.

Cluster / Corridor Banner

When a dispatched site carries a cluster tag (set via the πŸ“ tool above, or one of the built-in remote clusters like the Fayette/Clayton corridor), a blue banner appears suggesting you check the Restock Tracker for nearby sites that may benefit from a preemptive restock.

Map View

Tap πŸ—ΊοΈ Map View above the generated dispatches to plot every tech's stops geographically. Each tech gets a distinct color, matching the dot next to their name on their card. Tap any pin for that stop's site name, address, and distance from the previous stop.

Show all service locations (off by default) adds the rest of the state's sites as dots: green on track, amber due soon, red overdue for forms. Testing / OTC (T-codes) stay gray β€” they are not form-restock sites. Zoom and pan survive a refresh and survive toggling that checkbox. The AI command bar stays available in the expanded map.

On a gray/red/amber site popup you can jump to Restock Tracker notes for the last visit, and see driving distance to the nearest stop already on today's board (not the straight line on the map).

The legend below the map lists each tech with their stop count and lets you toggle their route on/off. Stops without saved coordinates are listed separately under the map ("Not plotted") rather than silently dropped.

Distance figures use the real site-to-site driving-distance matrix where it's been built for that state; elsewhere, or for specific pairs the matrix build didn't resolve, distances fall back to straight-line and are marked (est.).

Note: whether the map is shown or hidden, and the zoom you left it on, persist across a page refresh.

State Console

A single-state overview page, separate from the main dispatch workflow -- useful for a quick check-in, or for getting oriented in a state you don't normally cover. Access it via πŸ“ State Console on the dispatch board (carries over your currently selected state and date automatically) or by navigating to state.html directly.

Note: if you land on the wrong state or date without navigating from the dispatch board's link, it's likely an already-open tab or browser back/forward reloading an old URL rather than a fresh page load -- click through from the dispatch board to guarantee both carry over correctly.

Site History

Tap a site name on a stop card to open that site's history. The popup is the same on the dispatch board, the State Console and Saturday On-Call.

Good to know: some locations have several kiosks at one address (for example, locations with more than one printer station). Salesforce reports them under one account name, so their visits can show together under one site code. Trouble tickets still carry the specific kiosk.

AI Assistant

Available on both the dispatch board and the State Console, once a board is generated for a real date.

Typed or spoken commands

Type or tap the mic and speak a plain-language instruction -- e.g. "move stop 2 from Robert to Sean" -- and tap Run. The assistant applies the change directly to the board and repaints the map. Voice input runs entirely in the browser; nothing is recorded or sent as audio.

Note: moving a stop this way -- or applying an Analyze Routes suggestion below -- automatically re-sorts both the giving and receiving technician's remaining stops into a sensible driving order right away. No separate Sort click needed afterward.

🧭 Analyze Routes

Scans the currently generated board and suggests specific single-stop swaps between two technicians where doing so would reduce total fleet mileage, or meaningfully even out a lopsided day (one tech nearly idle while another is overloaded) even when the mileage math alone is close to neutral. Each suggestion shows the site, which tech it would move from/to, and the net mileage change, with its own Apply button -- apply just the ones that make sense, and tap again to revert (the button relabels itself). It won't suggest moving a stop onto someone marked unavailable that day, won't suggest a swap that would push the receiving tech into likely overtime for the day, and won't hand more than a couple of stops to the same tech in a single pass.

Note: suggestion quality depends on that state having a distance matrix built (Admin Panel β†’ Distance Matrix). Haversine (free) is enough for reasonable suggestions; real driving-distance data (paid) sharpens them further. A state with no matrix built yet has no real distance data to suggest swaps from.

Session Actions β€” Undo

When you mark a stop Done, Cancel, or push it to Tomorrow, it moves to a session log at the bottom of the results. Each entry has an ↩ Undo button that fully restores the stop to its original position in the queue with all badges and flags intact.

Two separate sections appear when populated:

Note: Undo is session-only. Refreshing the page clears all session actions and undo history.

πŸ“± Text this stop

1. Assign the trouble ticket on the board (Reassign if needed).
2. On that card tap πŸ“± Text this stop. Only real trouble WOs show the button.
3. If the carrier sheet appears, pick Verizon / T-Mobile / AT&T / Sprint (or type the full address). That choice is saved on their technician card. Email only sends this message without saving a carrier.
4. Edit the draft if you want. Confirm Send. They get an email with the full text. The text message (short ping + ack link) is currently blocked for Verizon phones, so for an urgent stop also copy the draft and text it yourself.
Do not use this to assign Salesforce. Drop the ticket on the Gantt yourself. This only tells the technician.

Urgent / Trouble Ticket Dispatch

Step 1. The trouble ticket email arrives automatically and is added to that site’s entry on the board. Nothing to paste.
Step 2. Open the site’s entry (or the banner, if a dispatch list came with it) and check the details.
Step 3. The SLA end time is calculated automatically from the ticket's Earliest Start Permitted field.
Step 4. Tap βœ… Messages (or πŸ“± Text this stop). The tech message reads:
⚑ URGENT - Hey Randy, a trouble ticket for Cobb County Kroger Whitlock #455 just came in: 1. Printer Jam (SLA ends Sat 1:27 PM) Tap the link in the text to confirm you got this.

Armored Truck Meets (Cash-Side Tickets)

A "Big Kahuna" (cash-handling) kiosk has a locked cash vault behind a separate door from the printer/consumables side. An MCR tech can work on the cash side, but a carrier technician (Loomis in Michigan and Oregon; Brinks in Indiana -- the carrier varies by state) must be present whenever that side is opened. So whenever a ticket needs the vault opened, MCR has to schedule a "meet" -- a time both an MCR tech and a carrier tech will be on site together -- over an email back-and-forth with that carrier's regional branch.

Note: this only applies to the specific line item that needs the vault open. A printer jam or consumables call at the same BK site doesn't need a carrier meet -- that side has its own door and doesn't require anyone but MCR.

Why this ticket type is handled differently

A normal trouble ticket's deadline is the app's standard 4-business-hour SLA. That doesn't make sense for an Armored Truck Meet ticket -- the real deadline is whatever date/time both sides actually land on, which can take anywhere from same-day to a couple of weeks depending on the carrier's own route capacity. Holding these to a 4-hour clock would just mark them "overdue" almost immediately for no real reason.

What the app does automatically (live now)

1. Detects it. Any ticket whose issue category is "Armored Truck Meet" is automatically exempted from the standard SLA calculation the moment it's created.
2. Tracks the negotiation. Every reply on that ticket's email thread -- from MCR, the carrier, or Neumo relaying either side -- is read automatically and the ticket's status is updated:
  • Awaiting Response -- the original request went out, nobody's replied yet.
  • Proposed -- a date/time has been suggested by either side, not yet agreed.
  • Confirmed -- both sides have agreed on a date/time.
  • Needs Reschedule -- the carrier couldn't accommodate the proposed time and a new one is needed.
Note: this reads the plain language of each reply (phrases like "confirms," "we cannot accommodate," "added to our route"), so it's a best-effort read of the conversation, not a guarantee -- always worth a quick glance at the actual thread before treating a status as final.

What's planned, not live yet

Note: Georgia has no cash-side units, so this workflow doesn't come up in Mark's own territory -- it's new coordination overhead specific to states with Big Kahuna kiosks.

Unknown Location Codes

If a site code in the dispatch list isn't in the database, an amber banner appears listing each unknown code with an + Add to database button.

Tap it to enter:

The new location saves to the database immediately and the dispatch re-runs automatically with it included.

Note: If some codes are known and some aren't, the board generates for the known ones while the amber banner lists the unknowns above the results.

Saturday On-Call

On Saturdays the main board still auto-marks everyone Not on call except the scheduled on-call techs. Day-to-day Saturday work now lives on πŸ“ž Saturday On-Call (saturday-oncall.html).

What the Saturday page shows

Assigning

Closest on-call house is only a suggestion. Nothing is written until you tap Assign suggested or pick someone in the dropdown. The dropdown is that state's Saturday on-call list (usually one or two people). Show all techs is for the occasional cover-from-next-door case. Primary/secondary from the weekday board is not used here, because those people are often the same ones already on call.

Messaging

πŸ’¬ Message sends a short SMS telling the tech the details are in email, plus a full email (WO, site, address, issue, SLA, closed-Saturday warning). After the stop is actually assigned, the SMS also includes a tap-to-confirm link. Tapping it stamps the assignment received, shows βœ“ Received on the card (refreshes about every 20 seconds), and texts today's on-call dispatcher. Tapping twice does not ping again.

Demo mode

Add ?preview=1 to see sample placards without writing to the database. Demo SMS/email are labeled TEST β€” DO NOT DISPATCH. Confirm-receipt links are not created in demo, so testers cannot accidentally ping the live Saturday dispatcher.

Georgia weekday rotation (still used by the main board)

SaturdaysOn-Call TechsComp Day
Odd (05/09, 05/23…)Randy Thomas + Sean ReichMonday before
Even (05/16, 05/30…)Omari Williams + Robert MedleyThu before (Robert M.) / Mon before (Omari)
Note: Keontae Johnson covers Savannah only and is not in that GA rotation. Other states keep their own Saturday on-call rows in Admin. There is never Sunday coverage.

Admin Panel

Access via the Admin Panel button at the bottom of the main screen.

Locations Tab

Technicians Tab

Users Tab (admin role only)

Backup Tab

Notifications Tab

Distance Matrix Tab

Builds real driving-distance data via the Google Maps API. Two kinds of data get built: tech-to-site (each technician's drive time to every location -- powers nearest-tech suggestions) and site-to-site (every location's drive time to every other location -- powers Map View's real distance labels and route-order suggestions). Both are one-time builds per state in normal use, not something to re-run casually.

βž• Quick Add -- the fast, safe way to add ONE new technician or ONE new location to a state that's already built out. Shows the real price before anything runs (typically well under a dollar, since it only prices that one new item against everything already on file), asks for the admin password, then handles geocoding and drive-time automatically -- plus site-to-site for a new location. No Full Rebuild, Force re-geocode, or other options to get wrong. This is the same flow offered automatically after saving a technician or location on their respective tabs (see above) -- Quick Add here is for running it again later, or for anyone who dismissed that prompt.

The rest of the tab is the advanced, state-wide toolset -- Geocode Locations/Techs/All, Build (Straight-Line, Free) and Build (Drive-Time) for the full tech-to-site matrix, Build Site-to-Site Matrix for the full state, and Fill Missing Pairs Only to top up a state's site-to-site coverage if it's ever incomplete (cheaper than a full rebuild -- only queries pairs that don't already exist). These carry real cost for anything beyond a single state's worth of new sites/techs, so Quick Add above is the better choice for routine one-at-a-time additions.

Both driving-mode builds (advanced and Quick Add alike) require a separate admin password beyond your regular login.

A haversine (straight-line) mode is also available, free and instant, as a fallback or a first pass before paying for real drive-time.

Closed Tickets Tab

Repeat Issues Tab

Issue Trends Tab

Unmatched Sites Tab

Restock Schedule Tab

Service responses

Inventory

Current Features

πŸ“‹ Dispatch

  • Auto date defaulting (Friβ†’Mon, Satβ†’today)
  • Technician availability board
  • Comp day auto-flagging
  • Saturday on-call auto-mark
  • Primary + fallback tech per location
  • No-fallback queue prompt
  • Reassignment with permanent save option
  • Unknown code detection + add flow with machine type
  • URGENT mode with automatic SLA calculation
  • Done / Cancel / Tomorrow controls with ↩ Undo
  • Direct-to-Maps Route button, Sort, Cluster tagging
  • Map View with real driving-distance labels
  • Direct email + SMS send to technicians
  • Print dispatch summary
  • Tomorrow / Monday date jump
  • Map: all sites + restock colors, zoom kept on refresh
  • Board auto-rebuilds from saved state on page load/refresh
  • Per-person login; board opens on that dispatcher's home state

πŸ”§ Machine Type Rules

  • SK / BK (Small / Big Kahuna) β€” 800 form max count
  • SB (Surfboard) β€” 700 form max count, all states
  • Right Forms badge + confirmation β€” GA SK/BK only
  • Partial restock SWAP warning β€” GA SK/BK only
  • Color/decal rules β€” GA only
  • Cluster/corridor banners, taggable per stop
  • NC all-surfboard auto-detected
  • SC auto-assigns to Michael Newboult

βš™οΈ Admin

  • State-scoped location + technician management
  • Notification recipients with per-person hours/timezone
  • Site-to-site + tech-to-site distance matrix builds (password + cooldown protected)
  • Quick Add -- one-item, price-shown-first matrix updates, prompted automatically after saving a tech/location
  • Fill Missing Pairs Only -- tops up incomplete site-to-site coverage without a full rebuild
  • Closed-ticket sync (manual or automatic)
  • Repeat Issues and Issue Trends (site repeats vs. category over time; print PDF on both)
  • Unmatched-site detection tools
  • Backup and restore per state
  • Users tab β€” add/deactivate logins, reset PINs, set territories
  • Mark a technician as a dispatcher from the employee form
  • Service responses (testing-station close-outs)
  • Inventory received / missing from the inventory mailbox

🧭 AI Assistant

  • Natural-language dispatch commands, typed or spoken
  • Analyze Routes -- suggested swaps with mileage saved
  • Per-suggestion Apply/Revert
  • Respects tech availability automatically
  • Available on dispatch board + State Console

πŸ“ State Console

  • Per-state overview without running a full dispatch
  • Map View for any saved date
  • Recent tickets + restock status
  • On-demand closed-ticket sync

πŸ“ž Saturday On-Call

  • Dedicated Saturday console for trouble tickets only
  • Closest on-call house is a suggestion until Assign
  • Show all techs escape hatch
  • SMS ping + full email; tap-to-confirm receipt
  • Demo mode (?preview=1) with TEST labels

πŸ”” Watchdog

  • Email monitoring (dispatch, trouble/maintenance tickets, RMA shipping)
  • SMS alert on trouble tickets, filtered by state + active hours
  • PC Name, WO number, issue category + detail parsed into alerts
  • Duplicate reply filtering

Planned Features & Future Upgrades

In Testing

Medium Term

Longer Term

Known Limitations

Last updated: October 10, 2026