Концепция сервисов¶

Платформа "Библиотека технологий"Ы содержит интеллектуальный слой - AI-сервисы. AI-сервисы - это набор приложений (сервисов), расширяющих функциональность библиотек и интегрирующих их в цифровую среду. Мы предоставляем инфраструктуру, которая позволяет библиотекам легко внедрять современные решения, экономя время и ресурсы на разработке, и фокусироваться на своей основной миссии — работе с читателями и знаниями.

Наша задача — создать инфраструктуру, где:

Библиотеки получают доступ к проверенным, совместимым и постоянно обновляемым цифровым инструментам.
Разработчики находят готовую аудиторию и отработанные механизмы для распространения и монетизации своих решений.
Пользователи (читатели) пользуются удобным и современным цифровым сервисом библиотек.

Модель разработки и распространения¶

Роли участников¶

Разработчик платформы
- Разработка и поддержка платформы
  Обеспечение работы сервисов, API-шлюза, системы аутентификации, учета использования и аналитики.
- Модерация и валидация
  Проверка сервисов на соответствие техническим и правовым стандартам платформы перед публикацией.
- Техническая поддержка
  Консультирование библиотек и разработчиков по вопросам интеграции и использования платформы.
- Вычислительные ресурсы
  Предоставление вычислительных ресурсов для размещения сервисов (опционально).
Разработчики сервисов
- Создание сервисов
  Разработка решений по стандартам платформы. Разработка сервисов может проводиться как разработчиками платформы, так и независимыми командами.
- Поддержка и развитие
  Обновление функциональности и исправление ошибок в сервисах.
- Монетизация и лицензирование
  
  Разработчик самостоятельно выбирает модель распространения своего сервиса:
  - Коммерческая модель
    Получение дохода через платформу по модели оплаты за количество обращений (usage-based) или фиксированной лицензии.
  - Открытая модель
    Публикация сервиса на условиях открытого программного обеспечения или использования без взимания платы. Мы готовы разместить и поддерживать такие решения, так как заинтересованы в распространении технологий и развитии библиотек.
Библиотеки и библиотечные сети:
- Доступ к сервисам
  Получение функциональности в рамках подписки на платформу "Библиотека технологий".
- Интеграция
  - Использование сервисов через единый интерфейс платформы.
  - Использование API отдельных сервисов для самостоятельной интеграции в свои информационные системы.
- Обратная связь
  Участие в формировании требований и улучшении сервисов.

Процесс публикации и распространения сервиса¶

Разработка
Создание сервиса по опубликованным стандартам платформы (см. ниже).
Тестирование
Разработчик размещает сервис в изолированной тестовой среде платформы для проверки корректности работы и интеграции.
Валидация
Разработчики платформы проводят аудит на соответствие требованиям.
Публикация
После одобрения сервис с описанием, документацией и тарифами размещается в общем каталоге платформы.
Использование и распространение
Библиотеки могут подключать сервис. Платформа обеспечивает учёт использования, биллинг и распределение платежей разработчику.

Технические стандарты для разработчиков¶

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

Приложение, размещенное на серверах платформы
- Приложение с готовым API, которое размещается и обслуживается на вычислительных ресурсах платформы. Полное управление инфраструктурой со стороны платформы, высокая доступность и масштабируемость. Предоставить Docker-контейнер или код для развертывания. Поддерживать логику приложения.
- Приложение, предназначенное для пакетной обработки файлов. Размещается на ресурсах платформы. Интеграция в автоматизированные библиотечные потоки обработки данных (например, обработка новых поступлений). Предоставить Docker-контейнер, принимающий файлы и возвращающий результат. Платформа обеспечит вызов через API.
Приложение, размещенное на серверах разработчика Сервис полностью размещен и обслуживается разработчиком на своих собственных ресурсах. Полный контроль над инфраструктурой и версиями у разработчика. Обеспечить доступ со стороны платформы, мы предоставим доступ библиотекам и учёт использования ресурса.

Требования к API¶

Архитектура: RESTful API.
Протокол: HTTP/HTTPS.
Формат данных: JSON для запросов и ответов.
Документация: Обязательное наличие документации в формате OpenAPI (Swagger).
Webhooks (рекомендовано): Поддержка механизма webhooks для уведомления платформы или библиотек о событиях (например, «задача выполнена», «поступило новое сообщение»).
Идемпотентность: Критические операции (создание, изменение) должны быть идемпотентными при передаче уникального ключа запроса.

Следующие шаги¶

Для разработчиков¶

Свяжитесь с нами, чтобы предложить к публикации свой сервис или обсудить идею для разработки. Мы поможем с технической реализацией и интеграцией в платформу.

Для библиотек¶

Посмотрите каталог доступных сервисов или свяжитесь с нами для обсуждения возможностей интеграции с вашей АБИС. Расскажите о требуемых вам сервисах — возможно, они уже в разработке или мы сможем реализовать их в первую очередь.

Контакты¶

почта info@bibtech.ru
телефон +7-983-705-25-73