> ## Documentation Index > Fetch the complete documentation index at: https://docs.olie.ai/llms.txt > Use this file to discover all available pages before exploring further. # Hierarquia de projetos automatizada > Crie estruturas complexas de projetos automaticamente usando automações ## Visão geral A funcionalidade de **Criar Hierarquia de Projetos** permite que você crie automaticamente uma estrutura organizacional de projetos filhos vinculados a um projeto pai. Esta ferramenta é ideal para automatizar a criação de estruturas complexas de projetos baseadas em templates ou configurações dinâmicas. O projeto pai sempre será o projeto que acionou o gatilho da automação. ## Quando usar Quando você precisa criar múltiplos projetos com a mesma estrutura ou estrutura dinâmica. Para automatizar a criação de hierarquias baseadas em templates ou regras de negócio. Para manter uma estrutura clara e organizada de projetos relacionados sempre que um novo projeto for criado. Para replicar estruturas complexas rapidamente sem trabalho manual repetitivo. ## Configuração básica ### 1. Escolha o tipo de ação **Cria novos projetos** baseados em um template ou do zero. * Usa um projeto template como base (opcional) * Cria projetos filho com configurações do template * Ideal para estruturas padronizadas Use esta opção quando quiser criar uma estrutura nova de projetos. **Vincula projetos existentes** à hierarquia. * Conecta projetos já criados ao projeto pai * Não cria novos projetos * Ideal para reorganização Use esta opção quando os projetos já existem e você quer apenas organizá-los. ### 2. Projeto template (opcional) Selecione um projeto template que será usado como base para criar os projetos filhos. Este template será clonado para cada novo projeto criado. **Vantagens:** * Herda todas as configurações do template * Mantém etapas, campos customizados e automações * Consistência garantida em todos os projetos **Exemplo:** Se o template tem campos customizados e automações específicas, todos os projetos filhos terão essas mesmas configurações. **Vantagens:** * Projetos mais simples e limpos * Menor tempo de criação * Ideal para estruturas básicas **Exemplo:** Projetos são criados com configurações básicas padrão do sistema. Se não selecionar um template, os projetos serão criados do zero com configurações básicas. ### 3. Etapa de destino (opcional) Selecione a etapa do funil onde os projetos serão vinculados. Apenas projetos marcados com `>` serão vinculados a esta etapa. A etapa de destino só funciona para projetos que você marcar explicitamente na estrutura usando o prefixo `>`. ## Definindo a estrutura ### Sintaxe básica A estrutura é definida usando quebras de linha e símbolos para indicar níveis hierárquicos: ``` Filho 1 Filho 2 -Neto 1 -Neto 2 --Bisneto Outro Filho ``` **Projeto Pai** é sempre o projeto que está envolvido no gatilho que acionou a automação. Não é necessário incluí-lo na estrutura. ### Símbolos especiais no prefixo Indica um projeto filho direto (nível 1). ``` Filho 1 Filho 2 ``` Indica um projeto neto (nível 2). ``` -Neto 1 -Neto 2 ``` Indica um projeto bisneto (nível 3). ``` --Bisneto 1 --Bisneto 2 ``` Marca o projeto para ser vinculado à etapa do funil especificada. ``` >Projeto Prioritário ``` Você pode combinar com os níveis: `>Filho`, `->Neto`, `-->Bisneto` ## Exemplos práticos ### Exemplo 1: Estrutura simples Criação de subprojetos básicos sem hierarquia profunda: ``` Projeto A Projeto B Projeto C ``` **Resultado:** ``` [Projeto Pai do Gatilho] ├── Projeto A ├── Projeto B └── Projeto C ``` ### Exemplo 2: Hierarquia de 2 níveis Estrutura com filhos e netos: ``` Subprojeto 1 Subprojeto 2 -Tarefa 1 -Tarefa 2 ``` **Resultado:** ``` [Projeto Pai] ├── Subprojeto 1 └── Subprojeto 2 ├── Tarefa 1 └── Tarefa 2 ``` ### Exemplo 3: Estrutura complexa Organização completa com múltiplos níveis: ``` Frontend -Componentes -Páginas Backend -API -Banco de Dados Testes -Qualidade ``` **Resultado:** ``` [Projeto Pai] ├── Frontend │ ├── Componentes │ └── Páginas ├── Backend │ ├── API │ └── Banco de Dados └── Testes └── Qualidade ``` ### Exemplo 4: Com vinculação ao funil Marcando projetos prioritários para uma etapa específica: ``` >Projeto Prioritário Projeto Normal >Outro Prioritário -Subprojeto ``` **Resultado:** * "Projeto Prioritário" e "Outro Prioritário" serão vinculados à etapa escolhida * "Projeto Normal" e "Subprojeto" não serão vinculados a nenhuma etapa Os projetos marcados com `>` ficam destacados na etapa do funil para fácil identificação. ## Usando sintaxe avançada O campo de estrutura suporta o uso de **sintaxe avançada** para criar estruturas dinâmicas baseadas em variáveis e lógica condicional. Criar múltiplos projetos similares: ```twig theme={null} {% for i in 1..3 %} {{ project.name }} - Sprint {{ i }} -{{ project.code }} Planning -{{ project.code }} Development -{{ project.code }} Testing -{{ project.code }} Review {% endfor %} ``` **Resultado:** ``` [Projeto Pai] ├── Projeto Pai - Sprint 1 │ ├── P1 Planning │ ├── P1 Development │ ├── P1 Testing │ └── P1 Review ├── Projeto Pai - Sprint 2 │ ├── P1 Planning │ ├── P1 Development │ ├── P1 Testing │ └── P1 Review └── Projeto Pai - Sprint 3 ├── P1 Planning ├── P1 Development ├── P1 Testing └── P1 Review ``` Criar projetos baseado em condições: ```twig theme={null} Planejamento Desenvolvimento {% if project.type == 'premium' %} Consultoria Especializada -Análise Avançada -Suporte Dedicado {% endif %} Testes Deploy ``` **Resultado para projeto premium:** Inclui os projetos de consultoria **Resultado para projeto normal:** Não inclui os projetos de consultoria Criar projetos baseado em listas: ```twig theme={null} {% for module in project.modules %} Módulo {{ module.name }} -Desenvolvimento {{ module.name }} -Testes {{ module.name }} {% endfor %} ``` Se `project.modules` contém `[{name: 'CRM'}, {name: 'Financeiro'}]`: ``` [Projeto Pai] ├── Módulo CRM │ ├── Desenvolvimento CRM │ └── Testes CRM └── Módulo Financeiro ├── Desenvolvimento Financeiro └── Testes Financeiro ``` Usar dados do projeto pai: ```twig theme={null} {{ project.client }} - Fase 1 -Análise de {{ project.client }} -Proposta para {{ project.client }} {{ project.client }} - Fase 2 -Implementação -Treinamento ``` Se `project.client` é "Acme Corp": ``` [Projeto Pai] ├── Acme Corp - Fase 1 │ ├── Análise de Acme Corp │ └── Proposta para Acme Corp └── Acme Corp - Fase 2 ├── Implementação └── Treinamento ``` [Aprenda mais sobre sintaxe avançada →](/guides/advanced/advanced-syntax) ## Exemplos completos ### Exemplo 1: Desenvolvimento de software ``` >Análise de Requisitos -Entrevistas com Stakeholders -Documentação de Requisitos >Design e Arquitetura -Design de Interface -Arquitetura do Sistema >Desenvolvimento -Frontend --Componentes React --Páginas -Backend --API REST --Banco de Dados >Testes -Testes Unitários -Testes de Integração -Testes de Aceitação >Deploy -Configuração de Ambiente -Deploy em Produção ```

