Skip to main content

Helpdesk Technical Documentation

Audience​

Developers, QA engineers, support engineers, DevOps engineers, security engineers, solution architects and implementation partners.

Overview​

This section describes the verified extracted Helpdesk Service and its frontend, gateway, notification and document boundaries. It intentionally excludes endpoint-by-endpoint API contracts, database schema reference and production deployment instructions.

Summary​

Helpdesk is a Transitional .NET 8 Minimal API service. It references the shared kernel and event-contract projects, persists canonical ticket aggregates and operational records through EF Core, and keeps application orchestration inside endpoint handlers and infrastructure helpers. A legacy-shaped compatibility surface and gateway routing switch coexist with the canonical service surface.

Technical scope​

  • Canonical ticket, category, priority, assignment, comment, attachment, SLA, escalation, audit and timeline models.
  • Direct DbContext command/query handlers rather than a separate CQRS or repository layer.
  • Transactional lifecycle-event outbox and Notification Service resolution.
  • Document Service upload/download delegation with a development-only fallback.
  • Gateway employee-service and compatibility routing.
  • Tenant context, global query filters, diagnostics and verified security gaps.

Documentation map​

Start with architecture, runtime composition, project structure, layer dependencies and the domain model. Continue through the ticket, assignment and attachment models.

Integration pages cover notifications, documents and dashboards. Application and platform references cover application behavior, commands, queries, validation, repositories, persistence, security, tenant isolation, observability, compatibility, testing, limitations and the source map.

Requires confirmation​

Production service exposure, gateway ownership, authentication enforcement, event processing, document dependency configuration and compatibility retirement require confirmation.

Source References​

  • microservices/src/helpdesk-service/Program.cs
  • microservices/src/helpdesk-service/helpdesk-service.csproj
  • microservices/src/helpdesk-service/Domain/HelpdeskEntities.cs
  • microservices/src/helpdesk-service/Api/HelpdeskEndpoints.cs
  • microservices/src/helpdesk-service/Infrastructure/HelpdeskDbContext.cs

See Also​

Keywords​

Helpdesk architecture, Minimal API, EF Core, outbox, tenant isolation, compatibility.

Revision Information​

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