Projetos

Para que serve

Um projeto é uma pasta que já existe no seu computador, normalmente um repositório Git. Quando você cadastra a pasta, o PrumoGrid passa a abrir os terminais dentro dela, a mostrar no cartão do projeto o branch e as sessões abertas, e a guardar ali as etapas, as regras e a verificação daquele trabalho. Selecionar um projeto troca a Grade e a lateral direita juntas, então você vê só o que pertence a ele.

Veja no vídeo

VÍDEO 11 · 1:58

Organização com vários projetos. Três projetos relacionados: um projeto por repositório, um fluxo por objetivo, worktree, modelo pela tarefa, verificação, rotinas e regras. Legendas e transcrição ↗

Quando usar e quando não usar

Use um projeto para cada repositório em que você trabalha. Nos exemplos deste portal são três: loja-api (a API de uma loja), portal-web (o site que consome a API) e pagamentos.

Não cadastre a mesma pasta duas vezes para separar tarefas. Para duas tarefas no mesmo repositório, use um worktree, que é outra pasta do mesmo repositório em outro branch. Também não é preciso cadastrar a pasta de instalação do PrumoGrid.

Passo a passo

Cadastrar a loja-api e abrir um terminal nela:

1. Na coluna Projetos, à esquerda, clique em + adicionar projetos… (o mesmo comando está em Ferramentas → Adicionar projetos…).
2. Escolha a pasta C:\demo\loja-api e confirme. Dá para escolher várias pastas de uma vez.
3. Confira o cartão que apareceu: o nome do projeto, o caminho e a linha do branch, por exemplo main.
4. Com o cartão selecionado, clique em PowerShell na linha NOVO, acima dos terminais.
5. No terminal, rode git status. O prompt mostra PS C:\demo\loja-api>, porque o terminal já nasce na pasta do projeto.

Para ver tudo de uma vez, escolha Todos os projetos no seletor do topo. Para voltar a um projeto, clique no cartão dele.

O que aparece na tela

Ampliar captura ↗

O cartão de cada projeto resume o estado dele:

Fechar um projeto

O × no canto do cartão fecha o projeto. Se houver terminais abertos, o PrumoGrid pede confirmação. Fechar tira a pasta do catálogo aberto e preserva as sessões: nenhum arquivo é apagado, e os terminais que continuarem vivos aparecem em Todos os projetos. Para cadastrar de novo, use + adicionar projetos….

Dicas

• Para pôr os cartões na ordem que você quiser, arraste o cartão ou use Mover para cima e Mover para baixo no menu ···. Veja Organizar projetos e terminais.
• Dê nomes de pasta curtos e distintos. O nome do cartão é o nome da pasta, e é ele que aparece na Atenção ("Em outro projeto: portal-web aguarda permissão").
• Num perfil novo, o primeiro terminal que abre sozinho passa a pertencer ao primeiro projeto cadastrado, desde que você ainda não tenha digitado nele.
• Um terminal sem projeto funciona normalmente. Só as etapas, as regras e a verificação exigem um projeto cadastrado.
• No Git Bash, a pasta aparece como /c/demo/loja-api, e o cartão entende que é a mesma pasta do projeto.

Limites conhecidos

• Cadastrar uma pasta não clona repositório, não move arquivos e não instala dependências.
• Worktrees e a revisão de alterações dependem do Git. Num projeto sem Git (ou em SVN), as etapas rodam direto na pasta do projeto.
• Fechar um projeto não remove os worktrees dele do disco.