Equipes & Projetos
No Projectura, três coisas organizam o seu trabalho: o workspace (onde tudo vive), as equipes (as pessoas) e os projetos (as frentes de trabalho). Entender como esses três se encaixam é o que faz o app passar de "lista de tarefas" para um lugar onde uma squad inteira se coordena. Esta página explica cada um e mostra como montá-los.
Os três níveis, em uma frase
Comece pelo mapa mental — ele evita 90% da confusão:
- Workspace é o seu espaço. Tudo o que você cria — tarefas, documentos, releases, equipes e projetos — mora dentro de um workspace. Você começa com o seu workspace pessoal (criado sozinho no primeiro acesso) e pode ter outros, um por cliente ou por organização. Cada workspace é isolado: o que está em um não aparece no outro.
- Equipe (squad) é um grupo de pessoas com um propósito — "Plataforma", "Mobile", "Growth". Reúne membros, define quem lidera e registra capacidade. Uma equipe não guarda tarefas; ela responde por projetos.
- Projeto é uma frente de trabalho — um serviço, um produto, um módulo. É onde as tarefas realmente vivem, onde fica o Kanban e onde você conecta os repositórios do GitHub.
Na prática: o workspace contém equipes e projetos; uma equipe é dona de um ou mais projetos; cada projeto concentra as tarefas daquela frente. Pessoas trabalham em projetos; equipes dão a essas pessoas um nome e uma responsabilidade comum.
É fácil confundir os três. Um jeito de lembrar: o workspace é o prédio, a equipe é o time que trabalha lá, e o projeto é a obra que esse time toca. Você pode ter vários projetos por equipe, várias equipes no mesmo workspace, e participar de mais de um workspace ao mesmo tempo.
O workspace: o seu espaço
Você não precisa criar nada para começar — no primeiro acesso, o Projectura cria o seu workspace pessoal automaticamente, já com um projeto Inbox pronto para receber ideias soltas.
- Trocar de workspace: use o seletor no topo da barra lateral (o chip com a bolinha colorida e o nome). Ele lista os workspaces de que você participa, com um check no ativo. Ao trocar, o app recarrega para o Painel — assim o que você vê bate exatamente com o workspace selecionado.
- Criar um novo: ainda no seletor, use "Criar workspace", digite o nome e confirme. Ele já nasce ativo. Crie um por cliente, por produto ou por organização — como fizer mais sentido.
- Isolamento: cada pessoa só enxerga os workspaces de que faz parte, e os dados de cada um ficam separados. Trocar de workspace troca de contexto por inteiro: outras tarefas, outros projetos, outras equipes.
Equipes (squads)
Uma equipe é onde você dá nome a um grupo de pessoas e a uma responsabilidade. Vá em Equipes na barra lateral para ver os cards das squads do workspace e abrir o detalhe de cada uma.
Criar uma equipe
Em Equipes → Nova equipe, defina:
- Nome — como o time é chamado (ex.: "Plataforma Core").
- Handle — o identificador curto com
@, usado para referência e como canal (ex.:@plataforma-core). - Missão — uma linha sobre o propósito do time. Aparece no topo do detalhe.
Membros e quem lidera
No detalhe da equipe, monte o roster: adicione as pessoas que fazem parte e marque quem é o lead (a pessoa que lidera). O roster mostra cada membro com avatar, papel e a carga de trabalho (load%) — uma leitura rápida de quão ocupado cada um está.
Capacidade e alocação
A equipe registra capacidade (quanto o time comporta) e alocação (quanto já está comprometido). Esses números aparecem no detalhe como um indicador de % alocado — útil para saber se o time ainda tem folga antes de puxar mais trabalho.
Projetos da equipe
Associe à equipe os projetos pelos quais ela responde. No detalhe, eles aparecem no bloco "Projetos do time", cada card com a chave (KEY), o nome e o progresso. É assim que a ponte equipe → projeto fica explícita: bateu o olho na squad, você vê tudo o que ela toca.
O que mais o detalhe da equipe mostra
A página de detalhe de uma equipe reúne, além do roster e dos projetos: um hero com nome, missão e dados do time (handle, lead, número de pessoas, timezone); stats do momento (tarefas ativas, PRs abertos, concluídas no sprint, capacidade); o trabalho ativo da squad; indicadores de ritmo (velocity, cycle time, tempo de review de PR); a atividade recente e os docs do time.
Projetos
O projeto é onde o trabalho concreto acontece. Em Projetos na barra lateral você vê todos os projetos do workspace como cards (cada um com a cor no topo, a chave, a descrição e a barra de progresso) e abre o detalhe de qualquer um.
Criar um projeto
Em Projetos → Novo projeto, defina:
- Nome — o nome da frente de trabalho.
- Chave (key) — um identificador curto e único no workspace (ex.:
AUTH,WEB). É a etiqueta que aparece junto às tarefas do projeto. - Cor — escolha uma das cores disponíveis. Ela ajuda a reconhecer o projeto de relance, na lista e no board, e marca a barra de progresso.
Você não precisa criar um agora se ainda não souber a estrutura: todo workspace já vem com o projeto Inbox, pensado para jogar tarefas soltas sem decidir, no calor do momento, onde elas moram. Organize depois, movendo as tarefas para os projetos certos.
Conectar repositórios do GitHub
Cada projeto pode estar ligado a um ou mais repositórios do GitHub — é o que faz branches, pull requests e status de CI aparecerem nas tarefas certas. A ligação é feita na aba Integrações do projeto:
- Abra o projeto → aba Integrações.
- Instale o app do GitHub na sua conta ou organização e selecione os repositórios. É o caminho recomendado e funciona mesmo em organizações com restrições de acesso.
- Escolha quais repos ficam ligados a este projeto.
Como um projeto aceita vários repositórios, frentes que se espalham por mais de um repo (back-end
- front-end, por exemplo) ficam sob o mesmo guarda-chuva. A partir daí, o status de CI de uma branch e o PR vinculado aparecem na tarefa correspondente. Os detalhes de como tudo isso casa com as tarefas estão em GitHub & CI.
As abas do projeto
Aberto o detalhe de um projeto, você navega por quatro abas:
- Board — o Kanban do projeto: as cinco colunas (Aberta · Em progresso · Bloqueada · Revisão · Concluída) onde você arrasta as tarefas. É a visão do dia a dia. Veja Tarefas & Kanban.
- Overview — a visão geral: o documento fixado como README do projeto, os demais documentos, a distribuição por status e por responsável.
- Activity — o histórico de eventos do projeto, incluindo o que chega do GitHub.
- Deploys — a lista de deploys com versão, ambiente (prod/staging), commit, duração, autor e resultado (sucesso/falha).
No topo do detalhe ainda há atalhos para abrir o repositório no GitHub, a URL de produção e criar uma Nova tarefa já dentro do projeto.
Como os três trabalham juntos
Um fluxo típico amarra tudo:
- Você está em um workspace (o pessoal ou um compartilhado com o time).
- Cria uma equipe e convida as pessoas, definindo o lead.
- Cria os projetos daquela frente e os associa à equipe.
- Conecta os repositórios de cada projeto na aba Integrações.
- As tarefas nascem dentro dos projetos, fluem pelo Board e — vinculadas a uma branch — passam a mostrar CI e PRs automaticamente.
O resultado: olhando a equipe, você vê por quais projetos ela responde e como está sua carga; olhando o projeto, você vê o trabalho real e o que está acontecendo no código.
Não precisa montar a estrutura inteira de uma vez. Um workspace, um projeto e uma equipe já bastam para começar. Vá criando novos projetos e squads à medida que o trabalho cresce — sem burocracia, sem pré-configuração.
Convidar pessoas para o workspace
Para colaborar, as pessoas precisam fazer parte do workspace (é o nível onde está o convite — não
da equipe nem do projeto). Quem é dono (owner) do workspace adiciona membros pelo @handle. A
partir daí, esses membros podem ser colocados em equipes e assumir tarefas nos projetos. Cada pessoa
enxerga apenas os workspaces de que participa.