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

Это руководство для тех, кто обслуживает Ronde в организации: администратора экземпляра на своём сервере, а также владельцев и администраторов рабочего пространства (в облаке или на вашем сервере). Чтобы установить Ronde, начните с руководства по развёртыванию.

Экземпляр

Первый аккаунт, созданный в новом экземпляре, становится его администратором. Он открывает Администрирование сервера из меню пространства слева вверху (/admin), где может:

• видеть, сколько аккаунтов, рабочих пространств и встреч в экземпляре;
• выбрать язык по умолчанию, который используется, когда ни человек, ни его браузер не просят язык, поддерживаемый Ronde;
• решить, кто может создавать аккаунты;
• ввести или удалить лицензионный ключ.

Значения, сохранённые на этой странице, важнее переменных окружения. Собственные настройки каждого пространства (участники, роли, безопасность) остаются в его Настройках.

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

Кто может создать аккаунт

То же самое задаётся через SIGNUP_POLICY (invite-only, domains, open) и SIGNUP_ALLOWED_DOMAINS.

Лицензионный ключ

Функции Team и Enterprise включаются лицензионным ключом, введённым в администрировании сервера или заданным переменной RONDE_LICENSE (переменная главнее и блокирует поле). Ключ проверяется на сервере офлайн: ничего никуда не отправляется. Страница показывает тариф, клиента, дату окончания и число занятых мест.

• Людей больше, чем мест: ничего не блокируется; страница просит обновить лицензию.
• Срок истёк: льготный период в 14 дней сохраняет всё в рабочем состоянии. После него платные функции переходят в режим только для чтения: их содержимое остаётся доступным, но добавить новое нельзя. Функции Community это никогда не затрагивает.
• Образ ronde-ce собран только из открытого кода и не умеет читать лицензионный ключ: для Team или Enterprise используйте образ ronde.

Школы и университеты получают бесплатную лицензию Enterprise: напишите на hello@joinronde.com с адреса вашего учреждения.

Скрыть платные тарифы

Администраторы видят в настройках ненавязчивые подсказки о платных функциях (никогда во время встречи). Укажите RONDE_HIDE_UPGRADE_HINTS=1, чтобы убрать их во всём экземпляре.

Отзывы пользователей

Кнопка в виде облачка вверху страниц (на телефоне — в меню аккаунта) позволяет сообщить о проблеме или предложить идею, при желании со снимком экрана. Вместе с сообщением отправляются адрес страницы (без параметров), браузер, размер окна, язык и версия Ronde. Администраторы читают сообщения в разделе Администрирование сервера, отвечают по электронной почте тем, кто об этом попросил, и могут открыть заполненный issue в проекте Ronde, если проблема в самом Ronde. Если задан SENTRY_DSN, сообщения также попадают в этот проект Sentry как отзывы пользователей. Сообщения удаляются через год; RONDE_FEEDBACK=off убирает кнопку.

Рабочие пространства

Рабочее пространство объединяет людей, встречи, шаблоны и коннекторы команды. Любой, кому разрешена регистрация, может создать его; человек может состоять в нескольких. Настройки находятся в разделе Настройки на боковой панели:

Роли

У каждого участника есть роль в рабочем пространстве:

У каждого человека во встрече есть ещё и роль в этой встрече:

Тот, кто создаёт встречу, становится её ведущим. В Enterprise собственные роли добавляют права участникам и гостям; их права на встречи действуют для всех встреч рабочего пространства.

Люди и приглашения

Справочник общий для всех встреч рабочего пространства: имя человека, день рождения (только день и месяц), профессиональная категория и аккаунты в GitLab или GitHub вводятся один раз. Людей можно добавлять без аккаунта — для встречи, на которую они не входят; приглашение отправляет письмо со ссылкой, действующей 14 дней. Удаление участника закрывает ему доступ; его карточки и история остаются в рабочем пространстве. С SCIM люди, отключённые в вашем каталоге, теряют доступ так же.

