Onboarding

From kickoff to first live result in five steps.

A practical guide to keys, manifests, edge packs, dry runs, baseline monitoring, and correction-path validation.

Shadow detectionPost-repair verificationSigned evidence
NADIR HORIZON forecast demo
HORIZON forecast demo · seed dataProduct / documented source
Pilot KPIMTTFF-REFlag within 7 days of repair
ModeShadow onlyNo ECU writes
EvidenceSigned bundlesInsurer-ready export
BoundaryAdvisory analyticsNot ASIL-certified
01 / INTERACTIVE DIAGRAM

Pilot week map

Week 0 setup through week 4 readout.

NADIR VISUAL · SEED DATAILLUSTRATIVE · NOT FIELD PERFORMANCE
Nominal Caution Critical

Illustrative seed-data visualization. Validate on your representative fleet sample before operational decisions.

02 / DETAILS

Two ways to read this page

Plain language for fleet and investor conversations. Technical detail for engineering diligence.

Plain-language summary

NADIR helps fleets detect likely ADAS miscalibration after repair using data you already export.

Shadow mode means advisory tiers and signed records — not automatic vehicle changes.

  • Start with a four-week $750 proof pilot.
  • Success = MTTFF-RE within seven days on most repair events.
  • Expand only after a written pass/fail readout.
03 / RACI

Roles and responsibilities.

A shadow pilot fails when nobody owns the RO feed.

Fleet maintenance: cohort selection and bay follow-up on CRITICAL rows.

Fleet IT: telematics export cadence and schema stability.

NADIR: scoring, digest, readout, sample EVBs.

  • Maint leadQueue consumer
  • ITData contract owner
  • LegalShadow LOI sign-off
04 / RUNBOOK

Week 0–4 onboarding runbook

Roles, meetings, and artifacts each week.

Confirm cohort VIN list, RO feed owner, telematics export owner, legal shadow language.

Deliver adapter manifest draft and sample batch template.

Attendees
Maint · IT · Legal optional
Output
Data contract v1
05 / DATA CONTRACTS

Repair order ingestion

The RO close timestamp anchors post-repair scoring. Without it, MTTFF-RE is undefined.

VIN (17 char), RO identifier, close timestamp (UTC preferred), procedure category, and shop identifier.

Optional but valuable: part numbers for glass, ADAS kit replacement flag, technician notes.

NADIR validates identity before joining — malformed VINs land in a quarantine report, not silent scoring.

Required
vin · ro_id · closed_at · procedure
Format
CSV · JSON · webhook
Cadence
Daily batch minimum
06 / INTEGRATION

Telematics ingest and schema validation

Signals you already export — validated before scoring.

VIN, UTC timestamp, speed, yaw rate, steering angle, forward radar lead distance if available, lane offset proxy if available.

Geotab, Samsara, Motive, and OEM exports differ — NADIR maps through adapter manifests.

Missing optional fields reduce confidence; missing required fields reject the batch row.

Required
vin · ts · speed
Ideal
+ yaw · radar · lane
Mode
Batch first
07 / PILOT KPI

MTTFF-RE — the one pilot metric

Mean Time To First Flag after Repair Event. One number for pass, fail, or stop.

When a vehicle leaves a glass or body shop, start a clock at repair order close.

MTTFF-RE measures hours until NADIR assigns CAUTION or CRITICAL in the post-repair observation window.

If most events flag within seven days, your maintenance team gets actionable lead time before silent misalignment becomes a safety conversation.

  • Median MTTFF-RE ≤ 168 hours is the default pilot target.
  • Pass rate ≥ 70% of in-cohort events is the companion statistic.
  • Events without telemetry are excluded — never counted as passes.
08 / EVIDENCE

Evidence bundles and verification

Tamper-evident records for QA, insurers, and safety boards.

Source frame hashes, ingest adapter version, model and policy IDs, tier transition, repair_event_id, operator ack metadata.

Canonical JSON serialization before HMAC-SHA256 signature.

Verification recomputes digest — integrity check, not ground-truth calibration proof.

09 / REFERENCE TABLE

Reference matrix — pilots/onboarding-guide

Dense field reference for engineering diligence on this topic.

