Qué es una aplicación de Marketplace

Una aplicación del Marketplace de Flowlu es un complemento modular que amplía la plataforma a través de ubicaciones de integración documentadas. Las aplicaciones se instalan en Flowlu pero funcionan de forma independiente del sistema principal, y cada una sigue una estructura estándar que tanto Flowlu como los desarrolladores comprenden.

A nivel básico, una aplicación es un paquete que incluye una descripción (el manifiesto de la aplicación), código ejecutable o enlaces a un servicio externo, y recursos de interfaz como widgets, iconos o plantillas de IU.

Formatos de aplicación

Las aplicaciones del Marketplace pueden desarrollarse en dos formatos principales.

Módulo web embebido

Un módulo web embebido está compuesto por componentes frontend que se integran en la interfaz de Flowlu en ubicaciones de integración predefinidas. Estos módulos se ejecutan en el navegador del usuario, utilizan el SDK de Flowlu y aparecen como parte de la interfaz de Flowlu. No tienen acceso directo a la lógica o datos internos de Flowlu e interactúan con la plataforma únicamente a través de las APIs aprobadas.

Servicio externo

Un servicio externo es una aplicación web independiente alojada por el desarrollador e integrada con Flowlu mediante APIs y un iframe. Su interfaz se muestra dentro de un iframe seguro o se abre en una nueva ventana. Toda la interacción con Flowlu ocurre a través de solicitudes de API autenticadas, siguiendo las políticas de seguridad y roles y permisos de la plataforma.

Estructura de la aplicación

Cada paquete de aplicación incluye los siguientes componentes.

Manifiesto de la aplicación

El manifiesto de la aplicación define los metadatos de la aplicación, los permisos requeridos y las ubicaciones de integración dentro de Flowlu. Es el archivo de configuración central de la aplicación y se describe con más detalle en las secciones posteriores.

Frontend

El frontend incluye los archivos de interfaz (HTML, CSS, JavaScript) o un bundle compilado que renderiza la interfaz de usuario de la aplicación dentro de Flowlu. Puede ser dinámico y utilizar la generación de formularios basada en esquemas.

Backend

El backend contiene la lógica del lado del servidor de la aplicación. Si se requiere procesamiento en el servidor, la aplicación puede llamar a APIs externas, usar funciones en la nube o interactuar con el propio servidor del desarrollador. Toda la comunicación con Flowlu se realiza a través de la API pública, con validación de tokens y comprobaciones de permisos en cada solicitud.

Assets y recursos estáticos

Estos son los materiales de apoyo que una aplicación necesita para funcionar: iconos, archivos de localización, plantillas, estilos y otros recursos estáticos. Pueden almacenarse dentro del paquete de la aplicación o cargarse desde URLs externas especificadas en el manifiesto de la aplicación.

Aislamiento e interacción con la plataforma principal

Todas las aplicaciones se ejecutan aisladas del núcleo de Flowlu. Un error en el código de una aplicación no debe afectar la estabilidad de la plataforma principal. Para garantizar esto, las aplicaciones se ejecutan en un entorno de sandbox sin acceso directo a las páginas o scripts internos de Flowlu. Por ejemplo, una aplicación embebida en la interfaz de Flowlu se carga en un iframe desde un dominio separado, por lo que sus scripts no pueden interactuar directamente con la página principal.

Las aplicaciones no pueden acceder a la base de datos de Flowlu ni a los métodos internos del núcleo. Toda la interacción ocurre a través de las APIs oficiales e interfaces de integración documentadas. Cada solicitud de API debe estar autorizada con credenciales válidas; se realizan comprobaciones de permisos en cada solicitud y cualquier llamada a un método fuera de los permisos asignados a la aplicación se bloquea automáticamente.

Este enfoque permite a los desarrolladores ampliar Flowlu a través de ubicaciones de integración aprobadas mientras se mantiene la seguridad y estabilidad de la plataforma principal.

Para referencias de endpoints, detalles de autenticación y ejemplos de solicitudes, consulte la documentación de la API de Flowlu.