Внутренний бот проекта RMRP

RMRP Staff

Служебный Discord-бот проекта RMRP для управления штатными должностями: выдача и снятие позиций сотрудников, автоматический пересчёт ролей и никнеймов, учёт операций. Бот создан исключительно для служебных Discord-серверов проекта, не оказывает услуг третьим лицам и не публикуется в каталогах ботов.

Назначение

Бот обслуживает кадровый контур проекта RMRP на его служебных Discord-серверах. Он переводит решения администрации в изменения Discord: выдаёт и снимает роли, соответствующие должности, подразделению и званию, и обновляет никнейм участника в утверждённом формате. Правила доступа считаются от текущей должности инициатора, поэтому команды видны и доступны только тем, кому это разрешено иерархией проекта.

Возможности

• Выдача и снятие позиций: штатные, лидерские и кураторские должности, включая правила о том, какие ранги и подразделения (Government / Criminal) вправе выдавать и снимать конкретный сотрудник.
• Каскадный пересчёт ролей: при выдаче или снятии позиции бот заново определяет все должности участника по конфигу проекта (с разбором неоднозначных совпадений и кэшем рангов) и пересчитывает набор ролей целиком, чтобы результат не зависел от порядка операций.
• Никнеймы: обновление ника по должности и его возврат к исходному значению при снятии позиции.
• Массовые операции: выдача и снятие по фиксированному списку позиций сервера для плановых кадровых решений.
• Отложенные выдачи: если участник временно отсутствует на сервере, выдача не теряется — она ставится в очередь и применяется при вступлении или фоновой сверкой каждые 10 минут.
• Восстановление после сбоев: журнал операций с WAL-семантикой и повтор незавершённых операций при старте.
• Постоянный контроль состояния: полный скан серверов каждые 30 минут, сброс изменений на диск каждые 30 секунд, ежечасные бэкапы служебных данных.
• Реакция на события участников и медиа-монитор: бот отслеживает вход, выход и изменение ролей участников (журнал аудита сервера), следит за медийной администрацией медиа-сервера и каскадом снимает у неё вспомогательные роли, когда человек теряет медийные роли или уходит с сервера проекта; при снятии должности участник также исключается с тех служебных серверов проекта, которые перечислены в настроенном списке (игровые серверы и аккаунты администрации проекта не затрагиваются) — поэтому в список запрошенных прав входят View Audit Log и Kick Members.
• Справочные команды: своя текущая должность, журнал снятий, проверка целостности данных и очередь отложенных выдач.

Команды

Все команды — слэш-команды Discord; доступ проверяется по должности вызывающего.

Команда	Что делает
/setstaff	Выдаёт штатную позицию: роли, соответствующие должности, подразделению и званию.
/setleader	Выдаёт лидерскую позицию.
/setcurator	Выдаёт кураторскую позицию.
/setname	Устанавливает никнейм участника по утверждённому формату.
/unsetleader	Снимает лидерскую позицию и пересчитывает роли.
/unsetcurator	Снимает кураторскую позицию и пересчитывает роли.
/resetname	Возвращает никнейм к исходному значению.
/staffall	Массовая выдача ролей по фиксированному списку позиций сервера.
/staffallremove	Массовое снятие ролей из того же списка.
/removallogs	Журнал снятий: кто, когда и у кого снял позицию.
/myrank	Показывает вызывающему его текущую должность и связанные роли.
/validate	Проверка целостности: соответствие ролей, никнеймов и журнала должностей.
/pendinggrants	Показывает и применяет очередь отложенных выдач.

Права доступа и иерархия

Отдельный движок прав рассчитывает допустимость операции от текущей должности инициатора: доступ к кадровым командам открыт старшим должностям проекта, при этом для каждой должности определено, какие ранги и подразделения она вправе выдавать и снимать. Позиции сопоставляются с ролями Discord по конфигурации проекта, а спорные совпадения имён разрешаются автоматически. Никто не может выдать или снять позицию выше своего уровня.

Используемые права Discord

Manage Roles Manage Nicknames Kick Members View Audit Log View Channels Send Messages Embed Links Read Message History

Из привилегированных шлюзов используется только Server Members Intent — он необходим, чтобы находить участника и его роли при кадровых операциях. Message Content Intent не запрашивается: бот не читает содержимое сообщений, вся работа идёт через слэш-команды. Presence Intent также не используется.

Какие данные обрабатываются и зачем

Данные	Зачем	Где хранятся
ID участников, имена пользователей и никнеймы на сервере	определить участника, его текущую должность и обновить никнейм по формату проекта	служебные JSON-файлы бота на сервере Оператора
ID ролей, названия должностей, подразделения и звания	рассчитать набор ролей для должности и проверить права инициатора	конфигурация проекта и служебные JSON-файлы
Журнал кадровых операций: кто, кого, что и когда выдал или снял	аудит решений администрации и восстановление незавершённых операций	журнал операций и журнал должностей (JSON, с резервной копией)
Очередь отложенных выдач (участник, сервер, роли и никнейм к применению)	не потерять кадровое решение, если участника временно нет на сервере (TTL 14 дней)	служебный JSON-файл бота
Технические журналы работы и предупреждений	диагностика сбоев и контроль нагрузки на Discord API	файлы логов на сервере Оператора

Бот не обрабатывает личные сообщения, содержимое каналов, голосовые данные, платёжные, медицинские или геолокационные данные, а также данные участников других Discord-серверов.

Сроки хранения и надёжность

• актуальные кадровые записи (кто какую должность занимает) — пока участник является сотрудником проекта и пока это необходимо для кадрового учёта;
• журналы операций и аудита — до 12 месяцев, если более длительное хранение не требуется для разбора спорных ситуаций;
• очередь отложенных выдач — 14 дней;
• логи работы — 14 дней (ротация), локальные бэкапы служебных данных — 7 дней;
• по обоснованному запросу пользователя данные удаляются в срок не более 30 дней.

Служебный /health-эндпоинт бота доступен только локально (http://127.0.0.1:8080/health) и не публикуется в интернете.

Правовые документы

• Политика конфиденциальности — раздел RMRP Staff (EN)
• Условия использования — раздел RMRP Staff (EN)
• Полная политика конфиденциальности · Условия использования

Discord является независимой платформой; бот использует официальный Discord API и не связан с Discord Inc. Игровой проект RMRP — независимый проект GTA 5 RP, не связанный с Rockstar Games / Take-Two Interactive.