Skip to main content

Helpdesk Ticket Attachments

Summary

The service can upload a ticket file to Document Service, retain document/storage metadata and a SHA-256 hash, list and download attachments, and delete the external and local records. The reviewed administration UI only lists and downloads.

Audience

Employees, agents, administrators, product, QA, support and security.

Business Purpose

Associate supporting evidence with a ticket while delegating file content storage to the document capability.

Actors

An authenticated uploader supplies the file; Helpdesk stores its relationship; Document Service stores and retrieves content; agents download through the administration page.

Business Process

The service validates ticket and file, delegates upload, stores identifiers, filename, content type, size, hash and uploader, writes activity records and emits TicketAttachmentAdded. Download and delete call Document Service using the stored document identity.

Responsibilities

Uploaders must submit appropriate content. Administrators must establish file classification and retention. Support must monitor Document Service dependency health.

Business Rules

The file must be nonempty and no larger than 25,000,000 bytes. Document Service availability is required. Stored filenames are limited to 260 characters; storage keys to 700; content type to 120.

Integrations

Document Service is the verified file-storage boundary. Attachment-added events target requester and assignee through Notification Service.

Limitations

No reviewed UI exposes upload or deletion, and employee self-service exposes no attachments. File-extension allowlists, malware scanning, preview, versioning and business retention enforcement were not found in the helpdesk source.

Requires Confirmation

Allowed file types, malware controls, retention, deletion authorization, privacy classification, production size policy and Document Service operational behavior require confirmation.

Source References

  • microservices/src/helpdesk-service/Api/HelpdeskEndpoints.cs
  • microservices/src/helpdesk-service/Infrastructure/DocumentServiceClient.cs
  • microservices/src/helpdesk-service/Domain/HelpdeskEntities.cs
  • UI/salary-ui/apps/client-hrms-portal/src/pages/admin/OperationsAdminPages.tsx

Reference Content

The file validation, document delegation, stored metadata, hash and UI boundary above are the verified attachment reference.

See Also

Keywords

Ticket attachment, document storage, file size, SHA-256, download.

Revision Information

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