Skip to main content

Helpdesk / Employee Service Desk

Summary​

HR Suit contains a Transitional employee-service-desk implementation. It supports tenant-scoped tickets, categories, priorities, assignments, comments, document-backed attachments, resolution and closure actions, SLA tracking, escalation records, lifecycle notifications, audit/timeline records and four operational report views. The administration page exposes the principal agent actions; the employee page exposes ticket submission and a ticket-history list.

The implementation is not yet a complete service-management product. Requester isolation and the employee submission contract have verified gaps, status changes are not governed by a transition matrix, and workflow orchestration, queues, approvals, knowledge articles, satisfaction measurement and configurable notification administration were not found.

Audience​

Employees, service-desk agents, HR administrators, product owners, implementation partners, QA, support, security reviewers and solution architects.

Overview​

Business Purpose​

Provide a traceable channel for recording employee support needs and managing them from creation through assignment, work, resolution, closure or reopening.

Actors​

  • Employee/requester: submits a request and is the intended audience for ticket progress.
  • Helpdesk agent or HR administrator: reviews tenant tickets, assigns an owner, records internal comments and performs lifecycle actions.
  • Helpdesk administrator: fallback audience for escalations and breached unassigned tickets.
  • Support, product, QA and security: validate configuration, controls, reporting and transitional gaps.

Business Process​

A ticket is created against an existing category and priority, receives a ticket number and due date, may be assigned and commented on, and can be resolved, closed or reopened. Lifecycle operations write audit and timeline evidence and enqueue integration events. Operational views summarize volume, SLA exposure, agent load and category distribution.

Responsibilities​

Employees provide an actionable title and description. Agents maintain ownership and status and protect internal notes. Administrators maintain classifications and SLA policies through supported service capabilities. Product and security owners must resolve the self-service and authorization gaps before treating the module as production-complete.

Business Rules​

Tenant context is mandatory. Category and priority must exist. New tickets open immediately. Resolution-policy matching sets the due date where possible, with a 48-hour fallback when no matching policy exists. See the verified rule catalog.

Integrations​

Verified boundaries include the employee portal and gateway, shared authentication/tenant context, Document Service attachment storage, transactional lifecycle events, Notification Service recipient resolution, and helpdesk-native reports and dashboards. No verified workflow-engine integration exists.

Limitations​

The employee route can expose a tenant-wide ticket list rather than requester-only history, and its creation payload does not match the extracted service identifiers. Direct service endpoints do not declare a helpdesk authorization policy in the service bootstrap. These are material transitional limitations requiring security and integration review.

Requires Confirmation​

Production routing, effective access enforcement at infrastructure boundaries, tenant-specific categories/priorities/SLA policy, escalation operating procedures, notification templates, retention, legal classification and support ownership require confirmation.

Documentation Map​

Source References​

  • microservices/src/helpdesk-service/Domain/HelpdeskEntities.cs
  • microservices/src/helpdesk-service/Api/HelpdeskEndpoints.cs
  • microservices/src/helpdesk-service/Infrastructure/Persistence.cs
  • microservices/src/gateway-api/EssEndpoints.cs
  • UI/salary-ui/apps/client-hrms-portal/src/pages/admin/OperationsAdminPages.tsx
  • UI/salary-ui/apps/client-hrms-portal/src/ess/EssPages.tsx

See Also​

Keywords​

Helpdesk, employee service desk, ticket, agent, requester, SLA, escalation.

Revision Information​

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