bdotapps/engine-api repository overview

  :!!^                                 ^!!.                                     
  J@@B                                 #@@7                       .JJ?.         
  J@@B                                 #@@7                       ^@@&.         
  J@@G ^!7777777!^.       .~!7777777!:.B@@7    .:~777777777!^.    ^@@&J77777?!  
  J@@&&&&&&&&&&&@@&G:   ^B&@@&&&&&&&&&#&@@7   J&@@@&&&&&&&&@@&5.  ^@@@&&&&&&&#. 
  J@@@7.........:5@@#. .&@@J..........J@@@7  ?@@#^.........:G@@P  ^@@&:.......  
  J@@B           .&@@: ^@@&.           #@@7  G@@J           ~@@&. ^@@&.         
  J@@G           .&@@: ^@@&.           #@@7  G@@J           ~@@&. ^@@&.         
  J@@G           .&@@: ^@@&.           #@@7  G@@J           ~@@&. ^@@&.         
  J@@#.          ^@@&. :@@&:          .&@@7  P@@P           ?@@#  :@@@^         
  J@@@&PYYYYYYYYP&@@J   5@@&PYYYYYYYYP&@@@7  :&@@B5YYYYYYYYG@@&!   Y@@&PYJJJJ7  
  7&#P7G#&&&&&&&#GY^     ^YB#&&&&&&&#G!G#&~   .7P##&&&&&&&&#GJ:     ^YG#&&&&&B. 

⁠BDOT Community Edition - Engine API

⁠🚀 O que é a aplicação?

O engine-api é a porta de entrada do ambiente de execução da plataforma bdot. Ele recebe requisições HTTP para executar fluxos de negócio modelados no console, valida cada solicitação (segurança, escopo de origem e versão do fluxo) e dispara a execução, devolvendo o resultado ao cliente — de forma síncrona, aguardando a conclusão com timeout, ou assíncrona, retornando na hora o identificador da sessão para consulta posterior.

Isso permite que aplicações externas, sistemas legados e agendadores acionem processos de integração da plataforma de forma padronizada, segura e de alta performance — sem expor a complexidade interna de orquestração. O público-alvo são desenvolvedores e arquitetos que desejam expor e consumir fluxos de negócio via API, bem como gestores de TI que buscam controlar e proteger o acesso a esses processos.

⁠✨ Principais Funcionalidades

• Execução síncrona e assíncrona via REST: flexibilidade total — chame o fluxo aguardando a resposta (com controle de timeout) ou envie em modo "fire-and-forget" e consulte o andamento pela sessão.
• Segurança em camadas: autenticação obrigatória, validação de escopo de origem (interno, agendador ou público), controle de CORS e API Keys por versão de fluxo — o acesso é liberado somente para quem e como foi autorizado.
• Alta performance com baixo consumo de recursos: construído com virtual threads e compilação nativa (GraalVM), lida com muitas requisições concorrentes sem ocupar threads do servidor, com notificação de conclusão via PubSub.

⁠🛠️ Tecnologias e Arquitetura

Microsserviço construído com Quarkus e Java 21 (virtual threads), compilado para executável nativo via GraalVM. Utiliza Redis para gerenciamento de sessões, cache de definições e notificação de conclusão, e Apache Kafka para a orquestração da comunicação com os runners de execução da plataforma.

⁠🔒 Licença e Suporte

⁠Licença de Software Proprietário

Copyright (c) 2026 BPX TECNOLOGIA. Todos os direitos reservados.

Este software e a documentação associada (o "Software") são propriedade da BPX TECNOLOGIA e protegidos por leis de direitos autorais e tratados internacionais.

É estritamente proibida qualquer utilização, cópia, reprodução, modificação ou distribuição do Software, ou de qualquer parte dele, sem a autorização prévia e por escrito da BPX TECNOLOGIA.

O uso não autorizado do Software pode resultar em severas penalidades civis e criminais, e será processado na máxima extensão possível sob a lei.

Para questões de licenciamento, por favor, entre em contato com: **[email protected]**

⁠⚡ Como Executar via BDOT CLI

⁠Pré-requisitos

• BDOT CLI instalada e configurada (guia de instalação⁠)