Ctrlk
ДемоОфициальный сайт
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Сценарии ответов AI-чата

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

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

Как использовать сценарии

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

Сценарий: пользователь не понимает рабочий стол

Короткий ответ

Рабочий стол — это быстрый экран контроля обменника. По нему смотрят активные заявки, операции, деньги, пользователей, резервы, качество обработки, команду и риски.

Пошаговая проверка

  1. Сначала уточните период: сегодня, 7 дней, 30 дней или весь период.

  2. Посмотрите активные заявки: ожидание оплаты, обработка, заморозка, ошибки автовыплаты.

  3. Проверьте денежные показатели: выполненные обмены, прибыль, активные и пустые резервы.

  4. Посмотрите качество: завершенные, проблемные и отклоненные заявки.

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

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

Предупреждение

Рабочий стол показывает оперативную картину. Для спорных цифр открывайте аналитику и сравнивайте тот же период и те же статусы.

Сценарий: поиск по админке ничего не нашел

Короткий ответ

Поиск лучше работает по точным данным: номер заявки, e-mail, телефон, реквизит, код валюты, название направления, мерчант или название раздела.

Пошаговая проверка

  1. Проверьте, что запрос не слишком короткий.

  2. Выберите правильную область поиска: заявки, пользователи, валюты, направления, мерчанты или разделы.

  3. Если ищете заявку, используйте номер заявки, e-mail или реквизит.

  4. Если ищете раздел, проверьте права роли администратора.

  5. Если объект архивирован, проверьте архив или список с фильтрами.

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

Предупреждение

Поиск не должен обходить права доступа. Если сотрудник не видит раздел через меню и поиск, сначала проверьте роль.

Сценарий: нужно полностью настроить валюту

Короткий ответ

Валюту настраивают по вкладкам: Основное, Поля, Информация, Верификация карты, Верификация личности, Мерчанты, Выплаты, AML, Лимиты резерва, Реквизиты, Пересчет, Партнер, Опции.

Пошаговая проверка

  1. В Основное проверьте статус, платежный код, отображаемый код, формат числа и XML-обозначение.

  2. В Поля настройте реквизиты клиента, подсказки, маски, min/max и тексты ошибок.

  3. В Информация заполните инструкцию, описание, документы, уведомления и текст кнопки.

  4. Во вкладках верификаций включите проверки только с понятным текстом для клиента.

  5. В Мерчанты и Выплаты выберите провайдеры, сети и лимиты.

  6. В AML настройте проверку адреса или транзакции и действие при ошибке.

  7. В Лимиты резерва и Реквизиты задайте реальные лимиты и способ выдачи платежных данных.

  8. В Пересчет включайте автоматический пересчет только для не финальных статусов.

  9. В Партнер укажите процент или фиксированную выплату, если по валюте есть отдельное правило.

  10. В Опции включите QR, загрузку файлов, пошаговую заявку или email-подтверждение только при необходимости.

  11. После сохранения проверьте направление, публичную форму, тестовую заявку и журнал.

Предупреждение

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

Сценарий: резерв из файла не обновился

Короткий ответ

Проверьте цепочку: включены ли файловые резервы, доступен ли txt-файл, есть ли нужный ключ, активен ли ключ, привязан ли обычный резерв и работает ли CRON.

Пошаговая проверка

  1. Убедитесь, что файловые резервы включены в настройках резервов.

  2. Откройте группу файла и проверьте URL, статус, последнюю успешную проверку и последнюю ошибку.

  3. Проверьте формат txt-файла: каждая строка должна быть похожа на USDT_TRC20 : 15000.

  4. Проверьте, что нужный ключ существует и активен.

  5. Откройте обычный резерв валюты и проверьте, что он привязан к этому ключу файла.

  6. Проверьте, что резерв не фиксированный, если ожидается обновление из файла.

  7. Проверьте CRON в FastPanel: /opt/php84/bin/php полный_путь_к_проекту/artisan schedule:run >/dev/null 2>&1.

  8. Убедитесь, что между /opt/php84/bin/php и путем к проекту есть пробел, а путь полный и точный.

Предупреждение

Используется именно PHP 8.4 FastPanel. Команда через /usr/bin/php может запускать не ту версию PHP и ломать фоновые задачи.

Сценарий: партнеру не начислился бонус

Короткий ответ

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

Пошаговая проверка

  1. Проверьте, включена ли реферальная система.

  2. Проверьте программу по умолчанию и процент.

  3. Проверьте срок жизни реферала и cookie.

  4. Откройте клиента и убедитесь, что он закреплен за партнером.

  5. Проверьте статус заявки: начисление обычно ожидается после финального успешного статуса.

  6. Проверьте тип начисления: от суммы обмена или от прибыли направления.

  7. Проверьте HOLD и дату, когда начисление должно стать доступным.

  8. Откройте реферальный журнал и найдите событие по партнеру, клиенту, заявке или trace ID.

Предупреждение

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

Сценарий: направление не видно на сайте

Короткий ответ

Проверьте цепочку: валюта "Отдаю", валюта "Получаю", направление, курс, резерв, лимиты, график работы и кеш.

