Projetos

Projetos são agrupamentos lógicos de fluxos dentro de um WorkspaceWorkspace. Com eles, é possível organizar integrações por cliente, domínio, sistema, time ou qualquer critério que faça sentido para a operação — tornando a navegação, organização e o gerenciamento mais eficientes à medida que o volume de integrações cresce.

Sem Projetos, todos os fluxos de um Workspace ficam numa lista plana. Com Projetos, cada fluxo pertence a um contexto claro, e as equipes conseguem localizar e organizar os fluxos de integrações sem depender apenas de nomenclatura ou tags.

Um Projeto existe dentro de um Workspace e agrupa fluxos relacionados. A hierarquia da plataforma fica:

Cada fluxo pertence a um único Projeto por vez. Um Projeto pode conter quantos fluxos forem necessários. Fluxos que não foram associados a nenhum Projeto, são automaticamente associados ao projeto Default.

A navegação dentro de um Projeto exibe um breadcrumb indicando o caminho atual (Workspace → Projeto), e um empty state orientado é exibido quando o Projeto ainda não possui fluxos.

Projetos estão disponíveis diretamente na tela de Fluxos, no menu lateral do Console. Ao acessar a listagem, os fluxos são exibidos organizados pelos Projetos existentes no Workspace.



O Projeto aparecerá imediatamente na listagem, com seu empty state indicando que ainda não há fluxos associados.



Para organizar fluxos em níveis adicionais dentro de um Projeto, é possível criar subprojetos:



Um subprojeto pode, por sua vez, conter outros subprojetos, formando uma hierarquia (por exemplo, Pai → Filho → Neto). Cada nível é exibido com indentação na árvore de projetos, e o número de fluxos associados a cada Projeto ou subprojeto aparece ao lado do respectivo nome.





Clique no nome de um Projeto na listagem de Fluxos para acessar sua visão de detalhe. Nela você encontra:



Fluxos podem ser associados a um Projeto em três momentos distintos:

Ao criar ou editar um fluxo pelo Canvas, o campo Projeto estará disponível nas configurações do fluxo. Selecione o Projeto desejado antes de salvar.

No fluxo de importação, após selecionar o arquivo, uma etapa permite escolher o Projeto de destino dentro do Workspace. Caso nenhum Projeto seja selecionado, o fluxo é importado no Projeto Default.

Ao ativar um Flowkit pelo marketplace, o formulário de ativação inclui o campo Projeto. Todos os fluxos gerados pela ativação serão automaticamente associados ao Projeto selecionado.

Para reorganizar fluxos entre Projetos e Workspaces:

O controle de acesso a Projetos é integrado ao sistema de GruposGrupos de Permissões de Permissões do Workspace. As permissões disponíveis são:

As permissões são configuradas nos GruposGrupos de Permissões de Permissões e aplicadas a todos os membros daquele grupo.

Organize por domínio ou cliente, não por tipo de fluxo. Projetos funcionam melhor como contêineres de contexto de negócio. Um Projeto por cliente, por domínio (Financeiro, Logística, Comercial), por ambiente (Produção, Homologação) ou por sistema (Tray, Senior, etc) costuma ser mais eficiente do que categorizar por tecnologia ou conector usado.

Use o campo Descrição. Projetos com descrições claras facilitam a manutenção por outros membros da equipe, especialmente em operações com muitos Workspaces e clientes simultâneos.

Associe fluxos ao Projeto na criação. É mais fácil definir o Projeto no momento em que o fluxo é criado ou importado do que reorganizar uma lista plana depois que os fluxos já estão em produção.

Em operações iPaaS com múltiplos clientes no mesmo Workspace, crie um Projeto por cliente. Todos os fluxos relacionados àquele cliente ficam agrupados, facilitando o monitoramento, a manutenção e o controle de acesso por responsável.

Em vez de usar nomes como fluxo-producao e fluxo-hml, crie dois Projetos: Produção e Homologação. Os fluxos ficam com nomes limpos e o contexto fica claro pela organização.

Ao ativar um mesmo Flowkit para clientes diferentes, direcione cada ativação para o Projeto do respectivo cliente. O identificador de ativação diferencia as instâncias, e o Projeto garante que os fluxos gerados apareçam no contexto correto.

Em operações com um Projeto por Cliente que concentra muitas integrações, crie subprojetos dentro dele para refinar a organização — por exemplo, um subprojeto Produção e outro Homologação, ou um subprojeto por sistema integrado (Tray, Senior, etc). Isso mantém o Projeto do cliente como contexto principal, sem perder granularidade.

Um fluxo pode pertencer a mais de um Projeto? Não. Cada fluxo pertence a um único Projeto por vez. Para mover o fluxo para outro Projeto, use a opção Mover para projeto no menu de ações do fluxo.

Qual a diferença entre um Projeto e um subprojeto? Um subprojeto é um Projeto criado dentro de outro Projeto (ou subprojeto), formando uma hierarquia. Funcionalmente, subprojetos se comportam como Projetos — podem conter fluxos e outros subprojetos, e são criados, editados e excluídos da mesma forma.

O que acontece com os fluxos ao excluir um Projeto? Os fluxos não são excluídos. Eles são associados ao Projeto Default. Podem ser movidos posteriormente para outro Projeto quando necessário.

Posso criar um Projeto sem adicionar fluxos? Sim. Projetos vazios são válidos e exibem um empty state orientado. É uma forma útil de preparar a estrutura antes de criar ou importar fluxos.

Projetos são visíveis em outros Workspaces? Não. Projetos são criados dentro de um Workspace específico e não são compartilhados entre Workspaces.