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

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

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

Руководства

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

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

Откройте /dashboard/login. Все остальные маршруты находятся внутри ProtectedRoute и требуют аутентифицированной сессии. Сам факт входа не даёт прав на проект или административное действие: API отдельно проверяет пользователя, проект, группу и операцию. Скрытая или отключённая кнопка не доказывает, что другой пользователь вправе выполнить действие.

После входа начните с /dashboard. Задайте нужные для решения фильтры: проект, группа, организация, команда, среда, критичность, язык, домен, тип сервиса, риск и период. Сохраните представление, если ту же область предстоит повторно сравнивать или экспортировать.

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

Текущие рабочие области
Маршрут Практическая задача
/dashboard Сводка по портфелю и отфильтрованное состояние проектов.
/dashboard/red-zone Приоритетные риски и переход к деталям.
/dashboard/repositories Зарегистрированные репозитории и синхронизация.
/dashboard/compare Сравнение проектов.
/dashboard/projects Каталог проектов.
/dashboard/projects/:name Один проект: аудит, compliance, выпуск, delivery, SCA, тренды, память, сессии и документация.
/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 Пользователи и сервисные учётные записи.
/dashboard/service-accounts Переход на /dashboard/accounts?mode=service.

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

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

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

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

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

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

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

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

  1. Сохраните точное отфильтрованное представление портфеля.
  2. Для проектов откройте /dashboard/compare, для неизменяемого «до/после» — /dashboard/snapshots.
  3. При экспорте используйте то же представление, базовый и сравниваемый периоды.
  4. Сохраните вместе с результатом ревизию доказательств.

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

  1. Откройте /dashboard/notifications.
  2. Выберите поддерживаемую область: portfolio, project или saved view.
  3. Укажите события, критичность, канал и режим доставки.
  4. Подтвердите событие успешной доставки в рабочем контуре. Тестовая отправка доказывает только тестовый путь.

Источники истины

  • frontend/src/App.tsx — актуальная карта маршрутов.
  • frontend/src/components/auth/ProtectedRoute.tsx — граница аутентификации.
  • src/api/services/dashboard/surface_state/surface_freshness.py — состояния свежести и данные о действиях.
  • src/api/routers/dashboard_core/ и src/api/routers/dashboard_domains/ — области и действия API.

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