Estrutura resultante:

7 projetos filhos diretos (todos marcados para etapa)

13 projetos netos

2 projetos bisnetos

Total: 22 projetos criados automaticamente

### Exemplo 2: Campanha de marketing ``` >Pesquisa de Mercado -Análise da Concorrência -Pesquisa com Clientes >Estratégia -Definição de Público-Alvo -Desenvolvimento de Mensagem >Execução -Desenvolvimento de Conteúdo -Criação de Materiais >Divulgação -Redes Sociais -Email Marketing >Análise -Métricas de Performance -Relatórios de Resultados ``` ### Exemplo 3: Com sintaxe avançada (Sprints) ```twig theme={null} {% for i in 1..project.sprint_count %} >Sprint {{ i }} -Planning Sprint {{ i }} -Development Sprint {{ i }} --Frontend Tasks --Backend Tasks -Testing Sprint {{ i }} -Review Sprint {{ i }} {% endfor %} >Encerramento -Documentação Final -Entrega ao Cliente ``` **Se `project.sprint_count` for 3, cria:** * 3 Sprints completas (12 projetos) * 1 projeto de Encerramento (3 projetos) * Total: 15 projetos ## Limitações e regras **Máximo de 3 níveis de hierarquia** * Nível 1: Filhos diretos (sem prefixo) * Nível 2: Netos (um `-`) * Nível 3: Bisnetos (dois `--`) Tentar criar mais de 3 níveis resultará em erro de validação. * Estrutura não pode estar vazia * Nomes de projetos não podem estar vazios * Sintaxe avançada deve ser válida * Hierarquia deve respeitar o limite de níveis * Projetos marcados com `>` são automaticamente vinculados à etapa do funil * Projetos criados a partir de templates herdam todas as configurações * Projetos criados do zero recebem configurações básicas * A ordem dos projetos na estrutura é mantida ## Solução de problemas **Causas comuns:** * Sintaxe avançada inválida * Nome de projeto vazio * Mais de 3 níveis de profundidade * Estrutura vazia **Solução:** Verifique a estrutura linha por linha e corrija os erros identificados. **Causa:** Projetos não foram marcados com `>`. **Solução:** Adicione o prefixo `>` aos projetos que devem ser vinculados à etapa. ``` >Projeto que vai para etapa Projeto que não vai para etapa ``` **Causa:** Uso incorreto dos prefixos `-`. **Solução:** Verifique que: * Filhos não têm prefixo * Netos têm um `-` * Bisnetos têm dois `--` ``` Correto: Filho -Neto --Bisneto Incorreto: -Filho Neto ---Bisneto ``` **Causa:** Template não foi selecionado corretamente. **Solução:** Certifique-se de que o template está selecionado no campo apropriado antes de salvar. ## Boas práticas Comece com estruturas simples e evolua conforme sua necessidade. Teste bem antes de criar estruturas complexas. Configure templates bem estruturados para garantir consistência em todos os projetos criados. Teste a automação com um projeto de teste antes de ativar em produção para verificar se a estrutura está correta. Adicione comentários na sintaxe avançada explicando a lógica, especialmente em estruturas complexas. Use nomes claros e descritivos para os projetos para facilitar navegação na hierarquia. Revise as automações de hierarquia periodicamente para garantir que ainda atendem às necessidades do negócio. ## Conclusão A criação automatizada de hierarquia de projetos é uma funcionalidade poderosa que economiza tempo e garante consistência na organização de projetos complexos. Com esta funcionalidade, você pode transformar horas de trabalho manual em uma automação que executa em segundos, criando estruturas complexas de forma confiável e repetível. Lembre-se: Esta funcionalidade é poderosa para automatizar a criação de estruturas complexas. Comece com estruturas simples e evolua conforme sua necessidade e confiança no sistema! [Voltar para Hierarquia de Projetos →](/guides/projects/project-hierarchy)