Skip to main content

Helpdesk Business Source Map

Summary​

This map ties every business area to reviewed repository evidence. It does not claim runtime deployment or configuration.

Audience​

Product owners, QA, support, implementation partners and solution architecture.

Business Purpose​

Make business statements reviewable against concrete backend, gateway, event, notification and frontend sources.

Actors​

Documentation owners maintain traceability; engineering reviewers verify behavior; QA derives tests; product owners distinguish implementation from desired policy.

Business Process​

Business areaPrimary source evidenceDocumentation
Ticket model, status, category, priority, SLAmicroservices/src/helpdesk-service/Domain/HelpdeskEntities.csLifecycle, creation, categories, priorities, rules
Operations and reportsmicroservices/src/helpdesk-service/Api/HelpdeskEndpoints.csAssignment, comments, resolution, reporting
Tenant isolation and storage constraintsmicroservices/src/helpdesk-service/Infrastructure/HelpdeskDbContext.csRules, compliance
Audit, timeline and transactional eventsmicroservices/src/helpdesk-service/Infrastructure/Persistence.csNotifications, compliance
File storage delegationmicroservices/src/helpdesk-service/Infrastructure/DocumentServiceClient.csAttachments, integrations
Shared lifecycle contractmicroservices/src/contracts/Events/HelpdeskLifecycleEvents.csNotifications
Notification audiencesmicroservices/src/notification-service/Application/EventNotificationResolver.csNotifications
Employee forwardingmicroservices/src/gateway-api/EssEndpoints.csCreation, self-service, limitations
Agent administrationUI/salary-ui/apps/client-hrms-portal/src/pages/admin/OperationsAdminPages.tsxAgent workflow, reports
Employee experienceUI/salary-ui/apps/client-hrms-portal/src/ess/EssPages.tsxSelf-service, limitations
Navigation/access presentationUI/salary-ui/apps/client-hrms-portal/src/components/AppLayout.tsx and utils/ProtectedRoute.tsxAgent workflow, self-service

Responsibilities​

Reviewers should validate source changes before approving these Draft pages. Documentation owners should refresh evidence quarterly and when Helpdesk contracts or UI change.

Business Rules​

Source-backed behavior outranks sample data or assumed policy. Development seeding is evidence of examples only. Absence claims are limited to the searched Helpdesk-relevant source set.

Integrations​

The source set verifies Employee/gateway, Authentication/tenant, Notification and Document boundaries and native report/dashboard consumption; it does not verify Organization or Workflow integration.

Limitations​

Static source review cannot confirm production routing, deployed configuration, data quality, service availability, notification delivery or operational procedures.

Requires Confirmation​

Engineering reviewers should confirm endpoint intent; frontend reviewers should confirm supported UX; security should confirm access boundaries; product should confirm policy and accepted gaps.

Source References​

  • microservices/src/helpdesk-service/Domain/HelpdeskEntities.cs
  • microservices/src/helpdesk-service/Application/Common.cs
  • microservices/src/helpdesk-service/Api/HelpdeskEndpoints.cs
  • microservices/src/helpdesk-service/Infrastructure/HelpdeskDbContext.cs
  • microservices/src/helpdesk-service/Infrastructure/Persistence.cs
  • microservices/src/helpdesk-service/Infrastructure/DocumentServiceClient.cs
  • microservices/src/contracts/Events/HelpdeskLifecycleEvents.cs
  • microservices/src/gateway-api/EssEndpoints.cs
  • microservices/src/notification-service/Application/EventNotificationResolver.cs
  • UI/salary-ui/apps/client-hrms-portal/src/pages/admin/OperationsAdminPages.tsx
  • UI/salary-ui/apps/client-hrms-portal/src/ess/EssPages.tsx

Reference Content​

The evidence table and complete source list above form the verified business source map.

See Also​

Keywords​

Helpdesk source map, traceability, repository evidence, static source review.

Revision Information​

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