O que é um aplicativo de Marketplace

Um aplicativo do Marketplace do Flowlu é um complemento modular que estende a plataforma por meio de pontos de integração documentados. Os aplicativos são instalados no Flowlu, mas funcionam de forma independente do sistema principal, e cada um segue uma estrutura padrão que tanto o Flowlu quanto os desenvolvedores compreendem.

Em um nível básico, um aplicativo é um pacote que inclui uma descrição (o manifesto do aplicativo), código executável ou links para um aplicativo externo e recursos de interface, como widgets, ícones ou modelos de UI.

Formatos de aplicativo

Os aplicativos do Marketplace podem ser desenvolvidos em dois formatos principais.

Módulo web incorporado

Um módulo web incorporado é composto por componentes de frontend que se integram à interface do Flowlu em pontos de integração predefinidos. Esses módulos rodam no navegador do usuário, utilizam o SDK do Flowlu e aparecem como parte da interface do Flowlu. Eles não têm acesso direto à lógica ou aos dados internos do Flowlu e interagem com a plataforma apenas por meio de APIs aprovadas.

Serviço externo

Um aplicativo externo é um aplicativo web independente hospedado pelo desenvolvedor e integrado ao Flowlu por meio de APIs e um iframe. Sua interface é exibida dentro de um iframe seguro ou aberta em uma nova janela. Toda a interação com o Flowlu ocorre por meio de solicitações de API autenticadas, seguindo as políticas de segurança e permissões da plataforma.

Estrutura do aplicativo

Cada pacote de aplicativo inclui os seguintes componentes.

Manifesto

O manifesto do aplicativo define os metadados do aplicativo, as permissões necessárias e os pontos de integração dentro do Flowlu. É o arquivo de configuração central do aplicativo e é descrito com mais detalhes nas seções posteriores.

Frontend

O frontend inclui os arquivos de interface (HTML, CSS, JavaScript) ou um bundle compilado que renderiza a interface de usuário do aplicativo dentro do Flowlu. Pode ser dinâmico e utilizar a geração de formulários baseada em esquemas.

Backend

O backend contém a lógica do lado do servidor do aplicativo. Se o processamento no servidor for necessário, o aplicativo pode chamar APIs externas, usar funções em nuvem ou interagir com o próprio servidor do desenvolvedor. Toda a comunicação com o Flowlu é feita através da API pública, com validação de token e verificações de permissão aplicadas em cada solicitação.

Assets e recursos estáticos

Estes são os materiais de suporte que um aplicativo precisa para rodar: ícones, arquivos de localização, modelos, estilos e outros recursos estáticos. Eles podem ser armazenados dentro do pacote do aplicativo ou carregados de URLs externas especificadas no manifesto.

Isolamento e interação com a plataforma principal

Todos os aplicativos rodam isolados do núcleo do Flowlu. Um erro no código de um aplicativo não deve afetar a estabilidade da plataforma principal. Para garantir isso, os aplicativos rodam em um ambiente de sandbox sem acesso direto às páginas ou scripts internos do Flowlu. Por exemplo, um aplicativo incorporado na interface do Flowlu é carregado em um iframe de um domínio separado, para que seus scripts não possam interagir diretamente com a página principal.

Os aplicativos não podem acessar o banco de dados do Flowlu ou os métodos internos do núcleo. Toda a interação ocorre por meio de APIs oficiais e interfaces de integração documentadas. Cada solicitação de API deve ser autorizada com credenciais válidas; verificações de permissão são executadas em cada solicitação e qualquer chamada a um método fora das permissões atribuídas ao aplicativo é bloqueada automaticamente.

Essa abordagem permite que os desenvolvedores estendam o Flowlu por meio de pontos de integração aprovados, mantendo a segurança e a estabilidade da plataforma principal.

Para referências de endpoints, detalhes de autenticação e exemplos de solicitações, consulte a documentação da API do Flowlu.