Что такое приложение маркетплейса

Приложение Аспро.Cloud – это подключаемый модуль, устанавливаемый в портал для расширения его возможностей. Каждое встроенное приложение имеет стандартную структуру, понятную платформе и разработчикам. По сути, приложение – это пакет, включающий в себя описание (манифест), исполняемый код (скрипты) или ссылки на внешний сервис, а также ресурсы интерфейса (например, виджеты, иконки, шаблоны UI).

Приложения могут быть реализованы в двух основных форматах :

• Внутренний веб-модуль: фронтенд-компоненты, которые встраиваются в интерфейс Аспро.Cloud через предусмотренные точки интеграции. Такие модули работают в браузере пользователя (с использованием SDK платформы) и выглядят как часть интерфейса портала .
• Внешний сервис: автономное веб-приложение, работающее на стороне разработчика приложения и интегрирующееся в Аспро.Cloud через API и iframe. В этом случае интерфейс приложения отображается внутри безопасного iframe либо открывается в новом окне, а взаимодействие с платформой идёт по защищённому API с соблюдением политик безопасности.

Структура приложения включает несколько компонентов (пакет поставки приложения содержит их все):

• Manifest (манифест): описание метаданных приложения и точек его интеграции в платформу . Манифест – центральный элемент, подробнее о нём рассказано ниже.
• Front-end часть: набор файлов интерфейса (HTML, CSS, JS) или скомпилированный бандл, отвечающий за отображение UI внутри Аспро.Cloud. Фронтенд может быть динамическим, в том числе с использованием UI-генератора форм на основе JSON Schema .
• Back-end часть (опционально): серверная логика приложения. Если приложению нужен сервер для обработки данных, оно может обращаться к внешним API, запускать облачные функции или взаимодействовать с собственным сервером разработчика . При этом все обращения к платформе Аспро.Cloud выполняются только через открытый API с проверкой токенов и прав доступа приложения .
• Ресурсы и статические файлы: дополнительные материалы – изображения (иконки), файлы локализации, шаблоны, стили и пр., необходимые для работы приложения . Они могут храниться внутри пакета приложения либо загружаться по ссылкам, указанным в манифесте.

Изоляция и взаимодействие с ядром: Все приложения устанавливаются и работают изолированно от ядра системы . Ошибка в коде приложения не должна приводить к сбоям всего портала. Для этого реализуется «песочница» выполнения: например, если приложение запускается внутри UI Аспро.Cloud, оно загружается в iframe с другим доменом, чтобы его скрипты не могли напрямую взаимодействовать с основной страницей . Прямой доступ к базе данных или внутренним методам ядра исключён – приложение общается с платформой только через официальные интеграционные интерфейсы и API. Взаимодействие контролируется: все вызовы к API требуют авторизации от имени приложения. Если приложение пытается вызвать метод, не указанный в его разрешениях, запрос блокируется системой безопасности . Таким образом, приложение может расширять функциональность (через предоставленные точки встройки, о которых далее), но не может нанести вред ядру или обойти встроенные ограничения прав.