G-SERVER Docs
Диагностика связи: Синхронизация Discord и Dashboard
Глубокое руководство по расшифровке heartbeat-сигналов бота, анализу очереди задач и пониманию механизмов синхронизации структуры без догадок и предположений.
В верхней части обзора вашего сервера расположен критически важный блок Состояние Discord ↔ Dashboard. Он транслирует сырые, не кэшированные данные напрямую из рабочей очереди (Message Broker) и фиксирует последний успешный ответ (Heartbeat) от бота. Цифры и статусы здесь никогда не генерируются для вида: если heartbeat устарел на несколько минут или какая-то фоновая задача завершилась критической ошибкой, панель мгновенно и прямо сообщит вам об этом.
Четыре ключевых сигнала состояния системы
- Heartbeat Discord-бота — Абсолютное время последнего успешного сигнала 'Я жив'. Зелёный индикатор подтверждает недавний ответ, жёлтый предупреждает о сетевой задержке или перегрузке API, красный констатирует факт потери связи.
- Снимок структуры (Snapshot) — Точная временная метка, когда база данных сайта в последний раз получила актуальный и полный слепок вашего сервера: все каналы, категории, голосовые комнаты, иерархию ролей и матрицу разрешений.
- Аналитика очереди изменений — Динамическая сводка: сколько конкретно задач ожидают обработки (worker-ом), сколько находятся в активном выполнении прямо сейчас и сколько завершились сбоем за последние 24 часа.
- Аудит прав бота — Отчет о реальных разрешениях бота, извлеченных из последнего системного снимка. Для надежного управления модулями критически важно наличие права 'Управление ролями' (Manage Roles) и корректное (высокое) положение роли G-SERVER в иерархии Discord.
Закулисный процесс: Что происходит после нажатия «Применить»
1. Инициализация
Dashboard генерирует запрос на изменение, присваивая ему уникальный криптографический ID, и помещает в очередь. Ваша защита от ошибок: повторные клики не создают параллельных, конфликтующих дубликатов, а лишь запрашивают статус уже существующей задачи.
2. Перехват задачи
Свободный worker бота обнаруживает задачу, устанавливает на нее эксклюзивную блокировку (lock) на время выполнения и отправляет сигнал подтверждения (heartbeat). Это гарантирует, что длительная, сложная настройка не будет ошибочно запущена сервером дважды.
3. Исполнение и валидация
Модуль физически обращается к API Discord, создает или модифицирует необходимые ресурсы (каналы, роли), после чего самостоятельно верифицирует фактический результат и проверяет корректность примененных прав.
4. Финальный Callback
Только после успешного получения отчета от бота задача официально переводится в статус Подтверждено. Если произошла временная ошибка (например, Discord API недоступен), система умного ретрая вернет задачу обратно в очередь, не превышая безопасный лимит попыток.
Золотое правило: Если индикатор heartbeat горит красным, категорически запрещается спамить кнопку применения. Ваша первая и единственная задача на этом этапе — проверить, что бот действительно запущен и находится в сети (Online). Будьте спокойны: ваш тщательно настроенный черновик в полной безопасности хранится в базе данных дашборда и никуда не исчезнет.
Ситуации, требующие ручной, принудительной синхронизации
- Вы произвели прямое, ручное вмешательство в структуру Discord: создали, переименовали или удалили канал, категорию или роль.
- Вы ожидаете увидеть недавно созданный объект в выпадающих списках (Select) дашборда, но его там нет.
- Системная панель выдает явное предупреждение о том, что снимок серверной структуры катастрофически устарел или полностью отсутствует в базе.
- Вы производили тонкую настройку прав сервера или перемещали системную роль G-SERVER в визуальной иерархии ролей Discord.