Skip to main content

Helpdesk Events & Integration Contracts

Summary

Helpdesk persists ten named ticket-lifecycle integration events through one versioned shared contract. Event rows are written to the Helpdesk transactional outbox with the ticket change, audit record and timeline entry. Notification Service implements a consumer for all ten event types.

The runtime is Transitional: Helpdesk registers an outbox store and the shared processor, but no hosted relay or processor invocation is registered in the Helpdesk service. End-to-end automatic broker delivery is therefore Not implemented in the verified Helpdesk runtime. No Helpdesk-owned domain-event classes were found.

Authoritative totals

ArtifactVerified totalMaturity
Helpdesk domain events0Not implemented
Named lifecycle integration events10Partial
Shared Helpdesk integration contract types1Foundation
Helpdesk broker consumers0Not implemented
Notification consumers covering Helpdesk events1Partial
Helpdesk hosted outbox relays0Not implemented

Documentation map

Start with the event overview and architecture. Catalogs cover domain events, integration events, publishers, consumers, and message contracts. Integration pages cover notifications, documents, gateway interaction, and compatibility.

Delivery behavior is documented in outbox, delivery guarantees, ordering, correlation, idempotency, and retries and failures. Finish with timeline versus events, testing, limitations, and the source map.

Scope

This section describes static implementation evidence. It does not assert that a broker, consumer deployment, templates, or operational relay is enabled in any environment.

Source References

  • microservices/src/helpdesk-service/Program.cs
  • microservices/src/helpdesk-service/Infrastructure/Persistence.cs
  • microservices/src/contracts/Events/HelpdeskLifecycleEvents.cs
  • microservices/src/notification-service/Messaging/NotificationEventConsumer.cs

Revision Information

Draft source-backed documentation reviewed on 2026-07-20; next quarterly review is 2026-10-20.