@openeld/openeld 0.1.0

package/proto/logistics/asset_location.proto

@@ -0,0 +1,19 @@
+syntax = "proto3";
+
+package openeld.logistics.v1;
+
+import "common/metadata/audit.proto";
+import "common/metadata/source.proto";
+import "common/primitives/location.proto";
+import "google/protobuf/timestamp.proto";
+
+// * Represents a time-stamped asset location and optional linkage to a powered vehicle.
+message AssetLocation {
+  string asset_location_id = 1;
+  string asset_id = 2;
+  google.protobuf.Timestamp timestamp = 3;
+  openeld.common.primitives.v1.GeoPoint position = 4;
+  optional string linked_vehicle_id = 5;
+  optional openeld.common.metadata.v1.SourceRecord source = 20;
+  optional openeld.common.metadata.v1.AuditMetadata audit = 21;
+}

package/proto/logistics/carrier.proto

@@ -0,0 +1,18 @@
+syntax = "proto3";
+
+package openeld.logistics.v1;
+
+import "common/metadata/audit.proto";
+import "common/metadata/source.proto";
+
+// * Represents a motor carrier in the normalized logistics model.
+message Carrier {
+  string carrier_id = 1;
+  string usdot_number = 2;
+  optional string mc_number = 3;
+  string name = 4;
+  optional string main_office_address = 5;
+  string home_terminal_timezone = 6;
+  optional openeld.common.metadata.v1.SourceRecord source = 20;
+  optional openeld.common.metadata.v1.AuditMetadata audit = 21;
+}

package/proto/logistics/data_consent.proto

@@ -0,0 +1,24 @@
+syntax = "proto3";
+
+package openeld.logistics.v1;
+
+import "common/metadata/audit.proto";
+import "common/metadata/source.proto";
+import "google/protobuf/timestamp.proto";
+import "logistics/enums.proto";
+
+// * Represents a carrier-granted consent for a platform to access specific data scopes.
+message DataConsent {
+  string consent_id = 1;
+  string carrier_id = 2;
+  string platform_id = 3;
+  repeated DataAccessScope granted_scopes = 4;
+  google.protobuf.Timestamp granted_at = 5;
+  optional google.protobuf.Timestamp revoked_at = 6;
+  optional google.protobuf.Timestamp expires_at = 7;
+  ConsentStatus status = 8;
+  ConsentMethod consent_method = 9;
+  optional string external_consent_reference = 10;
+  optional openeld.common.metadata.v1.SourceRecord source = 20;
+  optional openeld.common.metadata.v1.AuditMetadata audit = 21;
+}

package/proto/logistics/driver.proto

@@ -0,0 +1,28 @@
+syntax = "proto3";
+
+package openeld.logistics.v1;
+
+import "common/metadata/audit.proto";
+import "common/metadata/source.proto";
+import "google/protobuf/timestamp.proto";
+import "logistics/enums.proto";
+
+// * Represents an individual operating under a carrier.
+message Driver {
+  string driver_id = 1;
+  string carrier_id = 2;
+  string first_name = 3;
+  string last_name = 4;
+  optional string license_number = 5;
+  optional string license_state = 6;
+  bool eld_exempt = 7;
+  HosRuleset hos_ruleset = 8;
+  DriverStatus status = 9;
+  optional string email = 10;
+  optional string phone = 11;
+  optional string username = 12;
+  optional google.protobuf.Timestamp created_at = 13;
+  optional google.protobuf.Timestamp updated_at = 14;
+  optional openeld.common.metadata.v1.SourceRecord source = 20;
+  optional openeld.common.metadata.v1.AuditMetadata audit = 21;
+}

package/proto/logistics/dvir.proto

