61 lines
2.2 KiB
Markdown
61 lines
2.2 KiB
Markdown
# 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:
|
|
|
|
```http
|
|
POST /api/eventhub/runtime-processing/event-processing
|
|
```
|
|
|
|
Use the tachograph profile key:
|
|
|
|
```text
|
|
tachograph-driver-esper-v1
|
|
```
|
|
|
|
The old endpoint remains available as an adapter:
|
|
|
|
```http
|
|
POST /api/eventhub/runtime-processing/tachograph/esper-processing
|
|
```
|
|
|
|
It delegates to the same profile infrastructure used by the generic endpoint. See:
|
|
|
|
```text
|
|
docs/runtime-event-processing.md
|
|
```
|
|
|
|
Vehicle-only evidence is now attached through the same common runtime event-processing profile. The old compatibility endpoint maps:
|
|
|
|
```json
|
|
{
|
|
"expandVehicleEvents": true,
|
|
"vehicleExpansionPaddingMinutes": 15
|
|
}
|
|
```
|
|
|
|
to the generic profile behavior:
|
|
|
|
```json
|
|
{
|
|
"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.
|