Criando o Primeiro Fluxo

Ao final desse guia, você terá um fluxo funcional, publicado e executando na plataforma.

Visão Geral

O fluxo no bdot é organizado em uma estrutura para facilitar a compreensão, separação de responsabilidade e manutenção. De forma direta, a estrutura é:

Projeto -> Pacote -> Fluxo -> Versão (Tag)

Neste guia vamos criar o primeiro fluxo estruturado da seguinte maneira:

Projeto: Primeiros Passos
Pacote: Tutoriais
Fluxo: Olá Mundo
Tag: 1.0

Após o desenvolvimento do fluxo, vamos configurar um ambiente de execução e consequentemente publica-lo.

Ambiente: Local

Criando o projeto

Acesse a tela “Projetos”

No menu lateral, clique em “Projetos”.
Clique em “+ Projeto”

Preencha o formulário“

Nome do projeto: Primeiros Passos
Slug: primeiros-passos
Descrição: Projeto inicial de agregação do fluxos de tutoriais, guias e validação de conceitos do bdot.

Clique em “Gravar”

Você será redirecionado a tela de gestão do projeto.

Criando o pacote

Clique em “+ Pacote”

Preencha o formulário“

Nome do pacote: Tutoriais
Slug: tutoriais
Descrição: Pacote de fluxos agregador de tutoriais do projeto.

Clique em “Gravar”

Você será redirecionado a tela de gestão do pacote.

Criando o fluxo

Clique em “+ Fluxo”

Preencha o formulário“

    Nome do fluxo: Ola Mundo
    Inicializador: GET
    Slug: ola-mundo
    Descrição: Fluxo "Olá Mundo!", para teste simples da plataforma.

Clique em “Gravar”

O fluxo apareça como um card na tela de gestão do pacote.
Clique no card do fluxo

Você será redirecionado a tela de gestao do fluxo.

Criando uma versão do fluxo

Seguindo boas práticas de desenvolvimento, o bdot versiona seus fluxos, trazendo segurança para o desenvolvedor. É na versão que desenhamos o fluxo de fato. Toda versão é identificada por uma tag.

Clique em “+ Versão”

Preencha o formulário“

Tag: 1.0
Descrição: Primeira versão do fluxo "Olá Mundo!"

Clique em “Gravar”

Você será redirecionado a uma tela com 3 opções inicialização de versão.
Clique em Novo
Clique em Iniciar

Confirme que realmente deseja criar uma versão em branco. Você será redirecionado para a tela de gestão da versão.

Modelagem

Clique em “Editor”

Você será redirecionado para uma tela em branco. Nela vamos desenhar o primeiro fluxo.
Clique na paleta

No canto inferior esquerdo, clique no botão com uma paleta. Um menu com os motores disponíveis sera aberto.
Adicione um motor “Dados - Entrada”

Arraste para adicionar o motor. Um formulário de configuração aparecerá, preencha somente o campo “Alias” por enquanto.
```
Alias: entrada
```
Adicione um motor “Dados - Saída”

Arraste para adicionar o motor. Um formulário de configuração aparecerá, preencha somente o campo “Alias” por enquanto.
```
Alias: saida
```
Clique no código e no editor que abrir, cole o seguinte código
```
{
    "mensagem": "Olá Mundo!"
}
```
Aperte “Esc” ou clique no “X” do popup do editor. Você deverá ver uma prévia do código no menu de configuração.
Conecte entrada a saída

Clique no motor de entrada. Depois na seta, ligando com o motor de saída.
Clique em “Gravar”

Você acaba de criar seu primeiro fluxo, executável, agora precisamos configurar o ambiente e publicar o modelo antes de executar.

Conectando o Ambiente

Clique em “Ambientes”

No menu lateral, clique em ambientes, você será direcionado para a tela de gestão de ambientes de execução.
Clique em “+ Ambiente”

Um formulário será aberto, preencha o campo “Url Engine Pública” com o seguinte endereço
```
Url Engine Pública: https://bdot.local/engine
```
Sincronize os dados do ambiente

O resto dos dados do ambiente serão carregados automaticamente.
Clique em “Gravar”
Ambiente configurado.

Publicando o fluxo

Publicação de fluxo

Na tela de gestão de ambiente, clique na aba “Publicações”
Clique em “+ Publicação”

Selecione o projeto, o pacote, o fluxo e a versao:
```
Projeto: Primeiros Passos
Pacote: Tutoriais
Fluxo: Ola Mundo
Versão: 1.0
```
Selecione o escopo

Ao selecionar a versão do fluxo, três opções de escopo serão exibidas, ative o escopo “Público”.
Clique em “Publicar”

Seu fluxo foi publicado e já pode ser consumido no endpoint público.

Executando o fluxo

Abra o terminal e rode o seguinte comando:

curl -k https://bdot.local/engine/v1/core/public/primeiros-passos/tutoriais/ola-mundo?tag=1.0

A primeira execução é um pouco mais lenta, mas a saída esperada é algo como:

{
  "id": "aa1e9699-820f-4f2b-bac4-a1ad57d68286",
  "sessao": "/v1/core/info/aa1e9699-820f-4f2b-bac4-a1ad57d68286",
  "dados": "{\n    \"mensagem\": \"Olá Mundo!\"\n}"
}