POST /api/collections/:id/group
Как открыть: Редактор коллекции → граф коллекции → выделите два или больше блока (Ctrl/Shift-клик) → в боковой панели нажмите «Сгруппировать в блок».
Объединяет несколько выделенных блоков в один новый. Имя, описание, слой и специальности нового блока пишет модель — вы можете задать ей необязательный ориентир (например, «назови блок по итоговому результату»). Внешние связи выделенной группы переходят на новый блок с сохранением направления: если сосед указывал на один из старых блоков, теперь он указывает на новый; если из группы шла связь к соседу — она идёт от нового блока. Связи, которые были внутри группы, отбрасываются. По завершении на месте нескольких блоков остаётся один, он выделяется автоматически, а модаль показывает отчёт «Было — N блоков → Стало — 1 блок» со списком перевешенных связей.
Операция обратима: «Отменить» (Ctrl+Z) вернёт исходные блоки.
Ограничения: только для администратора коллекции (org_admin — своей коллекции, owner_org_id). Нужно выделить минимум два блока. Ручного выбора слоя нет — его подбирает модель из доступных слоёв коллекции (при неоднозначности берётся слой первого блока группы).
Связанные
- Экраны: Редактор коллекции
- Конвенции · Роли · Ошибки · Глоссарий
Машинная сводка (HTTP, таблицы, связанные требования)
| Поле | Значение |
|---|---|
| HTTP | POST /api/collections/:id/group |
| Auth | — |
| Scope токена | read_write |
| PG-функции | api.group_collection_blocks |
| Таблицы | collection_block, collection_edge, generation_job |
| SRM | SRM-365 |
| RP (права) | — |
| Файл роута | server/routes/collections.js |
| Статус | done |
Аргументы запроса (best-effort из хендлера; путь-параметры опущены):
| Аргумент | Где | Обяз. | Заметка |
|---|---|---|---|
block_ids | body | подтвердить | |
guidance | body | подтвердить | |
mode | query | подтвердить |
Коды ответов/ошибок (из хендлера): 202, 400, 429, 500 (+ 200) — уточнить причины вручную