Skip to main content

Helpdesk Architecture Overview

Audience​

Developers, architects, QA, security and support engineers.

Summary​

The extracted capability is one executable service with API, Application, Domain, Infrastructure and Backfill folders. Minimal API handlers directly coordinate EF Core and infrastructure clients; no independent application-service or repository assembly exists.

Reference Content​

Boundaries​

The executable owns helpdesk records and report projections. Shared Kernel supplies tenant base types, messaging/outbox and observability extensions. Contracts supplies lifecycle-event types. Gateway, Notification Service and Document Service are separate runtime boundaries.

Maturity​

The architecture is Transitional because canonical and compatibility routes coexist, endpoint handlers contain most orchestration, and direct service authentication/authorization is not configured in the reviewed bootstrap.

Requires confirmation​

Production topology, network controls, service ownership, event dispatcher hosting and the target post-compatibility architecture require confirmation.

Source References​

  • microservices/src/helpdesk-service/Program.cs
  • microservices/src/helpdesk-service/helpdesk-service.csproj
  • microservices/src/helpdesk-service/Api/HelpdeskEndpoints.cs
  • microservices/src/helpdesk-service/Infrastructure/HelpdeskDbContext.cs
  • microservices/src/gateway-api/Program.cs

See Also​

Keywords​

Helpdesk architecture, Minimal API, service boundary, EF Core, outbox.

Revision Information​

  • Status: Draft
  • Last reviewed: 2026-07-20
  • Next review: 2026-10-20