Документация

Каждый объект имеет два индикатора здоровья:

Итоговый (эффективный) статус = ручной статус (если установлен) или автоматическое здоровье. Светофор: GREEN (всё в порядке), YELLOW (предупреждения), RED (проблемы).

Главная страница (/) показывает сводную информацию по всему портфелю:

• Общее количество сегментов, программ, инициатив, задач и связей
• Диаграммы распределения по статусам, меткам и здоровью
• Таблица здоровья сегментов с агрегированными показателями
• Элементы, требующие внимания (просроченные, с проблемами)
• Прогресс вех, открытые развилки, последние изменения
• Кнопка «Рассчитать здоровье» для пересчёта всех объектов

Глобальный поиск доступен в боковой панели и по сочетанию клавиш ⌘K (macOS) или Ctrl+K (Windows/Linux).

• Поиск выполняется по всем типам объектов: сегменты, программы, инициативы, задачи
• Ищет по названию, описанию, ответственному, ключевому описанию, AS IS и целевому состоянию
• Результаты сгруппированы по типу объекта с индикаторами здоровья
• Клик по результату — переход на карточку объекта
• Кнопка графа (иконка) — переход на граф с выделением найденного узла
• Навигация клавиатурой: стрелки ↑↓ для выбора, Enter для перехода, Esc для закрытия

Каждый тип объекта имеет страницу списка и страницу детальной информации:

• Списки (/segments, /programs, /initiatives) — таблица с фильтрацией и кнопкой создания
• Карточка объекта — редактирование полей, описание «as is», целевое состояние, ограничения, матрица влияния, атрибуты
• Вкладки — связи, вопрос-ответ (Q&A), развилки, задачи/инициативы, вехи, риски, история изменений
• Здоровье — автоматический и ручной индикаторы, описание проблем, кнопка пересчёта

Страница /graph — интерактивная визуализация всех объектов и связей на основе @xyflow/react.

• Фильтрация по типам объектов, статусам и сегментам
• Переход из поиска — найденный объект автоматически выделяется на графе
• Создание связей через кнопку «Связь» — выбор источника и цели
• Контекстное меню для быстрых действий (открыть, создать связь)
• Кнопка «Здоровье» — запуск расчёта, результат отображается цветом узла
• Автоматическая раскладка (dagre): горизонтальная или вертикальная (настраивается)
• Zoom, pan, легенда типов связей

Страница /roadmap — временная шкала (Gantt chart) с квартальными и годовыми разделителями.

• Иерархический вид: сегмент → программа → инициатива → задача
• Стрелки зависимостей: красные сплошные — пререквизиты, зелёные пунктирные — влияния
• Вехи отображаются ромбами: красные — ожидающие, зелёные — завершённые
• Настройки: показ/скрытие дат, статуса, ответственного и связей
• Фильтрация по типам, статусам и сегментам
• Зум (Ctrl + колесо мыши) и горизонтальное панорамирование

Три типа связей между объектами любого уровня иерархии:

Связи можно создавать/удалять на странице объекта (вкладка «Связи»), через граф и при создании развилок. Связи поддерживают якоря для корректного отображения стрелок на таймлайне (начало/конец).

Вехи (Milestones) привязаны к инициативам. Каждая веха имеет описание, дату и статус завершения. Управление вехами доступно на странице инициативы.

• Отображаются на роадмапе в виде ромбов — клик для переключения статуса
• Учитываются при расчёте здоровья (просроченные вехи = RED, отсутствие вех = RED)
• Влияют на расчёт прогресса инициативы (30% вес)

Развилки (Decision Forks) — вопросы, требующие решения, привязанные к инициативам или задачам.

• Каждая развилка содержит варианты решений с возможностью пометить утверждённый вариант
• Статусы: Открыта, Решена, Отложена
• Развилки могут быть привязаны к связям — нерешённая развилка на зависимости даёт RED
• Открытые развилки дольше 14 дней подсвечиваются в системе внимания

Для сегментов, программ и инициатив доступны HTML-отчёты (кнопка «Отчёты»). Для сегментов и программ система поддерживает 5 типов отчётов, каждый из которых ориентирован на свою аудиторию:

