README

Эта база знаний предназначена в первую очередь для GitBook AI Agent и Assistant. Ее задача — дать AI-чату безопасные и подробные знания по админ-панели iEXExchanger, чтобы пользователи могли задавать вопросы простым языком и получать точные ответы по настройкам, заявкам, курсам, платежам, KYC, AML, уведомлениям и диагностике.

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

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

Документация написана простым языком. Она объясняет практическое назначение разделов, полей, галочек, статусов и действий администратора. Здесь не должно быть исходного кода, внутренних путей проекта, секретов, токенов, паролей, приватных адресов, реальных данных клиентов или реквизитов.

Как пользоваться

Используйте эту базу как справочник по админ-панели:

Что нужно узнать	Где искать
Как устроена админка в целом	Раздел "Администрирование"
Какой маршрут и право нужны для конкретного экрана	Раздел "Маршруты, разделы и права админ-панели"
Как понять, в какой раздел админки идти	Раздел "Полная карта админ-панели"
Как работает рабочий стол, поиск, аналитика и журналы	Раздел "Рабочий стол, поиск, аналитика и журнал событий"
Как добавить валюту, сеть или реквизиты	Раздел "Валюты и направления"
Как работают коды, фильтры, шаблоны, профили и массовый редактор	Раздел "Каталоги и автоматизация направлений"
Как пройти все вкладки валюты по порядку	Раздел "Валюты: полный порядок настроек"
Как пройти все вкладки направления по порядку	Раздел "Направление обмена: все настройки по порядку"
Как настроить обычные, связанные и файловые резервы	Раздел "Резервы: обычные, связанные и из файлов"
Как настроить прибыль, доп. комиссии, комиссии ПС, пересчет и ограничения направления	Раздел "Комиссии, пересчет и ограничения направления"
Почему курс не обновляется	Раздел "Курсы" и "Диагностика"
Как подключить JSON, CSV или TXT с курсами	Раздел "Источники курсов и курсы из файлов"
Как настроить формулу курса и коэффициенты	Раздел "Полная инструкция по формулам курсов"
Как полностью настроить парсер BestChange	Раздел "BestChange: полный справочник парсера курсов"
Как добавить обменник в BestChange и настроить XML	Раздел "BestChange: добавление обменника, экспорт курсов и сопровождение"
Как проверить внешний черный список BestChange	Раздел "Черный список BestChange"
Как проверить, установить, настроить или откатить плагин	Раздел "Установка и работа с плагинами"
Что делать с заявкой	Раздел "Заявки"
Как расследовать зависшую, скрытую или спорную заявку	Раздел "Управление заявками и устранение проблем"
Как выдать, заменить или заблокировать реквизиты по запросу	Раздел "Реквизиты по запросу: выдача, замена и контроль"
Как работает KYC или AML	Раздел "KYC и AML"
Как настроить почту, Telegram или платежи	Раздел "Интеграции и уведомления"
Как подключить JivoSite, Intercom, Tawk.to, Talk-Me, iEXChat или Zendesk	Раздел "Онлайн-чаты: iEXChat, JivoSite, Intercom, Tawk.to, Talk-Me и Zendesk"
Как настроить операторов, отделы, очереди и рабочие часы Jivo, Intercom или Zendesk	Раздел "Jivo, Intercom и Zendesk: настройка службы поддержки"
Как проверить безопасность, журналы и фоновые процессы	Раздел "Безопасность и процессы"
Как настроить роли, доверенные устройства, OAuth, уровни, скидки и Bonus Center	Раздел "Пользователи, роли, безопасность и лояльность"
Как создать группы сотрудников и выдать точные права	Раздел "Группы пользователей и права доступа"
Как работать с блочным конструктором, промокодами и конкурсами	Раздел "Конструктор контента и маркетинг"
Где искать точное событие и как читать системную аналитику	Раздел "Аналитика, журналы и служебные инструменты"
Как полностью защитить вход и критичные операции	Раздел "Безопасность админ-панели: полная настройка"
Что ответить клиенту или оператору при ошибке	Раздел "Диагностика и FAQ"
Как AI-чату отвечать на вопросы	Раздел "Инструкция для AI-агента и чата"
Как AI-чату проверять качество и актуальность ответа	Раздел "Стандарт качества и актуальности ответов AI"
Какие вопросы должен понимать AI	Раздел "База вопросов для AI-чата"
Как быстро понять, куда отправить пользователя	Раздел "Маршрутизатор задач для AI-чата"
Как дать пошаговую настройку	Раздел "Чек-листы настройки админки"
С чего начать новичку	Раздел "С чего начать настройку админки"
Как настройки связаны между собой	Раздел "Карта связей настроек"
Что делать после покупки	Раздел "После покупки и запуск"
Как запустить обменник с нуля	Раздел "Запуск обменника по шагам"
Что делать после ошибки обновления	Раздел "Типовые ошибки после обновления"
Как подготовить сервер, FastPanel, Nginx и PHP 8.4	Раздел "Техническая настройка"
Как выбрать облако и подготовить новый VPS	Раздел "Выбор и подготовка облачного сервера"
Как создать сервер в Hetzner, DigitalOcean, Timeweb Cloud или FASTVPS	Отдельная страница выбранного провайдера в разделе "Техническая настройка"
Как работать со всеми разделами FASTPANEL	Раздел "FASTPANEL: полное руководство администратора"
Как обслуживать Debian 12 или Ubuntu 24.04	Раздел "Debian 12 и Ubuntu 24.04: эксплуатация сервера"
Как развернуть iEXExchanger в FASTPANEL	Раздел "Развёртывание iEXExchanger в FASTPANEL"
Как настроить frontend Nginx, Angular SSR и /backend-api	Раздел "Nginx для Angular SSR в FastPanel"
Почему не работают CRON, очереди или Horizon	Раздел "CRON, очереди и Horizon"
Как работают Horizon и Pulse и где искать замедление	Раздел "Laravel Horizon и Pulse"
Как настроить Nginx, SSL и Cloudflare Full (strict)	Раздел "Nginx, SSL и Cloudflare"
Как подключить DNS в REG.RU, Namecheap или GoDaddy	Раздел "Домены и DNS у регистраторов"
Как запустить и проверить партнерскую программу	Раздел "Партнерская программа"
Как отвечать на реальные частые вопросы клиентов	Раздел "Частые вопросы клиентов из Telegram"
Сколько резервов нужно для старта	Раздел "Стартовые резервы и популярные валюты"
Какие криптовалюты добавить первыми	Раздел "Стартовые резервы и популярные валюты"
Как защитить FastPanel	Раздел "Защита FastPanel и сервера"
Что нового в конкретном релизе	Раздел "Релизы и новости для AI-чата" и подключенный Website source

