Профессии в действии¶
Управление интерактивными видеосценариями для LED-платформы. Видеосценарий — это дерево видеофрагментов с точками выбора: после каждого фрагмента зритель выбирает вариант, и воспроизводится следующий фрагмент.
API¶
Видеосценарии¶
| Метод | Эндпоинт | Описание |
|---|---|---|
GET |
/cms/video-scenarios |
Список видеосценариев с фильтрацией по профессии |
POST |
/cms/video-scenarios |
Создать видеосценарий |
GET |
/cms/video-scenarios/{id} |
Получить видеосценарий с деревом веток |
PUT |
/cms/video-scenarios/{id} |
Обновить название, описание, профессию |
DELETE |
/cms/video-scenarios/{id} |
Удалить видеосценарий (если не использовался) |
Ветки¶
| Метод | Эндпоинт | Описание |
|---|---|---|
POST |
/cms/video-scenarios/{id}/branches |
Добавить дочернюю ветку |
PUT |
/cms/video-scenarios/{id}/branches/{branchId} |
Обновить текст варианта или видео |
DELETE |
/cms/video-scenarios/{id}/branches/{branchId} |
Удалить ветку и её дочерние |
Режимы¶
- Список — таблица: название, профессия, количество веток, дата создания
- Карточка — создание / редактирование видеосценария с редактором дерева веток
Действия¶
| Действие | Описание |
|---|---|
| Создать | Новый видеосценарий |
| Редактировать | Изменить название, профессию, структуру веток |
| Сохранить | Сохранить все изменения сценария (название, профессию, дерево веток) |
| Копировать | Дубликат сценария (для создания похожего) |
| Удалить | Деактивация сценария |
Сохранение¶
Все изменения в карточке видеосценария (название, профессия, дерево веток) сохраняются вместе при нажатии кнопки «Сохранить». До сохранения изменения существуют только в интерфейсе и не записываются в базу.
При создании нового сценария кнопка «Сохранить» создаёт сценарий и все его ветки. При редактировании — обновляет изменённые поля и структуру веток (добавленные, изменённые, удалённые).
Валидация при сохранении¶
- Название сценария обязательно
- Каждая ветка должна содержать загруженный видеофайл
- Ветки с дочерними вариантами должны иметь заполненный «Текст вопроса»
- Дочерние ветки должны иметь заполненный «Текст варианта»
- Стартовая ветка не может быть удалена
Карточка видеосценария¶
Основные поля¶
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| Название | string | да | Название сценария (например, «День разработчика», «Как устроена больница») |
| Профессия | → [Profession] | нет | Привязка к профессии из справочника |
Редактор дерева веток¶
Основная часть карточки — редактор дерева веток. Каждая ветка — это видеофрагмент, а дочерние ветки — варианты выбора после него.
Структура редактора¶
Редактор представляет собой список веток текущего уровня с возможностью раскрыть каждую и увидеть её дочерние варианты.
Стартовая ветка — всегда первая в списке, не имеет текста варианта (это начало сценария).
Дочерние ветки — варианты выбора. Каждая имеет текст варианта (то, что увидит пользователь) и видеофайл.
Элементы ветки¶
Каждая ветка в редакторе содержит:
| Элемент | Описание |
|---|---|
| Название файла | Имя загруженного видео |
| Кнопка замены | Загрузить другое видео вместо текущего |
| Поле «Текст вопроса» | Вопрос, который показывается после видео этой ветки (для веток с дочерними вариантами). Скрывается для конечных веток. |
| Поле «Текст варианта» | Текст, который увидит пользователь при выборе этой ветки (для дочерних веток) |
| Кнопка «Удалить» | Удалить ветку и все её дочерние ветки |
| Кнопка «Раскрыть» | Показать дочерние варианты выбора (если есть) |
| Кнопка «+ Добавить вариант» | Добавить дочернюю ветку (вариант выбора после этого видео) |
Работа с редактором¶
-
Создание сценария — заполняются название, описание, выбирается профессия. Стартовая ветка создаётся автоматически.
-
Загрузка видео — для каждой ветки загружается видеофайл через кнопку замены.
-
Добавление вариантов выбора — под каждой веткой кнопка «+ Добавить вариант». При нажатии открывается форма: загрузка видео + поле «Текст варианта».
-
Навигация по дереву — кнопка «Раскрыть» показывает дочерние варианты. Можно раскрывать ветки рекурсивно.
-
Конец сценария — ветка без дочерних элементов автоматически является концом сценария. Кнопка «+ Добавить вариант» отсутствует или создаёт новый вариант.
-
Удаление — удаление ветки удаляет все её дочерние ветки. Стартовую ветку удалить нельзя.
-
Порядок вариантов — дочерние варианты можно перетаскивать для изменения порядка отображения.