ROADTRUTH User Guide

VEHICLE RELIABILITY INTELLIGENCE · PLATFORM v1.6 · JOSMOL GROUP INC.
1. What ROADTRUTH is2. The Floor3. Clinical Rounds4. The Prover Board5. The Forecaster6. The Office7. Connecting a carrier8. WhatsApp shop reports9. Data & privacy10. Troubleshooting & FAQ11. Support

1. What ROADTRUTH is

ROADTRUTH monitors every vehicle in a fleet through the telematics it already carries, computes a Vehicle Health Score (VHS, 0–100) for each unit, predicts what is about to break inside a time window, and then holds itself to account: every prediction is adjudicated against what the workshop actually found, and both confirmations and misses are published on the Prover Board.

The platform is organized like a clinic. AI Physicians read each unit's case file (fault codes, telemetry, service history) and draft prognoses; a human maintenance lead reviews and posts them; the shop's findings close the loop. Three honesty rules run through everything: simulated data is always labeled, cost figures are estimates and never quotes, and nothing posts to the board without a human confirming it.

ROADTRUTH is paired with ROADWORTHY, its driver-readiness sibling. Vehicle data flows to the driver's app; only a 0–100 readiness aggregate flows back. Driver health never crosses the wall.

2. The Floor

The Floor is the fleet at a glance — one card per unit.

3. Clinical Rounds

Rounds is the floor's conversation: the Physicians walking the fleet, challenging each other's readings, answering the Adversary. Use ASK THE FLOOR ⚡ to put a question to the live AI channel — "what's the risk on LAG-07 this week?" — and the floor answers from the actual case files.

4. The Prover Board

The board is the platform's public record. Every prediction appears with its type, interval, and status:

StatusMeaning
PENDINGPosted; the interval clock is running.
CONFIRMEDThe shop's findings matched the prediction.
MISSThe findings refuted it. Misses stay on the board — they train the engine.
WITHDRAWNPulled before adjudication.

Statuses flip when a teardown report arrives (see WhatsApp shop reports).

5. The Forecaster

The ninth agent, powered by Claude. RUN AI FORECAST on any unit produces a 90-day outlook: per-item risk, expected window, recommended action, and a cost range grounded in your fleet's own logged invoices — plus a quarterly maintenance budget figure. Every figure is marked ESTIMATE · NOT A QUOTE, and each item states its basis. The more service records the Office logs, the sharper the cost grounding becomes.

6. The Office

The Office is the fleet maintenance desk, gated by PIN. The master Office PIN sees everything; a fleet PIN (set per carrier) scopes every action below to that carrier's own units — pairing, service records, predictions, import, registry view, and reports.

Fleet Registry

Driver pairing

Enter the driver's DoktorConnect ID (DC-XXXX-XXXX) against a unit and PAIR. The driver's "My Truck" card and Lane readiness strip light up in ROADWORTHY on their next open.

Service records

LOG WORK after every job — description, parts, odometer, hours, cost, currency. This is the Forecaster's cost reference base: the fleet's own invoices become the pricing truth.

Prediction Desk

  1. AI PROPOSE ⚡ — the Physicians read the unit's real case file and draft up to two candidates with rationale. Thin evidence produces fewer candidates or none; that restraint is deliberate.
  2. Review and edit — take a draft with USE THIS DRAFT, or write your own; adjust confidence and interval.
  3. POST TO BOARD — the prognosis goes to the Prover Board as PENDING with the next P-#### id. Nothing posts without this human step.

7. Connecting a carrier, end to end

  1. Office → enter PIN → ADD FLEET (or have the carrier click your OAuth connect link and approve).
  2. IMPORT UNITS — trucks land on the Floor, pre-mapped.
  3. Within 15 minutes the ingestion pass writes telemetry and fault codes; the engine computes each unit's first VHS with its basis.
  4. Pair drivers to units by DC-ID; the ROADWORTHY lane strip goes live.
  5. Give the shop the WhatsApp reporting habit (next section). From here the platform runs itself: score → predict → alert → confirm.

No hardware is installed on any vehicle at any step. Access is read-only, scoped, and revocable by the carrier at any time.

8. WhatsApp shop reports

After a repair, the mechanic sends one short WhatsApp message to the fleet's ROADTRUTH number: the prediction id (or the unit), what was found, and whether it matched — a photo helps. The AI parses the message, matches it to the open prediction, and flips the board to CONFIRMED or MISS. Example:

P-0147 LAG-07 — opened the alternator, rectifier diode pair burnt exactly as predicted. Replaced. Confirmed.

Report the misses with the same energy as the wins. A miss on the board is the engine learning; a miss kept quiet is the engine lying.

9. Data & privacy

10. Troubleshooting & FAQ

You seeIt means
"Awaiting first telemetry window"The unit was just imported; the next 15-minute ingestion pass will populate it.
ENV FALLBACK on a fleetThe fleet has no stored credential of its own; it rides the deployment's environment token if one is set.
A score changed after a repairCorrect behavior — the engine recomputes from current evidence. Adjudicating a prediction removes its risk penalty on the next pass.
DEMO label on outputAn honest fallback: the underlying service or table isn't configured yet, and the platform says so instead of inventing data.
"This pin is scoped to another fleet"You used a fleet PIN on a unit that belongs to a different carrier. Use that fleet's PIN or the master PIN.
AI PROPOSE returns nothingThe case file was too thin to justify a prediction. Wait for more telemetry or fault evidence.

11. Support

Josmol Group Inc. · Joseph@josmolgroup.com · 915-478-8807 · 4816 N. Mesa St, El Paso, TX 79912