Покер-планирование

КонтурКЭДО

Покер-планирование

Инструкция для команды

О сервисе

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

В оценку входит весь цикл производства: от аналитики до завершения тестирования и релиза web-части.

Майка	Оценка	Диапазон	Комментарий
XS	1–4 дня	до 4 дней	Низкая неопределённость
S	2 недели	от 4 дней до 2 нед.	Низкая неопределённость
M	1 месяц	от 2 нед. до 1 мес.	Средняя неопределённость. Средний риск погрешности
L	3 месяца	от 1 до 3 мес.	Средняя неопределённость. Средний риск погрешности
XL	6 месяцев	от 3 до 6 мес.	Высокая неопределённость. Рекомендуется декомпозиция
XXL	более 6 мес.	более 6 мес.	Высокая неопределённость. Обязательная декомпозиция

XXL-задачи целиком в работу не берём — обязательна декомпозиция на этапы. XL-задачи рекомендуется декомпозировать.

Запуск сервиса

Что нужно

Python 3.6 и выше (уже установлен на рабочих машинах)
Два файла в одной папке: server.py и index.html
Все участники подключены к той же сети (офис или VPN)

Базовый запуск (HTTP)

Положите server.py и index.html в одну папку
Откройте терминал в этой папке
Выполните команду: python server.py
В терминале появится ссылка вида http://192.168.x.x:8080
Отправьте эту ссылку участникам в Mattermost

Сервер работает пока открыт терминал. Для остановки нажмите Ctrl+C. После перезапуска история сессии не сохраняется.

Запуск через туннель (доступ из интернета)

Если участники находятся в разных сетях или VPN недоступен, используйте Cloudflare Tunnel — он даёт публичный HTTPS-адрес без открытия портов:

Скачайте cloudflared с github.com/cloudflare/cloudflared/releases
Запустите сервер: python server.py
В отдельном терминале: cloudflared tunnel --url http://localhost:8080
Cloudflare выдаст адрес вида https://xxxx.trycloudflare.com — отправьте его в Mattermost

Адрес туннеля меняется при каждом перезапуске cloudflared. Сначала запускайте python server.py, затем туннель, и только после этого отправляйте ссылку команде.

Запуск с HTTPS (свой сертификат)

Если у вас есть домен и сертификат, сервер может работать напрямую по HTTPS без туннеля:

Получите сертификат — от Let's Encrypt (certbot) или своего удостоверяющего центра
Запустите сервер с параметрами:
python server.py --cert cert.pem --key key.pem --port 8443
В терминале появится ссылка вида https://192.168.x.x:8443

Для тестирования можно создать самоподписанный сертификат командой:

openssl req -x509 -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365 -nodes -subj "/CN=localhost"

При самоподписанном сертификате браузер покажет предупреждение безопасности. Нажмите «Дополнительно» → «Перейти на сайт» чтобы продолжить. Для постоянного использования рекомендуется сертификат от доверенного центра.

Параметры командной строки

Параметр	По умолчанию	Описание
--port	8080	Порт сервера. Для HTTPS обычно используют 8443
--cert	—	Путь к файлу SSL-сертификата (.pem). Включает HTTPS
--key	—	Путь к файлу приватного ключа (.pem)

Роли участников

Первый пользователь, открывший сессию, автоматически становится ведущим 👑. Все остальные — участники.

Ведущий

Добавляет и удаляет задачи
Выбирает активную задачу для голосования
Запускает и останавливает таймер
Вскрывает карты после завершения голосования
Принимает итоговую оценку или назначает переголосование

Участник

Выбирает оценку из карточек XS–XXL
Видит текущую задачу, список участников и результаты
Ожидает решения ведущего после вскрытия карт

Проведение сессии

Подготовка

Ведущий запускает сервер и отправляет ссылку в командный канал Mattermost
Все участники открывают ссылку в браузере
Каждый вводит своё имя и нажимает «Войти»
Ведущий добавляет задачи в список (можно вставить ссылку на YouTrack — она будет кликабельной)

Голосование по задаче

Ведущий выбирает задачу из списка
При необходимости ведущий запускает таймер (2 минуты)
Каждый участник выбирает карточку: XS, S, M, L, XL или XXL
Карточку можно сменить до вскрытия
Ведущий нажимает «Вскрыть» — все видят карты и диаграмму

Горячие клавиши: 1 = XS, 2 = S, 3 = M, 4 = L, 5 = XL, 6 = XXL

Работа с результатами

Консенсус — все проголосовали одинаково. Ведущий нажимает «Принять» и переходит к следующей задаче.

Большинство — один размер набрал больше голосов. Ведущий принимает оценку большинства или запускает обсуждение.

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

Если оценка задачи кажется неверной — кликните на бейдж с размером в списке задач. Оценка сбросится и задача откроется заново для голосования.

Элементы интерфейса

Панель управления (только у ведущего)

Кнопка	Действие
🔄 Сбросить	Обнуляет все голоса текущей задачи без смены задачи
👁 Вскрыть карты	Показывает голоса всех участников и итоговую диаграмму
→ Следующая задача	Переходит к следующей неоценённой задаче без принятия оценки
✓ Принять и далее	Фиксирует выбранную оценку и переходит к следующей задаче
🔄 Переголосовать	Сбрасывает голоса и позволяет проголосовать заново

Список задач