Отсутствие

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

Перерыв между встречами

На вкладке «Общее» перерыв между встречами (нет, 5, 10, 15 или 30 минут) остаётся свободным до и после каждой встречи человека. «Найти время» его учитывает, а расписание встречи отмечает даты, которые слишком близко к другой встрече тех же людей.

Вход и единый вход

Редакция Community предлагает аккаунты с почтой и паролем, ссылки для входа по почте, двухфакторную аутентификацию, аккаунты Google, GitHub и Microsoft и один провайдер OpenID Connect для экземпляра (переменные OIDC_*, см. руководство по развёртыванию).

Каждый управляет способами входа в своём аккаунте, в разделе Вход и безопасность: пароль, ключи доступа (Face ID, Windows Hello, менеджер паролей или ключ безопасности), двухэтапная проверка и выход на всех устройствах. Ключи доступа привязаны к домену APP_URL, который должен работать по HTTPS: после смены домена их добавляют заново. Адрес, для которого обязателен единый вход, не может ни добавлять, ни использовать ключи доступа.

В Enterprise вкладка Безопасность рабочего пространства добавляет:

1. Подтверждённые домены. Добавьте свой почтовый домен и показанную DNS-запись, затем подтвердите его. Подтверждённый домен может:
   • забирать новые аккаунты: каждый, кто регистрируется с адресом домена, становится участником рабочего пространства;
   • требовать единый вход: его адреса входят только через ваш провайдер, без пароля и без ссылки по почте. Прежде чем включать, убедитесь, что провайдер у вас работает.
2. Провайдеры идентификации, OpenID Connect или SAML (Okta, Entra ID, Google Workspace, Keycloak…), для адресов ваших подтверждённых доменов. Страница даёт URI перенаправления или URL ответа (ACS) и entity ID, которые нужно указать на стороне провайдера.
3. Корпоративный каталог (LDAP или Active Directory). Люди входят с паролем из каталога. Ronde находит их через служебную учётную запись и проверяет пароль, не сохраняя его. Используйте ldaps:// или ldap:// со StartTLS.
4. Синхронизация пользователей (SCIM). Ваш каталог (Okta, Entra ID, JumpCloud…) создаёт людей, обновляет их имя и адрес и удаляет при уходе. Вкладка даёт точку подключения SCIM и токен.

Экземпляр за аутентифицирующим обратным прокси может вместо этого доверять адресу, который тот передаёт в заголовке (AUTH_TRUSTED_EMAIL_HEADER); делайте так, только если к Ronde больше ничто не может обратиться.

Встречи

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

Встреча начинается с эмодзи своего шаблона, который показывается рядом с её названием в меню; в разделе Настройки › Оформление ведущие выбирают другой эмодзи или загружают изображение (логотип, фото команды).

Сессии сразу

Начать сейчас на карточке встречи проводит сессию немедленно, вне расписания: команда получает уведомление (колокольчик и правила уведомлений «сессия началась»), открывается пульт. Сессия датируется сегодняшним днём; запланированная дата остаётся в расписании. Если начать с пульта сессию, подготовленную на другой день, произойдёт то же самое.

Пример встречи

До первой встречи главная страница пространства предлагает пример: еженедельную встречу с вымышленной командой из пяти человек, историей за месяц (архивные встречи с протоколами, статистикой и действиями) и встречей, готовой к запуску, — всё на языке пространства. Он нужен, чтобы всё попробовать: ничего не отправляет (ни напоминаний, ни писем, ни событий календаря, ни уведомлений), не занимает мест, не отмечает первые шаги и не попадает в аналитику и отчёты пространства. Об этом напоминает баннер на его страницах, а Удалить пример стирает его навсегда вместе с вымышленной командой (участник этой команды, добавленный в другую встречу, остаётся). Его участники отмечены в справочнике как «Пример», и их нельзя пригласить.

Праздничные дни

