{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://docs.demiton.io/registers/asset_utilisation/v1.json",
  "title": "asset_utilisation contract v1",
  "type": "object",
  "required": [
    "asset",
    "engine_hours",
    "occurred_at",
    "odometer"
  ],
  "properties": {
    "fuel": {
      "type": "number",
      "description": "CAN-bus tank-level reading, INSTANTANEOUS (never summed)",
      "x-demiton-requiredness": "optional",
      "x-demiton-unit": "pct"
    },
    "asset": {
      "type": "string",
      "description": "the machine the reading belongs to",
      "x-demiton-requiredness": "required",
      "x-demiton-reference": true
    },
    "range": {
      "type": "number",
      "description": "cumulative/remaining range counter; meaning and unit not documented",
      "x-demiton-requiredness": "optional",
      "x-demiton-unit": "km (**unverified**)",
      "x-demiton-type": "decimal"
    },
    "device": {
      "type": "number",
      "description": "the telematics device that produced the reading",
      "x-demiton-requiredness": "optional"
    },
    "project": {
      "type": "string",
      "description": "the project the asset was working on",
      "x-demiton-requiredness": "optional",
      "x-demiton-reference": true
    },
    "location": {
      "type": "string",
      "description": "last known position/place as delivered by the source; datum and unit **unverified**",
      "x-demiton-requiredness": "optional"
    },
    "odometer": {
      "type": "number",
      "description": "lifetime GPS odometer, CUMULATIVE",
      "x-demiton-requiredness": "required",
      "x-demiton-unit": "km",
      "x-demiton-type": "decimal"
    },
    "operator": {
      "type": "number",
      "description": "the operator/driver attributed at reading time",
      "x-demiton-requiredness": "optional",
      "x-demiton-reference": true
    },
    "energy_used": {
      "type": "number",
      "description": "cumulative energy counter; meaning and unit not documented in any digest read",
      "x-demiton-requiredness": "optional",
      "x-demiton-unit": "kWh (**unverified**)",
      "x-demiton-type": "decimal"
    },
    "fuel_period": {
      "type": "number",
      "description": "fuel consumed over the reading window, ADDITIVE",
      "x-demiton-requiredness": "optional",
      "x-demiton-unit": "litres",
      "x-demiton-type": "decimal"
    },
    "occurred_at": {
      "type": "string",
      "description": "the timestamp of the reading snapshot",
      "x-demiton-requiredness": "required",
      "format": "date-time",
      "x-demiton-type": "datetime"
    },
    "engine_hours": {
      "type": "number",
      "description": "lifetime GPS engine-hours meter, CUMULATIVE (never summed)",
      "x-demiton-requiredness": "required",
      "x-demiton-unit": "hours",
      "x-demiton-type": "decimal"
    },
    "odometer_can": {
      "type": "number",
      "description": "CAN-bus lifetime odometer twin, CUMULATIVE",
      "x-demiton-requiredness": "optional",
      "x-demiton-unit": "km",
      "x-demiton-type": "decimal"
    },
    "source_units": {
      "type": "object",
      "description": "the source unit each measure arrived in, beside the canonical unit",
      "x-demiton-requiredness": "optional"
    },
    "distance_period": {
      "type": "number",
      "description": "distance delta over the reading window, ADDITIVE",
      "x-demiton-requiredness": "optional",
      "x-demiton-unit": "km",
      "x-demiton-type": "decimal"
    },
    "engine_hours_can": {
      "type": "number",
      "description": "CAN-bus lifetime engine-hours twin, CUMULATIVE",
      "x-demiton-requiredness": "optional",
      "x-demiton-unit": "hours",
      "x-demiton-type": "decimal"
    },
    "financial_period": {
      "type": "string",
      "description": "the period the reading is attributed to",
      "x-demiton-requiredness": "optional",
      "x-demiton-reference": true
    },
    "engine_hours_period": {
      "type": "number",
      "description": "engine-hours delta over the reading window, ADDITIVE",
      "x-demiton-requiredness": "optional",
      "x-demiton-unit": "hours",
      "x-demiton-type": "decimal"
    }
  },
  "x-demiton-register-type": "asset_utilisation",
  "x-demiton-contract-version": "1.0.3",
  "x-demiton-store": "tenant",
  "x-demiton-axes": [
    {
      "axis": "project",
      "requirement": "optional",
      "role": "subject"
    },
    {
      "axis": "asset",
      "requirement": "required",
      "role": "subject"
    },
    {
      "axis": "financial_period",
      "requirement": "optional",
      "role": "context"
    }
  ],
  "x-demiton-measures": [
    {
      "key": "distance_period",
      "accumulation": "additive",
      "dtype": "decimal",
      "unit": "km"
    },
    {
      "key": "engine_hours",
      "accumulation": "cumulative",
      "dtype": "decimal",
      "unit": "hours"
    },
    {
      "key": "engine_hours_can",
      "accumulation": "cumulative",
      "dtype": "decimal",
      "unit": "hours"
    },
    {
      "key": "engine_hours_period",
      "accumulation": "additive",
      "dtype": "decimal",
      "unit": "hours"
    },
    {
      "key": "fuel",
      "accumulation": "instantaneous",
      "dtype": "float",
      "unit": "pct"
    },
    {
      "key": "fuel_period",
      "accumulation": "additive",
      "dtype": "decimal",
      "unit": "litres"
    },
    {
      "key": "odometer",
      "accumulation": "cumulative",
      "dtype": "decimal",
      "unit": "km"
    },
    {
      "key": "odometer_can",
      "accumulation": "cumulative",
      "dtype": "decimal",
      "unit": "km"
    }
  ],
  "x-demiton-provenance": {
    "standards": [
      {
        "code": "GDA2020 / MGA2020",
        "title": "Geocentric Datum of Australia 2020 and Map Grid of Australia 2020 (EPSG:7844 / EPSG:78xx zones)",
        "access": "public_summary",
        "region": "Australia",
        "edition": "GDA2020 = ITRF2014 at epoch 2020.0",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Privacy Act 1988 (Cth)",
        "title": "Privacy Act 1988 - Australian Privacy Principles",
        "access": "full_text_verified",
        "clause": "APP 3",
        "region": "Australia",
        "edition": "APP Guidelines ch 3 v1.2 (2026-05-13)",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Workplace Surveillance Act 2005 (NSW)",
        "title": "Workplace Surveillance Act 2005 (tracking surveillance of employees)",
        "access": "public_summary",
        "clause": "s 10",
        "region": "Australia",
        "edition": "in force (compilation 2025-06-14)",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Regulation (EU) 2016/679 (GDPR)",
        "title": "General Data Protection Regulation (GDPR)",
        "access": "public_summary",
        "region": "European Union",
        "edition": "2016",
        "checked_on": "2026-09-14"
      },
      {
        "code": "ISO 55001",
        "title": "Asset management - Asset management system - Requirements",
        "access": "paywalled_secondary",
        "clause": "7.6",
        "region": "International",
        "edition": "2024 (AS ISO 55001:2024 identical AU adoption)",
        "checked_on": "2026-09-14"
      },
      {
        "code": "ISO/TS 15143-3",
        "title": "Earth-moving machinery and mobile road construction machinery - Worksite data exchange - Telematics data (AEMP 2.0)",
        "access": "paywalled_secondary",
        "region": "International",
        "edition": "2020 (SA TS ISO 15143.3:2021 AU and PD ISO/TS 15143-3:2020 UK identical adoptions)",
        "checked_on": "2026-09-14"
      },
      {
        "code": "WGS 84 (EPSG:4326)",
        "title": "World Geodetic System 1984 datum ensemble (EPSG:6326)",
        "access": "full_text_verified",
        "region": "International",
        "edition": "EPSG Dataset v13.102; record revised 2022-11-29",
        "checked_on": "2026-09-14"
      },
      {
        "code": "49 CFR Part 395 Subpart B",
        "title": "FMCSA - Hours of Service of Drivers - Electronic Logging Devices",
        "access": "full_text_verified",
        "clause": "s 395.26(b)",
        "region": "United States",
        "edition": "current (ELD mandate from 2017-12-18)",
        "checked_on": "2026-09-14"
      }
    ]
  },
  "description": "Engine hours and utilisation for plant and equipment.",
  "x-demiton-contract-url": "https://docs.demiton.io/registers/asset_utilisation/",
  "x-demiton-register-catalog": "https://docs.demiton.io/concepts/register-catalog"
}