@@ -0,0 +1,34 @@
+syntax = "proto3";
+
+package openeld.logistics.v1;
+
+import "common/metadata/audit.proto";
+import "common/metadata/source.proto";
+import "google/protobuf/timestamp.proto";
+import "logistics/enums.proto";
+
+// * Represents a DVIR defect or inspection issue.
+message DvirDefect {
+  string defect_id = 1;
+  optional string code = 2;
+  string title = 3;
+  optional string description = 4;
+  bool repaired = 5;
+  bool repaired_verified = 6;
+  optional string mechanic_notes = 7;
+}
+
+// * Represents a normalized driver vehicle inspection report.
+message Dvir {
+  string dvir_id = 1;
+  string driver_id = 2;
+  string vehicle_id = 3;
+  InspectionType inspection_type = 4;
+  google.protobuf.Timestamp inspection_time = 5;
+  bool is_safe_to_drive = 6;
+  repeated DvirDefect defects = 7;
+  optional string signature_driver = 8;
+  optional string mechanic_notes = 9;
+  optional openeld.common.metadata.v1.SourceRecord source = 20;
+  optional openeld.common.metadata.v1.AuditMetadata audit = 21;
+}

package/proto/logistics/enums.proto

@@ -0,0 +1,197 @@
+syntax = "proto3";
+
+package openeld.logistics.v1;
+
+// * Represents the driver's lifecycle state inside the carrier system.
+enum DriverStatus {
+  DRIVER_STATUS_UNSPECIFIED = 0;
+  DRIVER_STATUS_ACTIVE = 1;
+  DRIVER_STATUS_INACTIVE = 2;
+  DRIVER_STATUS_DEACTIVATED = 3;
+}
+
+// * Represents the normalized duty status state.
+enum DutyStatus {
+  DUTY_STATUS_UNSPECIFIED = 0;
+  DUTY_STATUS_OFF_DUTY = 1;
+  DUTY_STATUS_SLEEPER_BERTH = 2;
+  DUTY_STATUS_DRIVING = 3;
+  DUTY_STATUS_ON_DUTY_NOT_DRIVING = 4;
+  DUTY_STATUS_PERSONAL_CONVEYANCE = 5;
+  DUTY_STATUS_YARD_MOVE = 6;
+  DUTY_STATUS_WAIT_TIME = 7;
+}
+
+// * Represents the high-level FMCSA ELD event family.
+enum EventType {
+  EVENT_TYPE_UNSPECIFIED = 0;
+  EVENT_TYPE_DUTY_STATUS_CHANGE = 1;
+  EVENT_TYPE_INTERMEDIATE_LOG = 2;
+  EVENT_TYPE_SPECIAL_DRIVING_CONDITION = 3;
+  EVENT_TYPE_CERTIFICATION = 4;
+  EVENT_TYPE_LOGIN_LOGOUT = 5;
+  EVENT_TYPE_ENGINE_POWER = 6;
+  EVENT_TYPE_MALFUNCTION_OR_DIAGNOSTIC = 7;
+}
+
+// * Represents a normalized sub-code for the event family.
+enum HosEventCode {
+  HOS_EVENT_CODE_UNSPECIFIED = 0;
+  HOS_EVENT_CODE_OFF_DUTY = 1;
+  HOS_EVENT_CODE_SLEEPER_BERTH = 2;
+  HOS_EVENT_CODE_DRIVING = 3;
+  HOS_EVENT_CODE_ON_DUTY_NOT_DRIVING = 4;
+  HOS_EVENT_CODE_PERSONAL_CONVEYANCE = 5;
+  HOS_EVENT_CODE_YARD_MOVE = 6;
+  HOS_EVENT_CODE_WAIT_TIME = 7;
+  HOS_EVENT_CODE_INTERMEDIATE_LOG = 8;
+  HOS_EVENT_CODE_LOGIN = 9;
+  HOS_EVENT_CODE_LOGOUT = 10;
+  HOS_EVENT_CODE_ENGINE_POWER_UP = 11;
+  HOS_EVENT_CODE_ENGINE_SHUTDOWN = 12;
+  HOS_EVENT_CODE_CERTIFICATION = 13;
+  HOS_EVENT_CODE_MALFUNCTION = 14;
+  HOS_EVENT_CODE_DIAGNOSTIC = 15;
+}
+
+// * Represents how a record entered the system.
+enum EventOrigin {
+  EVENT_ORIGIN_UNSPECIFIED = 0;
+  EVENT_ORIGIN_AUTO = 1;
+  EVENT_ORIGIN_DRIVER = 2;
+  EVENT_ORIGIN_OTHER_USER = 3;
+  EVENT_ORIGIN_UNIDENTIFIED = 4;
+}
+
+// * Represents the record lifecycle after edits and review.
+enum RecordStatus {
+  RECORD_STATUS_UNSPECIFIED = 0;
+  RECORD_STATUS_ACTIVE = 1;
+  RECORD_STATUS_INACTIVE_CHANGED = 2;
+  RECORD_STATUS_INACTIVE_CHANGE_REQUESTED = 3;
+  RECORD_STATUS_INACTIVE_CHANGE_REJECTED = 4;
+}
+
+// * Represents the HOS cycle/ruleset applied to the driver.
+enum HosRuleset {
+  HOS_RULESET_UNSPECIFIED = 0;
+  HOS_RULESET_US_70_8 = 1;
+  HOS_RULESET_US_60_7 = 2;
+  HOS_RULESET_US_PASSENGER = 3;
+  HOS_RULESET_US_SHORT_HAUL = 4;
+  HOS_RULESET_CA_SOUTH_70 = 5;
+  HOS_RULESET_CA_SOUTH_120 = 6;
+  HOS_RULESET_CA_NORTH_80 = 7;
+  HOS_RULESET_CA_NORTH_120 = 8;
+}
+
+// * Represents a standardized malfunction or diagnostic code.
+enum MalfunctionCode {
+  MALFUNCTION_CODE_UNSPECIFIED = 0;
+  MALFUNCTION_CODE_POWER = 1;
+  MALFUNCTION_CODE_ENGINE_SYNCHRONIZATION = 2;
+  MALFUNCTION_CODE_TIMING = 3;
+  MALFUNCTION_CODE_POSITIONING = 4;
+  MALFUNCTION_CODE_DATA_RECORDING = 5;
+  MALFUNCTION_CODE_DATA_TRANSFER = 6;
+  MALFUNCTION_CODE_OTHER = 7;
+}
+
+// * Represents the inspection lifecycle stage for a DVIR.
+enum InspectionType {
+  INSPECTION_TYPE_UNSPECIFIED = 0;
+  INSPECTION_TYPE_PRE_TRIP = 1;
+  INSPECTION_TYPE_POST_TRIP = 2;
+  INSPECTION_TYPE_INTERIM = 3;
+}
+
+// * Represents the severity of a compliance or operational violation.
+enum ViolationSeverity {
+  VIOLATION_SEVERITY_UNSPECIFIED = 0;
+  VIOLATION_SEVERITY_INFO = 1;
+  VIOLATION_SEVERITY_WARNING = 2;
+  VIOLATION_SEVERITY_CRITICAL = 3;
+}
+
+// * Represents the lifecycle state of a carrier-granted data consent.
+enum ConsentStatus {
+  CONSENT_STATUS_UNSPECIFIED = 0;
+  CONSENT_STATUS_ACTIVE = 1;
+  CONSENT_STATUS_REVOKED = 2;
+  CONSENT_STATUS_EXPIRED = 3;
+}
+
+// * Represents how a carrier granted access to a platform.
+enum ConsentMethod {
+  CONSENT_METHOD_UNSPECIFIED = 0;
+  CONSENT_METHOD_ELD_OAUTH = 1;
+  CONSENT_METHOD_PORTAL = 2;
+  CONSENT_METHOD_API_KEY = 3;
+  CONSENT_METHOD_WRITTEN_AGREEMENT = 4;
+}
+
+// * Represents the categories of data a platform may access.
+enum DataAccessScope {
+  DATA_ACCESS_SCOPE_UNSPECIFIED = 0;
+  DATA_ACCESS_SCOPE_GPS = 1;
+  DATA_ACCESS_SCOPE_HOS = 2;
+  DATA_ACCESS_SCOPE_DRIVER = 3;
+  DATA_ACCESS_SCOPE_VEHICLE = 4;
+  DATA_ACCESS_SCOPE_SAFETY = 5;
+  DATA_ACCESS_SCOPE_IFTA = 6;
+  DATA_ACCESS_SCOPE_ASSET = 7;
+}
+
+// * Represents the normalized type of telematics safety event.
+enum SafetyEventType {
+  SAFETY_EVENT_TYPE_UNSPECIFIED = 0;
+  SAFETY_EVENT_TYPE_HARD_BRAKE = 1;
+  SAFETY_EVENT_TYPE_HARD_ACCEL = 2;
+  SAFETY_EVENT_TYPE_SPEEDING = 3;
+  SAFETY_EVENT_TYPE_HARD_TURN = 4;
+  SAFETY_EVENT_TYPE_COLLISION = 5;
+  SAFETY_EVENT_TYPE_ROLLOVER = 6;
+  SAFETY_EVENT_TYPE_LANE_DEPARTURE = 7;
+  SAFETY_EVENT_TYPE_FOLLOWING_DISTANCE = 8;
+}
+
+// * Represents the normalized severity of a safety event.
+enum SafetySeverity {
+  SAFETY_SEVERITY_UNSPECIFIED = 0;
+  SAFETY_SEVERITY_LOW = 1;
+  SAFETY_SEVERITY_MEDIUM = 2;
+  SAFETY_SEVERITY_HIGH = 3;
+  SAFETY_SEVERITY_CRITICAL = 4;
+}
+
+// * Represents the type of non-powered or auxiliary asset being tracked.
+enum AssetType {
+  ASSET_TYPE_UNSPECIFIED = 0;
+  ASSET_TYPE_TRAILER = 1;
+  ASSET_TYPE_CONTAINER = 2;
+  ASSET_TYPE_CHASSIS = 3;
+  ASSET_TYPE_DOLLY = 4;
+  ASSET_TYPE_REEFER = 5;
+  ASSET_TYPE_OTHER = 6;
+}
+
+// * Represents the operational status of an asset.
+enum AssetStatus {
+  ASSET_STATUS_UNSPECIFIED = 0;
+  ASSET_STATUS_ACTIVE = 1;
+  ASSET_STATUS_INACTIVE = 2;
+  ASSET_STATUS_IN_MAINTENANCE = 3;
+  ASSET_STATUS_RETIRED = 4;
+}
+
+// * Represents the normalized fuel type used for IFTA reporting.
+enum FuelType {
+  FUEL_TYPE_UNSPECIFIED = 0;
+  FUEL_TYPE_DIESEL = 1;
+  FUEL_TYPE_GASOLINE = 2;
+  FUEL_TYPE_CNG = 3;
+  FUEL_TYPE_LNG = 4;
+  FUEL_TYPE_ELECTRIC = 5;
+  FUEL_TYPE_HYBRID = 6;
+  FUEL_TYPE_OTHER = 7;
+}