Как обновлять документацию

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

Ситуация	Что обновить	Как проверить
В админке появился новый пункт меню	Добавить страницу или подраздел в подходящую папку	Проверить название раздела, назначение и права доступа
В форме появилось новое поле или галочка	Добавить строку в таблицу настроек	Объяснить, что поле меняет для сайта, заявки или оператора
Изменился статус заявки, KYC или AML	Обновить таблицу статусов и частых ошибок	Проверить, как статус видит оператор и что можно сказать клиенту
Добавлен новый платежный провайдер	Обновить раздел платежных систем	Не добавлять ключи, токены, приватные адреса и реальные реквизиты
Изменились фоновые процессы	Обновить раздел CRON, очередей и диагностики	Проверить, что написано, какие симптомы видит администратор

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

Ситуация	Правильно	Неправильно
Нужно объяснить галочку	"Если включить настройку, валюта станет доступна клиенту на сайте. Перед включением проверьте резерв, лимиты и реквизиты."	"Поставьте значение Да в техническом поле."
Нужно описать поле курса	"Укажите источник курса и проверьте итоговый расчет на примере пары BTC - USDT."	"Используется внутренний обработчик курса."
Нужно описать ошибку	"Если заявка зависла в ожидании оплаты, проверьте статус оплаты, журнал платежной системы и сумму поступления."	"Проверьте метод, маршрут или файл."
Нужно дать пример	"Например, для USDT TRC20 укажите сеть TRC20, минимальную сумму и отдельный резерв."	"Например, настройте как в коде."
Нужно предупредить об опасной настройке	"Не отключайте проверку реквизитов без теста, иначе клиенты смогут отправлять заявки с ошибочными данными."	"Можно выключить, если мешает."

