Что такое VibeGantt
VibeGantt — это лёгкий планировщик роадмапов и диаграмм Гантта поверх данных Jira. Он не пишет ничего обратно в Jira: задачи и эпики только читаются, а планирование (даты, длительности, зависимости, ресурсы) хранится отдельно — в браузере и на общем сервере.
Основные сущности:
- Проект — контейнер задач. Бывает импортированным из Jira (project-контейнер с эпиками) или пустым (ручным).
- Задача — карточка из пула, которую вы размещаете на таймлайне.
- План — расположение задач во времени с длительностями, зависимостями и назначенными ресурсами.
- Baseline — зафиксированный снимок плана для сравнения «план / факт».
Быстрый старт
- Откройте Настройки и укажите адрес Jira и API-токен, проверьте соединение.
- На главной нажмите + Новый проект: вставьте ссылку на project-контейнер Jira, выберите проект из списка или создайте пустой проект.
- Откройте проект — попадёте на Gantt. Слева находится пул задач, справа — таймлайн.
- Перетащите задачи из пула на таймлайн, задайте им длительность и при необходимости свяжите зависимостями.
- Назначьте исполнителей/команды из каталога Ресурсов.
- Нажмите Сохранить. Сводку по всем проектам смотрите в Общем роадмапе.
Проекты (главная)
Главный экран показывает все сохранённые проекты карточками со статусом, сроками и счётчиками задач.
- Поиск — фильтрует проекты по названию или коду.
- Сортировка — по дате сохранения, статусу, старту плана или числу задач.
- Фильтры по статусу (красный / жёлтый / зелёный) — над сеткой карточек.
- История на карточке — открывает версии проекта с возможностью восстановления.
- Верхние кнопки ведут в Общий роадмап и Ресурсы.
Подключение Jira
В разделе Настройки задаются параметры доступа к Jira:
- Jira Base URL — адрес вашей Jira, например
https://jira.company.com.
- API Token — персональный токен. Запросы уходят с заголовком
Authorization: Bearer <token>.
- Проверить соединение — быстрый тест доступа к Jira с текущими настройками.
Jira вызывается напрямую из браузера, поэтому Jira должна разрешать CORS для адреса приложения. Токен хранится локально — не передавайте его третьим лицам и не публикуйте.
Ниже на экране показаны справочные параметры импорта (Project JQL, лимит, Epic Link clause) — они используются только для чтения из Jira.
Создание проекта
Кнопка + Новый проект открывает три способа добавления:
- Проект по Jira-ссылке — вставьте ссылку на project-контейнер (например
/browse/PROJECT-123). Приложение загрузит сам контейнер, связанные с ним эпики и задачи каждого эпика.
- Выбор из списка — проекты, найденные по Project JQL; нажмите «Обновить список», чтобы перезапросить.
- Пустой проект — контейнер без привязки к Jira, для эпиков, инициатив или разовых задач. Укажите название и код.
В уже открытый проект можно добавлять отдельные Jira-задачи или эпики прямо из пула задач — полем «Jira URL задачи или Epic».
Черновики
Кнопка + Черновик создаёт локальную задачу (ключ вида DRAFT-1) с оценкой 16 ч по умолчанию. У черновика можно менять название, оценку, старт и длительность. Черновики хранятся в плане проекта и не пишутся в Jira.
Что читается из Jira
Для задач подтягиваются статус, тип, исполнитель, команда, компоненты, связи и оценки: DEV / TEST / Total и остатки. Для project-контейнера дополнительно — статус доставки, плановые даты старта/финиша и релизные даты (High-Level / Planned Release Date), если они заданы в Jira; они показываются в заголовке проекта.
Планирование на Gantt
Рабочая область проекта состоит из пула задач слева и таймлайна справа. Таблица слева от таймлайна содержит колонки, ширину которых можно менять перетаскиванием границ (значения запоминаются):
- Задача — ключ Jira и название.
- Владелец / команда — исполнитель или команда (поле Team из Jira).
- Статус — статус задачи из Jira.
- Оценка — суммарная оценка в часах.
- FF — фокус-фактор (см. ниже).
- Расчёт — вычисленная длительность в календарных днях.
Пул задач
- Поиск по названию/ключу и фильтры по типу, проекту и статусу (множественный выбор).
- Чип «Не размещены» — показывает только задачи, которых ещё нет на таймлайне.
- Чип «Закрытые» скрывает закрытые задачи; состояние запоминается.
- Задачи сгруппированы по эпикам — группы можно сворачивать.
- Панель можно свернуть и менять её ширину перетаскиванием разделителя (от 220 px до половины экрана).
- Поле «Jira URL задачи или Epic» добавляет в проект отдельную задачу или эпик целиком.
- + Черновик — создаёт локальную задачу без Jira (см. раздел «Создание проекта»).
Размещение и редактирование на таймлайне
- Перетащите задачу из пула на нужную дату таймлайна, чтобы запланировать её. Бросок на строку существующей задачи задаёт порядок (выше/ниже).
- Двигайте полосу по горизонтали — меняется дата начала; перетаскивание на другую строку меняет порядок.
- Тяните за края полосы — меняется длительность (начало или конец).
- Начало автоматически «прилипает» к ближайшему рабочему дню. Нерабочие дни (выходные и праздники) подсвечиваются и не входят в длительность задачи.
- Сегодня — прокручивает таймлайн к текущей дате (она отмечена на сетке).
- Очистить — снимает все задачи с таймлайна (с подтверждением).
Длительность и фокус-фактор (FF)
Фокус-фактор отражает, какую долю рабочего дня человек реально тратит на задачу. По умолчанию 0,6, диапазон 0–1, шаг 0,05. Расчётная длительность считается по формуле:
дни = оценка(ч) ÷ 8 ÷ FF, результат округляется вверх, минимум 1 день.
Например, при оценке 16 ч и FF 0,6 получится 16 ÷ 8 ÷ 0,6 ≈ 3,33 → 4 дня. FF меняется прямо в колонке таблицы или в инспекторе; колонка «Расчёт» пересчитывается на лету. Фактическую длительность полосы можно задать и вручную — она хранится независимо от расчётной.
Карточка задачи
Клик по полосе или по элементу пула открывает инспектор задачи справа. В шапке — ключ со ссылкой в Jira и название. В сводке показаны:
- Статус, тип задачи, команда и компонент.
- Где задача (на Gantt / в пуле), дата старта, длительность в днях, оценка в часах, FF и расчётные календарные дни.
- Оценки DEV / TEST, если заданы в Jira.
- Зависимости (блокирует / заблокирована) со ссылками на связанные задачи.
В форме редактируются старт и длительность. Для черновиков дополнительно доступны название и оценка в часах (FF и кал. дни — только для чтения). Ниже — блок назначения ресурсов.
Действия в шапке зависят от задачи: «Убрать с Gantt» (вернуть в пул), «Удалить черновик» или «Удалить из проекта» (для задач, добавленных по ссылке).
Зависимости
Зависимости берутся из связей Jira типа «blocks / is blocked by». На таймлайне они рисуются стрелками между полосами, что помогает видеть последовательность работ и конфликты сроков.
- В инспекторе задачи связи сгруппированы по типу; блокирующие и заблокированные выделяются цветом.
- Завершённые связанные задачи помечаются как выполненные.
- Зависимости не создаются вручную внутри VibeGantt — управляйте связями в Jira и обновляйте проект через Sync.
Baseline и Sync
Baseline (план/факт)
- Зафиксировать baseline — сохраняет текущую раскладку как эталон (нужна хотя бы одна задача на Gantt).
- Переключатель Baseline накладывает эталонные полосы поверх текущих для сравнения.
- Рядом отображается сводка отклонений: сколько задач добавлено, сдвинуто (изменён старт или длительность), убрано, а также насколько сдвинулась дата завершения проекта (например
+5д).
- Обновить baseline перезаписывает эталон текущим планом; Удалить baseline убирает его.
Sync Jira
- Перечитывает задачи проекта из Jira (статусы, оценки, новые/удалённые задачи), сохраняя вашу раскладку на таймлайне.
- Изменения показываются в окне предпросмотра — их можно применить или отменить. Если данные не изменились, об этом сообщается.
Производственный календарь
Кнопка Календарь в шапке открывает общий производственный календарь:
- Обычные выходные — отметьте дни недели, которые считаются нерабочими (по умолчанию суббота и воскресенье).
- Праздники и нерабочие даты — список дат в формате
ГГГГ-ММ-ДД (по одной на строку или через запятую).
- Рабочие переносы — даты, которые считаются рабочими, даже если попали на выходной.
Перед сохранением показывается сводка изменений и запрос подтверждения. Нерабочие дни подсвечиваются на таймлайне и исключаются из длительности всех задач.
Календарь общий для всех проектов и сохраняется по принципу «последний победил». Изменения влияют на расчёт дат и длительностей везде, поэтому проверяйте список дат перед применением.
Ресурсы и нагрузка
Раздел Ресурсы — это общий каталог команд и людей компании, доступный всем проектам.
- Вкладка Ресурсы — управление каталогом: имя, активность ресурса, периоды доступности и отсутствий (отпуска), отображаемые на временной шкале ресурса.
- Вкладка Нагрузка — кросспроектная загрузка по периодам: видно, где один и тот же ресурс перегружен сразу несколькими проектами. Клик по ячейке показывает список задач, формирующих нагрузку. Столбец текущей недели подсвечивается в заголовке и по всей колонке.
Назначение на задачу
- В инспекторе задачи на Gantt добавляйте назначения кнопкой «+ Назначить»: выберите ресурс и укажите часы (минимум 0,5).
- На одну задачу можно назначить нескольких разных ресурсов; повторно один и тот же ресурс выбрать нельзя.
- Назначенные часы формируют кросспроектный расчёт нагрузки.
При удалении ресурса из каталога его назначения каскадно убираются из планов всех проектов.
Общий роадмап
Роадмап показывает запланированные задачи по всем проектам на одной шкале времени, сгруппированные по проектам.
- Масштаб — 2 недели, месяц, квартал или год; уровень запоминается.
- Статус — фильтр проектов по цвету статуса (красный / жёлтый / зелёный).
- Свернуть / развернуть все — управление группами проектов; состояние свёрнутых проектов сохраняется.
- Сегодня — переход к текущей дате; чип «Закрытые» скрывает закрытые задачи.
- Полосы можно перетаскивать и менять их длительность прямо на роадмапе; кнопка Сохранить записывает изменения в соответствующие проекты.
Сохранение и история версий
Кнопка Сохранить записывает изменения плана. Каждое сохранение фиксирует краткое описание (что добавилось, сдвинулось, изменилось) и добавляет запись в историю — хранится до 10 версий.
- При выходе с несохранёнными изменениями приложение предложит сохранить их (со списком изменений).
- Кнопка История на карточке проекта открывает список версий с описаниями и датами; любую версию можно восстановить.
- Сохранение каждого проекта идёт с проверкой ревизии. Если кто-то изменил тот же проект параллельно, вы получите сообщение о конфликте — нужно перечитать актуальную версию.
Экспорт PNG
Кнопка Экспорт PNG на Gantt собирает автономный снимок плана (отдельным SVG) и скачивает его картинкой — удобно для отчётов и презентаций. В снимок попадают задачи, их полосы и сетка таймлайна.
Хранение данных
VibeGantt хранит данные в двух местах:
- Браузер (localStorage) — настройки Jira и токен, ширина панели и колонок, состояние фильтров и зум роадмапа. Эти настройки локальны для вашего браузера.
- Сервер — проекты с планами и историей, общий производственный календарь и каталог ресурсов. Доступны всем, кто открывает сервис.
- Проекты сохраняются по одному, с проверкой ревизии (защита от затирания параллельных правок).
- Календарь и каталог ресурсов сохраняются по принципу «последний победил» — без проверки конфликтов.
Доступ и режим просмотра
Если включён общий пароль, вход выполняется на отдельной странице. Возможен режим просмотра — тогда в шапке появляется бейдж «Только просмотр», а кнопки редактирования и сохранения скрыты: данные можно смотреть, но не изменять.
Данные общие: нет пользователей, ролей и разграничения прав по проектам. Все, у кого есть доступ, работают с одними и теми же проектами, календарём и ресурсами.
Частые вопросы
Изменения в плане попадают в Jira? Нет. Запись в Jira не реализована — приложение только читает данные.
Почему не загружается Jira? Чаще всего из-за CORS: Jira должна разрешать обращения с адреса приложения. Проверьте также Base URL и токен в настройках.
Где хранятся мои планы? В браузере (localStorage) и на общем сервере. Календарь общий и сохраняется по принципу «последний победил».
Есть ли автоматическое планирование? Нет, планирование ручное — критического пути и авто-распределения мощностей пока нет.