package/proto/logistics/gps_location.proto

@@ -0,0 +1,24 @@
+syntax = "proto3";
+
+package openeld.logistics.v1;
+
+import "common/metadata/audit.proto";
+import "common/metadata/source.proto";
+import "common/primitives/location.proto";
+import "common/units/measurements.proto";
+import "google/protobuf/timestamp.proto";
+
+// * Represents a normalized GPS breadcrumb.
+message GpsLocation {
+  string location_id = 1;
+  string vehicle_id = 2;
+  optional string driver_id = 3;
+  google.protobuf.Timestamp timestamp = 4;
+  openeld.common.primitives.v1.GeoPoint position = 5;
+  optional openeld.common.units.v1.Speed speed = 6;
+  optional openeld.common.units.v1.Heading heading = 7;
+  optional openeld.common.units.v1.OdometerReading odometer = 8;
+  optional openeld.common.units.v1.EngineHours engine_hours = 9;
+  optional openeld.common.metadata.v1.SourceRecord source = 20;
+  optional openeld.common.metadata.v1.AuditMetadata audit = 21;
+}

package/proto/logistics/hos_daily_summary.proto

@@ -0,0 +1,38 @@
+syntax = "proto3";
+
+package openeld.logistics.v1;
+
+import "common/metadata/audit.proto";
+import "common/metadata/source.proto";
+import "common/primitives/time.proto";
+import "common/units/measurements.proto";
+import "google/protobuf/duration.proto";
+import "google/protobuf/timestamp.proto";
+import "logistics/enums.proto";
+
+// * Represents a normalized HOS violation entry.
+message HosViolation {
+  string code = 1;
+  optional string title = 2;
+  optional string description = 3;
+  ViolationSeverity severity = 4;
+  optional google.protobuf.Timestamp start_time = 5;
+  optional google.protobuf.Timestamp end_time = 6;
+  optional google.protobuf.Duration duration = 7;
+}
+
+// * Represents a driver's daily HOS summary for a single log date.
+message HosDailySummary {
+  string summary_id = 1;
+  string driver_id = 2;
+  openeld.common.primitives.v1.LocalDate log_date = 3;
+  optional google.protobuf.Duration off_duty_duration = 4;
+  optional google.protobuf.Duration sleeper_berth_duration = 5;
+  optional google.protobuf.Duration driving_duration = 6;
+  optional google.protobuf.Duration on_duty_duration = 7;
+  optional openeld.common.units.v1.Distance distance = 8;
+  bool is_certified = 9;
+  repeated HosViolation violations = 10;
+  optional openeld.common.metadata.v1.SourceRecord source = 20;
+  optional openeld.common.metadata.v1.AuditMetadata audit = 21;
+}

