2.2 KiB
Runtime tachograph Esper scope processing
This document is kept for compatibility with earlier patches.
The preferred endpoint is now the generic Runtime Event Processing endpoint:
POST /api/eventhub/runtime-processing/event-processing
Use the tachograph profile key:
tachograph-driver-esper-v1
The old endpoint remains available as an adapter:
POST /api/eventhub/runtime-processing/tachograph/esper-processing
It delegates to the same profile infrastructure used by the generic endpoint. See:
docs/runtime-event-processing.md
Vehicle-only evidence is now attached through the same common runtime event-processing profile. The old compatibility endpoint maps:
{
"expandVehicleEvents": true,
"vehicleExpansionPaddingMinutes": 15
}
to the generic profile behavior:
{
"parameters": {
"attachVehicleOnlyEvents": true,
"vehicleEvidencePaddingMinutes": 15
}
}
Attachment is temporal: a vehicle-only event must match a reconstructed driver vehicle-usage interval and occur inside the interval plus configured padding.
Debugging vehicle evidence attachment
Prefer the generic /api/eventhub/runtime-processing/event-processing endpoint with partitioning.includeDebug=true or parameters.includePartitionDebug=true. The compatibility response type has partitionDebugByDriver, but the generic endpoint is the preferred way to enable debug output explicitly. The generic response exposes debug data under partitionResults[*].metadata.partitionDebug.
Support evidence normalization
The tachograph runtime profile is now implemented as a specialization of the generic runtime event-processing framework. Before calling the shared tachograph Esper core, mixed support events are normalized by RuntimeSupportEvidenceNormalizer.
This means that attached vehicle-only evidence from sources such as YellowFox ignition/position events can be consumed by the tachograph profile as support geo evidence when the event contains a position or odometer value. The provider-specific event meaning is preserved in the raw payload, while the Esper-facing event domain is adapted to the common tachograph support evidence contract.