Пошаговая проверка

  1. Убедитесь, что обе валюты включены и не находятся в архиве.

  2. Проверьте, что направление активно.

  3. Проверьте, что у направления есть рабочий курс.

  4. Проверьте, что резерв достаточный для минимальной суммы обмена.

  5. Проверьте минимальную и максимальную сумму.

  6. Проверьте, не закрывает ли направление график работы.

  7. Очистите кеш и снова откройте форму обмена.

Частые причины

Причина
Что сделать

Валюта выключена

Включить валюту и проверить ее фильтр

Направление выключено

Включить направление после проверки курса и резерва

Нет курса

Настроить ручной курс или источник курса

Резерв ниже минимума

Пополнить резерв или изменить лимиты

Сработало расписание

Проверить рабочий статус и город, если обмен наличный

Предупреждение

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

Сценарий: клиент не может создать заявку

Короткий ответ

Если направление видно, но заявка не создается, проблема обычно в сумме, обязательных полях, реквизитах, KYC, AML, чекбоксах согласия или ограничениях пользователя.

Пошаговая проверка

  1. Попросите пользователя назвать направление и сумму.

  2. Проверьте текст ошибки на форме обмена.

  3. Проверьте минимальную и максимальную сумму направления.

  4. Проверьте обязательные поля валюты и направления.

  5. Проверьте чекбоксы согласия и правила формы.

  6. Проверьте KYC и верификацию карты.

  7. Проверьте AML-правила, если обмен связан с криптовалютой.

  8. Проверьте пользователя: блокировка, IP, e-mail, черный список.

Частые причины

Ошибка
Причина
Решение

Сумма меньше минимума

Пользователь ввел слишком маленькую сумму

Указать допустимый минимум

Сумма больше максимума

Лимит направления или резерва меньше суммы

Изменить лимит или предложить меньшую сумму

Не заполнено поле

Обязательное поле пустое

Заполнить поле или убрать обязательность, если она не нужна

Требуется KYC

Для направления включена проверка личности

Направить пользователя на верификацию

Клиент заблокирован

Сработал черный список или ограничение

Проверить причину блокировки

Сценарий: курс не обновляется

Короткий ответ

Сначала выясните, какой тип курса использует направление: ручной, из источника, по формуле, из файла или BestChange. После этого проверяйте именно этот источник.

Пошаговая проверка

  1. Откройте направление и посмотрите тип курса.

  2. Если курс ручной, проверьте значение в направлении.

  3. Если курс из источника, проверьте дату последнего обновления источника.

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

  5. Если курс из файла, проверьте дату файла и формат.

  6. Если курс BestChange, проверьте пару, режим расчета и фильтры.

  7. Проверьте CRON и фоновые процессы.

  8. Очистите кеш и проверьте форму обмена.

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

Ситуация
Причина
Что сделать

На сайте старый курс

Кеш или не сработало автообновление

Очистить кеш, проверить CRON

В направлении другой курс

Выбран другой источник или формула

Проверить тип курса в направлении

Формула считает странно

Ошибка в переменных или коэффициенте

Проверить расчет на конкретном примере

BestChange не дает курс

Нет подходящих обменников после фильтров

Ослабить фильтры или проверить пару

Предупреждение

Не меняйте формулу или источник на рабочем направлении без теста. Ошибка курса может привести к финансовому убытку.

Сценарий: формула курса считает неправильно

Короткий ответ

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

Пошаговая проверка

  1. Откройте формулу и выпишите все теги, которые в ней используются.

  2. Проверьте значение каждого тега отдельно.

  3. Если какой-то тег пустой или равен 0, проверьте источник этого курса.

  4. Проверьте коэффициенты: 1.01 означает плюс 1 процент, 0.99 означает минус 1 процент.

  5. Проверьте, не применена ли маржа дважды: в формуле и отдельно в направлении.

  6. Если это обратная пара, посчитайте вручную: 1 делится на исходный курс.

  7. Если курс считается через промежуточную валюту, проверьте обе части цепочки.

  8. Проверьте округление: для фиата обычно 2 знака, для криптовалюты нужно больше.

  9. Сделайте preview и сравните результат с ручным расчетом.

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

Типовые ситуации

Ситуация
Вероятная причина
Что сделать

Формула дала 0

Пустой источник, неизвестный тег или деление на 0

Проверить каждый тег и добавить запасной источник

Курс стал слишком высоким

Дважды применена маржа или неверный кросс-курс

Проверить формулу и настройки направления

Курс стал слишком низким

Использована обратная пара или лишняя скидка

Проверить inverse, коэффициент и округление

После изменения коэффициента изменились другие пары

Коэффициент общий для нескольких формул

Проверить связанные формулы или разделить коэффициенты

Запасной источник всегда используется

Основной источник давно пустой

Проверить основной источник, а fallback оставить как страховку

Предупреждение

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

Сценарий: клиент оплатил, но заявка не перешла дальше

Короткий ответ

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