Ссылки на YouTrack автоматически подсвечиваются и открываются в новой вкладке по кнопке «↗»
Клик по бейджу с размером (XL, S и т.д.) сбрасывает оценку задачи
Кнопка «✕» удаляет задачу
В заголовке панели задач отображается ∑ N pts — суммарный велосити оценённых задач (только в сценарии разработки)

Велосити команды

По мере оценки задач сервис считает суммарный велосити — сумму очков по всем оценённым задачам. Очки соответствуют шкале Фибоначчи:

Майка	Очки	Диапазон
XS	1	1–4 дня
S	2	до 2 недель
M	3	до 1 месяца
L	5	до 3 месяцев
XL	8	до 6 месяцев
XXL	13	более 6 месяцев

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

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

Участники

✓ — участник проголосовал (голос скрыт до вскрытия)
Оценка каждого участника видна всем после вскрытия карт
👑 — ведущий сессии

Тема

Кнопка ☀️ / 🌙 / 🎨 в заголовке переключает между тёмной, светлой и фирменной темой КЭДО — сохраняется между сессиями
Кнопка «✕ Выйти» позволяет сменить имя

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

Ведущий может открыть настройки кнопкой ⚙ в заголовке. Настройки применяются ко всей комнате и синхронизируются между участниками.

Настройка	Описание
Блокировать голос после вскрытия	Участники не смогут изменить карту после того, как ведущий открыл результаты. По умолчанию выключено — карту можно менять до вскрытия в любой момент.
Режим наблюдателя для ведущего	Ведущий управляет сессией, но не участвует в голосовании и не влияет на результаты. Полезно когда ведущий — скрам-мастер или аналитик, а не разработчик. В списке участников рядом с именем ведущего появляется пометка «наблюдатель».

Настройка

Описание

Блокировать голос после вскрытия

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

Режим наблюдателя для ведущего

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

Обе настройки можно включать и выключать в любой момент прямо во время сессии — без перезапуска и сброса голосов.

Экспорт результатов

После того как задачи оценены, ведущий может экспортировать результаты — кнопка ↓ Экспорт в заголовке панели задач. Экспорт доступен в двух форматах.

Скачать CSV

Файл открывается в Excel или Google Таблицах. Разделитель — точка с запятой (Excel-совместимый формат, кодировка UTF-8 с BOM).

Состав столбцов зависит от сценария:

Разработка: №, YouTrack ID, Задача, Оценка (XS / S / M / L / XL / XXL)
Бизнес-критерии: №, YouTrack ID, Задача, Охват, Выручка, Затраты, UX, Критичность, Сумма

Задачи без оценки тоже попадают в файл — со значением «—». Это удобно чтобы видеть что ещё не оценено.

Записать в YouTrack

Сервис умеет обновлять поле задачи в YouTrack напрямую через API — без ручного копирования оценок.

Откройте экспорт кнопкой ↓ Экспорт
Прокрутите до раздела «Отправить в YouTrack»
Укажите URL вашего YouTrack (напр. https://yt.skbkontur.ru)
Вставьте токен с правом на обновление задач
Укажите имя поля в YouTrack, куда записывать оценку (напр. Size для разработки, Business Score для бизнес-критериев)
Нажмите Записать в YouTrack — прогресс по каждой задаче будет виден в таблице

Настройки YouTrack (URL, токен, имена полей) сохраняются в браузере — вводить их каждый раз не нужно. Токен нигде не передаётся на сервер покера — запросы идут напрямую из браузера в YouTrack.

Как получить токен YouTrack

Откройте YouTrack и перейдите в свой профиль
Раздел Аутентификация → Новый токен
Дайте токену право YouTrack (чтение и запись задач)
Скопируйте токен — он показывается только один раз

Комнаты — несколько команд одновременно

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

Создать новую комнату

Откройте страницу сервиса в браузере
Введите своё имя и оставьте поле «Код комнаты» пустым
Нажмите «Войти» — сервер автоматически создаст комнату и выдаст код вида AB34
Поделитесь кодом с командой в Mattermost

Подключиться к существующей комнате

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

Код комнаты отображается в правой колонке под списком участников. Нажмите на него или на кнопку «📋 Скопировать код» — код скопируется в буфер обмена.

Как это работает

Комната создаётся автоматически при первом входе без кода и живёт пока в ней есть хотя бы один участник
Когда все участники покидают комнату, она удаляется — все задачи и голосования не сохраняются
При обновлении страницы браузер запоминает код комнаты и автоматически переподключается к ней
Коды комнат не чувствительны к регистру — AB34 и ab34 ведут в одну комнату

Типовой сценарий для двух команд

Ведущий команды разработки создаёт комнату (код AB34) и отправляет его в канал разработчиков. Ведущий бизнес-команды создаёт свою комнату (код XY78) и отправляет в канал продукта. Обе команды работают независимо на одном запущенном сервере.

Частые вопросы

Страница не открывается

Убедитесь, что server.py запущен в терминале
Проверьте подключение к сети (офис или VPN)
Попробуйте открыть ссылку в другом браузере

Голоса не синхронизируются

Красный индикатор в заголовке — нет связи с сервером
Убедитесь, что ведущий не закрыл терминал
Обновите страницу (F5) — при работающем сервере сессия восстановится

Нужно сменить ведущего

Перезапустите сервер (Ctrl+C, затем снова python server.py) и войдите в нужном порядке — первый вошедший станет ведущим.