package/proto/logistics/hos_event.proto

@@ -0,0 +1,41 @@
+syntax = "proto3";
+
+package openeld.logistics.v1;
+
+import "common/metadata/audit.proto";
+import "common/metadata/source.proto";
+import "common/primitives/location.proto";
+import "common/units/measurements.proto";
+import "google/protobuf/timestamp.proto";
+import "logistics/enums.proto";
+
+// * Represents a normalized HOS annotation or remark.
+message HosAnnotation {
+  string text = 1;
+  optional string author_driver_id = 2;
+}
+
+// * Represents a normalized HOS event as defined by FMCSA concepts.
+message HosEvent {
+  string event_id = 1;
+  string driver_id = 2;
+  optional string vehicle_id = 3;
+  google.protobuf.Timestamp event_timestamp = 4;
+  optional google.protobuf.Timestamp event_end_time = 5;
+  EventType event_type = 6;
+  HosEventCode event_code = 7;
+  DutyStatus duty_status = 8;
+  optional openeld.common.primitives.v1.GeoPoint position = 9;
+  optional string location_description = 10;
+  optional openeld.common.units.v1.OdometerReading odometer = 11;
+  optional openeld.common.units.v1.EngineHours engine_hours = 12;
+  EventOrigin origin = 13;
+  RecordStatus record_status = 14;
+  optional HosAnnotation annotation = 15;
+  bool certified = 16;
+  optional string edited_by_driver_id = 17;
+  uint32 sequence_number = 18;
+  repeated MalfunctionCode malfunction_codes = 19;
+  optional openeld.common.metadata.v1.SourceRecord source = 20;
+  optional openeld.common.metadata.v1.AuditMetadata audit = 21;
+}

