Документация TIQQET

Руководство по установке, настройке и использованию системы. Для интеграции с внешними системами — REST API Reference

Установка

TIQQET разворачивается через Docker Compose. Одна команда — и система готова к работе на любом сервере с Docker. Обзор всех возможностей — на странице демонстрации продукта.

Системные требования

  • Docker 20.10+ и Docker Compose v2
  • Минимум: 2 vCPU / 4 GB RAM / 20 GB SSD
  • Рекомендуемо: 4+ vCPU / 8+ GB RAM / NVMe SSD
  • ОС: любая с поддержкой Docker (Ubuntu, CentOS, Debian, macOS, Windows)

Быстрая установка

# Клонируем репозиторий git clone https://github.com/tiqqet/tiqqet.git cd tiqqet # Копируем конфигурацию cp .env.example .env # Запускаем docker compose up -d # Система доступна на http://localhost:3000
Совет: Для production-развёртывания рекомендуем настроить SSL через Nginx reverse proxy — конфигурация включена в Docker Compose.

Состав контейнеров

  • app — Node.js 20 + PM2 (backend + frontend)
  • postgres — PostgreSQL 16 Alpine
  • nginx — Reverse proxy, SSL, статика
  • mailpit — SMTP/IMAP для email-интеграции
  • openldap — Active Directory (опционально)

Настройка

Основные параметры задаются через файл .env и веб-интерфейс администратора.

Переменные окружения

# База данных DATABASE_URL=postgresql://user:password@postgres:5432/tiqqet # JWT JWT_SECRET=your-secret-key # Email (SMTP) SMTP_HOST=mailpit SMTP_PORT=1025 sales@tiqqet.ru # Jira (опционально) JIRA_URL=https://your-jira.atlassian.net sales@tiqqet.ru JIRA_TOKEN=your-api-token

Веб-настройки

После первого запуска войдите как администратор и настройте:

  • Каталог услуг — иерархическая структура с SLA для каждой услуги
  • Команды — группировка операторов для маршрутизации заявок
  • Рабочий календарь — рабочие часы и выходные для расчёта SLA
  • Модули — включение/отключение функциональности (AD, Email, Jira, Оборудование)

Первые шаги

После установки и базовой настройки:

  • Создайте каталог услуг с SLA-параметрами
  • Добавьте операторов и настройте команды
  • Импортируйте пользователей из AD/LDAP или создайте вручную
  • Настройте email-интеграцию для автоматического приёма заявок
  • Установите мобильные приложения и укажите URL сервера

Управление заявками

Заявки проходят через 7 статусов с контролем переходов. Каждое действие записывается в аудит-лог.

  • Новая (не назначена) — создана пользователем, ожидает обработки
  • Новая (назначена) — создана оператором с назначением исполнителя
  • В работе — оператор работает над заявкой
  • Ожидает ответа — запрошена информация у пользователя, SLA приостановлен
  • Отложена — временно приостановлена, SLA приостановлен
  • Выполнена — оператор завершил работу
  • Закрыта — финальный статус

Таблица заявок настраивается: 16 колонок, каждый пользователь выбирает свой набор. Доступны массовые операции и экспорт в Excel.

SLA и контроль сроков

Два типа SLA настраиваются для каждой услуги:

  • SLA реакции — время от создания заявки до первого ответа оператора
  • SLA решения — время от создания до выполнения
  • Учёт рабочих часов по настраиваемому календарю
  • Автоматическая пауза SLA при статусах «Ожидает ответа» и «Отложена»
  • Цветовая индикация: зелёный (в норме), красный (просрочена), серый (пауза)

Управление оборудованием

Каталог оборудования с полным жизненным циклом: в использовании → ремонт → склад → списано.

  • Каталог: название, тип, серийный и инвентарный номер
  • Генерация и печать QR-кодов для инвентаризации
  • Сканирование QR через камеру (Web + Mobile)
  • Привязка оборудования к заявкам и сотрудникам
  • Полная история изменений

База знаний

WYSIWYG-редактор статей с форматированием, категоризация по тегам, привязка статей к заявкам. Доступ для всех ролей — операторы создают, все читают.

Email-интеграция

Автоматическое создание заявок из входящих писем на служебный адрес.

  • Обработка вложений и inline-изображений (CID)
  • Автоматическая привязка ответов к существующим заявкам
  • Возобновление заявки по ссылке из email
  • Оценка качества через email (звёзды-ссылки)
  • HTML-шаблоны с брендированием

Интеграция с Jira

Связь заявок ServiceDesk с задачами Jira. Поддержка Cloud и on-premise (Server/Data Center).

  • Настройка подключения: URL, email, API Token, проект по умолчанию
  • Поиск задач по коду проекта или тексту
  • Автоматическое обновление статуса из Jira API
  • Цветовая индикация: Done (зелёный), In Progress (жёлтый), To Do (серый)
  • Доступно на всех платформах: Web, iOS, Android

Active Directory / LDAP

Импорт и синхронизация пользователей из Active Directory или OpenLDAP.

  • Автосинхронизация: ФИО, email, должность, отдел, телефон
  • Настраиваемый BaseDN и фильтр поиска
  • Маппинг атрибутов AD → полей системы
  • Создание учётных записей с ролью USER по умолчанию

Мониторинг

Стек мониторинга включён в Docker Compose: Prometheus + Grafana + Node Exporter + cAdvisor + PG Exporter.

  • Преднастроенный дашборд из 13 панелей
  • Метрики Node.js, PostgreSQL, Docker, системы
  • Алерты на критичные события

Мобильные приложения

Нативные приложения для iOS (SwiftUI) и Android (Jetpack Compose). Полный список функций →

  • Авторизация с настраиваемым URL сервера
  • Полный функционал: заявки, комментарии, действия оператора
  • QR-сканер оборудования через камеру
  • Статусная timeline — визуализация переходов

Безопасность

  • JWT авторизация с Bearer Token и HTTP-only cookie
  • bcrypt хеширование паролей (rounds 8)
  • Ролевая модель с проверкой на каждом эндпоинте
  • HTTPS с автоматическим редиректом
  • CORS и CSP настройки
  • Rate limiting на критичных эндпоинтах
  • Аудит-лог всех действий с заявками