Cluster · разработчикам

Администрирование и модерация

Административный режим открывается отдельно от обычного профиля. Нужны назначение администратором в настройках сервера, подтверждённая почта и включённый вход с кодом приложения, если для ID не задано отдельное серверное исключение. Одно наличие пункта меню не даёт права на административный запрос: ядро проверяет роль и сеанс при каждом обращении.

Пользователи

Вкладка «Пользователи» содержит поиск по логину, почте и ID. Нажми на карточку, чтобы получить состояние юзербота, подписку, лимит хранилища и установленные модули.

Профиль можно заблокировать или разблокировать, юзербот можно остановить или запустить. Блокировка отзывает сеансы и останавливает процессы. Снятие блокировки само по себе не запускает юзербота. Текущий администратор не может заблокировать собственный профиль.

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

Маркет

Во вкладке «Маркет» видны публичные, непубличные, скрытые и заблокированные публикации. Есть поиск по названию, описанию, автору и ID. Фильтр «Запрошена проверка» оставляет публикации, у которых хотя бы одна версия ожидает рассмотрения.

Карточка показывает автора, последнюю версию, число версий, установок и запросов проверки. Нажми «Открыть публикацию». Слева появятся версии, справа описание выбранной версии, изменения, права, зависимости и сведения о пакете. На небольшом экране список версий находится над описанием.

Версия

Действия блока «Действия с этой версией» относятся только к выбранному выпуску.

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

Публикация

Блок «Публикация целиком» находится отдельно от действий версии.

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

Проверка данных Cluster

Для разбора конкретного обращения открой профиль пользователя и блок «Проверка данных Cluster». Укажи причину или номер обращения, выбери срок и подтверди действие своим паролем Cluster и кодом приложения. Пароль пользователя для этого не нужен.

Интерфейс предлагает 15 минут, 30 минут, час или два часа. API допускает срок от 5 до 120 минут. Доступ привязан к администратору, юзерботу и конкретной проверке. Другой администратор не может использовать её ID. Повторное открытие после завершения создаёт новый ID; старый больше не принимается.

Доступны:

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

Нажми «Завершить проверку», чтобы закрыть доступ раньше срока. После истечения срока ядро отклоняет новые запросы независимо от состояния страницы. Пользовательская овнерка не меняется, сеанс пользователя не создаётся.

Причина, открытие, завершение и обращения к данным записываются в отдельный журнал. Результаты чтения в этот журнал не копируются. Записи хранятся 30 дней, затем удаляются обслуживанием. Панель показывает последние 100 событий выбранного юзербота. Этот журнал нельзя очистить через пользовательскую операцию logs/clear.

Доступ поддержки

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

Обращения о нарушениях

Для обращения сохраняй причину, ID профиля, время и ссылки на предполагаемое нарушение. Панель не скачивает подозрительные фото или видео для проверки. Жалоба сама по себе не устанавливает факт нарушения, а наличие административной функции не определяет правовое основание обработки данных.

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

Исходники и сравнение версий

В выбранной версии нажми «Исходники и сравнение версий». Режим «Файлы» показывает содержимое опубликованного пакета. Выбери файл в списке: текст откроется с номерами строк. Файлы не выполняются, HTML и другие разметки показываются как текст.

Администратору доступны и закрытые исходники. Пользовательский просмотр и сравнение разрешены только для версий с source=true. Снятие этого флага не запрещает проверку администратором сервиса.

В режиме сравнения выбери «Было» и «Стало». Раздел «Изменения описания, прав и зависимостей» показывает различия в описании версии, запрошенных правах, ограничениях, пакетах Python, зависимостях и интерфейсе. Для первого выпуска можно выбрать пустой пакет. В списке отдельно отмечены добавленные, удалённые и изменённые файлы. В выбранном файле добавленные строки выделяются зелёным, удалённые красным. Номера относятся к соответствующему старому или новому файлу. Счётчик показывает количество строк только в выведенном фрагменте.

Предпросмотр текста ограничен 128 КБ на файл. Файлы выдаются страницами по 500 записей, есть переходы к следующей и предыдущей части пакета. Изменение одного файла показывается до 2000 строк и 192 КБ UTF-8. Сравнение текста с суммарным количеством строк больше 10000 не строится. Двоичные и слишком большие файлы отмечаются отдельно. Хеши позволяют обнаружить изменение двоичного файла, но его содержимое не отображается. При сокращении текста сайт показывает предупреждение. Отсутствие изменений в одной части списка не означает совпадение остальных файлов: проверь следующие страницы. Для полной проверки такого пакета нужны его исходные материалы.

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

Подтверждение профилей

Во вкладке «Галочки профилей» находятся заявки с фильтром по состоянию и переходом по страницам. Открой заявку, проверь описание и ссылки, при необходимости перейди в карточку пользователя. Для отказа требуется комментарий. Решение принимается только для текущей ожидающей заявки: отменённую или уже рассмотренную заявку повторно подтвердить нельзя.

В карточке пользователя галочку также можно выдать или снять без заявки. Выдача галочки при ожидающей заявке сразу отмечает её одобренной. Действия доступны только назначенному администратору, прошедшему проверку режима входа и записываются с его ID и временем. Обычная овнерка, доверка или редактирование профиля этих прав не предоставляют.

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

Двухэтапный вход администратора

Отключение двухэтапного входа, в том числе при восстановлении доступа, не снимает назначенную роль. Без отдельного серверного исключения административные запросы при этом недоступны. Вместо общей ошибки панель показывает предложение настроить двухэтапный вход и кнопку перехода в «Профиль и безопасность». После повторного включения административный режим становится доступен.

Исключение из обязательного второго фактора задаётся только на сервере параметром --admin-without-totp PROFILE_ID вместе с --admin PROFILE_ID. Оно действует только для указанного внутреннего ID и не назначает административную роль само по себе. По умолчанию список исключений пуст. Вход, CSRF, пароль для чувствительных действий и остальные ограничения доступа сохраняются. Если сам профиль включает двухэтапный вход, коды продолжают требоваться в предусмотренных им действиях. При пересоздании аккаунта новый ID исключение не наследует.

Отметка основателя отображается особой галочкой и управляется отдельно от обычной галочки. В карточке такого профиля форма выдачи и снятия обычной галочки не показывается. Попытка изменить её через admin/verification/set возвращает конфликт. Сведения об авторе и его отметка доступны также в административном каталоге и отзывах.