Пошаговая проверка

  1. Откройте карточку заявки.

  2. Проверьте текущий статус заявки.

  3. Сверьте сумму, которую должен был отправить клиент.

  4. Сверьте реквизиты, на которые клиент оплатил.

  5. Проверьте журнал платежной системы или входящего платежа.

  6. Проверьте, была ли частичная оплата, переплата или оплата не на тот реквизит.

  7. Проверьте, не требуется ли AML или KYC перед продолжением.

  8. Если автоматическая проверка не сработала, передайте заявку ответственному оператору.

Типовые ситуации

Ситуация
Что означает
Действие

Оплата не найдена

Система не видит поступление

Проверить реквизит и платежную систему

Сумма меньше ожидаемой

Клиент недоплатил

Пересчитать или запросить доплату по регламенту

Сумма больше ожидаемой

Клиент переплатил

Проверить правила переплаты

Оплата пришла позже

Платеж задержался

Проверить статус подтверждений

Оплата пришла на другой реквизит

Клиент ошибся

Передать на ручную проверку

Предупреждение

Не переводите заявку в оплаченные или выполненные, пока не подтвержден факт поступления. Это одно из самых рискованных действий в админке.

Сценарий: курс на сайте отличается от админки

Короткий ответ

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

Пошаговая проверка

  1. Откройте направление и проверьте выбранный тип курса.

  2. Проверьте источник, формулу или ручное значение.

  3. Проверьте, есть ли отдельная наценка или скидка в направлении.

  4. Проверьте комиссии, которые меняют итоговую сумму.

  5. Проверьте округление и точность.

  6. Сравните расчет на одной и той же сумме.

  7. Очистите кеш, если настройки уже изменены.

  8. Создайте тестовую заявку или проверьте калькулятор без оплаты.

Типовые ситуации

Ситуация
Причина
Что сделать

В админке курс один, на сайте другой

Дополнительная комиссия или наценка

Проверить настройки направления

После правки курс старый

Кеш или автообновление еще не прошло

Очистить кеш и проверить дату обновления

Отличие только на больших суммах

Работает комиссия или лимит по сумме

Проверить правила суммы и комиссии

Отличие в копейках или малых долях

Округление

Проверить точность курса и валюты

Предупреждение

Не сравнивайте курс на разных суммах. Комиссия и округление могут менять итог, даже если базовый курс одинаковый.

Сценарий: итоговая сумма изменилась из-за комиссии направления

Короткий ответ

Проверяйте не только курс, но и все вкладки направления, которые меняют итог: Основная, Доп. и ПС, От суммы обмена, Пересчет заявок и ограничения по сумме/новичкам.

Пошаговая проверка

  1. Откройте нужное направление.

  2. Во вкладке Основная проверьте профиль прибыли, процент прибыли, фиксированную прибыль и групповую комиссию.

  3. Во вкладке Доп. и ПС проверьте доп. комиссию и комиссию ПС отдельно по сторонам "Отдаю" и "Получаю".

  4. Проверьте минимальную комиссию: она может заменить маленькую процентную комиссию.

  5. Во вкладке От суммы обмена проверьте, не попала ли сумма клиента в отдельный диапазон.

  6. Во вкладке Пересчет заявок проверьте, выбран ли FIX или FLOATING и какая корректировка применяется.

  7. Проверьте округление и точность валют.

  8. Повторите расчет на той же сумме, которую ввел клиент.

Типовые ситуации

Ситуация
Причина
Что сделать

Маленькая сумма стала заметно хуже

Фиксированная прибыль или минимальная комиссия

Проверить минимум, фикс и min/max направления

Крупная сумма считается иначе

Сработал диапазон "От суммы обмена"

Проверить границы диапазона и корректировку

Комиссия появилась только при выплате

ПС-комиссия стоит на стороне "Получаю"

Проверить блок "Комиссия ПС"

Клиент выбрал floating и сумма изменилась

Сработал плавающий режим или пересчет

Проверить статусы, интервал и пороги

Пользовательская скидка не применилась

Скидка отключена для направления

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

Предупреждение

Не исправляйте итоговую сумму вслепую через курс. Если причина в комиссии ПС, диапазоне суммы или FIX/FLOATING, изменение курса может сломать все суммы по направлению.

Сценарий: автовыплата не отправилась

Короткий ответ

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

Пошаговая проверка

  1. Убедитесь, что заявка находится в статусе, где разрешена выплата.

  2. Проверьте, включена ли автовыплата для валюты и направления.

  3. Проверьте лимиты автовыплаты.

  4. Проверьте реквизиты клиента и сеть.

  5. Проверьте, достаточно ли средств у провайдера.

  6. Откройте журнал автовыплаты и посмотрите причину ошибки.

  7. Проверьте очередь фоновых задач.

  8. Перед повторным запуском убедитесь, что первая выплата точно не прошла.

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

Ошибка
Причина
Решение

Автовыплата не выбралась

Нет подходящего правила или провайдера

Проверить правила выплат

Провайдер вернул ошибку

Ошибка на стороне провайдера или неверные данные

Проверить журнал и настройки подключения

Превышен лимит

Сумма больше разрешенного лимита

Изменить лимит или выполнить вручную по регламенту

Неверная сеть

