Справка

Руководство по работе с PM Dashboard

📋

Проекты

Главный раздел — таблица всех IT-проектов с прогрессом, текущим этапом и бюджетом. Фильтр по заказчику — в правом верхнем углу.

Прогресс и этапы

Полоса прогресса отражает долю закрытых вех с учётом их веса. Считается автоматически при синхронизации с трекером.

Текущий этап — этап ближайшей незакрытой активной вехи. Порядок этапов:

Инициация → Исследование → Разработка → Тестирование → Внедрение → Закрытие

Страница проекта

Кликните на название проекта. Откроется детальный вид с вехами по этапам.

  • Закрыть веху — указать дату закрытия и номер акта
  • Сменить этап вехи прямо в таблице
  • Настроить веса этапов (вкладка «Веса этапов») — влияет на расчёт прогресса
  • Gantt-диаграмма — переключатель по этапам или трекам
📄

Акты

Инструмент подготовки акта сдачи-приёмки работ за месяц. Помогает проверить заполненность задач, посмотреть нагрузку по дисциплинам и согласовать данные с исполнителями.

Валидация задач

Задачи отчётного периода разделены на две таблицы:

  • Валидные — заполнены SP, нагрузка и тег проекта
  • Невалидные — есть пропуски. Фильтры Нет SP, Нет нагрузки, Не указан проект помогают разобрать их по типу проблемы

Исполнители

Таблица показывает кто над чем работал: родительские задачи и подзадачи с исполнителями.

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

Сводная таблица нагрузки

Иерархическое представление задач с разбивкой нагрузки по дисциплинам: FE / BE / QA / Anal / UX.

  • Синее число — нагрузка на родительской задаче
  • +N серым — агрегат нагрузки подзадач
  • Строки подзадач показывают индивидуальные значения; дисциплина определяется по префиксу ([backend] → BE, [front] → FE)

Типы задач в таблице:

Story Улучшение ЗНО Ошибка

Исключения из расчёта

Если нагрузка задачи не должна входить в акт (например, работа вне отчётного периода) — добавьте её ключ в блоке «Исключено из расчёта» внизу страницы месяца.

Задача остаётся видна в таблице, но её нагрузка заменяется на — и не суммируется в итогах.

🔍

Ревью

Вехи, не прошедшие автоматическую валидацию при синхронизации с трекером.

  • Нет тега проекта — не выставлен тег с кодом проекта (KSP-10 и т.д.)
  • Нет дедлайна — не указана дата окончания вехи
  • Без этапа — веха есть в базе, но не назначена ни на один этап
  • Orphaned — потеряла тег при синке. Кнопка «Архивировать» скрывает её из всех списков

Чтобы убрать веху из ревью — исправьте данные в Яндекс.Трекере и запустите синк.

⚙️

Настройки

Inline-редактирование данных проектов без захода в трекер. Все изменения сохраняются без перезагрузки.

  • Статус — текущее состояние (В работе, Приостановлен, Завершён…)
  • Этап — текущий этап проекта: Исследование, Разработка или Внедрение; отображается на главной странице
  • Целевой бюджет — уточнённая сумма после этапа исследования; отображается на главной вместо планового
  • Актировано — сумма уже принятых актов
  • Комментарий — заметка, видна только в дашборде
💼

Операции

Раздел для работ вне проектов:

  • Бюджетные статьи — Поддержка, Архитектура, Управление
  • Локальные проекты — работы внутри бюджетной статьи (например, PPU-19 внутри Поддержки)
🔄

Обновление данных

Данные не обновляются автоматически. Запустить синк можно двумя способами:

1
Нажмите кнопку ↻ Синк в верхней шапке — синхронизация запустится прямо в браузере и покажет результат
2
Или выполните команду в терминале:
./sync/update.sh

Что происходит внутри:

  • Скачивает JSON всех задач из Яндекс.Трекера в feroom-yandex-tracker/data/FE/
  • Фильтрует проектные вехи и обновляет базу данных дашборда
  • Закрытые вехи не перезаписываются
После синка в Актах автоматически обновляются данные нагрузки (FE/BE/QA/Anal/UX) — они читаются напрямую из JSON. Список задач спринта (CSV-файлы) синком не обновляется — см. ниже.
📥

Данные для Актов

Список задач спринта и валидация генерируются отдельными скриптами из папки acts/. Запускать после синка трекера.

Шаг 1 — просмотр задач спринта

Фильтрует задачи по спринтам и выводит таблицу в консоль. Спринты задаются в блоке // === CONFIG === в начале файла.

cd feroom-yandex-tracker
npx tsx ../acts/filter-sprint-tasks.ts

Шаг 2 — генерация CSV

Генерирует acts/{месяц}/valid.csv и acts/{месяц}/invalid.csv. Читает JSON из data/FE/issues/ и data/FE/.archive/issues/.

cd feroom-yandex-tracker
npx tsx ../acts/validate-l3.ts

Что попадает в каждый файл:

valid.csv задачи с заполненными SP, нагрузкой и тегом проекта
invalid.csv задачи с пропусками; поле missing_fields указывает что именно не заполнено
Нагрузка считается заполненной если хотя бы одно поле (FE/BE/QA/Anal/UX) > 0 на самой задаче или на любой из её подзадач — так же, как считает сводная таблица дашборда.

Шаг 3 — генерация исполнителей

Генерирует acts/{месяц}/assignees.csv — иерархию родительских задач и подзадач с исполнителями. Спринты задаются в TARGET_SPRINTS в начале файла.

cd ~/Documents/Claude\ Code/feroom-tracker
npx tsx acts/sprint-assignees.ts
Перед новым месяцем обновить TARGET_SPRINTS в начале каждого из трёх скриптов под нужные спринты.