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

1. Установка системы

1

Подготовка файлов

Загрузите все файлы системы на хостинг, сохранив структуру папок. Настройте веб-сервер на директорию public/.

2

Запуск установщика

Откройте в браузере: your-domain.com/install.php. Если система уже установлена, произойдет автоматический редирект.

3

Заполнение данных

Введите данные администратора:

Email администратора - для входа в систему
Пароль - минимум 6 символов
Имя администратора - отображаемое имя

4

Завершение установки

Нажмите "Установить систему". При успешной установке произойдет редирект на страницу входа.

Примечание: После установки рекомендуется удалить файл install.php для безопасности.

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

Компонент	Требования
PHP	8.2 или выше
Расширения PHP	PDO, SQLite3, OpenSSL, MBString, IMAP
Веб-сервер	Apache, Nginx или другой с поддержкой PHP
Память	Минимум 128MB RAM
Дисковое пространство	Зависит от объема вложений и тикетов

Проверка окружения: Откройте your-domain.com/requirements.php для автоматической проверки всех требований.

3. Работа со списком заявок

Фильтрация заявок по статусам

Система предоставляет несколько способов фильтрации:

На компьютере: Используйте кнопки статусов в верхней части страницы

На мобильном устройстве: Используйте выпадающий список для выбора статуса

Элементы заявки в списке

Номер заявки (#ID)
Тема заявки (кликабельная ссылка)
Email клиента или Telegram имя
Количество сообщений в заявке
Дата и время создания
Статус (визуально выделен цветом)
Кнопка удаления заявки

Создание новой заявки

Нажмите кнопку "Создать заявку" (на компьютере) или "+" (на мобильном).

4. Просмотр и работа с заявкой

Шапка заявки

В верхней части отображается:

Статус заявки с цветовой индикацией
Номер и тема заявки
Информация о клиенте (email или Telegram)
Дата создания заявки

Сообщения в заявке

Визуальное разделение:

Сообщения клиента - выделены специальным стилем
Сообщения агентов - стандартное оформление
Внутренние сообщения - полупрозрачный фон

Действия с сообщениями

Удаление внутренних сообщений: Рядом с внутренними сообщениями есть кнопка удаления (❌). Обычные сообщения удалить нельзя.

Просмотр вложений: Все прикрепленные файлы отображаются под сообщением со значком скрепки.

5. Ответ на заявку

Форма ответа

В нижней части страницы заявки находится форма для ответа:

Поле	Описание
Текст сообщения	Обязательное поле для ввода ответа
Прикрепление файлов	Можно выбрать несколько файлов
Внутреннее сообщение	Чекбокс для создания сообщения, видимого только администраторам

Типы ответов

Обычный ответ - виден клиенту
Внутреннее сообщение - видно только администраторам (можно удалить)

6. Статусы заявок и их значение

Статус	Цвет	Описание
Новые	Синий	Только что созданные заявки, требующие первичной обработки
В работе	Оранжевый	Заявки, по которым ведется активная работа
Решенные	Зеленый	Проблемы решены, ожидают подтверждения клиента
Закрытые	Красный	Окончательно завершенные заявки

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

Для открытых заявок:

✅ Отметить решенным - переводит в статус "Решена"
🏁 Закрыть заявку - переводит в статус "Закрыта"

Для закрытых/решенных заявок:

Открыть заявку - возвращает в активную работу

7. Управление пользователями

Список пользователей

Интерфейс отображает карточки пользователей с информацией:

Имя пользователя (цвет указывает на активность)
ID пользователя
Email
Статус активности (Активен/Выключен)
Кнопки управления (редактирование, удаление)

Добавление пользователя

1

Нажмите кнопку "Добавить пользователя"

2

Заполните обязательные поля:

Email (проверяется на валидность и уникальность)
Пароль (минимум 6 символов)
Имя (не может быть пустым)

3

Установите статус активности

4

Сохраните пользователя

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

Процесс привязки:

В редактировании своего профиля генерируется код
Код действует 10 минут
Используйте код в боте Telegram для привязки
Отвязать Telegram можно через интерфейс

8. Настройки системы

Основные настройки

Тема интерфейса - светлая или темная
Email отправителя - адрес для исходящих писем
Имя отправителя - отображаемое имя в письмах

Настройки Telegram

1

Создайте бота через @BotFather в Telegram

2

Получите токен бота

3

Вставьте токен в соответствующее поле

4

Сохраните настройки

Уведомления

Типы уведомлений:

Уведомления о новых заявках - при создании тикетов
Уведомления об ответах клиентов - при новых сообщениях

Автоответчик

Функционал автоматического ответа на новые заявки с настраиваемым текстом приветствия.

Обработка почты

Фильтрация автоподписей из писем клиентов с поддержкой регулярных выражений.

Настройки транспорта (Email)

Способы отправки:

SMTP - рекомендуемый способ
Sendmail - системный sendmail
PHP mail() - встроенная функция PHP

9. Резервное копирование

Настройка

В этом разделе можно изменить количество хранимых копий и интервал их автоматического создания.

10. Планировщик задач

CRON

Чтобы автоматизировать прием писем по IMAP и создание резервного копирования необходимо произвести настройку планировщика задач (cron) на вашем хостинге или сервере.

Настройка CRON задач

                # Проверка задач каждую минуту

                * * * * * php /path/to/app/cron/master.php

11. Устранение неисправностей

Распространенные проблемы

Ошибка создания базы данных

Проверьте права на запись в директорию app/storage/. Убедитесь, что расширение PDO-SQLite включено.

Ошибка создания директорий

Создайте вручную директорию app/storage/ с правами 755 и поддиректории: attachments, logs, backups.

Редирект на главную страницу

Если установщик сразу перенаправляет на главную - система уже установлена. Удалите файл app/storage/database.db для переустановки.