Architectures/Private layers · dispatch · field proof
Public reference architecture

Geo Operations & Roadside

Precise intake and eligible-resource evidence before dispatch or closure.

Keep location precision, resource eligibility, provider availability/acceptance, customer ETA, physical execution and CRM reconciliation as separate authorities.

Know which component owns the state—and what it must never infer.

Every layer exposes an authoritative responsibility and an explicit non-authority boundary.

01
Owner/care/vehicle channels

Intake evidence

OwnsConfirmed location, safety, vehicle and contact context

Must not inferSignals inform context, not diagnosis

02
SAAS-08

Geo/resource intelligence

OwnsEligibility, catchment, access and calculated suitability

Must not inferEligible is not available or accepted

03
Provider/field systems

Provider workflow

OwnsOffer, acceptance, en-route, arrival and service evidence

Must not inferPlatform intent is not physical dispatch

04
APP-08 / CRM/DMS

Workspace/reconciliation

OwnsCase projection, offline intent, proof and source reconciliation

Must not inferPending intent cannot advance canonical provider state

State advances through evidence—not optimistic UI.

Each transition names both the action and the identity or version evidence that makes it reproducible.

  1. 01

    Confirm incident

    Capture minimum necessary precise location, safety and vehicle context.

    location source/quality · consent · case revision
  2. 02

    Select resource

    Filter service capability, coverage, access, status and policy.

    eligibility reasons · status source/freshness
  3. 03

    Offer and accept

    Separate provider offer, availability and authoritative acceptance.

    assignment revision · provider receipt
  4. 04

    Execute

    Progress en-route, arrived and completed only from declared provider source.

    source event · clocks · proof refs
  5. 05

    Reconcile and learn

    Require closure proof and CRM/source agreement; analyze network gaps separately.

    proof · reconciliation · observed/calculated/predicted class

Interfaces that a production program must own.

01

Incident

Location, safety, vehicle context, consent and revision.

02

Resource

Capability, eligibility, status, access and source freshness.

03

Assignment

Offer, accept/decline, ETA and provider-source progression.

04

Closure/analysis

Proof, reconciliation and observed/calculated/predicted evidence.

Failure states stay truthful and useful.

Emergency indicators

Stop before service recommendation and show approved emergency guidance without claiming dispatch.

Ambiguous location

Require confirmation; publish no resource result.

No eligible/accepted provider

Escalate while remaining unassigned; do not invent ETA.

CRM/provider terminal mismatch

Keep case escalated and preserve both authorities until reconciliation.

Privilege follows the narrowest useful boundary.

  • Minimum-data, case/role/purpose-limited access
  • Precise location and contact protected at field/device boundary
  • Offline intent uses event/idempotency/base revision
  • Proof references avoid uncontrolled evidence bytes
  • Emergency/service wording follows authoritative boundary

A green demo is not a production acceptance case.

  • 01Precise/ambiguous/emergency intake fixtures
  • 02Eligibility, status freshness and provider decline
  • 03Offline field journal and stale revision
  • 04Proof closure and CRM reconciliation
  • 05Network suitability definitions and bias/data-gap review

Compose the system without collapsing product ownership.

Each product can be bought and operated independently while sharing identity, context and lifecycle contracts.

OEM program workshop

Turn the Geo Operations & Roadside reference into your program architecture.

Confirm target products, vehicle and cloud boundaries, source systems, contract versions, deployment, validation and lifecycle ownership.