Владелец, роли и права

У сервера есть владелец и роли. Владелец - один человек, записанный в config.json; всё остальное - роли и права - настраивается прямо в клиенте и хранится в базе сервера.

#Владелец

Владелец может всё, и его нельзя отключить, заблокировать или понизить из клиента. Его ID лежит в поле ownerId в config.json. Как его туда вписать - в разделе Личность и ID.

Владельцем можно стать и заново: avoice-server set-owner <ID> на машине сервера или вход с паролем владельца, если поле ownerId пустое. Новый пароль выдаёт avoice-server reset-password.

#Роли

Щит на верхней панели → Роли. Роли идут по старшинству: выше по списку - сильнее. Управлять можно только теми, чья роль ниже вашей, выдавать - только роли ниже своей и только те права, что есть у вас.

Роли по умолчанию:

Роли можно переименовывать, перекрашивать (цвет имени в списке людей), создавать свои и двигать стрелками. Права - галочками. Роль для новых людей - кнопка «Сделать ролью для новых» в редакторе роли.

Назначить роль человеку - правый клик по нему → «Роль на сервере», или во вкладке «Пользователи», где видны и те, кого сейчас нет.

#Права в каналах и категориях

Правый клик по каналу → «Права в канале…» (или по категории → «Права в категории…»). Для каждой роли каждое право можно оставить «как у роли», разрешить или запретить. Канал наследует категорию, категория - роль сервера.

Так делаются:

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

#Модерируемый голосовой канал

Правый клик по голосовому каналу → «Модерируемый». Говорят только модераторы и те, кому дали голос. Остальные слушают и могут «поднять руку» - у модераторов рядом с именем появится ✋, и правым кликом можно дать голос.

#Пароль на весь сервер

Щит → «Настройки сервера…» → «Пароль сервера» (или поле serverPassword в config.json). Его спросят один раз у каждого, кроме владельца: сервер запоминает, кто его вводил, пока пароль не сменят. Сменили пароль - все введут новый. Галочка «Убрать пароль» снова открывает сервер. Сервер с паролем не показывается в общем списке серверов.

#Пароль комнаты и запросы на вход

Правый клик по голосовой комнате (у тех, кто может менять каналы, и у создателя временной комнаты):

• «Пароль комнаты…» - войти можно, только введя пароль. Его спрашивают один раз: сервер запоминает, кто его вводил, пока пароль не сменят. Пустое поле убирает пароль. Сервер хранит пароль только в виде хэша.
• «Разрешать запросы на вход» - тот, кто войти не может (нет права, не знает пароля, комната полна), нажимает «Попросить войти».

Запросы видят те, у кого есть право «Впускать по запросам на вход» (по умолчанию у модераторов и администраторов): у комнаты в списке появляется счётчик, в шапке комнаты - кнопка «Запросы», приходят звук и уведомление Windows. «Впустить» даёт человеку ровно один вход в течение 5 минут - без пароля и даже если комната полна; ему приходит уведомление, и если он не разговаривает в другой комнате, AVOICE заходит сам. После отказа новый запрос можно отправить через минуту. Те, кто может впускать, сами входят без пароля.

#Временные каналы

«+» рядом с категорией - у тех, у кого есть право «Создавать временные голосовые каналы» (по умолчанию у участников; можно разрешить только в нужных категориях). Создатель - модератор своего канала. Канал исчезает, когда в нём 15 секунд никого нет. У человека одновременно - один временный канал.

#Модерация

• Перенести человека в другой голосовой канал - перетащить мышью в дереве.
• Правый клик по человеку: выключить микрофон (модератор), убрать из голосового канала, подписать для всех, отключить с сервера с причиной, заблокировать.
• Блокировка - по ключу, по IP или по обоим, на час, день, неделю, месяц или навсегда. Снять - щит → «Блокировки».

#Настройки сервера

Щит → «Настройки сервера…»: название, аватарка (до 512 КБ) и шапка (до 3 МБ), приветствие, описание в Markdown, слоты, людей в комнате, предел файла. Текстовые настройки сохраняются в config.json, картинки - в хранилище сервера.