package/proto/logistics/ifta_trip.proto

@@ -0,0 +1,24 @@
+syntax = "proto3";
+
+package openeld.logistics.v1;
+
+import "common/metadata/audit.proto";
+import "common/metadata/source.proto";
+import "common/units/measurements.proto";
+import "google/protobuf/timestamp.proto";
+import "logistics/enums.proto";
+
+// * Represents a normalized IFTA mileage record for a jurisdiction and time range.
+message IftaTrip {
+  string ifta_trip_id = 1;
+  string vehicle_id = 2;
+  optional string driver_id = 3;
+  google.protobuf.Timestamp start_time = 4;
+  google.protobuf.Timestamp end_time = 5;
+  string jurisdiction = 6;
+  openeld.common.units.v1.Distance distance = 7;
+  optional double fuel_consumed_liters = 8;
+  FuelType fuel_type = 9;
+  optional openeld.common.metadata.v1.SourceRecord source = 20;
+  optional openeld.common.metadata.v1.AuditMetadata audit = 21;
+}

package/proto/logistics/safety_event.proto

@@ -0,0 +1,27 @@
+syntax = "proto3";
+
+package openeld.logistics.v1;
+
+import "common/metadata/audit.proto";
+import "common/metadata/source.proto";
+import "common/primitives/location.proto";
+import "common/units/measurements.proto";
+import "google/protobuf/timestamp.proto";
+import "logistics/enums.proto";
+
+// * Represents a normalized telematics safety event.
+message SafetyEvent {
+  string safety_event_id = 1;
+  optional string driver_id = 2;
+  optional string vehicle_id = 3;
+  SafetyEventType event_type = 4;
+  google.protobuf.Timestamp event_time = 5;
+  optional openeld.common.primitives.v1.GeoPoint position = 6;
+  SafetySeverity severity = 7;
+  optional openeld.common.units.v1.Speed speed = 8;
+  optional openeld.common.units.v1.Speed speed_limit = 9;
+  optional double g_force = 10;
+  optional string provider_event_label = 11;
+  optional openeld.common.metadata.v1.SourceRecord source = 20;
+  optional openeld.common.metadata.v1.AuditMetadata audit = 21;
+}

