POST /api/collections/generate-id — Сгенерировать ID коллекции
Как открыть: орг-админ → раздел «Коллекции» → карточка коллекции → редактор; при добавлении слоя, блока или специальности рядом с полем ID есть кнопка «Сгенерировать» — она и вызывает этот метод.
Превращает человеческое название («Бизнес-аналитик», «РЕАЛИЗАЦИЯ») в системный ID в латинице: короткий слаг из 2–4 слов. Для блоков и специальностей — snake_case (business_analyst), для слоёв — UPPER_SNAKE_CASE (IMPLEMENTATION). ID придумывает LLM, поэтому из любого языка получается осмысленная транслитерация, а не побуквенная.
Это лишь подсказка для поля: значение можно отредактировать вручную перед сохранением. Помните, что ID — системный ключ (на него ссылаются блоки, рёбра, специальности), а название — отображаемая надпись; менять их нужно осознанно.
Название обязательно — без него вернётся ошибка 400. Если LLM недоступна, метод не падает, а отдаёт простой слаг из самого названия.
Кто может. Только администратор: орг-админ (для коллекций своей организации) или администратор платформы. Обычный сотрудник получит 403, неавторизованный — 401.
Связанные
Машинная сводка (HTTP, таблицы, связанные требования)
| Поле | Значение |
|---|---|
| HTTP | POST /api/collections/generate-id |
| Auth | requireAuth — только авторизованный |
| Scope токена | read_write |
| PG-функции | — |
| Таблицы | — |
| SRM | SRM-223 |
| RP (права) | RP-103 |
| Файл роута | server/routes/collections.js |
| Статус | done |
Аргументы запроса (best-effort из хендлера; путь-параметры опущены):
| Аргумент | Где | Обяз. | Заметка |
|---|---|---|---|
name | body | подтвердить | |
type | body | подтвердить |
Коды ответов/ошибок (из хендлера): 400, 401, 403 (+ 200) — уточнить причины вручную