> For the complete documentation index, see [llms.txt](https://docs.iexexchanger.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iexexchanger.com/help-center/ai-base/bezopasnost-i-processy/admin-utilities-reference.md).

# Служебные инструменты админки

Этот раздел нужен GitBook AI, чтобы отвечать на вопросы по функциям, которые не всегда видны как отдельный пункт меню, но активно используются администраторами: глобальный поиск, файловый менеджер, уведомления в шапке, центр обновлений в реальном времени, количество строк в таблицах, сортировка, статус оператора и системные уведомления на сайте.

## Для чего нужен раздел

Служебные инструменты помогают быстро находить данные, работать с файлами, управлять видимостью уведомлений, менять рабочий режим оператора и делать админку удобнее для ежедневной поддержки.

Если клиент спрашивает “где найти заявку”, “почему таблица показывает мало строк”, “куда загрузить картинку”, “почему оператор оффлайн”, “почему не видно уведомление”, GitBook AI должен смотреть именно этот раздел.

## Когда использовать

| Ситуация                                                           | Что открыть                        | Что проверить                                         |
| ------------------------------------------------------------------ | ---------------------------------- | ----------------------------------------------------- |
| Не получается найти заявку, пользователя или направление           | Глобальный поиск в верхней панели  | Строку поиска, выбранную область, историю поиска      |
| Нужно загрузить картинку для страницы, новости, баннера или валюты | Файловый менеджер                  | Контекст папки, тип файла, размер, статус обработки   |
| Таблица слишком короткая или слишком длинная                       | Настройка количества строк таблицы | `page_name`, `per_page`, сохраненное значение         |
| Оператор временно не принимает ручные обмены                       | Статус оператора в верхней панели  | Онлайн/оффлайн, WorkStatus, настройки экспорта курсов |
| В шапке админки висят непрочитанные события                        | Уведомления в реальном времени     | Прочитано ли событие, кто прочитал, дата просмотра    |
| Нужно показать клиентам плашку на сайте                            | Tools — Notifications              | Текст, ссылка, цвета, расписание, статус              |
| Элементы в списке должны идти в нужном порядке                     | Drag-and-drop сортировка           | Порядок, сохранение сортировки, права доступа         |

## Основные возможности

| Возможность                   | Что означает простыми словами                              | Когда использовать                                            |
| ----------------------------- | ---------------------------------------------------------- | ------------------------------------------------------------- |
| Глобальный поиск              | Поиск по админке из шапки                                  | Когда неизвестно, где находится объект                        |
| Быстрые префиксы поиска       | Поиск только по типу данных                                | Когда нужно сузить выдачу до заявок, валют или пользователей  |
| История поиска                | Последние запросы администратора                           | Чтобы повторить частый поиск                                  |
| Медиа-менеджер                | Единое хранилище картинок, документов и файлов             | Для контента, баннеров, FAQ, новостей, валют, направлений     |
| Контекстная папка             | Папка, связанная с разделом или записью                    | Чтобы файлы не лежали в одной общей куче                      |
| Корзина медиа                 | Временно удаленные файлы и папки                           | Когда файл удалили случайно                                   |
| Диагностика медиа             | Проверка размера, ошибок обработки и потерянных файлов     | Когда изображения не открываются или хранилище раздувается    |
| Realtime-уведомления          | События, которые приходят в админку без ручного обновления | Новые заявки, сообщения, системные события                    |
| Отметить прочитанным          | Скрыть событие из непрочитанных                            | После обработки уведомления                                   |
| Статус оператора              | Работает ли обменник для ручных операций                   | Когда оператор уходит на перерыв или возвращается             |
| Быстрая настройка автовыплаты | Быстрое включение или выключение автоматических выплат     | Когда нужно управлять автоматическими выплатами по регламенту |
| Количество строк таблицы      | Сколько записей показывать на странице                     | Для операторов, которые работают с большими списками          |
| Сортировка по умолчанию       | Сохранение порядка строк после перетаскивания              | Для меню, уведомлений, баннеров, списков                      |

## Глобальный поиск

### Для чего нужен

Глобальный поиск помогает найти объекты в админке без ручного перехода по меню. Он ищет по разделам, заявкам, пользователям, валютам, направлениям, мерчантам, курсам и BestChange.

### Поля и настройки

| Поле / настройка               | Что означает                              | Как правильно заполнять                                                                                         | Важно знать                                                            |
| ------------------------------ | ----------------------------------------- | --------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
| Строка поиска                  | Что администратор ищет                    | Введите минимум 2 символа                                                                                       | Если меньше 2 символов, поиск не запускается                           |
| Область поиска                 | Где искать                                | Выберите “Все”, “Разделы”, “Заявки”, “Пользователи”, “Валюты”, “Направления”, “Мерчанты”, “Курсы”, “BestChange” | Чем точнее область, тем меньше лишних результатов                      |
| Префикс `u:`                   | Поиск по пользователям                    | Например `u: ivan` или `u: client@example`                                                                      | Подходит для имени, email, телефона                                    |
| Префикс `o:`                   | Поиск по заявкам                          | Например `o: 12345`                                                                                             | Ищет ID, email или телефон, связанный с заявкой                        |
| Префикс `d:`                   | Поиск по направлениям                     | Например `d: BTC - USDT`                                                                                        | Используйте формат пары через дефис                                    |
| Префикс `m:`                   | Поиск по мерчантам                        | Введите название или alias мерчанта                                                                             | Помогает найти платежную интеграцию                                    |
| Префикс `bc:`                  | Поиск по BestChange                       | Введите пару или источник                                                                                       | Полезно при диагностике парсера BestChange                             |
| Префикс `c:`                   | Поиск по валютам                          | Введите код, XML-код или сеть                                                                                   | Например BTC, USDT, TRC20                                              |
| Лимит выдачи                   | Сколько результатов вернет поиск          | Обычно используется 30                                                                                          | Если результата нет, уточните запрос                                   |
| История поиска                 | Последние запросы текущего администратора | Нажмите на старый запрос, чтобы повторить                                                                       | История персональная для администратора                                |
| Удалить запрос из истории      | Убрать один старый запрос                 | Используйте, если запрос больше не нужен                                                                        | Не удаляет найденный объект                                            |
| Очистить историю               | Убрать всю историю поиска администратора  | Используйте при необходимости                                                                                   | Не влияет на других администраторов                                    |
| Facets / категории результатов | Количество найденного по типам            | Используйте для понимания, где совпадений больше                                                                | Если больше всего “Разделы”, возможно вы ищете пункт меню, а не объект |

### Как использовать

1. Нажмите поле поиска в верхней панели или используйте горячую клавишу поиска, если она доступна в интерфейсе.
2. Введите минимум 2 символа.
3. Если знаете тип объекта, выберите область или используйте префикс.
4. Смотрите сначала точные совпадения, затем результаты по меню.
5. Если результатов много, добавьте ID, код валюты, email, телефон или часть пары.
6. Нажмите на результат, чтобы перейти в нужный раздел.

### Типовые ошибки

| Ошибка / ситуация             | Причина                                                | Что сделать                                                                      |
| ----------------------------- | ------------------------------------------------------ | -------------------------------------------------------------------------------- |
| “Ничего не найдено”           | Слишком короткий или общий запрос                      | Ввести ID, email, код валюты или пару                                            |
| Поиск не запускается          | Введен 1 символ                                        | Ввести минимум 2 символа                                                         |
| Результаты не по тому разделу | Выбрана область “Все”                                  | Выбрать “Заявки”, “Пользователи”, “Валюты” или другой фильтр                     |
| История мешает                | Старые запросы больше не актуальны                     | Удалить один запрос или очистить историю                                         |
| Нужная заявка не находится    | Ищут внутренний комментарий, а не ID/клиентские данные | Искать по ID заявки, tracking ID, email, телефону или реквизиту в разделе заявок |

## Файловый менеджер

### Для чего нужен

Файловый менеджер — это раздел админки для выбора и загрузки изображений, документов, архивов и видео для страниц, новостей, FAQ, валют, направлений, платежных систем, баннеров и документов.

### Контексты медиа

| Контекст          | Что означает                  | Когда использовать                            |
| ----------------- | ----------------------------- | --------------------------------------------- |
| `uploads`         | Общие загрузки                | Временные или универсальные файлы             |
| `editor`          | Файлы из текстового редактора | Изображения внутри описаний, FAQ и новостей   |
| `pages`           | Страницы сайта                | Картинки для статических страниц              |
| `news`            | Новости                       | Обложки и изображения новостей                |
| `faq`             | FAQ                           | Изображения в ответах                         |
| `currencies`      | Валюты                        | Иконки, QR, документы по валюте               |
| `directions`      | Направления                   | Файлы и изображения, связанные с парой обмена |
| `payment_systems` | Платежные системы             | Логотипы платежек                             |
| `banners`         | Баннеры                       | Изображения рекламных блоков                  |
| `documents`       | Документы                     | Файлы для правил, инструкций, подтверждений   |

### Поля и настройки

| Поле / настройка        | Что означает                      | Как правильно заполнять                                      | Важно знать                                                     |
| ----------------------- | --------------------------------- | ------------------------------------------------------------ | --------------------------------------------------------------- |
| Режим `manager`         | Обычное управление файлами        | Используйте для просмотра, перемещения и удаления            | Подходит для администраторов                                    |
| Режим `picker`          | Выбор файла для поля формы        | Откройте из формы, где нужен файл                            | После выбора файл вставляется в форму                           |
| Разрешенные типы файлов | Разрешенные типы файлов           | Выберите изображения, видео, документы, архивы или любой тип | Лучше ограничивать тип под задачу                               |
| Множественный выбор     | Можно ли выбрать несколько файлов | Да — для галереи, Нет — для логотипа или иконки              | Неверный режим мешает сохранить форму                           |
| Текущая папка           | Текущая папка                     | Открывайте нужную папку перед загрузкой                      | Помогает не потерять файл                                       |
| Поиск                   | Поиск по файлам                   | Введите часть имени файла                                    | Не ищет по содержимому документа                                |
| Название новой папки    | Название новой папки              | Пишите коротко и понятно                                     | Не используйте секретные названия                               |
| Имя файла               | Имя файла                         | Используйте понятное имя без лишних символов                 | Лучше латиница, цифры и дефис                                   |
| Исходное имя файла      | Исходное имя файла                | Проверяйте, если файл был загружен клиентом или сотрудником  | Может отличаться от сохраненного имени                          |
| Расширение файла        | Расширение файла                  | Проверяйте перед загрузкой                                   | Исполняемые и опасные форматы не должны использоваться          |
| Тип файла               | Тип файла                         | Обычно заполняется автоматически                             | Если тип странный, файл лучше не использовать                   |
| Размер файла            | Размер файла                      | Оптимизируйте тяжелые изображения                            | Большие файлы замедляют сайт                                    |
| Размер изображения      | Размер изображения                | Используйте подходящий размер под место на сайте             | Слишком большое изображение ухудшает скорость                   |
| Альтернативный текст    | Альтернативный текст изображения  | Коротко опишите изображение                                  | Полезно для доступности и SEO                                   |
| Название файла          | Название файла                    | Пишите понятно для админов                                   | Не должно содержать приватные данные                            |
| Состояние обработки     | Состояние обработки               | Готово или ошибка                                            | При ошибке проверьте формат и размер                            |
| Ошибка обработки        | Ошибка обработки                  | Читать как причину проблемы                                  | Не копируйте внутренние пути в публичные ответы                 |
| Версии изображения      | Созданные версии изображения      | Используйте для разных размеров                              | Не удаляйте оригинал без проверки                               |
| Корзина                 | Корзина                           | Используйте для восстановления                               | Удаленные файлы могут иметь срок хранения                       |
| Срок хранения в корзине | Когда файл исчезнет из корзины    | Восстановите до этой даты                                    | После удаления из корзины восстановление может быть невозможным |

### Диагностика хранилища

| Показатель           | Что означает               | Когда смотреть                                   |
| -------------------- | -------------------------- | ------------------------------------------------ |
| Всего файлов         | Общее количество файлов    | При аудите хранилища                             |
| Всего папок          | Количество папок           | Если структура стала хаотичной                   |
| Общий размер         | Общий размер               | Когда серверное место заканчивается              |
| Размер оригиналов    | Размер оригиналов          | Если изображения занимают много места            |
| Размер копий         | Размер созданных копий     | Если много адаптивных версий                     |
| Размер корзины       | Размер корзины             | Если удаленные файлы всё еще занимают место      |
| Потерянные оригиналы | Потерянные оригиналы       | Если файл отображается в базе, но не открывается |
| Файлы без связи      | Файлы без связи            | При уборке старых загрузок                       |
| Ошибки обработки     | Ошибки обработки           | Если превью не создаются                         |
| Ожидают обработки    | Файлы в ожидании обработки | Если очередь обработки не работает               |
| Большие файлы        | Слишком большие файлы      | Для оптимизации скорости сайта                   |
| Возможная экономия   | Возможная экономия места   | Перед чисткой хранилища                          |

### Как загрузить файл

1. Откройте форму, где нужен файл, или сам файловый менеджер.
2. Проверьте контекст папки: страница, новость, FAQ, валюта, направление, баннер или документ.
3. Убедитесь, что разрешенный тип файла подходит под задачу.
4. Загрузите файл.
5. Дождитесь завершения обработки.
6. Если это изображение, проверьте размер и внешний вид.
7. Вставьте файл в нужное поле формы.
8. Сохраните форму, из которой открыт менеджер.

### Типовые ошибки

| Ошибка / ситуация                 | Причина                                    | Что сделать                                       |
| --------------------------------- | ------------------------------------------ | ------------------------------------------------- |
| Файл не загружается               | Неверный тип или слишком большой размер    | Сжать файл или выбрать разрешенный формат         |
| Изображение не отображается       | Обработка не завершена или ошибка `failed` | Проверить статус обработки, загрузить файл заново |
| Файл потеряли                     | Загрузили не в тот контекст                | Найти через поиск или открыть общую папку         |
| Удалили нужный файл               | Файл попал в корзину                       | Открыть Trash и восстановить                      |
| Вставили слишком тяжелую картинку | Не оптимизировали изображение              | Сжать и загрузить новую версию                    |
| Картинка не подходит по размеру   | Неверная ширина/высота                     | Использовать crop или подготовить корректный файл |

## Системные уведомления на сайте

### Для чего нужны

Tools — Notifications управляет плашками или сообщениями, которые показываются пользователям на сайте. Это не email и не Telegram. Это видимое уведомление в интерфейсе.

### Поля и настройки

| Поле / настройка          | Что означает                     | Как правильно заполнять                        | Важно знать                                            |
| ------------------------- | -------------------------------- | ---------------------------------------------- | ------------------------------------------------------ |
| Статус                    | Показывать уведомление или нет   | Включайте только готовое уведомление           | Выключенное уведомление не видно клиентам              |
| Текст                     | Текст уведомления по языкам      | Заполните основной язык обязательно            | Пишите коротко, без внутренних терминов                |
| Ссылка                    | Ссылка по клику                  | Укажите публичную страницу или оставьте пусто  | Не добавляйте приватные URL                            |
| Открывать в новой вкладке | Открывать ссылку в новой вкладке | Да — для внешних страниц, Нет — для внутренних | Для важных правил можно открыть в этой же вкладке      |
| Цвет фона                 | Цвет фона уведомления            | Используйте контрастный, но спокойный цвет     | Слишком яркий цвет ухудшает доверие                    |
| Цвет текста               | Цвет текста                      | Должен читаться на фоне                        | Проверьте мобильный вид                                |
| Размер текста             | Размер текста                    | Оставьте стандартный, если нет причины менять  | Слишком большой текст ломает плашку                    |
| Иконка                    | Иконка уведомления               | PNG, JPG, JPEG, WEBP, SVG или ICO до 4 МБ      | Не загружайте тяжелые изображения                      |
| Показ по расписанию       | Показывать по расписанию         | Да — если уведомление временное                | Без расписания работает по статусу                     |
| Время начала              | Время начала показа              | Укажите часы и минуты                          | Работает вместе с расписанием                          |
| Время окончания           | Время окончания показа           | Укажите часы и минуты                          | Если время перепутано, уведомление может не показаться |
| Сортировка                | Порядок уведомлений              | Перетащите строку                              | Важное уведомление ставьте выше                        |

### Типовые ошибки

| Ошибка / ситуация            | Причина                                           | Что сделать                           |
| ---------------------------- | ------------------------------------------------- | ------------------------------------- |
| Уведомление не видно         | Выключен статус или не наступило время расписания | Проверить статус, from time и to time |
| Ссылка открывается не так    | Неверно выбран режим новой вкладки                | Изменить “В новом окне”               |
| Текст пустой на другом языке | Не заполнена локализация                          | Заполнить все активные языки          |
| Иконка не грузится           | Неверный формат или размер                        | Загрузить разрешенный файл до лимита  |

## Realtime-уведомления в админке

### Для чего нужны

Realtime-уведомления показывают администраторам события в админке: новые заявки, сообщения, системные предупреждения и другие события, которые нужно обработать.

### Поля и действия

| Поле / действие           | Что означает                | Как использовать                     | Важно знать                        |
| ------------------------- | --------------------------- | ------------------------------------ | ---------------------------------- |
| Список уведомлений        | Последние админские события | Открывайте из шапки                  | Обычно отображается постранично    |
| Прочитано                 | Прочитано ли уведомление    | Отмечается автоматически или вручную | Непрочитанные влияют на счетчик    |
| Время прочтения           | Когда прочитано             | Используйте для аудита               | Полезно при споре “кто видел”      |
| Кто просмотрел            | Кто просмотрел              | Смотрите имя и email администратора  | Не публикуйте эти данные клиентам  |
| Отметить все прочитанными | Отметить все прочитанными   | После обработки всех событий         | Не удаляет события                 |
| Отметить одно прочитанным | Отметить одно событие       | Если обработано только оно           | Остальные останутся непрочитанными |

## Статус оператора и служебные настройки

### Для чего нужен

Статус оператора показывает, работает ли обменник в ручном режиме. Если статус оффлайн, это может влиять на ручные направления, экспорт курсов и ожидания клиентов.

### Поля и настройки

| Поле / настройка                     | Что означает                               | Как правильно заполнять                          | Важно знать                                   |
| ------------------------------------ | ------------------------------------------ | ------------------------------------------------ | --------------------------------------------- |
| Статус оператора                     | Онлайн или офлайн                          | Переключайте только по реальному графику         | Может скрывать ручные направления из экспорта |
| Подробный статус работы              | Подробное состояние работы                 | Проверяйте при споре, почему обменник был закрыт | Это источник истины для статуса               |
| Автоматические выплаты по расписанию | Включены ли автоматические выплаты по CRON | Меняйте только по регламенту                     | Влияет на автовыплаты и фоновые задачи        |

### Типовые ошибки

| Ошибка / ситуация                          | Причина                                                | Что сделать                                                  |
| ------------------------------------------ | ------------------------------------------------------ | ------------------------------------------------------------ |
| Ручное направление пропало из файла курсов | Оператор оффлайн и включено скрытие ручных направлений | Проверить статус оператора и настройки экспорта курсов       |
| Автовыплата не сработала                   | Отключена настройка или очередь не работает            | Проверить настройку раздела, CRON и журналы платежных шлюзов |
| Оператор включил оффлайн случайно          | Статус переключили в шапке                             | Вернуть онлайн и проверить публичный сайт                    |

## Количество строк в таблицах

### Для чего нужно

Эта настройка сохраняет, сколько записей показывать на странице конкретной таблицы. Например, оператору удобно видеть 50 заявок, а не 20.

### Поля и настройки

| Поле / настройка  | Что означает               | Как правильно заполнять                | Важно знать                                  |
| ----------------- | -------------------------- | -------------------------------------- | -------------------------------------------- |
| Название таблицы  | Внутреннее имя таблицы     | Обычно задается админкой автоматически | Не меняйте вручную без причины               |
| Строк на странице | Количество строк           | От 1 до 1000                           | Очень большое число может замедлить страницу |
| Ключ настройки    | Сохраненный ключ настройки | Создается автоматически                | Используется админкой для сохранения выбора  |

### Рекомендации

| Роль                                  | Рекомендуемое значение | Почему                                  |
| ------------------------------------- | ---------------------- | --------------------------------------- |
| Оператор заявок                       | 25–100                 | Удобно работать со сменой без перегруза |
| Владелец / аналитика                  | 50–200                 | Удобно сравнивать списки                |
| Слабый ноутбук или медленный интернет | 20–50                  | Меньше нагрузка на браузер              |
| Массовая проверка                     | 100–300                | Только если страница работает быстро    |

## Сортировка по умолчанию

### Для чего нужна

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

### Поля и настройки

| Поле / настройка | Что означает                 | Как правильно заполнять          | Важно знать                    |
| ---------------- | ---------------------------- | -------------------------------- | ------------------------------ |
| Page             | Какой список сортируется     | Обычно задается автоматически    | Для каждого списка свой ключ   |
| Item             | Новый порядок ID             | Формируется после перетаскивания | Не редактируется вручную       |
| Sort handle      | Кнопка/иконка перетаскивания | Перетащите строку                | После ошибки обновите страницу |

## Важные предупреждения

Не удаляйте медиафайлы, которые уже используются на страницах, в новостях, баннерах, валютах или платежных системах. Сначала проверьте, где файл подключен.

Не включайте слишком большое количество строк в таблицах без проверки скорости. Значение 1000 может быть полезно для редкой проверки, но неудобно для ежедневной работы.

Не выключайте статус оператора и автовыплаты без регламента. Эти настройки могут повлиять на заявки, экспорт курсов, ручные направления и ожидания клиентов.

Не добавляйте в уведомления приватные ссылки, внутренние инструкции, реквизиты, токены, email сотрудников и данные клиентов.

## Связанные разделы

| Раздел                             | Почему связан                                                 |
| ---------------------------------- | ------------------------------------------------------------- |
| Панель управления                  | Рабочий стол, счетчики и поиск                                |
| Страницы и контент                 | Контент, где часто используется медиа                         |
| Дизайн                             | Баннеры, логотипы и изображения                               |
| CRON и фоновые процессы            | CRON, обновления в реальном времени, очереди                  |
| Ошибки и диагностика               | Диагностика ошибок                                            |
| Платежи, автовыплаты и уведомления | Email, Telegram, центр уведомлений и события платежных шлюзов |
| Диагностические сценарии           | Практические сценарии поддержки                               |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.iexexchanger.com/help-center/ai-base/bezopasnost-i-processy/admin-utilities-reference.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
