Коллекции
Домен: Коллекции
Коллекция — шаблон предметной области, по которому строятся проекты: набор слоёв (этапов документа), блоков, специальностей (ролей) и связей между ними, а также промпты трёх этапов генерации. Организация создаёт коллекции под свои задачи; по коллекции создаются спейсы и проекты.
Домен покрывает весь цикл: список и просмотр, создание и (пере)генерацию через LLM, редактирование содержимого (слои/блоки/специальности/связи), промпты этапов, корзину и выдачу межорганизационного доступа.
Доступ. Управляют коллекциями администраторы организации-владельца (создание, правка, генерация, содержимое); участники этой организации видят и используют коллекцию по членству — отдельная выдача прав не нужна. Межорганизационный доступ выдаёт и отзывает только администратор платформы. Подробнее — роли, источник истины прав — матрица RP.
Многие эндпоинты редактирования содержимого не имеют документации в SRM и описаны по коду — это отражено в _generated/drift-report.md (кандидаты на пополнение матриц). Ниже — методы API и экраны домена.
Методы API
| Метод | Эндпоинт | Статус |
|---|---|---|
| Список коллекций | GET /api/collections | done |
| Создать коллекцию | POST /api/collections | код |
| Удалить коллекцию | DELETE /api/collections/:id | done |
| Получить коллекцию | GET /api/collections/:id | код |
| Обновить коллекцию | PUT /api/collections/:id | done |
| Доступы организаций | GET /api/collections/:id/access | код |
| Выдать доступ организации | POST /api/collections/:id/access | код |
| Отозвать доступ | DELETE /api/collections/:id/access/:orgId | код |
| Добавить блок | POST /api/collections/:id/blocks | код |
| Удалить блок | DELETE /api/collections/:id/blocks/:blockId | код |
| Изменить блок | PUT /api/collections/:id/blocks/:blockId | код |
| Удалить связи | DELETE /api/collections/:id/edges | код |
| Связи коллекции | GET /api/collections/:id/edges | код |
| Добавить связь | POST /api/collections/:id/edges | код |
| Последняя применённая генерация | GET /api/collections/:id/last-applied-attempt | done |
| Добавить слой | POST /api/collections/:id/layers | код |
| Удалить слой | DELETE /api/collections/:id/layers/:layerId | код |
| Изменить слой | PUT /api/collections/:id/layers/:layerId | код |
| Промпты коллекции | GET /api/collections/:id/prompts | done |
| Сохранить промпт этапа | PUT /api/collections/:id/prompts/:stage | done |
| Предложить промпт (LLM) | POST /api/collections/:id/prompts/:stage/suggest | done |
| (Пере)генерация коллекции | POST /api/collections/:id/regenerate | done |
| Восстановить коллекцию | POST /api/collections/:id/restore | код |
| Добавить специальность | POST /api/collections/:id/specialties | код |
| Удалить специальность | DELETE /api/collections/:id/specialties/:specId | код |
| Изменить специальность | PUT /api/collections/:id/specialties/:specId | код |
| Доступные коллекции | GET /api/collections/available | код |
| Удалённые коллекции | GET /api/collections/deleted | код |
| Сгенерировать ID коллекции | POST /api/collections/generate-id | done |
Экраны
| Экран | Элементов |
|---|---|
| Коллекции | 13 |
| Редактор коллекции | 17 |