YARDMASTER: System & Persona Architecture

"A plant goes down. The concrete clock is ticking. Four different operators must execute a synchronized triage protocol in 90 minutes or lose $50,000."

1. The Social Graph (The Operational Network)

Readymix is not a single-player game. YARDMASTER interfaces with the Dispatcher, but its value is derived from stabilizing the entire social graph during a cascading failure.

The Dispatcher
The Air Traffic Controller

Goal: Reroute trucks and protect the concrete clock.
Friction: Blinded by fragmented systems (Jonel + TruckTrax) during a crisis.
YARDMASTER Value: Provides instantaneous, verified reroute recommendations passing the Triple-Gate check (Material, Washout, Labor).

The Batchman
The Ground Zero Operator

Goal: Execute mix designs and diagnose plant hardware failures.
Friction: Stuck communicating the same delay to multiple parties while trying to wrench on the machine.
YARDMASTER Value: Isolates the Batchman so they can focus on repairs, while the system automatically handles the routing fallout.

The Plant Manager
The Operations Chief

Goal: Assist troubleshooting, mobilize maintenance, protect P&L.
Friction: Loses visibility of the fleet while managing the mechanical fire.
YARDMASTER Value: Gives the Manager confidence that the Dispatcher has the tools to triage the bleeding profit while the Manager fixes the plant.

2. Operational Cascade: The "Plant Down" Protocol

When a physical failure occurs, this is the exact sequence of human and system events. This timeline represents the core operational loop YARDMASTER is built to optimize.

1
Batchman Diagnoses Hardware Failure

The plant stops batching. The Batchman identifies the mechanical/software fault and realizes the plant will not meet the immediate load schedule.

2
Batchman → Dispatcher The Warning Call

Batchman radios Dispatch to inform them of the shutdown and provides an estimated time of delay. The concrete clock (~90 mins) becomes the critical constraint for already-loaded trucks.

3
Batchman → Manager The Escalation

Batchman calls the Plant Manager to report the fault. Manager steps in to assist with troubleshooting and immediately contacts the Maintenance Team for dispatch.

4
Dispatcher + YARDMASTER The Reroute Execution

While management fights the fire, Dispatcher opens YARDMASTER. The AI has already analyzed the delay, cross-referenced idle capacity at Plant B, verified aggregate availability, checked truck washout status, and verified DOT driver hours. Dispatcher clicks "Approve Reroute." Disaster averted.

3. Trinity Graph Mapping

🌐
Knowledge Graph (Ground Truth): Live Jonel batch API, TruckTrax telemetry, mix design inventory, driver DOT hours, washout protocol physics.
👥
Social Graph (Human Network): Dispatcher ↔ Batchman ↔ Manager ↔ Maintenance Team ↔ Drivers ↔ Site Supers.
🧠
Generative Graph (Synthesis): Continuously monitors the Knowledge Graph. When an anomaly is detected (Plant Down), it calculates validated reroutes using physics and labor constraints, outputting only 100% executable options to the Dispatcher.