Helpdesk Message Contracts
Authoritative contract inventory
Helpdesk-specific integration contract total: 1.
| Contract | Purpose | Version | Payload owner | Compatibility | Validation |
|---|---|---|---|---|---|
HelpdeskTicketEvent | Carries any of ten ticket lifecycle event names and a ticket snapshot | 1 | Shared contracts project; populated by Helpdesk | Single additive record shape; no event-specific CLR types or upcaster found | Publisher calls TicketLifecycleSnapshot.EnsureComplete; consumer independently validates required Helpdesk fields |
The base IntegrationEvent supplies event ID, type, occurrence time, correlation, causation, tenant/user IDs, source service and schema version. The derived record adds tenant references, ticket identity, classification, requester/assignee, due date, notes, recipient and optional related entity IDs.
TicketLifecycleSnapshot is an internal construction model. Notification Service's private HelpdeskEventPayload is a consumer projection. OutboxMessage is a persistence envelope. None is counted as an additional public Helpdesk message contract.
Compatibility limits
No schema registry, negotiated compatibility policy, alternate schema version, or upcasting implementation was found. Consumers must tolerate optional fields and the current shared shape; evolution governance Requires confirmation.
Source References
microservices/src/contracts/Events/IntegrationEvent.csmicroservices/src/contracts/Events/HelpdeskLifecycleEvents.csmicroservices/src/helpdesk-service/Domain/HelpdeskEntities.csmicroservices/src/notification-service/Application/EventNotificationResolver.cs
Related Articles
Revision Information
Draft source-backed documentation reviewed on 2026-07-20; next quarterly review is 2026-10-20.