# Description Of Services

Responsibilities of the services that handle authentication, tickets, assets, automation, communication, reporting and other system functions.

Canonical: https://docs.mintsd.com/docs/mint-service-desk/introduction-description-of-services
Language: en-GB
Revision: 2a2d39f1e31deba465d9905cd685a5a3416966a588eb6151bba19ba5bc3c7cc9

<a id="element-01a18bf4-29c6-72a0-b4da-c48397df11ed"></a>

Mint Service Desk is built around a set of specialised services. Each service performs a specific role within the system architecture, providing essential capabilities that together form a flexible and comprehensive ITSM platform. Detailed descriptions of the services are provided below.

<a id="element-01a18bf4-29c7-7232-bec6-9cc33ca537f1"></a>

## Assets

<a id="element-01a18bf4-29c8-75bd-b801-ffc3d83e6a5b"></a>

A service responsible for managing an organisation’s assets. Its flexible structure supports the storage of different asset types, including devices, software and other IT infrastructure components. Its features include:

<a id="element-01a18bf4-29ca-7b27-aa9c-0da1459a60e3"></a>

- Searching and filtering assets using any criteria.
- Managing asset metadata through dynamic fields.
- Adding assets manually, via an API or by importing CSV files.

<a id="element-01a18bf4-29cb-7cd2-9129-d39aea9d0a97"></a>

## Auth

<a id="element-01a18bf4-29cb-7bb5-a1c7-acce10111628"></a>

A central service for managing user authentication and authorisation. It ensures system security and controls access based on roles and permissions. Key features include:

<a id="element-01a18bf4-29ce-70b1-90b8-71eb492c32db"></a>

- Supporting SSO (Single Sign-On).
- Centrally managing users, roles and permissions.
- Integrating with external authentication systems, such as LDAP and Active Directory.

<a id="element-01a18bf4-29cf-70ae-84ef-18c2869cc9dd"></a>

## Automation

<a id="element-01a18bf4-29cf-7420-a790-9ed71774334c"></a>

A service for configuring and managing automated tasks. It responds to system events and executes predefined actions. Example use cases include:

<a id="element-01a18bf4-29d2-705a-92b7-aaac70abe4c3"></a>

- Automatically assigning tickets when their status changes.
- Sending notifications in response to specified events.
- Supporting complex business scenarios through conditional rules.

<a id="element-01a18bf4-29d3-7761-b1bb-de4c6ae00ba6"></a>

## ContentManager

<a id="element-01a18bf4-29d3-77da-a8bd-c2dadd601056"></a>

A service responsible for modelling and delivering dynamic content. It uses snippets, simple machine learning models and regular expressions to automate processes. Key capabilities include:

<a id="element-01a18bf4-29d7-770f-bc72-c5ff82a41f07"></a>

- Inserting dynamic data into email templates.
- Analysing and extracting data from text using regular expression patterns.
- Populating contextual content throughout the system.

<a id="element-01a18bf4-29d8-7695-b3f2-3aa35c94b85f"></a>

## CustomerPortal

<a id="element-01a18bf4-29da-7529-800e-630621499b2d"></a>

A dedicated customer portal that simplifies ticket handling. It enables users to:

<a id="element-01a18bf4-29de-7bd2-951b-6ed91f4f5828"></a>

- Define predefined ticket forms with automatic assignment to a queue or ticket type.
- Simplify ticket creation through predefined values.
- Customise the interface to meet customer requirements.

<a id="element-01a18bf4-29df-762e-990a-00947773a6c0"></a>

## Dictionaries

<a id="element-01a18bf4-29e0-7f31-b4f6-4981de0ac333"></a>

A service responsible for managing dictionary structures. Dictionaries can be nested and support multiple values. Key use cases include:

<a id="element-01a18bf4-29e3-72c9-80a7-d024b24b5a62"></a>

- Extending services such as Tickets, Assets and Users with additional dictionary data.
- Standardising data throughout the system.
- Updating dictionaries dynamically.

<a id="element-01a18bf4-29e3-70c2-929d-2f58aa83f17c"></a>

## Drafts

<a id="element-01a18bf4-29e4-7b15-b47e-fea6788a8591"></a>

A service that saves data while users are working, allowing it to be recovered if a session is interrupted. Example features include:

<a id="element-01a18bf4-29e6-7ee2-b9eb-840ce589d3e3"></a>

- Storing unsubmitted tickets or reports.
- Automatically saving changes in real time.
- Restoring previous versions of data.

<a id="element-01a18bf4-29e7-7b8b-b9a5-191ea7eb599f"></a>

## DynamicFields

<a id="element-01a18bf4-29e8-7432-8e2a-54d0798db10b"></a>