На вкладке «Общие» пространство выбирает праздники страны, а там, где они различаются, и региона (немецкая земля, испанское автономное сообщество…); новое пространство начинает с праздников страны своего часового пояса. Встреча, выпадающая на такой день, пропускается: готовится следующая дата, напоминания и календари следуют за ней, а расписание называет праздник. В своём расписании встреча может следовать другим праздникам или никаким, а ведущий всё равно может провести или перенести каждую пропущенную встречу. Праздники взяты из проекта date-holidays на основе Википедии (CC BY-SA 3.0).

Гостевые ссылки

В настройках встречи Люди › Гостевые ссылки создаёт секретную ссылку для людей без аккаунта (клиент, совет, партнёр). Она открывает общий экран в прямом эфире и только для чтения — пока не истечёт (от 1 до 90 дней) или пока ведущий её не отзовёт. Ссылка показывается один раз, при создании; Ronde хранит только её хеш.

Проекты и портфель

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

У каждого проекта может быть логотип — рядом с названием и на его шаге во встречах: нажмите на его значок на странице проекта, чтобы выбрать изображение; без логотипа показываются его инициалы на его цвете. Импорт берёт изображение из инструмента: аватар организации GitHub, проекта GitLab или проекта Jira. Сменить или удалить его могут те, кто вправе редактировать проект.

Встреча выбирает свои проекты в разделе Настройки › Проекты. У каждого такого проекта есть вкладка в карточке каждого участника и общая карточка проекта: состояние и главное на сегодня, которые пишут те, кто над ним работает. Добавьте в повестку блок Круг по проектам, чтобы у каждого проекта была своя очередь, где его участники говорят вместе; без него пункты о проекте звучат в очереди каждого человека. Шаблоны Обзор портфеля и Команда и проекты уже содержат этот блок. С тарифом Team панель показывает состояние каждого проекта неделя за неделей, сроки и проекты без новостей, выгружает всё в CSV и добавляет проекты под наблюдением в отчёт по почте. С Enterprise проект может входить в другой, который становится программой (не больше трёх уровней), быть виден только своим участникам и изменяться участниками, а не только ответственным.

Импорт на той же странице переносит проекты из ваших инструментов: репозитории организации GitHub или проекты группы GitLab, вехи репозитория GitHub или проекта GitLab (каждая под именем «репозиторий · веха»), эпики проекта Jira или проекты Linear. Отметьте нужные; уже имеющиеся в портфеле распознаются, и каждый элемент переносится только один раз. Введённый там токен нужен только для этого импорта и не сохраняется:

• GitHub: для публичных репозиториев не нужен; для закрытых — детализированный токен, который может их читать (Metadata, а для вех ещё и Issues).
• GitLab: для публичных групп и проектов не нужен; иначе — личный токен, токен группы или токен проекта с областью read_api.
• Jira: API-токен аккаунта, чья почта указана (id.atlassian.com › Безопасность › API-токены).
• Linear: личный API-ключ.

Участники пространства импортируют с github.com, gitlab.com, Atlassian Cloud и Linear; импорт с другого сервера (GitHub Enterprise, GitLab на собственном сервере, Jira Data Center) и через трекеры задач, сохранённые в настройках пространства, доступен только администраторам пространства. В тарифе Team импорт через такой трекер синхронизирует проекты каждый час: название, статус, сроки и прогресс берутся из инструмента, то, чего инструмент не даёт, остаётся таким, как задано в Ronde (репозиторий даёт своё название и после архивации получает статус «Завершён»), а прогресс виден на карточках в портфеле и на встречах, пока он актуален. На странице проекта есть Обновить сейчас и Отключить синхронизацию. Синхронизация прекращается окончательно по кнопке Отключить синхронизацию, а также когда трекер удалён или указывает на другой сервер, и приостанавливается, пока пространство не на тарифе Team. Элемент, который инструмент больше не находит (удалён или недоступен для токена), проверяется повторно раз в день. Проекты в архиве не обновляются, пока их не восстановят.

