Перейти к основному содержимому

Руководство пользователя дашборда

Найдите риски проекта в дашборде CodeGraph, проверьте свежесть данных и сравните историю. Руководство объясняет навигацию и ограничения действий.

Руководства

Дашборд объединяет сигналы проекта, портфеля, безопасности, выпуска и управления в рабочих областях. Здесь удобно найти проблему и её доказательства. Для углублённого исправления используйте CLI, API или управляемый процесс владельца соответствующего контура.

Вход и выбор области

Откройте /dashboard/login на адресе вашей установки CodeGraph. Для входа нужна выданная учётная запись и доступ к API этой установки. После входа выберите доступный вам проект или группу. API проверяет права пользователя на выбранную область и операцию. Для управления учётными записями требуется роль admin.

После входа откройте /dashboard. Поиск сужает список проектов по имени, организации, команде и другим атрибутам. Выберите период; по умолчанию показано текущее состояние. Дополнительные фильтры в панели экрана задают язык и уровень риска. Откройте справку, чтобы получить доступ к фильтрам организации, команды, среды, критичности, домена и типа сервиса.

Сохранённое представление хранит фильтры панели, базовый период, выбранные для сравнения проекты и формат экспорта. Строка поиска сужает текущий список проектов. Чтобы повторно использовать определённый состав проектов, отметьте их в списке перед сохранением.

Текущие рабочие области

Текущие рабочие области
Маршрут Практическая задача
/dashboard Сводка по портфелю и отфильтрованное состояние проектов.
/dashboard/red-zone Приоритетные риски и переход к деталям.
/dashboard/repositories Зарегистрированные репозитории и синхронизация.
/dashboard/compare Сравнение проектов.
/dashboard/projects Каталог проектов.
/dashboard/projects/:name Один проект: аудит, соответствие, выпуск, поставка, SCA, тренды, память, сессии и документация.
/dashboard/projects/sections/:documentFile Старый маршрут перенаправляет на вкладку документации проекта codegraph. Из имени документа удаляются .md и суффикс _ru или _en; некорректное имя возвращает каталог проектов.
/dashboard/compliance Доказательства соответствия и пробелы.
/dashboard/cross-repo Межрепозиторный анализ.
/dashboard/gitverse Состояние интеграции с GitVerse и доступные действия, если интеграция включена в сборке.
/dashboard/sca Зависимости и состояние уязвимостей.
/dashboard/snapshots Неизменяемая история, ручные снимки, сравнение и экспорт.
/dashboard/notifications Подписки, доставка и каталог уведомлений.
/dashboard/ai-finops Использование ИИ, затраты и эффективность.
/dashboard/security Контекст безопасности и сохранённые представления.
/dashboard/digital-employees Состояние цифровых сотрудников и управляемая работа.
/dashboard/release-control Статус и доказательства управления выпуском, если интеграция включена в сборке.
/dashboard/onboarding-research Управляемое исследование для онбординга.
/dashboard/accounts Пользователи и сервисные учётные записи; требуется роль admin.
/dashboard/service-accounts Переход на /dashboard/accounts?mode=service; требуется роль admin.

GitVerse и управление выпуском по умолчанию отключены в frontend-сборке. При переходе на отключённый маршрут приложение возвращает сводку портфеля. Чтобы использовать эти области, оператор включает маршруты и настраивает соответствующие интеграции API.

Сначала свежесть, затем значение

Карточки показывают актуальность доказательств отдельно от наличия данных:

  • current — доказательство не старше основы анализа;
  • stale — основа анализа новее или не согласована с данными;
  • missing — обязательного доказательства нет;
  • updating — обновление поставлено в очередь или выполняется;
  • failed — последнее обновление завершилось ошибкой;
  • unknown — времени или основы анализа недостаточно, чтобы доказать актуальность.

Ответ также разделяет режим сервера, состояние синхронизации, наличие данных и доступность действия. Если refresh_required имеет значение true, выполняйте рекомендованное действие только при refresh_supported = true и action_availability = available. Старое значение, которое видно во время updating, не становится от этого актуальным.

Типовые задачи

Найти причину риска проекта

  1. Откройте /dashboard/red-zone и сохраните видимыми активные фильтры.
  2. Перейдите к проекту через /dashboard/projects/:name.
  3. Сопоставьте расшифровку индекса здоровья с соответствием, выпуском, SCA и свежестью доказательств.
  4. Откройте доказательство по ссылке, проверьте причину риска и выполните исправление в процессе владельца. Сохраните результат повторной проверки вместе с замечанием.

Сохранить рабочее представление

  1. На /dashboard задайте фильтры и отметьте нужные проекты в списке.
  2. Откройте справку в панели экрана: вместе с ней появится блок «Сохранённые представления».
  3. Введите имя, которое поможет найти область позже, например «Прод-платформа / 90 дней». Выберите формат экспорта по умолчанию: JSON или Markdown.
  4. Нажмите «Сохранить текущее представление». Дождитесь сообщения о сохранении и появления записи в списке.
  5. Нажмите «Открыть» у сохранённого представления. Проверьте восстановленные фильтры, период и выбранные проекты перед сравнением или экспортом.

Сравнить воспроизводимые периоды

  1. Для сравнения проектов отметьте от 2 до 10 проектов в портфеле и откройте /dashboard/compare.
  2. Для сравнения истории выберите период вместо текущего состояния. Нажмите «Показать справку» и найдите блок «История портфеля». В поле «Базовый период» выберите 30, 90, 180 дней или 1 год. Сохраните представление с выбранными параметрами.
  3. Для неизменяемого «до/после» откройте /dashboard/snapshots. Порядок выбора снимков и проверки их основы описан в руководстве по снимкам.
  4. Для экспорта откройте меню «…» в верхней части портфеля и выберите «Экспорт JSON» или «Экспорт в Markdown». Используйте то же представление и периоды; сохраните ревизию доказательств вместе с результатом.

Настроить уведомления

  1. Откройте /dashboard/notifications, выберите вкладку «Подписки», затем «Настройка».
  2. Выберите канал. «Входящие CodeGraph» доставляет события внутри дашборда. Для Telegram, Slack, электронной почты или webhook попросите оператора настроить канал и получателя.
  3. Выберите область: портфель, проект или сохранённое представление. Для области проекта укажите проект, для сохранённого представления — нужное представление.
  4. Откройте раздел «События» через меню вкладки «Подписки». Выберите события по названию и описанию, например «Изменение уровня риска» или «Провал релизного шлюза». Вернитесь в «Настройка», задайте минимальную серьёзность и режим доставки: сразу или ежедневная сводка. Нажмите «Создать подписку» и проверьте новую запись в списке.
  5. Когда выбранное событие произойдёт в указанной области, откройте «Входящие» и проверьте сообщение и статус доставки. В разделе «Доставка» можно проверить очередь и ошибки.

Связанные руководства

Правила интерпретации балла описаны в методологии, эксплуатационные действия — в руководстве оператора.