A library/framework that enables domain services, such as Tickets, Assets and Users, to extend their entities with dynamic fields. Its capabilities include:

<a id="element-01a18bf4-29ea-78dd-abfa-e7259d4345a8"></a>

- Defining custom fields specific to a given data type.
- Supporting data structures that change dynamically.
- Accommodating non-standard business requirements.

<a id="element-01a18bf4-29eb-777d-8cfa-7b1c32f9bf7c"></a>

## EntityExtensions

<a id="element-01a18bf4-29ec-701e-99a8-bd5248c9361c"></a>

A service that stores additional configuration for users (Users) and companies (Companies). It enables users to:

<a id="element-01a18bf4-29ee-7298-b975-8f1dea8ffd2c"></a>

- Extend user profiles with additional fields and attributes.
- Customise the interface according to the user or company type.

<a id="element-01a18bf4-29ef-7f13-ace2-19a6125cc0b8"></a>

## Escalations

<a id="element-01a18bf4-29ef-74c8-ba55-4c48ad746ad7"></a>

A service that manages SLA (Service Level Agreement) definitions and working calendars. It also:

<a id="element-01a18bf4-29f2-76e9-afde-6421107eeacd"></a>

- Calculates SLA deadlines for tickets.
- Performs escalation actions, such as notifying managers.
- Supports different time zones and working schedules.

<a id="element-01a18bf4-29f3-743d-b2dd-71d5160d7693"></a>

## ExternalIntegrations

<a id="element-01a18bf4-29f5-7256-ba0c-c03b58d465f7"></a>

A service that integrates Mint SD with external data sources, such as LDAP, APIs, Kafka and CSV files. Key features include:

<a id="element-01a18bf4-29f9-7716-95f9-09b152702dd1"></a>

- Synchronising users and companies with external databases.
- Importing and exporting data.
- Automating workflows between systems.

<a id="element-01a18bf4-29fa-74ee-9b8e-166c19978d15"></a>

## Gateway

<a id="element-01a18bf4-29fb-7f73-b2d5-dd7528db7e5d"></a>

The central access point for the Mint SD system. This service:

<a id="element-01a18bf4-29fe-718a-9626-f885ac37d963"></a>

- Exposes the system API through Swagger.
- Handles authorisation for all external requests.
- Acts as a security and traffic management layer.

<a id="element-01a18bf4-29ff-7a59-b8e2-cef39ac99931"></a>

## Geo

<a id="element-01a18bf4-29ff-72f6-aded-4602f9b78bd8"></a>

A service providing geolocation and mapping capabilities. Its features include:

<a id="element-01a18bf4-2a02-7926-8660-50260b75df64"></a>

- Providing map tiles and geospatial objects.
- Managing assets on maps.
- Locating tickets within a geographical context.

<a id="element-01a18bf4-2a02-7cd9-a944-7ae20e62a894"></a>

## KnowledgeBase

<a id="element-01a18bf4-2a03-746a-a93d-904f72c48fa9"></a>

A service responsible for managing the system’s knowledge base. Key features include:

<a id="element-01a18bf4-2a05-7ecc-8dfb-78f212ac3cca"></a>

- Providing predefined instructions for common ticket types.
- Analysing ticket content to automatically assign relevant knowledge resources.
- Organising and searching technical documentation.

<a id="element-01a18bf4-2a07-7310-9242-e160764306dc"></a>

## Mailing

<a id="element-01a18bf4-2a08-7300-9d66-4c05e706b563"></a>

A service responsible for retrieving and sending email messages. Its features include:

<a id="element-01a18bf4-2a0a-70b9-aba4-8dd55d0cdff9"></a>

- Integrating with email inboxes and handling attachments.
- Automatically creating tickets from incoming messages.
- Sending email notifications according to the configured settings.

<a id="element-01a18bf4-2a0b-77f8-915e-95333aea1c3c"></a>

## Notifications

<a id="element-01a18bf4-2a0b-7383-b2e3-f5b80120ce10"></a>

A dynamic notification service that allows rules and notification methods to be defined. It supports:

<a id="element-01a18bf4-2a0e-7f60-80ef-d05a2ecf234c"></a>

- System notifications (Mint UI) and email notifications.
- Customising notification content.
- Advanced event-driven notification scenarios.

<a id="element-01a18bf4-2a0f-7ccd-9b51-8d811523a900"></a>

## PdfGenerator

<a id="element-01a18bf4-2a10-7c5d-a09c-a91c9d1c8f4f"></a>

A service responsible for generating PDF documents from system data. Use cases include:

<a id="element-01a18bf4-2a11-7b37-b90a-29a4347d88fe"></a>

- Creating reports and summaries in PDF format.
- Generating documentation for tickets and assets.

<a id="element-01a18bf4-2a12-705d-b92c-ec67c8a980c1"></a>