CategoryField / controlValueNotes
Pilotmodeshadow_advisoryNo ECU writes
PilotkpiMTTFF-REMedian ≤168h target
Pilotcohort50–150 VINsShadow Proof SKU
IngesttelemetryPOST /v1/telemetry/batchCSV/JSONL
IngestrepairPOST /v1/repair-eventsRO anchor
ScoretierNOMINAL|CAUTION|CRITICALPolicy-bound
Scoremodelpulse_residual_*Versioned
ProductqueueConsole CRITICAL rowsOperator-facing
ProductdigestWeekly CSV/emailCAUTION summary
EvidencesignatureHMAC-SHA256Integrity only
EvidenceverifyPOST /v1/evidence/verifyRecompute digest
SecuritytransitTLS 1.2+API only
SecurityauthBearer + API keyTenant scoped
BoundaryasilNot claimedAdvisory analytics
BoundaryactuationNoneShadow default
Commercialproof$750 flat4 weeks
Commercialops$750/moAfter pass
Commercialregional$15k+150–500 VINs
10 / GLOSSARY

Shared vocabulary

Terms used across NADIR pilots, API docs, and readouts.

MTTFF-RE

Mean Time To First Flag after Repair Event — hours from RO close to first CAUTION+ tier.

RO closed Monday 6pm, first CAUTION Wednesday 2pm → MTTFF-RE = 44 hours.

Shadow mode

Advisory scoring and evidence export without ECU writes or automated dispatch.

Console shows CRITICAL; maintenance decides whether to pull the unit.

EVB

Evidence Vehicle Bundle — canonical signed JSON record of tier transition lineage.

Includes model_id, policy_id, frame hashes, repair_event_id.

Pulse tier

Low-latency residual scoring tier used in public shadow pilots.

Batch scoring within minutes of telematics upload.

Cross-modal residual

Disagreement metric between sensor modalities (e.g., camera lane vs radar range-rate).

Persistent elevation after glass repair triggers CAUTION.

RO close

Timestamp when repair order is marked complete — starts post-repair observation window.

Must be UTC with timezone documented in data contract.

Policy ID

Version identifier for tier threshold rules separate from model weights.

policy_post_repair_glass_v3.2

Quarantine batch

Ingest batch rejected for schema errors — not silently partially scored.

Clock regression rows excluded with explicit error report.

Exhibit A

Week-four pilot chart plotting MTTFF-RE per repair event.

Median line vs 168h threshold.

Coverage exclusion

Repair event omitted from KPI due to missing telematics — not counted as pass.

Listed in readout appendix with reason no_telemetry.

Reason codes

Machine-readable tags explaining why tier was assigned.

CAMERA_RADAR_DIVERGENCE, POST_REPAIR_PERSISTENCE.

Adapter manifest

Versioned field mapping from fleet telematics export to NADIR schema.

geotab_pulse_v1.4.json
11 / DETAILS

Common questions

Straight answers for buyers and reviewers.

Common questions

Straight answers for buyers and reviewers.

12 / DEPLOYMENT

The onboarding sequence.

No stage advances until its input and fallback behavior are understood.

01

Kickoff

Confirm owners, vehicles, signals, and outcomes.

02

Access

Create keys and the boot manifest.

03

Dry run

Validate schema and replay sample data.

04

Live

Establish baseline and review correction fit.

What your team provides.

The minimum depends on the integration path.

Fleet manifest
Vehicle IDs, sensor profile, and operating context
Telemetry
CSV, JSONL, API stream, or gateway source
Owner
A technical contact and an operations reviewer
Success criteria
Agreed outcomes labeled as targets
Correction path
Supported integration, fallback, and validation owner
15 / ACCEPTANCE GATES

Know what acceptance means at each stage.

Onboarding is complete only when data, workflow, and review criteria have named owners.

CAPABILITY
Sample acceptedMonitor acceptedCorrection accepted
Schema
ValidStable in operationBound to exact path
Behavior
RepresentativeQueue reviewedTransform re-scored
Fallback
N/AEscalation ownedDisable + original stream
Evidence
Source manifestWorkflow EVBCorrection lineage
Download requirements →

Detect miscalibration before vehicles return to route.

4-week paid shadow pilot on 50–150 ADAS vehicles.