Клиент указал реквизит другой сети

Проверить поле сети и реквизит

Сценарий: реквизиты не выдались клиенту

Короткий ответ

Проверьте статус реквизита, привязку к валюте и направлению, лимиты, остаток, правила выдачи и журнал реквизитов.

Пошаговая проверка

  1. Откройте валюту, которую клиент отдает.

  2. Проверьте, какой способ приема оплаты используется: ручные реквизиты или мерчант.

  3. Если используются ручные реквизиты, проверьте активность реквизита.

  4. Проверьте, подходит ли реквизит по сумме и направлению.

  5. Проверьте остаток лимита реквизита.

  6. Проверьте журнал выдачи реквизитов по конкретной заявке.

  7. Если используется мерчант, проверьте журнал платежной системы.

Предупреждение

Не добавляйте реальные реквизиты в переписку с AI или документацию. Реквизиты должны храниться только в защищенной админке.

Сценарий: мерчант не выбран или выбран не тот

Короткий ответ

Проверьте правила выбора мерчанта: валюта, направление, сумма, статус мерчанта, лимиты, доступный остаток и журнал выбора.

Пошаговая проверка

  1. Откройте направление заявки.

  2. Проверьте, какие мерчанты разрешены для этой валюты и пары.

  3. Проверьте статус нужного мерчанта.

  4. Проверьте минимальную и максимальную сумму мерчанта.

  5. Проверьте правила выбора мерчанта для направления.

  6. Проверьте, не исчерпан ли лимит или остаток.

  7. Откройте журнал выбора мерчанта по заявке.

  8. Если используется запасной мерчант, проверьте, почему основной не подошел.

Типовые ситуации

Ситуация
Причина
Что сделать

Мерчант не выдал реквизит

Нет подходящего правила или лимит исчерпан

Проверить правила и лимиты

Выдался другой мерчант

Основной не подошел по сумме, валюте или статусу

Проверить журнал выбора

Мерчант выключен

Статус отключен или провайдер недоступен

Включать только после проверки

Реквизит не подходит клиенту

Неверная сеть или способ оплаты

Проверить валюту, сеть и инструкцию

Предупреждение

Не переключайте мерчант на рабочем направлении без теста. Ошибка может привести к оплате на неверные реквизиты.

Сценарий: KYC не проходит или завис

Короткий ответ

Проверьте статус KYC-заявки, выбранный KYC-сервис, причину отказа, документы пользователя и журнал проверки.

Пошаговая проверка

  1. Откройте заявку KYC пользователя.

  2. Проверьте текущий статус.

  3. Проверьте, внешний сервис используется или ручная модерация.

  4. Проверьте загруженные документы и обязательные поля.

  5. Проверьте причину отказа, если она есть.

  6. Проверьте журнал KYC.

  7. Если сервис не отвечает, передайте вопрос ответственному специалисту.

Типовые причины

Причина
Что делать

Документы плохого качества

Попросить пользователя загрузить новые документы

Не совпадают данные

Проверить данные профиля и документа

Сервис не обновил статус

Проверить журнал и очередь

Требуется ручное решение

Передать ответственному модератору

Сценарий: AML показывает высокий риск

Короткий ответ

Не продолжайте обмен автоматически. Проверьте AML-лог, адрес, транзакцию, уровень риска и внутренний регламент обменника.

Пошаговая проверка

  1. Откройте карточку заявки.

  2. Проверьте AML-результат.

  3. Откройте AML-лог.

  4. Посмотрите, что проверялось: адрес, транзакция или оба варианта.

  5. Сравните риск с правилами обменника.

  6. Если риск высокий, передайте заявку на ручное решение.

  7. Не меняйте настройки AML только ради одной заявки.

Предупреждение

AML связан с юридическими и финансовыми рисками. AI не должен советовать обходить AML-проверку.

Сценарий: письма не приходят

Короткий ответ

Проверьте настройки email, шаблон события, адрес получателя, очередь, журнал отправки и папку спам.

Пошаговая проверка

  1. Уточните, кому не приходит письмо: клиенту, оператору или владельцу.

  2. Уточните событие: регистрация, заявка, смена статуса, KYC, выплата.

  3. Проверьте, включен ли шаблон события.

  4. Проверьте адрес отправителя и получателя.

  5. Отправьте тестовое письмо.

  6. Проверьте очередь и журнал.

  7. Если тест не отправляется, проверьте настройки почтового провайдера.

Предупреждение

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

Сценарий: Telegram не отправляет уведомления

Короткий ответ

Проверьте бота, канал, права бота, шаблон события, привязку канала и тестовое сообщение.

Пошаговая проверка

  1. Убедитесь, что бот создан и активен.

  2. Убедитесь, что бот добавлен в нужный канал или чат.

  3. Проверьте права бота на отправку сообщений.

  4. Проверьте привязку канала в админке.

  5. Проверьте шаблон уведомления.

  6. Отправьте тестовое сообщение.

  7. Проверьте журнал ошибок уведомлений.

Предупреждение

Токен Telegram-бота нельзя отправлять в чат поддержки или добавлять в документацию.

