System Topology¶

This topology is the map to use before opening a service repo, protocol document, or feature spec. It shows how physical assets, external standards, core ontology concepts, product domains, and user-facing surfaces fit together.

Read it from the outside inward:

1. External systems and physical assets create evidence or intent.
2. Standards describe the exchange boundary.
3. BetterFleet projects that input onto the core ontology.
4. Product domains own decisions over those concepts.
5. Services, screens, reports, and support workflows expose the result.

Navigational Topology¶

flowchart TB
  subgraph Sources["External intent, evidence, and constraints"]
    WorkSources["Work sources<br/>schedules, dispatch, ITCS, DMS, FMS"]
    PhysicalAssets["Physical assets<br/>vehicles, chargers, EVSEs, connectors, depots, meters"]
    GridActors["Grid and energy actors<br/>DSO, DERMS, tariff, market, aggregator"]
    CommercialActors["Commercial actors<br/>CPO, eMSP, roaming hub, payment provider"]
    Users["Users<br/>operator, fleet manager, energy manager, support, driver"]
  end

  subgraph Standards["Standards and integration boundaries"]
    TransportStandards["VDV, GTFS, TransXChange, SIRI<br/>work and operations context"]
    ChargingStandards["OCPP, ISO 15118, IEC 61851, IEC 62196<br/>charging and charger state"]
    EnergyStandards["OSCP, OpenADR, IEC 61850, IEEE 2030.5<br/>capacity and flexibility"]
    RoamingStandards["OCPI, OICP, OCMF<br/>access, tariffs, CDRs, meter proof"]
  end

  subgraph Ontology["Core ontology"]
    Work["work"]
    Fleet["fleet"]
    Vehicle["vehicle"]
    Requirement["energy requirement"]
    EnergySystem["energy system"]
    Charging["charging"]
    Activity["vehicle activity<br/>projection"]
    Commercial["commercial record<br/>projection"]
  end

  subgraph Domains["Problem domains"]
    Ops["Operations & Dispatch"]
    Smart["Smart Charging"]
    Energy["Energy & Cost Management"]
    Roaming["Roaming & Shared Charging"]
    Incidents["Incidents & Notifications"]
    Reports["Reporting & Insights"]
    Trust["Resilience & Security"]
    UX["Accessibility & Usability"]
  end

  subgraph Surfaces["BetterFleet surfaces and implementation"]
    Plan["Plan<br/>simulation, schedule analysis, scenarios"]
    Manage["Manage<br/>live depot, control, visibility"]
    Connect["Connect<br/>charger integration boundary"]
    RoamingApp["Roaming services<br/>access and settlement"]
    Reporting["Reports and dashboards"]
    Support["Help docs and support workflows"]
  end

  WorkSources --> TransportStandards
  PhysicalAssets --> ChargingStandards
  PhysicalAssets --> EnergyStandards
  GridActors --> EnergyStandards
  CommercialActors --> RoamingStandards
  Users --> Surfaces

  TransportStandards --> Work
  TransportStandards --> Activity
  ChargingStandards --> Charging
  ChargingStandards --> Activity
  EnergyStandards --> EnergySystem
  RoamingStandards --> Commercial

  Work --> Requirement
  Fleet --> Vehicle
  Vehicle --> Activity
  Requirement --> Charging
  EnergySystem --> Charging
  Charging --> Vehicle
  Charging --> Commercial
  Charging --> Activity

  Work --> Ops
  Fleet --> Ops
  Vehicle --> Ops
  Requirement --> Ops
  Requirement --> Smart
  EnergySystem --> Energy
  EnergySystem --> Smart
  Charging --> Smart
  Charging --> Roaming
  Commercial --> Roaming
  Activity --> Incidents
  EnergySystem --> Incidents
  Charging --> Reports
  Commercial --> Reports
  Activity --> Reports
  Charging --> Trust
  EnergySystem --> Trust
  Users --> UX

  Ops --> Plan
  Ops --> Manage
  Smart --> Manage
  Smart --> Connect
  Energy --> Manage
  Energy --> Plan
  Roaming --> RoamingApp
  Incidents --> Manage
  Reports --> Reporting
  Trust --> Manage
  UX --> Support

How To Navigate From A Question¶

Mental Model¶

Use this compact model in project discussions:

flowchart LR
  Intent["Operational intent<br/>work, target, deadline"]
  Constraint["Supply constraint<br/>site, grid, tariff, fault"]
  Decision["Product decision<br/>domain owner chooses action"]
  Action["Control or workflow<br/>command, plan, alert, report"]
  Evidence["Evidence trail<br/>event, meter, projection, CDR"]
  Learning["Operational learning<br/>readiness, cost, carbon, reliability"]

  Intent --> Decision
  Constraint --> Decision
  Decision --> Action
  Action --> Evidence
  Evidence --> Learning
  Learning --> Intent

The useful habit is to ask: what is the intent, what constraint changes it, who owns the decision, and what evidence proves the outcome?