package/proto/logistics/vehicle.proto

@@ -0,0 +1,25 @@
+syntax = "proto3";
+
+package openeld.logistics.v1;
+
+import "common/metadata/audit.proto";
+import "common/metadata/source.proto";
+import "common/units/measurements.proto";
+
+// * Represents a commercial motor vehicle in the normalized model.
+message Vehicle {
+  string vehicle_id = 1;
+  string carrier_id = 2;
+  string vin = 3;
+  string name = 4;
+  optional string license_plate = 5;
+  optional string license_state = 6;
+  optional string make = 7;
+  optional string model = 8;
+  optional int32 year = 9;
+  optional openeld.common.units.v1.OdometerReading odometer = 10;
+  optional openeld.common.units.v1.EngineHours engine_hours = 11;
+  optional string eld_device_id = 12;
+  optional openeld.common.metadata.v1.SourceRecord source = 20;
+  optional openeld.common.metadata.v1.AuditMetadata audit = 21;
+}

package/proto/logistics/vehicle_assignment.proto

@@ -0,0 +1,25 @@
+syntax = "proto3";
+
+package openeld.logistics.v1;
+
+import "common/metadata/audit.proto";
+import "common/metadata/source.proto";
+import "common/primitives/time.proto";
+
+// * Identifies a trailer associated with an assignment.
+message TrailerReference {
+  string name = 1;
+}
+
+// * Associates a driver with a vehicle during a time range.
+message VehicleAssignment {
+  string assignment_id = 1;
+  string driver_id = 2;
+  string vehicle_id = 3;
+  optional string codriver_id = 4;
+  optional openeld.common.primitives.v1.TimeRange assignment_time_range = 5;
+  repeated TrailerReference trailers = 6;
+  optional string shipping_doc_number = 7;
+  optional openeld.common.metadata.v1.SourceRecord source = 20;
+  optional openeld.common.metadata.v1.AuditMetadata audit = 21;
+}

package/proto/providers/eld/geotab/contracts.proto