Сценарий: клиент заблокирован или не может создать заявку

Короткий ответ

Проверьте пользователя, IP, e-mail, карту, кошелек, черный список, KYC, AML и лимиты направления.

Пошаговая проверка

  1. Найдите пользователя в админке.

  2. Проверьте блокировку пользователя.

  3. Проверьте IP и e-mail ограничения.

  4. Проверьте черный список по карте, кошельку или реквизиту.

  5. Проверьте KYC и AML.

  6. Проверьте направление и лимиты.

  7. Если блокировка была ручной, проверьте комментарий или журнал.

Предупреждение

Не снимайте блокировку без понимания причины. Блокировка могла быть связана с мошенничеством, AML или спорной оплатой.

Сценарий: промо-код или скидка не применяются

Короткий ответ

Проверьте срок действия, лимит использований, пользователя, направление, сумму и условия промо-кода или скидки.

Пошаговая проверка

  1. Проверьте активность промо-кода или скидки.

  2. Проверьте дату начала и окончания.

  3. Проверьте лимит использований.

  4. Проверьте, подходит ли направление.

  5. Проверьте, подходит ли сумма обмена.

  6. Проверьте пользователя или группу клиентов.

  7. Проверьте, не конфликтует ли скидка с другим правилом.

Сценарий: партнерский бонус не начислен

Короткий ответ

Проверьте реферальную связь, программу партнера, статус заявки, тип расчета, HOLD и журнал начислений.

Пошаговая проверка

  1. Найдите партнера и реферала.

  2. Проверьте, есть ли реферальная связь.

  3. Проверьте программу, назначенную партнеру.

  4. Проверьте статус заявки.

  5. Проверьте тип расчета: от суммы обмена или от прибыли.

  6. Проверьте минимальные суммы и HOLD.

  7. Откройте журнал партнерских начислений.

Предупреждение

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

Сценарий: страница, баннер или контакт не видны на сайте

Короткий ответ

Проверьте статус, дату публикации, место отображения, меню, группу, кеш и мобильную версию.

Пошаговая проверка

  1. Откройте нужный объект в админке.

  2. Проверьте, включен ли он.

  3. Проверьте даты показа, если они есть.

  4. Проверьте привязку к меню или группе.

  5. Проверьте порядок сортировки.

  6. Очистите кеш.

  7. Проверьте сайт на компьютере и телефоне.

Сценарий: CRON или фоновые процессы не работают

Короткий ответ

Проверьте дату последнего запуска, задачи курсов, очереди, уведомления и журналы ошибок. Если запуски остановились, нужен специалист по серверу.

Пошаговая проверка

  1. Проверьте дату последнего успешного запуска.

  2. Проверьте, какие задачи перестали работать: курсы, уведомления, выплаты, импорт, очереди.

  3. Проверьте журналы ошибок.

  4. Проверьте, не выключен ли автоматический режим.

  5. Проверьте очередь фоновых задач.

  6. Если задачи не запускаются совсем, передайте вопрос специалисту по серверу.

Предупреждение

AI может объяснить, где смотреть симптомы, но не должен выдавать приватные серверные команды или доступы.

Сценарий: сотрудник не видит раздел админки

Короткий ответ

Проверьте роль сотрудника, права доступа, активность нужного раздела, фильтры меню и сессию. Чаще всего раздел не виден из-за роли.

Пошаговая проверка

  1. Уточните, какой именно раздел не виден.

  2. Проверьте роль сотрудника.

  3. Проверьте, есть ли у роли право на этот раздел.

  4. Проверьте, не ограничен ли доступ по IP или дополнительной защите.

  5. Попросите сотрудника выйти и войти снова после изменения прав.

  6. Проверьте, видит ли раздел другой администратор с такой же ролью.

  7. Если раздел связан с отдельным модулем, проверьте, включена ли функция.

Типовые ситуации

Ситуация
Причина
Что сделать

Раздел не виден только одному сотруднику

У него другая роль или старая сессия

Проверить роль и обновить вход

Раздел не виден всем операторам

Роль оператора не имеет доступа

Добавить право только при необходимости

Раздел виден, но действие недоступно

Не хватает права на конкретное действие

Проверить права создания, изменения или удаления

После выдачи прав ничего не изменилось

Сессия еще не обновилась

Выйти и войти снова

Предупреждение

Не выдавайте полный доступ ради одного раздела. Лучше добавить только нужные права.

Сценарий: аналитика не совпадает с заявками

Короткий ответ

Сравните одинаковые фильтры: период, статусы, направления, валюты, партнеров и способ подсчета. Разные фильтры почти всегда дают разные цифры.

Пошаговая проверка

  1. Уточните, какую цифру сравнивают: заявки, оборот, прибыль, партнеров или посещения.

  2. Проверьте период в аналитике.

  3. Проверьте период в списке заявок.

  4. Проверьте статусы, которые входят в расчет.

  5. Проверьте направление и валюту.

  6. Проверьте, учитываются ли отмененные или архивные заявки.

  7. Проверьте, был ли пересчет аналитики.

  8. Если данные не обновляются, проверьте фоновые процессы.

