Streaming Maintenance Events Without Losing Business State
Executive summary
The central problem in maintenance event streaming is not a shortage of technology. It is that defects, work orders, part movements, aircraft status, and engineering actions have different ordering, ownership, and correction semantics. A useful design must preserve operational meaning while making the next decision easier to inspect.
This paper proposes a bounded approach: publish domain events from authoritative transitions with stable identity, idempotency, versioning, and reconciliation. The intent is decision support with explicit evidence and accountable authority—not an automated substitute for approved maintenance data, engineering judgment, or licensed action.
Boundary reference architecture
Aircraft-to-cloud telemetry reference architecture
- Technical question
- How does aircraft evidence move into real-time and historical maintenance use without losing custody?
- Design rationale
- Nested operational boundaries and two explicitly styled paths make custody, latency, and consumers visible at once.
- Responsive notes
- Boundaries stack vertically below 760px; paths remain ordered left-to-right.
Aircraft-to-cloud telemetry reference architecture
1. Define the operational decision
Programs often begin by collecting available data or selecting a platform. That reverses the useful order. The team should first identify who must decide, when the decision occurs, which evidence is authoritative, what uncertainty is acceptable, and which action remains under qualified control.
For maintenance event streaming, the dominant constraint is that defects, work orders, part movements, aircraft status, and engineering actions have different ordering, ownership, and correction semantics. The product boundary should therefore be written as a decision contract: inputs, freshness, effectivity, interpretation rules, exclusions, reviewer role, downstream record, and measurable outcome. This contract gives engineering and operations a shared definition of done.
Sequence diagram
Event-driven telemetry sequence
- Technical question
- What happens to a telemetry message on success, validation failure, and retry?
- Design rationale
- Lifelines preserve temporal order while colored exception paths prevent the happy path from hiding operational recovery.
- Responsive notes
- On narrow screens, the sequence becomes horizontally scrollable with a visible affordance.
Event-driven telemetry sequence
2. Preserve evidence before interpretation
Source records should retain identity, event time, ingestion time, configuration context, revision, lineage, and quality state. Normalized concepts are valuable, but they should never overwrite what the source actually reported. Investigators need to reproduce the view that existed when a decision was made.
The recommended design is to publish domain events from authoritative transitions with stable identity, idempotency, versioning, and reconciliation. Derived features, rules, statistical output, retrieved text, and generated synthesis should be distinguishable in storage and in the user interface. That separation supports correction without rewriting history and allows reviewers to challenge an inference while accepting the underlying evidence.
Streaming Maintenance Events Without Losing Business State
Which custody, schema, replay, and consumer controls must be observable?
3. Engineer the authority boundary
Operational software can assemble context, identify patterns, rank attention, and prepare a structured brief. It cannot create maintenance authority. The interface must identify the governing source, effective revision, responsible role, and required disposition. Override and abstention are normal system behaviors.
The most important anti-pattern is treating database changes as self-explanatory events and pushing interpretation onto every consumer. It tends to appear efficient because ambiguity disappears from the screen. In reality the ambiguity has only been hidden from the person accountable for the decision. Controls should make missing context, conflict, and inapplicability prominent enough to change behavior.
4. Implementation, governance, and limitations
A credible first release should define one domain event family with operations and prove replay plus reconciliation before scaling. The team should conduct prospective shadow use, compare product output with actual engineering reconstruction, and record why reviewers accept, modify, or reject the result. Expansion should depend on evidence quality and workflow value rather than demonstration appeal.
Governance belongs in the service itself: access control, source eligibility, versioning, release evidence, monitoring, rollback, retention, and outcome stewardship. Limitations should be published by fleet, configuration, operating regime, source availability, and decision type. When applicability cannot be established, the safe result is a visible abstention.
Measures should connect technical behavior to the decision contract. Useful families include evidence completeness, freshness, unresolved identity, reviewer correction, false escalation, missed significant cases, decision latency, recurrence, and outcome-linkage quality. These measures are meaningful only when segmented by the operational conditions that influence them.
Key takeaways
- Begin with a named decision, accountable role, and evidence contract.
- Preserve recorded facts separately from normalization and inference.
- Design explicitly against treating database changes as self-explanatory events and pushing interpretation onto every consumer.
- Define one domain event family with operations and prove replay plus reconciliation before scaling.