Модули

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

Оценка пользы спрашивает всех в конце, насколько полезной была встреча (от 1 до 5 звёзд, со своего экрана или телефона). Среднее появляется, когда есть хотя бы 3 оценки, чтобы никто не угадал чужую оценку; оно попадает в протокол и статистику. Шаблоны коротких ежедневных встреч, встреч один на один и официальных органов (управляющий комитет, советы, педсовет, совещание на стройке, консилиум, разбор инцидентов) оставляют её выключенной.

Экспорт

Страницы со списками выгружают их для электронных таблиц: Экспорт в CSV на странице «Задачи» (все задачи этого вида, включая выполненные более двух недель назад), на странице «Решения» (с поиском и фильтром по встрече), в статистике встречи (одна строка на встречу) и, с тарифом Team, в таблице «Аналитики» и на панели портфеля. Протоколы скачиваются в Markdown или PDF из «Истории». Файлы сразу открываются по столбцам в Excel, LibreOffice или Numbers на языке человека (";" и десятичная запятая на французском, немецком, испанском, итальянском, португальском и русском), а текст, похожий на формулу, остаётся текстом.

Уведомления

Коннекторы — это каналы, куда встречи могут публиковать сообщения: почта, Matrix (Tchap), Slack, Microsoft Teams, Discord, Mattermost или вебхук с подписью HMAC. Владельцы и администраторы добавляют их на вкладке «Общее» рабочего пространства. Затем каждая встреча выбирает в настройках уведомлений, какие события в какой коннектор отправлять: сессия скоро начнётся, началась или закончилась, опубликован протокол, напоминание о карточке, просроченная задача, день рождения.

Каждый понедельник с 8:00 (часовой пояс пространства) каждый участник получает еженедельную сводку по почте: свои встречи на неделе со ссылкой на каждую карточку, открытые задачи и полученные благодарности. Она отправляется, только если в ней что-то есть; каждый отключает её в аккаунте или по ссылке внизу письма. На собственном сервере нужен SMTP_URL; RONDE_WEEKLY_PER_RUN (по умолчанию 150) ограничивает число писем в час, остальные уходят в следующий час.

В Team сценарии уведомлений добавляют к каждому сообщению условия и ваш собственный текст, а ещё два коннектора отправляют SMS и сообщения WhatsApp через Twilio: укажите Account SID, номер отправителя и auth token. Сообщения уходят на мобильные номера, которые люди указывают в профиле (международный формат, +7…), и никогда — отсутствующим. Для WhatsApp отправитель должен быть одобрен в Twilio, а WhatsApp позволяет компании писать первой только по шаблону, одобренному Meta: создайте его в Content Template Builder Twilio с двумя переменными (сообщение, затем ссылка) и укажите его Content SID в коннекторе. Когда рабочее пространство уходит с Team, эти сообщения прекращаются, а журнал каждой встречи объясняет причину.

Карточка по почте: когда экземпляр читает почтовый ящик (INBOUND_IMAP_URL, см. руководство по самостоятельному размещению), напоминание сообщает, что достаточно ответить. Название каждого раздела на отдельной строке, пункты под ним: строки добавляются в карточку человека (ничего не заменяя), а письмо подтверждает, что добавлено. Учитываются только ответы с адреса, на который пришло напоминание (или с адреса учётной записи), в течение 14 дней; наблюдатели и пример встречи исключены.

Push-уведомления: когда у экземпляра есть ключи (см. руководство по самостоятельному размещению), каждый может установить Ronde из браузера (или добавить на экран «Домой» iPhone) и в своей учётной записи включить уведомления для каждого устройства: приближение своей очереди во время встречи в прямом эфире, напоминания о карточке и то, что приходит в колокольчик. Каждый тип можно выключить, устройства перечислены там же.

Интеграции