Типовые ситуации

Ситуация
Причина
Что сделать

В аналитике меньше заявок

Фильтр статусов исключает часть заявок

Сравнить статусы

Прибыль отличается от оборота

Это разные показатели

Сравнить метод подсчета

Партнерская аналитика не совпадает с выплатами

HOLD, отмены или разные периоды

Проверить партнерский журнал

Сегодняшние данные пустые

Пересчет еще не прошел или выбран неверный период

Проверить период и фоновые процессы

Предупреждение

Не используйте аналитику для финансового решения, пока не проверены фильтры и период.

Сценарий: пользователь спрашивает "что можно безопасно менять"

Короткий ответ

Безопаснее менять тексты, описания, порядок, FAQ, баннеры и неопасные визуальные настройки. Осторожно меняйте курсы, лимиты, резервы, статусы, мерчанты, автовыплаты, KYC, AML и безопасность.

Таблица риска

Настройка
Риск
Рекомендация

Тексты, FAQ, новости

Низкий

Можно менять после проверки отображения

Баннеры и дизайн

Средний

Проверить мобильную и desktop версию

Валюты и направления

Высокий

Проверять курс, резерв, лимиты, реквизиты

Курсы и формулы

Высокий

Тестировать на примере до включения

Резервы

Высокий

Не завышать без фактических средств

Статусы заявок

Высокий

Менять только после понимания цепочки обработки

Мерчанты и автовыплаты

Очень высокий

Проверять на малых суммах и по журналам

KYC и AML

Очень высокий

Согласовывать с регламентом обменника

2FA, IP, доступы

Очень высокий

Менять только ответственному администратору

Сценарий: новичок спрашивает "с чего начать"

Короткий ответ

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

Пошаговая проверка

  1. Убедитесь, что серверная часть готова: домен, SSL, PHP 8.4, база, Redis, cron и очередь.

  2. Войдите в админку владельцем.

  3. Включите 2FA и создайте резервного администратора.

  4. Настройте название сайта, часовой пояс, языки, контакты и правила.

  5. Настройте email и Telegram.

  6. Создайте первые валюты.

  7. Настройте платежные системы, реквизиты или мерчант.

  8. Создайте первое направление.

  9. Настройте курс, лимиты, резерв и инструкцию.

  10. Создайте тестовую заявку и проверьте весь путь.

Предупреждение

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

Сценарий: вопрос про сервер, FastPanel, Nginx или PHP

Короткий ответ

Это техническая настройка сервера. Для iEXExchanger нужно проверить FastPanel или ручной Nginx, PHP-FPM 8.4, базу данных, Redis, cron, Horizon/queue, SSL, права файлов и backup. Если используется Angular SSR frontend, отдельно проверьте proxy на SSR и /backend-api в backend.

Пошаговая проверка

  1. Уточните, используется FastPanel или ручной Nginx.

  2. Проверьте, что домен открывается по HTTPS.

  3. Проверьте, что backend-корень сайта указывает на public.

  4. Проверьте PHP-FPM 8.4 и PHP CLI.

  5. Проверьте базу данных и пользователя базы.

  6. Проверьте Redis.

  7. Проверьте FastPanel cron: /opt/php84/bin/php полный_путь_к_проекту/artisan schedule:run >/dev/null 2>&1.

  8. Проверьте Horizon или queue worker.

  9. Проверьте права storage и bootstrap/cache.

  10. Проверьте backup.

  11. Если есть отдельный frontend-домен, проверьте Angular SSR upstream 127.0.0.1:4000, browser API /backend-api и правильный backend Host/SNI.

FastPanel cron

Между /opt/php84/bin/php и путем обязательно должен быть пробел. Путь должен быть полным и точным, как в FastPanel. Используйте PHP 8.4 FastPanel, а не /usr/bin/php.

Предупреждение

Не просите пароли, токены, .env или приватные логи в открытый чат. Если нужны доступы, они передаются по защищенному регламенту.

Сценарий: сайт открывается, но автоматические задачи не работают

Короткий ответ

Сайт и фоновые процессы работают отдельно. Если сайт открывается, но курсы, письма, Telegram, выплаты или аналитика не обновляются, проверьте scheduler, Redis и Horizon/queue.

Пошаговая проверка

  1. Определите, что именно не работает: курсы, письма, Telegram, выплаты, архив, аналитика или всё сразу.

  2. Проверьте настройки CRON в админке, если речь о курсах или файлах.

  3. Проверьте последний успешный запуск.

  4. Проверьте Laravel scheduler на сервере. В FastPanel он должен запускаться через /opt/php84/bin/php полный_путь_к_проекту/artisan schedule:run.

  5. Проверьте Redis.

  6. Проверьте Horizon или queue worker.

  7. Проверьте, не растут ли очереди.

  8. Проверьте логи задачи.

  9. После исправления сделайте безопасный тест.

Предупреждение

Если зависла автовыплата, не повторяйте её вручную, пока не проверено, что первая попытка точно не прошла.

Сценарий: frontend Nginx, Angular SSR или /backend-api работает неправильно

Короткий ответ

