Граф проекта
Граф — это основной способ увидеть проект: блоки (ноды) и зависимости между ними (рёбра), сгруппированные по специальностям в «облака ролей». Это не отдельный домен API, а слой визуализации над данными проекта — поэтому методы здесь те же, что в домене Проекты, плюс пара графовых.
Как открыть
После входа откройте любой проект из Списка проектов — проект сразу показывается графом. Если проект ещё не сгенерирован, граф появится после генерации.
Что на экране и что с этим делать
- Ноды (блоки) — этапы работы. Перетаскивание ноды мышью двигает её по холсту
(позиция сохраняется через
PATCH /api/projects/:id/nodes/:nodeId/position). Важно: перетаскивание только меняет раскладку — рёбра мышью не рисуются, связи берутся из генерации (см. ниже). - Рёбра (связи) — причинно-следственные зависимости между блоками. Их строит LLM на этапе генерации; вручную мышью на графе они не создаются.
- Облака ролей — полупрозрачные области, охватывающие блоки одной специальности.
- Клик по ноде — открывает боковую панель с описанием блока и ролями.
- Тулбар — фильтр по специальностям (показать/скрыть роли).
- Play — пошаговый обход графа от блоков-источников к зависимым.
- Гант — представление проекта диаграммой Ганта (
GET /api/projects/:id/gantt).
Методы
Данные графа и действия над проектом — в домене Проекты:
- Получить проект — ноды, рёбра, роли (то, из чего рисуется граф).
- Граф для агента —
компактное/полное представление графа с ETag (
view=summary|full,diff_from). - Сгенерировать граф (SSE) — именно здесь появляются блоки и связи между ними.
- Создать share-ссылку — поделиться графом только на чтение (см. гостевой доступ).
Графовые эндпоинты, специфичные для этого слоя (документированы по коду):
PATCH /api/projects/:id/nodes/:nodeId/position (сохранить позицию ноды) и
GET /api/projects/:id/gantt (диаграмма Ганта).