--- title: Projetos slug: projetos icon: {"faIcon":"fa-solid fa-folder-open"} docTags: createdAt: 2026-06-09T21:53:50.771Z --- ## Objetivo **Projetos** são agrupamentos lógicos de fluxos dentro de um [Workspace](docId\:bQsTxq1kzn1hN1C3FXv2z). 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. ![](https://file+.vscode-resource.vscode-cdn.net/Users/daniwarken/Downloads/%23%20Fluid/%23%20Design%20Fluid/Projetos.md) ## Como funciona Um Projeto existe dentro de um Workspace e agrupa fluxos relacionados. A hierarquia da plataforma fica: :::BlockQuote Workspace └── Projeto Pai 1 │ ├── Projeto Filho │ │ ├── Projeto Neto │ │ └── Fluxo 1 │ ├── Fluxo 2 │ └── Fluxo 3 └── Projeto Pai 2 │ ├── Fluxo 4 │ └── Fluxo 5 ::: 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. ## Acessar os Projetos 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. :::hint{type="info"} **Pré-requisito:** Ações de criação, edição e exclusão requerem permissões específicas — consulte a seção Permissões de Projetos. ::: ## Criar um projeto 1. Na tela de **Fluxos**, clique em **Novo Projeto** no painel lateral ou no canto superior da listagem. 2. Preencha os campos: - **Nome** — obrigatório, deve ser único no Workspace. - **Descrição** — recomendado para facilitar a identificação futura do Projeto. 3. Clique em **Salvar**. ![](https://file+.vscode-resource.vscode-cdn.net/Users/daniwarken/Downloads/%23%20Fluid/%23%20Design%20Fluid/Projetos.md) O Projeto aparecerá imediatamente na listagem, com seu *empty state* indicando que ainda não há fluxos associados. :::hint{type="info"} Nomes de Projetos aceitam letras, números, espaços e caracteres especiais. Recomenda-se nomes descritivos que reflitam o domínio ou cliente ao qual as integrações pertencem. ::: ## Criar um subprojeto Para organizar fluxos em níveis adicionais dentro de um Projeto, é possível criar subprojetos: 1. Na árvore de projetos (painel **Filtros**, na listagem de Fluxos), localize o Projeto que servirá como pai. 2. Clique no menu de ações (⋮) ao lado dele. 3. Selecione **Criar subprojeto**. 4. Preencha nome e descrição do subprojeto. 5. Clique em **Salvar**. ::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/w8rXTKW03RNKehKhg6yXS_criar-subprojeto.png" size="30" isUploading="false" width="285" height="381" darkWidth="285" darkHeight="381" alt="Criar subprojeto" showCaption="false"} 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. :::hint{type="info"} A permissão necessária para criar um subprojeto é a mesma utilizada para criar um Projeto — consulte a seção Permissões de Projetos. ::: ## Ver detalhes de um projeto Clique no nome de um Projeto na listagem de Fluxos para acessar sua visão de detalhe. Nela você encontra: | Elemento | Descrição | | -------------------- | ------------------------------------------------ | | **Nome e descrição** | Informações cadastradas na criação ou edição | | **Breadcrumb** | Caminho de navegação: Workspace → Projeto | | **Lista de fluxos** | Todos os fluxos associados ao Projeto | | **Empty state** | Exibido quando o Projeto ainda não possui fluxos | ## Editar um projeto 1. Na listagem ou na tela de detalhe, clique no menu de ações (⋮) do Projeto desejado. 2. Selecione **Editar**. 3. Altere nome ou descrição conforme necessário. 4. Clique em **Salvar**. ::Image[]{src="https://file+.vscode-resource.vscode-cdn.net/Users/daniwarken/Downloads/%23%20Fluid/%23%20Design%20Fluid/Projetos.md" size="40" width="0" height="0" isUploading="false" position="center" darkSrc="https://archbee-image-uploads.s3.amazonaws.com/G1NTw6yAi4RDUYbsU8csp/5qv8h0zXweyPpyE1y1eHd-20260615-183838.png" darkWidth="582" darkHeight="526" showCaption="false"} ::Image[]{src="https://file+.vscode-resource.vscode-cdn.net/Users/daniwarken/Downloads/%23%20Fluid/%23%20Design%20Fluid/Projetos.md" size="80" width="0" height="0" isUploading="false" position="center" darkSrc="https://archbee-image-uploads.s3.amazonaws.com/G1NTw6yAi4RDUYbsU8csp/JcT5iBX6m063_ZbmQ0Dle-20260615-183839.png" darkWidth="1462" darkHeight="772" showCaption="false"} ## Excluir um projeto 1. No menu de ações (⋮) do Projeto, selecione **Excluir**. 2. Confirme a exclusão na caixa de diálogo. :::hint{type="warning"} **Atenção:** Ao excluir um Projeto, os fluxos associados a ele **não são apagados** — eles passam a ser associados ao Projeto *Default*. A exclusão afeta apenas a organização, não as integrações em si. ::: ## Associar fluxos a projetos Fluxos podem ser associados a um Projeto em três momentos distintos: ### Ao salvar um fluxo 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. ![]() ### Ao importar um fluxo 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 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. ![](https://file+.vscode-resource.vscode-cdn.net/Users/daniwarken/Downloads/%23%20Fluid/%23%20Design%20Fluid/Projetos.md) :::hint{type="info"} Selecionar o Projeto durante a ativação de um Flowkit é especialmente útil quando o mesmo Flowkit é ativado múltiplas vezes para clientes ou contextos diferentes — cada ativação pode ir para seu próprio Projeto, facilitando a separação. ::: ## Mover fluxos Para reorganizar fluxos entre Projetos e Workspaces: 1. Na listagem de Fluxos, localize o fluxo que deseja mover. 2. Clique no menu de ações (⋮) do fluxo e selecione **Mover fluxo**. 3. Escolha o Workspace e o Projeto de destino nas listas exibidas. 4. Confirme a ação no botão **Mover**. ::Image[]{size="80" isUploading="false" position="center" darkSrc="https://archbee-image-uploads.s3.amazonaws.com/G1NTw6yAi4RDUYbsU8csp/YdpMVG5T96TNoiqnsXjPN-20260615-183840.png" darkWidth="1518" darkHeight="908" showCaption="false"} :::hint{type="info"} A operação de mover um fluxo não afeta suas configurações, conexões, histórico de execuções ou status de publicação. É preciso ter permissão para criar fluxos no workspace de destino caso seja diferente do workspace atual. ::: ## Permissões de projetos O controle de acesso a Projetos é integrado ao sistema de [Grupos](docId:8DtrTUDBcA6J0L3fWKVbc) de Permissões do Workspace. As permissões disponíveis são: | Permissão | Descrição | | -------------------------------------------------------- | ------------------------------------------------------------- | | **Criar projeto** | Permite criar novos Projetos no Workspace | | **Editar projeto** | Permite renomear e alterar a descrição de Projetos existentes | | **Deletar projeto** | Permite remover Projetos do Workspace | | **Mover Fluxos entre Projetos** | Permite mover fluxo para outro projeto | | **Mover Fluxos entre Projetos de diferentes Workspaces** | Permite mover fluxo para outro projeto de outro workspace | As permissões são configuradas nos [Grupos](docId:8DtrTUDBcA6J0L3fWKVbc) de Permissões e aplicadas a todos os membros daquele grupo. :::hint{type="info"} As permissões de **Fluxos** (criar, editar, excluir) são independentes das permissões de **Projetos**. Um usuário pode ter permissão para editar fluxos dentro de um Projeto sem ter permissão para excluir o Projeto em si. ::: ## Boas práticas **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. ## Casos de uso comuns ### Separar integrações por cliente 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. ### Separar homologação de produção 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. ### Ativar múltiplos Flowkits por cliente 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. ### Organizar um cliente por ambiente ou sistema com subprojetos 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. ## Perguntas frequentes **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. ## Relacionados - [Flowkits](docId\:teosUy9T7cjEQUPLrBuxj) - [Acesso e Governança](docId\:C0YYpFaJh_xJDveiwdShI) - [Grupos](docId:8DtrTUDBcA6J0L3fWKVbc) de Permissões - [Membros](docId:7PtCs4EiLRZrR2DclfyqL) - [Workspaces](docId\:bQsTxq1kzn1hN1C3FXv2z) - Release Notes [v3.30.0](docId\:QSIfQ5mZEGyOVHtX6emOx)