Для инициатив доступны пресеты «План завершения», «Полный» и «Кастомный». Кнопку «План завершения» также можно найти в быстрой карточке объекта на графе (для сегментов, программ и инициатив).

Для каждого пресета (кроме «Полный» и «Кастомный») можно настроить состав блоков — нажмите «Настроить» рядом с выбранным пресетом в модалке, или настройте глобально на странице /settings.

Доступные блоки отчёта:

• Ключевые KPI (с трендом здоровья за 2 недели)
• Требует внимания руководства (RED-инициативы, просроченные вехи, блокеры, открытые развилки с зависимостями)
• Резюме с KPI: статус, здоровье (авто + ручной), описание, актуальность
• Стратегическая трансформация (компактный AS IS → Ограничения → Цель)
• Стратегическое видение, дерево структуры, граф зависимостей
• Встроенные Gantt-диаграммы (полная и упрощённая — только программы)
• Детальный расчёт здоровья, матрица влияния
• Проблемы и риски, открытые решения, зависимости и блокеры
• Ближайшие вехи, изменения за 2 недели
• План завершения (обзор + процесс выполнения с зависимостями)

На странице /settings доступен обмен данными через Excel:

• Экспорт — выгрузка всех данных в .xlsx (листы: сегменты, программы, инициативы, задачи, вехи, связи)
• Импорт — загрузка из .xlsx с upsert-логикой (существующие записи обновляются, новые создаются)
• После импорта отображается статистика (количество объектов по типам)

Все основные сущности поддерживают поле Jira Key для привязки к задачам Jira. Подключение настраивается в /settings: URL, email, API-токен, включение/выключение.

Страница /settings позволяет:

• Переключать тёмную/светлую тему
• Выбирать направление графа (горизонтальное / вертикальное)
• Настраивать состав блоков для каждого пресета отчётов: «Для руководства», «Для менеджеров», «Обзор (Overview)»
• Редактировать названия и описания типов связей
• Настраивать подключение к Jira (URL, email, API-токен)
• Экспортировать/импортировать данные (Excel)

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

Собственные проверки программ/сегментов:

• INVALID_DATES — дата окончания раньше начала (RED)
• OVERDUE_NOT_STARTED — не начата вовремя (RED)
• OVERDUE_NOT_COMPLETED — просрочена (RED)
• NO_OWNER — нет ответственного (YELLOW)
• NO_DATES — нет дат (YELLOW)
• ON_HOLD — приостановлена (YELLOW)
• MANUAL_STATUS_STALE/AGING — устаревший ручной статус (RED/YELLOW)

Ответственный может установить ручной статус (GREEN / YELLOW / RED) с описанием и списком проблем. Ручной статус имеет приоритет над автоматическим:

Система контролирует актуальность ручного статуса:

• 14+ дней без обновления → предупреждение (YELLOW: MANUAL_STATUS_AGING)
• 21+ дней без обновления → проблема (RED: MANUAL_STATUS_STALE)

При изменении любого объекта здоровье автоматически пересчитывается вверх по иерархии (в фоновом режиме):

При каждом пересчёте создаётся снимок здоровья (HealthSnapshot) с кулдауном 1 час, что позволяет отслеживать динамику через график тренда.

Система автоматически собирает элементы, требующие немедленного внимания. Используется на дашборде для приоритизации действий.

Каждая инициатива может содержать список рисков (хранятся в JSON). Каждый риск имеет:

• Описание — текст риска
• Критичность — Высокая, Средняя, Низкая
• Срок митигации — дата, к которой риск должен быть обработан
• Статус — Открыт, Митигация, Закрыт

Риски влияют на автоматическое здоровье: открытый HIGH-риск → RED, отсутствие/просрочка срока митигации → RED, открытый MEDIUM-риск → YELLOW, приближение срока → YELLOW.

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

Уровни: нет влияния, незначительное, значительное, новое/критическое. Отображается в виде heatmap на карточке объекта и в обзорном отчёте.