Для Angular SSR схема такая: frontend-домен проксирует страницы в 127.0.0.1:4000, а API браузера должен идти через /backend-api в backend-домен. Если браузер ходит напрямую на backend или /backend-api открывает HTML сайта, проблема в Nginx proxy, API_URL или порядке location.

Пошаговая проверка

  1. Уточните домены: какой frontend-домен и какой backend/admin-домен.

  2. Проверьте, что Angular SSR слушает локально, обычно 127.0.0.1:4000.

  3. Проверьте root .env SSR: API_URL должен указывать на backend-origin, например https://app.example.com.

  4. Проверьте, что в браузере API-запросы идут на https://frontend-domain/backend-api/....

  5. Проверьте Nginx location ^~ /backend-api/: он должен быть выше SSR fallback.

  6. Проверьте backend Host/SNI в proxy, чтобы Laravel получал backend-домен.

  7. Проверьте static aliases /images, /storage, /static, /dist, /exports.

  8. Проверьте /ng-custom/, если используются клиентские вставки или verification files.

Типовые причины

Симптом
Причина
Что сделать

В браузере CORS

Запрос идет напрямую на backend-домен

Перевести browser API на /backend-api

/backend-api возвращает HTML сайта

Запрос попал в SSR fallback

Исправить порядок Nginx location

SSR не грузит /start

Неверный API_URL или SSL/backend-origin

Указать backend-origin и проверить сертификат

Redirect на /ru/client-api/...

Backend получил неправильный Host

Проверить proxy_set_header Host

JS/CSS плохо кешируются

Static location ниже языкового SSR location

Поднять static location выше

Предупреждение

Не смешивайте frontend-домен и backend PHP-FPM через старый /apis как основную схему. Для новой конфигурации используйте /backend-api, а /apis оставляйте только временно для старых сборок.

Сценарий: после изменения безопасности администратор не может войти

Короткий ответ

Нужно определить, на каком этапе закрыт доступ: постоянный адрес, пароль, 2FA, персональная ссылка, IP или CAPTCHA. Не отключайте все защиты сразу.

Пошаговая проверка

  1. Проверить итоговый постоянный адрес, показанный системой.

  2. Открыть его в приватном окне.

  3. Если форма есть, проверить пароль и блокировку попыток.

  4. Проверить Google 2FA конкретного аккаунта.

  5. Если вход выполнен, проверить письмо с персональной ссылкой.

  6. Открывать ссылку в том же браузере и до истечения срока.

  7. Проверить правильность реального IP и доверенного прокси.

  8. Проверить CAPTCHA и домен ключей.

  9. Использовать только штатную процедуру восстановления владельца.

Предупреждение

Не публикуйте адрес входа, 2FA, email-коды и список разрешённых IP в обращении.

Сценарий: страховка курса неожиданно изменила или отключила направление

Короткий ответ

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

Пошаговая проверка

  1. Открыть направление — «Обмен» — «Страховка курса».

  2. Проверить состояние последней проверки.

  3. Сравнить рассчитанный и страховой курс.

  4. Проверить верхнюю или нижнюю сторону срабатывания.

  5. Проверить безопасный курс и лимит.

  6. Проверить минимальную абсолютную разницу.

  7. Проверить число нарушений подряд.

  8. Открыть историю срабатываний.

  9. После исправления нажать «Проверить сейчас».

  10. Включать направление только после проверки полного калькулятора.

Сценарий: файловый курс не найден

Короткий ответ

Нужно отдельно проверить доступность файла, определённый формат, имя пары и результат preview. Открытие URL в браузере не доказывает, что сервер может безопасно получить файл.

Пошаговая проверка

  1. Проверить публичный HTTP(S) URL и размер до 2 МБ.

  2. Обновить источник и посмотреть определённый тип JSON/CSV/TXT.

  3. Проверить формат строки или объекта.

  4. Проверить пару BTC - USDT и её нормализованное имя.

  5. Для кода поставщика добавить TXT-алиас или исправить исходный файл.

  6. Проверить исходное выражение и итоговое значение в preview.

  7. Проверить статус пары и дату обновления.

  8. Проверить scheduler и cron PHP 8.4.

  9. Проверить выбор пары в направлении.

Сценарий: плагин установлен, но функция не работает

Короткий ответ

Установка кода — только первый этап. Проверьте статус плагина, секреты, обычные настройки, миграции, health-check, импорт и рабочую привязку.

Пошаговая проверка

  1. Открыть строку плагина и проверить статус.

  2. Прочитать последнюю ошибку совместимости или здоровья.

  3. Заполнить обязательные секреты.

  4. Проверить обычную конфигурацию.

  5. Проверить, выполнены ли нужные миграции.

  6. Выполнить health-check.

  7. Для курса проверить импорт пар и статус нужной пары.

  8. Проверить scheduler и дату обновления.

  9. Привязать функцию к тестовой валюте или направлению.

  10. Выполнить тестовую операцию.

  11. Если новая версия сломана, откатить релиз и повторить проверку.

Предупреждение

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

Сценарий: после настройки FASTPANEL сайт или панель не открывается

