Управление командами в PanDev Metrics
Кратко. Команды (teams) — это рабочие группы внутри департамента в PanDev Metrics. Создайте команду, перетащите в неё сотрудников, назначьте team lead и привяжите команду к одному или нескольким проектам (репозиториям). Сотрудник состоит в одной команде одновременно. Аудитория: администратор тенанта.
Что понадобится
- Тенант PanDev Metrics, где у вас роль Owner или Maintainer на уровне тенанта, либо Owner / Maintainer в нужном департаменте
- Родительский департамент уже создан — см. Управление департаментами
- Сотрудники, которых добавите в команду, уже приглашены и зарегистрированы — см. Управление сотрудниками
- (Опционально) Список git-репозиториев, которые планируете привязать к команде
Шаг 1 — Откройте страницу «Команды»
В левом меню разверните Организация и откройте Команды. Переключитесь на нужный департамент — список команд всегда привязан к одному департаменту.
Шаг 2 — Создайте команду
Нажмите Создать команду и заполните:
| Поле | Заметки |
|---|---|
| Название команды | Короткое и уникальное внутри департамента, например Backend, Mobile. |
| Описание | (Опционально) Одно предложение о scope. |
Нажмите Создать команду. Команда автоматически создаётся внутри текущего департамента.
Команда не может существовать вне департамента. При удалении родительского департамента команду нужно сначала перенести — иначе PanDev Metrics заблокирует удаление.
Шаг 3 — Добавьте участников из пула «Сотрудники без команды»
PanDev Metrics держит всех сотрудников без команды в отдельном пуле — не нужно помнить, кто ещё не распределён.
- Откройте Организация → Команды → Сотрудники без команды.
- Справа — список всех сотрудников департамента без команды.
- Перетащите сотрудника на карточку нужной команды.
- В появившемся диалоге выберите роль в команде (например,
QA,Tech lead). - Нажмите Подтвердить.
Роли в команде — это метки, описывающие функцию человека. Они не дают и не отнимают доступ — за доступ отвечают роли тенанта и роли департамента. См. Управление сотрудниками и Управление департаментами.
Шаг 4 — Назначьте team lead
Team lead — это человек, ответственный за команду. Чтобы назначить:
- Откройте страницу команды.
- Найдите строку участника и выберите Сделать team lead в меню действий — либо отметьте лейбл team lead при добавлении.
- PanDev Metrics подсвечивает team lead на странице команды и использует его как default-контакт для уведомлений уровня команды.
Рекомендуется один team lead на команду. Чтобы сменить лида, сначала назначьте нового — прежний станет обычным участником.
Шаг 5 — Привяжите команду к проектам
Команды связываются с проектами (репозиториями), чтобы PanDev Metrics знал, какая работа относится к какой команде.
- Откройте страницу команды и перейдите на вкладку Проекты.
- Нажмите Добавить проект и выберите репозитории из списка подключённых git-интеграций.
- Нажмите Сохранить.
После следующего цикла синхронизации в дашбордах, отфильтрованных по команде, появятся commit, PR и IDE-активность из выбранных репозиториев. Один репозиторий может принадлежать нескольким командам.
Шаг 6 — Переместите сотрудника в другую команду
Откройте страницу исходной команды, найдите участника и выберите Перенести в команду. Укажите целевую команду и подтвердите. Сотрудник сразу покидает исходную; роль в команде в новой можно задать заново.
Чтобы убрать человека из команды без переноса в другую, выберите Удалить из команды — он вернётся в пул «Сотрудники без команды» того же департамента.
Шаг 7 — Удалите команду
- Откройте Организация → Команды в родительском департаменте.
- Отметьте команду чекбоксом.
- В нижней панели массовых действий нажмите Удалить.
- Подтвердите.
Участники удалённой команды не уходят из тенанта — они возвращаются в пул «Сотрудники без команды» того же департамента. При необходимости переназначьте их в другую команду.
Проверка
Убедитесь, что всё на месте:
- Команда видна под нужным департаментом в Организация → Команды.
- У каждого участника отображается ожидаемая роль в команде.
- Team lead подсвечен на странице команды.
- Дашборды, отфильтрованные по команде, показывают данные из привязанных репозиториев.
- При удалении команды её участники возвращаются в «Сотрудники без команды», а не пропадают из тенанта.
Решение проблем
Не нахожу сотрудника в списке «Сотрудники без команды»
Список показывает только сотрудников текущего департамента, у которых нет команды. Проверьте, что человек добавлен в этот департамент (см. Управление департаментами) и не состоит ли он уже в другой команде — перейдите туда и сначала удалите его оттуда.
Drag-and-drop не работает в моём браузере
Привязка drag-and-drop использует стандартные HTML5-события. Если не реагирует — попробуйте Chromium-браузер (Chrome, Edge, Arc), отключите расширения, которые могут блокировать drag-события, либо используйте кнопку Добавить участника на странице команды.
Команда показывает ноль данных, хотя коммиты есть
Скорее всего, к команде ещё не привязаны проекты. Откройте страницу команды, перейдите на вкладку Проекты и добавьте нужные репозитории. Данные появятся в течение следующего цикла синхронизации.
Не могу удалить родительский департамент — в нём ещё есть команды
PanDev Metrics блокирует удаление департамента, пока в нём есть команды. Сначала перенесите каждую команду в другой департамент, потом удаляйте исходный. Участники переезжают вместе со своей командой.
FAQ
Чем команда отличается от департамента?
Департамент — крупная орг-единица (например, Engineering). Команда — меньшая рабочая группа внутри департамента (Backend, Mobile). Сотрудник состоит в одной команде; команда принадлежит ровно одному департаменту. Департаменты — для роллапов уровня компании, команды — для view по продуктовым линиям или стекам.
Может ли сотрудник быть в нескольких командах?
Нет. PanDev Metrics держит ограничение «одна команда на сотрудника». Если нужна кросс-командная видимость, дайте человеку более высокую роль тенанта или департамента (Maintainer или Owner) — она и так видит всё в своём scope.
Контролируют ли роли в команде доступ к чему-либо?
Нет. Роли в команде — это метки функции (QA, Team lead и подобные). Доступ контролируется ролями тенанта (Owner / Maintainer / Viewer + Финансист) и ролями уровня департамента (Owner / Maintainer / Viewer + Финансист).
Может ли один репозиторий принадлежать нескольким командам?
Да. Откройте страницу команды, перейдите в Проекты и добавьте репозиторий. Один и тот же репозиторий можно привязать к нескольким командам, если они над ним работают совместно. Активность по репозиторию считается один раз, но появляется в дашборде каждой команды, к которой он привязан.
Что происходит при удалении команды?
Команда исчезает из департамента. Её участники возвращаются в пул «Сотрудники без команды» того же департамента и могут быть переназначены. Исторические commit и задачи, связанные с проектами команды, сохраняются в профилях сотрудников.
Можно ли переименовать команду?
Да. Откройте команду, перейдите в Настройки, измените название и сохраните. Дашборды подхватят новое имя при следующем рендере — старое не сохраняется.
Есть ли API для массового создания команд?
PanDev Metrics не предоставляет публичный API. Внутренние endpoint'ы используются UI, но они не входят в поддерживаемый контракт. Пока пользуйтесь UI-флоу.
Дальнейшие шаги
- Управление департаментами — создайте или реструктурируйте родительский департамент
- Управление сотрудниками — пригласите и онбордьте людей, которых добавите в команды
- Подключите git-интеграцию — убедитесь, что репозитории, которые привязываете к команде, доступны
Связанные материалы
- Reference: Роли в команде vs роли тенанта
- Концепция: Орг-структура в PanDev Metrics