GET /api/projects/:id/graph — Граф проекта (для агента)
Как открыть: отдельной кнопки «граф» в интерфейсе нет. Открыв проект со списка, вы уже на графе — это основной рабочий экран; данный метод отвечает за внутренний рендер графа и доступ агентов по токену, а не за отдельное действие пользователя.
Это «голый» граф проекта: только ноды-блоки, связи и роли, без шапки и метаданных проекта. Для человека самостоятельной страницы у него нет — всё, что он отдаёт, вы уже видите на холсте проекта. Полезен он прежде всего внешним агентам, которые читают структуру задачи без лишних данных.
Связанные
Машинная сводка (HTTP, таблицы, связанные требования)
| Поле | Значение |
|---|---|
| HTTP | GET /api/projects/:id/graph |
| Auth | optionalAuth, requireProjectAccess — гость + авторизованный, доступ к проекту (read/write) |
| Scope токена | read |
| PG-функции | api.get_project_graph |
| Таблицы | project, project_node, project_edge, project_node_role |
| SRM | SRM-343 |
| RP (права) | — |
| Файл роута | server/routes/projects.js |
| Статус | done |
Аргументы запроса (best-effort из хендлера; путь-параметры опущены):
| Аргумент | Где | Обяз. | Заметка |
|---|---|---|---|
diff_from | query | подтвердить | |
format | query | подтвердить | |
view | query | подтвердить |
Коды ответов/ошибок (из хендлера): 304, 404, 500 (+ 200) — уточнить причины вручную