Что запрещено добавлять

Запрещенные данные	Почему нельзя добавлять
API-ключи, токены, пароли, секретные коды	Это приватные данные проекта и провайдеров
Реальные клиентские данные, заявки, e-mail, телефоны, документы	Это персональные данные клиентов
Реальные реквизиты, кошельки, карты, адреса выплат	Это платежная информация
Приватные адреса админки, серверов, журналов и хранилищ	Это повышает риск несанкционированного доступа
Внутренние пути проекта, названия файлов, классов, методов	Эта база должна объяснять работу админки, а не устройство проекта

Проверка качества

Перед публикацией новой страницы проверьте:

Проверка	Что должно быть
Простота языка	Текст понятен владельцу обменника без программиста
Практическая польза	Есть ситуации, когда открывать раздел, и пошаговые действия
Поля и галочки	Каждое важное поле объяснено по смыслу и последствиям
Ошибки	Есть причина и действие, которое может выполнить администратор
Предупреждения	Отмечены настройки, влияющие на заявки, курсы, резервы, уведомления и безопасность
Безопасность	Нет секретов, приватных данных, внутренних путей и исходного кода
Актуальность	Названия полей и пути сверены с текущей админкой, внешние требования проверены по официальному источнику

Новые знания для AI-чата

Раздел	Для чего нужен
Инструкция для AI-агента и чата	Правила безопасных и полезных ответов в GitBook Assistant
База вопросов для AI-чата	Большой список естественных вопросов пользователей и быстрых маршрутов проверки
Сценарии ответов AI-чата	Пошаговые playbook-инструкции по частым проблемам
Карта покрытия базы знаний	Контроль, какие области админки уже покрыты знаниями для чата
Полная карта админ-панели	Общая навигация по реальным разделам админки: что где находится, зачем нужно и что проверять
Рабочий стол, поиск, аналитика и журнал событий	Подробный справочник по первому экрану админки, глобальному поиску, аналитике и журналам расследования
Валюты: полный порядок настроек	Все вкладки карточки валюты подряд: основное, поля, информация, KYC, мерчанты, выплаты, AML, резервы, реквизиты, пересчет, партнер и опции
Направление обмена: все настройки по порядку	Все вкладки направления: суммы, тексты, проверки, курс, страховка, комиссии, резерв, реквизиты, партнер и экспорт
Резервы: обычные, связанные и из файлов	Обычные резервы валют, связанные резервы, история, файловые ключи, источники txt-файлов и диагностика cron
Партнерская программа	Запуск партнерки, программы, проценты, cookie, тип начисления, логи, баннеры, скидки и диагностика бонусов
Полная инструкция по формулам курсов	Подробные правила формул, коэффициентов, маржи, примеры пар и диагностика ошибок
Источники курсов и курсы из файлов	Встроенные и плагинные источники, API-ключи, BestChange, конкуренты, JSON/CSV/TXT, preview и расписание
BestChange: полный справочник парсера курсов	Глобальные настройки, пары, стратегии, позиция, TOP-N, фильтры, формулы, fallback, рейтинг, журнал и scheduler
BestChange: добавление обменника, экспорт курсов и сопровождение	Подготовка обменника к листингу, BestChange XML, комиссии, точность, резерв, метки, партнерские переходы и контроль обновления
Черный список BestChange	Внешняя проверка IP, контактов и кошельков, безопасные режимы и действия оператора при совпадении
Онлайн-чаты: iEXChat, JivoSite, Intercom, Tawk.to, Talk-Me и Zendesk	Точные ID, встроенные ограничения, чат заявки, уведомления, приватность и диагностика каждого сервиса
Jivo, Intercom и Zendesk: настройка службы поддержки	Роли, сотрудники, отделы, team inboxes, группы, расписания, маршрутизация, offline, JWT, безопасность и приемочный тест
Стандарт качества и актуальности ответов AI	Структура ответа, уровни уверенности, денежные примеры, проверка свежести и безопасная эскалация
Реквизиты по запросу: выдача, замена и контроль	SLA первой выдачи, типы и сеть, видимость полей, шаблоны, версии, окно замены, история и повторные уведомления
Установка и работа с плагинами	Проверка ZIP, совместимость, импорт пар, секреты, health-check, миграции, релизы, откат и удаление
Безопасность админ-панели: полная настройка	Адреса входа, 2FA, пароль, сессии, IP, прокси, CAPTCHA и подтверждение критичных действий
Комиссии, пересчет и ограничения направления	Подробное объяснение вкладок "Основная", "Доп. и ПС", "От суммы обмена", "Пересчет заявок" и "Ограничения и проверки"
Расширенная база вопросов и ответов	Дополнительные вопросы по всем разделам админки, написанные языком клиентов и поддержки
Маршрутизатор задач для AI-чата	Быстрая карта: куда идти, что проверить первым и где высокий риск
Чек-листы настройки админки	Пошаговые инструкции по настройке валют, направлений, курсов, платежей, KYC, AML, уведомлений и безопасности
После покупки и запуск	Доступы, сервер, домен, Cloudflare, FastPanel, установка, новые версии и распределение ответственности
Типовые ошибки после обновления	Что проверить после обновления, какие данные прислать и когда нужен специалист
Запуск обменника по шагам	Полный порядок запуска от сервера до тестовой заявки
Частые вопросы клиентов из Telegram	Реальные вопросы клиентов: 2FA, новые версии, курсы, сервер, AML, партнерка, кешбек
Стартовые резервы и популярные валюты	Как считать резерв, какие валюты запускать первыми и как ставить лимиты
Защита FastPanel и сервера	Как защищать панель сервера, доступы, backup и временные аккаунты
Релизы и новости для AI-чата	Как подключить страницу релизов к GitBook Assistant и отвечать по версиям
С чего начать настройку админки	Порядок настройки для новичка от сервера и доступа до тестовой заявки
Карта связей настроек	Как настройки валют, направлений, курсов, резервов, уведомлений и CRON зависят друг от друга
FastPanel, Nginx и PHP 8.4	Технический runbook для серверной команды
Выбор и подготовка облачного сервера	Уровни ответственности, выбор тарифа, SSH, firewall, backup, мониторинг и готовность к FASTPANEL
Hetzner, DigitalOcean, Timeweb Cloud и FASTVPS	Отдельные пошаговые сценарии создания сервера, защиты, восстановления, resize и передачи в FASTPANEL
FASTPANEL: полное руководство администратора	Сайты, пользователи, DNS, SSL, PHP, базы, cron, firewall, backup, сервисы, мониторинг, обновления и восстановление
Debian 12 и Ubuntu 24.04: эксплуатация сервера	SSH, security updates, firewall, диски, память, systemd, MySQL, Redis, журналы, major-upgrade и аварийная диагностика
Развёртывание iEXExchanger в FASTPANEL	Точная production-схема backend/frontend, PHP 8.4, Pulse, Redis, Supervisor, PM2, Reverb, Nginx, cron, релиз и откат
Nginx для Angular SSR в FastPanel	Frontend-домен, SSR upstream, /backend-api, /ng-custom/, static aliases и частые ошибки proxy
CRON, очереди и Horizon	Фоновые процессы, без которых не работают курсы, письма, выплаты и аналитика
Laravel Horizon и Pulse	Реальные очереди проекта, Supervisor, failed jobs, метрики, Pulse DB, recorders, ingest и performance-диагностика
Nginx, SSL и Cloudflare	Origin и edge TLS, Full (strict), сертификаты, real IP, cache bypass, WAF, WebSocket и ошибки 520-526
Домены и DNS у регистраторов	Авторитетные NS, DNS records, DNSSEC, перенос и откат для REG.RU, Namecheap и GoDaddy