## Queues

<a id="element-01a18bf4-2a13-751d-8cec-a98d8daab7e5"></a>

A service dedicated to managing ticket queues. It provides:

<a id="element-01a18bf4-2a15-7481-8d06-86f3bb153459"></a>

- Configurable queue parameters, including priorities and assignments.
- Automatic assignment of tickets to the appropriate queues.

<a id="element-01a18bf4-2a16-7ffb-86b3-ccd64ff33775"></a>

## Reports

<a id="element-01a18bf4-2a16-7a51-9044-5bc469d43d7c"></a>

A service for creating and generating reports, primarily in tabular format. Key features include:

<a id="element-01a18bf4-2a18-7801-9c01-d446fd7499a2"></a>

- Grouping, filtering and exporting data to CSV or Excel.
- Extensive options for defining report parameters.

<a id="element-01a18bf4-2a19-7146-9cb5-7c3636683301"></a>

## Repository

<a id="element-01a18bf4-2a19-7100-a37b-56d871436bb1"></a>

A service responsible for storing files and attachments. Its features include:

<a id="element-01a18bf4-2a1b-765d-9613-cc6c7fe57905"></a>

- Secure data storage.
- Making files available within the system.

<a id="element-01a18bf4-2a1c-7bb8-bf7e-550105679174"></a>

## Services

<a id="element-01a18bf4-2a1d-787f-839a-f542e2e4bb51"></a>

A service responsible for managing service and contract definitions. It provides:

<a id="element-01a18bf4-2a1e-727b-acf7-b248b7498f26"></a>

- Configuring the services available in the system.
- Automatically verifying that services comply with contracts.

<a id="element-01a18bf4-2a1e-7bb7-971a-3e1fea4a5973"></a>

## Surveys

<a id="element-01a18bf4-2a1f-724d-8355-e2a1f08a423f"></a>

A service for creating and distributing surveys. It enables users to:

<a id="element-01a18bf4-2a21-7906-a384-c13cdbd97350"></a>

- Configure surveys and collect responses.
- Analyse results to improve service quality.

<a id="element-01a18bf4-2a21-772d-9c97-64d992e0ce76"></a>

## Tickets

<a id="element-01a18bf4-2a22-7d59-81e7-38152516e0b2"></a>

The system’s core service, responsible for handling ticket-related processes. Its features include:

<a id="element-01a18bf4-2a23-778f-a294-5c53310c9699"></a>

- Automating ticket workflows, including creation, updating and closure.
- Using dynamic fields and ticket queues.

<a id="element-01a18bf4-2a24-780e-857b-458e5b1f8df3"></a>

## Translation

<a id="element-01a18bf4-2a25-7811-bff7-81a15d37edd6"></a>

A service responsible for providing multilingual support throughout the system. It allows users to interact with the interface in their preferred language, regardless of the system’s default language. Key features include:

<a id="element-01a18bf4-2a28-7ce7-9d74-bd1831349921"></a>

- Managing text translations throughout the system.
- Supporting multiple languages in the user interface and email communications.
- Allowing system administrators to customise translations.
- Supporting dynamic fields in different languages.

<a id="element-01a18bf4-2a2a-7580-81ed-6085c63118d0"></a>

This service enables Mint Service Desk to be used globally by teams operating in different locations.

<a id="element-01a18bf4-2a2b-76f0-bb0b-2b47924a9706"></a>

## TimeTracker

<a id="element-01a18bf4-2a2c-740b-a38a-a76253b8b72b"></a>

A service dedicated to tracking and reporting the time users spend working on tickets and projects. Its main features include:

<a id="element-01a18bf4-2a2e-7a97-ae03-0a6fe412538a"></a>

- Recording time spent on specific tasks or tickets.
- Generating time reports by user, team or project.
- Integrating with the Tickets module to automatically associate recorded time with SLA processes.
- Configuring different time categories, such as productive time, waiting time and verification time.

<a id="element-01a18bf4-2a2f-7d7d-8dee-1ffda3a641c4"></a>

This service enables organisations to monitor productivity accurately and manage their workforce and time more effectively.

<a id="element-01a18bf4-2a30-7a4d-9549-d6221ec0e92d"></a>

## Users

<a id="element-01a18bf4-2a31-7d7d-9699-c127b8b5cfb6"></a>

A service responsible for managing system users. Its main functions include:

<a id="element-01a18bf4-2a32-7a6d-93c2-281e78670a8f"></a>

- Managing user profiles and their attributes.
- Managing user assignments to tickets.

<a id="element-01a18bf4-2a33-7f34-b2e5-4fac5ff8fc23"></a>

Each Mint Service Desk service specialises in a specific function, but together they form a coherent and efficient tool for IT service management.