Короткий ответ

Сначала определите, не открывается домен сайта, backend или сама панель. Затем по порядку проверьте DNS, firewall, SSL, Nginx и нужный upstream. Не меняйте все слои одновременно.

Пошаговая проверка

  1. Зафиксировать домен, URL, время и ошибку браузера.

  2. Проверить A/AAAA и фактический IP.

  3. Для панели проверить доступ к 8888 с доверенного IP.

  4. Для сайта проверить 80/443 и сертификат.

  5. Выполнить nginx -t до reload/restart.

  6. Проверить Nginx и backend: PHP-FPM для Laravel, PM2 для SSR.

  7. При 502 проверить локальный socket/порт upstream.

  8. При 404 проверить сайт, домен, рабочую подпапку public и try_files.

  9. Сохранить нужный фрагмент error log.

  10. После исправления проверить frontend, API, админку и тестовую заявку.

Предупреждение

Не отключайте firewall полностью и не применяйте chmod 777. Если после IP-ограничения закрылась панель, используйте сохранённый SSH-доступ и исправьте точное правило.

Сценарий: сервер заполнен или работает медленно

Короткий ответ

Проверьте место, inodes, память, swap, OOM, CPU и процессы. Затем определите конкретный каталог или процесс: логи, backup, документы, база, PM2, Supervisor или временные файлы.

Пошаговая проверка

  1. Выполнить df -hT и df -ih.

  2. Выполнить free -h, swapon --show и uptime.

  3. Проверить OOM в kernel journal.

  4. Найти крупные каталоги в пределах одной файловой системы.

  5. Проверить размер и ротацию Nginx, Laravel, MySQL, PM2 и Supervisor logs.

  6. Проверить локальные копии FASTPANEL и retention внешнего плана.

  7. Проверить процессы по CPU и памяти.

  8. Освобождать место только после определения назначения файлов.

  9. Проверить сервисы и полный цикл приложения.

  10. Настроить мониторинг и раннее предупреждение, чтобы ситуация не повторилась.

Предупреждение

Не удаляйте неизвестные каталоги базы, storage, release или backup. Не выполняйте redis-cli FLUSHALL как способ освободить память без понимания очередей и сессий.

Сценарий: Horizon не работает или очередь растет

Короткий ответ

Horizon выполняет Redis-задания. Проверьте очередь, master-процесс, Supervisor, Redis и первое failed job. Не очищайте очередь до понимания, какие письма, пересчеты или финансовые действия в ней ожидают.

Пошаговая проверка

  1. Уточнить симптом: Horizon Inactive, pending jobs, failed jobs или медленная очередь.

  2. Проверить QUEUE_DRIVER=redis.

  3. Выполнить /opt/php84/bin/php полный_путь/artisan horizon:status.

  4. Проверить sudo supervisorctl status.

  5. Проверить redis-cli ping.

  6. Определить имя растущей очереди.

  7. Проверить число процессов и wait time.

  8. Открыть первое failed job и профильный бизнес-журнал.

  9. После исправления выполнить horizon:terminate, чтобы Supervisor загрузил новый код.

  10. Провести безопасный тест и убедиться, что pending уменьшается.

Предупреждение

Для payout, refund и начислений сначала проверьте внешний transaction ID и состояние у провайдера. Повтор задания без проверки может продублировать финансовую операцию.

Сценарий: Pulse пустой или показывает замедление

Короткий ответ

Pulse собирает общие показатели запросов, SQL, jobs, внешних API, кеша и сервера. Пустой экран обычно связан с выключенным Pulse, базой, ingest или процессом pulse:check.

Пошаговая проверка

  1. Проверить PULSE_ENABLED=true.

  2. Проверить отдельное подключение mysql-pulse и миграции.

  3. Определить PULSE_INGEST_DRIVER.

  4. При storage проверить запись прямо в Pulse DB.

  5. При redis проверить отдельное Redis-подключение и pulse:work.

  6. Для карточки Servers проверить pulse:check и уникальное имя сервера.

  7. Выполнить pulse:restart после релиза.

  8. Если Pulse показывает медленную операцию, сопоставить время с Nginx, Laravel и профильным журналом.

  9. На высокой нагрузке проверить retention, sample rate и шумные recorder.

Предупреждение

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

Сценарий: Cloudflare показывает 521, 522, 525 или 526

Короткий ответ

Сохраните код, время, URL и Ray ID. 521/522 обычно относятся к доступности origin, firewall или нагрузке, а 525/526 к TLS между Cloudflare и origin.

Пошаговая проверка

  1. Проверить точный код, время и hostname.

  2. Сверить A/AAAA в Cloudflare с реальным origin IP.

  3. Проверить 80/443, Nginx и firewall.

  4. Убедиться, что актуальные Cloudflare CIDR не заблокированы.

  5. При 521 проверить, слушает ли Nginx нужный порт.

  6. При 522 проверить перегрузку, packet loss, keepalive и origin logs.

  7. При 525 проверить TLS handshake, SNI, cipher и сертификат.

  8. При 526 проверить срок, CN/SAN, chain и режим Full (strict).