Управление участниками

Team workspace поддерживает до 10 участников (Pro план). Управление участниками осуществляется через email-приглашения с magic link.

Приглашение участников

Приглашение новых участников выполняется через отправку email с magic link:

1. Откройте настройки workspace

   /{workspace-slug}/settings/members

2. Нажмите “Invite Member”

3. Введите email

   Email, на который будет отправлено приглашение

4. Выберите роль

   Admin или Member

5. Отправьте приглашение

   Система отправит email с magic link для присоединения

Параметры приглашения

• token — уникальный токен приглашения
• expiresAt — срок действия 7 дней с момента создания
• email — email получателя приглашения
• role — назначенная роль (ADMIN или MEMBER)

Роли и права

В workspace существует три уровня доступа:

OWNER

Создатель workspace с полным доступом:

• Все права Admin
• Удаление workspace
• Отмена подписки
• Передача ownership
• Управление API ключами

Осторожно

В workspace может быть только один Owner.

ADMIN

Администратор с расширенными правами:

• Все права Member
• Управление настройками workspace
• Создание/редактирование workspace env vars
• Приглашение участников
• Удаление участников (кроме Owner)
• Изменение ролей участников
• Управление API ключами

MEMBER

Базовый участник с ограниченными правами:

• Просмотр всех проектов
• Просмотр проектов (но не создание)
• Управление своими деплоями
• Просмотр логов
• Просмотр списка участников (без управления)

Принятие приглашения

Приглашение принимается через magic link:

/invitations/:token

Процесс принятия

1. Получите email с приглашением

2. Перейдите по magic link

   Ссылка ведёт на /invitations/:token

3. Авторизуйтесь или создайте аккаунт

   Если у вас ещё нет аккаунта — потребуется регистрация

4. Подтвердите присоединение

   После подтверждения вы становитесь участником workspace

Осторожно

Приглашение действительно в течение 7 дней. После истечения срока ссылка становится неактивной.

Обработка существующих участников

• Если пользователь уже состоит в workspace — приглашение отклоняется
• Если email уже связан с аккаунтом — присоединение происходит автоматически после перехода по ссылке

Управление через API

API endpoints для управления участниками и приглашениями:

Участники

# Получить список участников
GET /api/workspaces/{slug}/members

# Изменить роль участника
PATCH /api/workspaces/{slug}/members/{userId}
Content-Type: application/json

{
  "role": "ADMIN" | "MEMBER"
}

# Удалить участника
DELETE /api/workspaces/{slug}/members/{userId}

Приглашения

# Создать приглашение
POST /api/workspaces/{slug}/invites
Content-Type: application/json

{
  "email": "user@example.com",
  "role": "ADMIN" | "MEMBER"
}

# Получить список приглашений
GET /api/workspaces/{slug}/invites

# Отменить приглашение
DELETE /api/workspaces/{slug}/invites/{token}

# Принять приглашение (для получателя)
POST /api/invites/{token}/accept

Права доступа к API

Endpoint	OWNER	ADMIN	MEMBER
GET /members	Да	Да	Да
PATCH /members	Да	Да	Нет
DELETE /members	Да	Да	Нет
POST /invites	Да	Да	Нет
GET /invites	Да	Да	Нет
DELETE /invites	Да	Да	Нет
POST /invites/{token}/accept	Да	Да	Да

API Keys в Team

Workspace-scoped API ключи позволяют автоматизировать операции от имени workspace.

Создание API Key

1. Откройте Team Settings

   /{workspace-slug}/settings/team

2. Перейдите в раздел “API Keys”

3. Нажмите “Create API Key”

4. Укажите название и разрешения

5. Сохраните ключ

   Ключ отображается только один раз при создании

Управление ключами

• OWNER и ADMIN — могут создавать, просматривать и отзывать все ключи workspace
• MEMBER — не имеет доступа к управлению API ключами

Использование API Key

Authorization: Bearer <workspace-api-key>

API Key наследует права роли, с которой он был создан. Например, ключ созданный с правами ADMIN может управлять участниками.

Лимит участников

План	Максимум участников
Hobby (personal)	1
Pro (team)	10

При достижении лимита приглашение новых участников невозможно. Необходимо удалить существующего участника или перейти на Enterprise (свяжитесь с нами).

Удаление участников

1. Откройте /{workspace-slug}/settings/members
2. Найдите участника в списке
3. Нажмите иконку удаления
4. Подтвердите

Осторожно

При удалении участника:

• Он теряет доступ ко всем проектам workspace
• Его деплои остаются
• Проекты, созданные им, остаются в workspace

Изменение роли

1. Откройте /{workspace-slug}/settings/members
2. Найдите участника
3. Кликните на текущую роль
4. Выберите новую роль

Ограничения:

• Owner не может понизить себя
• Нельзя создать второго Owner
• Member не может изменять роли

Передача Ownership

Owner может передать ownership другому Admin:

1. Откройте настройки участников
2. Выберите Admin
3. Нажмите “Transfer Ownership”
4. Подтвердите с вводом slug

После передачи:

• Бывший Owner становится Admin
• Новый Owner получает полные права

Заметка

Owner не может покинуть workspace без передачи ownership.

Доступ к проектам

Все участники workspace видят все проекты. Нет отдельных прав на проекты — доступ определяется ролью в workspace.

Действие	Owner	Admin	Member
Просмотр проектов	Да	Да	Да
Создание проектов	Да	Да	Нет
Настройки проекта	Да	Да	Нет
Удаление проекта	Да	Да	Нет
Деплой	Да	Да	Да
Rollback	Да	Да	Нет

Уведомления участников

Участники получают уведомления о:

• Деплоях своих проектов
• Ошибках сборки
• Проблемах с доменами (Owner/Admin)
• Биллинге (только Owner)
• Новых приглашениях в workspace (email)

→ Настройки уведомлений

Выход из Workspace

Участник может покинуть workspace самостоятельно:

1. Откройте Team Switcher
2. Наведите на workspace
3. Нажмите “Leave”
4. Подтвердите

Заметка

Owner не может покинуть workspace. Необходимо сначала передать ownership или удалить workspace.

См. также

• Workspaces — обзор
• Создание Team Workspace
• Биллинг