Токены и секреты, введённые в Ronde, шифруются ключом SECRET_KEY перед сохранением и больше не показываются. Храните этот ключ надёжно: без него их не прочитать.

Токены учётных записей, входящих через Google, GitHub, Microsoft или единый вход, тоже шифруются — ключом AUTH_SECRET.

Slack

В Team владельцы и администраторы нажимают Добавить в Slack на вкладке «Общие» и выбирают канал для уведомлений. Затем:

• напоминания о карточке приходят в личные сообщения, с кнопкой Заполнить карточку, которая открывает разделы встречи в форме Slack; ответы сохраняются в Ronde так, как если бы их ввели на странице;
• выбранный канал становится коннектором, готовым для правил уведомлений встреч (опубликован протокол, скоро встреча…);
• /ronde показывает каждому его ближайшие встречи и открытые задачи по итогам — только ему.

Людей узнают по почте: у аккаунта Slack и профиля Ronde она должна совпадать. Те, кого нет в Slack, по-прежнему получают напоминание по почте. Отключить удаляет приложение из Slack и правила уведомлений, публикующие в его канал. На собственном сервере администратор сначала создаёт приложение Slack экземпляра (см. руководство по самостоятельному размещению).

Microsoft Teams

Владелец или администратор скачивает приложение Ronde для Teams на вкладке «Общее»; администратор Teams загружает его в приложения организации и добавляет в команду. В её канале Ronde публикует карточку: Связать с Ronde открывает Ronde, где выбирают пространство. С этого момента напоминания о карточке приходят личным сообщением людям, найденным в команде (по их почте), с кнопкой, которая превращает сообщение в форму карточки; сообщение «ronde» приложению показывает ближайшие встречи и открытые задачи человека; а канал становится коннектором для правил уведомлений встреч. Удаление приложения из команды или Отвязать в Ronde всё останавливает, и напоминания снова идут по почте.

Notion и Confluence

Владельцы и администраторы добавляют вики на вкладке «Общее»: страницу Notion, которой поделились с внутренней интеграцией (создаётся на notion.so/profile/integrations; поделитесь страницей через ••• › Подключения), или пространство Confluence — в облаке (сайт, ключ пространства, почта аккаунта и API-токен с id.atlassian.com) либо на Data Center или Server (персональный токен доступа). Необязательная родительская страница собирает протоколы вместе. Затем каждая встреча выбирает свою вики в разделе «Настройки › Интеграции»: при каждом архивировании протокол становится страницей с датой встречи и её названием и ссылкой на историю. Изменение резюме обновляет страницу; прошлые встречи публикуются из истории, где неудачная публикация объясняет причину и её можно повторить. Демонстрационные встречи ничего не публикуют.

ИИ-ассистент и расшифровка

В Team ИИ-ассистент готовит резюме сессии и предлагает задачи по итогам; ведущий проверяет всё перед сохранением. Он использует API-ключ Anthropic: ключ экземпляра (ANTHROPIC_API_KEY) или собственный ключ рабочего пространства.

Расшифровка превращает сказанное на сессии в текст, разложенный по очереди круга (сказанное вне круга ни за кем не закреплено). Для неё нужен сервис распознавания речи: OpenAI или ваш собственный сервер Whisper (профиль whisper файла Compose запускает его на той же машине). Каждая встреча должна разрешить её в настройках, все видят баннер, пока сессия записывается, и каждый может исключить свои выступления. Звук удаляется сразу после расшифровки.

Журнал аудита

В Team вкладка Журнал аудита показывает, кто что изменил в рабочем пространстве за последние 90 дней: настройки, людей, роли и встречи, с экспортом в CSV. Enterprise хранит всю историю и может отправлять каждую запись с подписью в вебхук-коннектор для вашей SIEM или платформы журналов.

Резервные копии и обновления

Всё, что хранит Ronde, находится в его базе данных PostgreSQL. Руководство по развёртыванию объясняет, как делать резервную копию, восстанавливать её и переходить на новую версию.