Функциональные требования Archivarius¶

Область применения¶

Требования распространяются на веб-приложение Archivarius в составе решения с Flussonic Media Server.

Участники и роли¶

• пользователь интерфейса Archivarius (оператор контента, сотрудник поддержки);
• администратор, подготавливающий конфигурацию и доступы.

Функциональные требования¶

FR-01. Доступ к каталогу¶

Система должна отображать список доступных исходных видеофайлов для выбранного хранилища.

FR-02. Открытие файла в плеере¶

Система должна открывать выбранный файл в интерфейсе плеера с таймлайном.

FR-03. Выбор границ фрагмента¶

Система должна позволять установить метку начала и метку конца фрагмента.

FR-04. Проверка корректности интервала¶

Система должна отклонять запуск обработки, если:

• отсутствует хотя бы одна из меток;
• конец интервала меньше либо равен началу.

FR-05. Запуск подготовки фрагмента¶

По команде пользователя система должна отправлять в Flussonic параметры подготовки фрагмента.

FR-06. Отображение статуса обработки¶

Система должна отображать текущий статус выполнения операции подготовки фрагмента.

FR-07. Доступ к Preview¶

После завершения обработки система должна предоставлять ссылки Preview:

• HLS для проверки результата в плеере;
• File для загрузки файла.

FR-08. Подтверждение выдачи основного результата¶

Система должна требовать подтверждение выдачи итогового результата после оплаты перед отображением секции Скачать.

FR-09. Доступ к основному результату¶

После подтверждения выдачи система должна предоставлять ссылки секции Скачать:

• HLS для потокового просмотра;
• File для скачивания.

FR-10. Обработка ошибок¶

Система должна отображать пользователю диагностическое сообщение при ошибках валидации, интеграции или обработки.

Требования к входным данным¶

Входные данные пользовательского сценария:

• идентификатор/имя исходного файла из каталога;
• временная метка начала фрагмента;
• временная метка конца фрагмента;
• параметры окружения из конфигурации (apiBaseUrl, playbackBaseUrl, sourceVodPrefix, transcodedVodPrefix).

Требования к выходным данным¶

Выходные данные:

• статус операции подготовки;
• ссылки Preview (HLS, File);
• ссылки итогового результата в секции Скачать (HLS, File).

Ограничения и допущения¶

• Archivarius не выполняет медиа-обработку самостоятельно, а использует Flussonic API.
• Корректность итогового результата зависит от доступности Flussonic и конфигурации VOD-хранилищ.
• Развертывание выполняется из образов Docker Hub, поэтому для установки требуется сетевой доступ к Docker Hub для загрузки образов.

Критерии приемки¶

Функциональные требования считаются выполненными, если в тестовом контуре:

1. Пользователь проходит полный сценарий от выбора файла до получения результата.
2. После завершения вырезки пользователю доступна секция Preview с двумя ссылками: HLS (просмотр) и File (скачивание) для проверки результата в low-res.
3. После оплаты становится доступна секция Скачать с двумя ссылками: HLS (просмотр) и File (скачивание) для получения итогового результата в high-res.