Skip to main content

Helpdesk Event Architecture

Runtime architecture​

A ticket mutation and its audit, timeline and outbox records share the same Helpdesk DbContext save. The shared outbox processor can publish eligible rows, but Helpdesk does not register a hosted caller for that processor.

Architectural classification​

There is no separate in-process domain-event dispatch layer. The event-producing extension is infrastructure code and writes an integration envelope directly. The outbox prevents the database change and message record from being independently committed, but it does not by itself deliver a message.

Compatibility​

Canonical and compatibility endpoints can feed the same event projection. Their differences are cataloged in compatibility events.

Source References​

  • microservices/src/helpdesk-service/Program.cs
  • microservices/src/helpdesk-service/Api/HelpdeskEndpoints.cs
  • microservices/src/helpdesk-service/Infrastructure/Persistence.cs
  • microservices/src/shared-kernel/Messaging/OutboxProcessor.cs

Revision Information​

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