@@ -0,0 +1,105 @@
+syntax = "proto3";
+
+package openeld.providers.eld.geotab.v1;
+
+import "google/protobuf/timestamp.proto";
+import "providers/eld/shared/common.proto";
+
+// * Represents a Geotab user/driver record close to the native API shape.
+message GeotabUserRecord {
+  string id = 1;
+  optional string first_name = 2;
+  optional string last_name = 3;
+  optional string active_to = 4;
+  optional string employee_no = 5;
+  optional openeld.providers.eld.shared.v1.EldDriverRecord normalized_projection = 20;
+}
+
+// * Represents a Geotab device/vehicle record close to the native API shape.
+message GeotabDeviceRecord {
+  string id = 1;
+  optional string name = 2;
+  optional string vehicle_identification_number = 3;
+  optional double odometer_meters = 4;
+  optional double engine_hours_seconds = 5;
+  optional openeld.providers.eld.shared.v1.EldVehicleRecord normalized_projection = 20;
+}
+
+// * Represents a Geotab DutyStatusLog record.
+message GeotabDutyStatusLogRecord {
+  string id = 1;
+  optional string driver_id = 2;
+  optional string device_id = 3;
+  optional google.protobuf.Timestamp date_time = 4;
+  optional string status = 5;
+  optional string type = 6;
+  optional string origin = 7;
+  optional string record_status = 8;
+  optional double latitude = 9;
+  optional double longitude = 10;
+  optional double odometer_meters = 11;
+  optional double engine_hours_seconds = 12;
+  optional openeld.providers.eld.shared.v1.EldHosEventRecord normalized_projection = 20;
+}
+
+// * Represents a Geotab HOS or regulation clock record.
+message GeotabDriverRegulationRecord {
+  string driver_id = 1;
+  optional string regulation = 2;
+  optional double driving_remaining_seconds = 3;
+  optional double cycle_remaining_seconds = 4;
+  optional double break_remaining_seconds = 5;
+  optional openeld.providers.eld.shared.v1.EldHosClockRecord normalized_projection = 20;
+}
+
+// * Represents a Geotab log record used for GPS or breadcrumb data.
+message GeotabLogRecord {
+  string id = 1;
+  optional string device_id = 2;
+  optional string driver_id = 3;
+  optional google.protobuf.Timestamp date_time = 4;
+  optional double latitude = 5;
+  optional double longitude = 6;
+  optional double speed_kilometers_per_hour = 7;
+  optional double heading_degrees = 8;
+  optional openeld.providers.eld.shared.v1.EldGpsLocationRecord normalized_projection = 20;
+}
+
+// * Represents a Geotab DVIR-like inspection record.
+message GeotabInspectionRecord {
+  string id = 1;
+  optional string driver_id = 2;
+  optional string device_id = 3;
+  optional google.protobuf.Timestamp inspection_time = 4;
+  optional string inspection_type = 5;
+  optional bool safe = 6;
+  repeated string defect_descriptions = 7;
+  optional openeld.providers.eld.shared.v1.EldDvirRecord normalized_projection = 20;
+}
+
+// * Represents a Geotab diagnostic or malfunction record.
+message GeotabDiagnosticRecord {
+  string id = 1;
+  optional string driver_id = 2;
+  optional string device_id = 3;
+  optional google.protobuf.Timestamp detected_at = 4;
+  optional string type = 5;
+  optional string code = 6;
+  optional string description = 7;
+  optional bool active = 8;
+  optional openeld.providers.eld.shared.v1.EldDiagnosticRecord normalized_projection = 20;
+}
+
+// * Groups the stable subset of Geotab records used by the normalization layer.
+message GeotabPayload {
+  optional openeld.providers.eld.shared.v1.EldPayloadMetadata metadata = 1;
+  repeated GeotabUserRecord users = 2;
+  repeated GeotabDeviceRecord devices = 3;
+  repeated openeld.providers.eld.shared.v1.EldVehicleAssignmentRecord vehicle_assignments = 4;
+  repeated GeotabDutyStatusLogRecord duty_status_logs = 5;
+  repeated GeotabDriverRegulationRecord driver_regulations = 6;
+  repeated GeotabLogRecord log_records = 7;
+  repeated GeotabInspectionRecord inspections = 8;
+  repeated GeotabDiagnosticRecord diagnostics = 9;
+  repeated openeld.providers.eld.shared.v1.EldSyncCheckpoint checkpoints = 10;
+}