Pular para o conteúdo
Latchkey
Menu da documentação

Equipe e funções

Convide colegas de equipe por e-mail ou link compartilhável, entenda as permissões de Owner, Admin e Member e gerencie assentos.

A aba Invite no Gerenciamento de Equipe
Convidando um colega de equipe: função, número máximo de usos e expiração para convites por e-mail ou link.

Abra Team na barra lateral do dashboard (owners e admins) para gerenciar quem está no seu workspace. O cabeçalho mostra o uso de assentos, e três abas cobrem membros, convites pendentes e a criação de novos convites.

Funções e permissões#

roleOwnerTudo o que os Admins podem fazer, além de transferir a propriedade e excluir o workspace. Exatamente um por workspace (a pessoa que instalou o GitHub App, a menos que seja transferido).
roleAdminGerenciar a equipe, cobrança e assentos, e integrações (Slack, monitoramento, configurações de runner), além de tudo o que os Members podem fazer.
roleMemberUsar os dashboards: visualizar todas as análises, insights e dados de runner. Sem gerenciamento de equipe, cobrança, monitoramento ou integrações.

Duas regras mantêm a hierarquia consistente: os Admins só podem gerenciar Members, e apenas o Owner pode alterar ou remover outros Admins.

Um padrão que funciona para a maioria das equipes, oferecido como sugestão e não como regra: reserve Admin para as poucas pessoas que realmente gerenciam cobrança, assentos e integrações, e deixe todos os outros como Member por padrão. Member não é uma experiência restrita; os membros veem todas as análises, insights e dados de runner, e as únicas coisas fora do alcance são gerenciamento de equipe, cobrança, monitoramento e integrações. Como o owner pode promover ou rebaixar entre Admin e Member a qualquer momento, começar as pessoas como Members e promover conforme a necessidade não custa nada.

A aba Members#

A aba Members lista todos no workspace com avatar, nome, e-mail, data de entrada e um selo de função. Owners e admins promovem ou rebaixam entre Admin e Member com um menu suspenso de função embutido, e a remoção de um membro pede confirmação primeiro. O cabeçalho da página mostra quantos assentos estão em uso ("X of Y seats used").

Convidando pessoas#

Abra a aba Invite

Escolha entre um Email Invite (enviado diretamente para um endereço, de uso único por padrão) e um Shareable Link (cole no chat da sua equipe; pode permitir vários usos).

Escolha a função

Os convites podem conceder Admin ("can manage team, billing, and integrations") ou Member ("can view and write data"). Owner não pode ser concedido por convite; use Transfer Ownership em vez disso.

Defina limites

Escolha o número máximo de usos (1, 5, 10, 25, personalizado ou ilimitado) e uma expiração (1 a 30 dias; 7 por padrão). Os convites podem ser revogados a qualquer momento na aba Pending Invites.

Envie ou compartilhe

Os convites por e-mail são entregues pela Latchkey. Os convites por link fornecem uma URL como latchkey.dev/invite/<code> com um botão de copiar.

Convite por e-mail

  • Entregue pela Latchkey para um endereço
  • De uso único por padrão
  • Melhor quando você está fazendo o onboarding de uma pessoa específica

Link compartilhável

  • Uma URL latchkey.dev/invite/<code> para colar no chat da equipe
  • Pode permitir vários usos: 1, 5, 10, 25, personalizado ou ilimitado
  • Melhor quando um grupo inteiro precisa entrar de uma vez

Convites pendentes#

A aba Pending Invites acompanha todos os convites não expirados e não aceitos, com um selo de contagem na própria aba. Cada cartão de convite mostra a função que concede, uma contagem regressiva de expiração ("Expires in N days", "Expires tomorrow", "Expired") e a contagem de usos em relação ao seu limite, por exemplo "2/10 uses". Um botão de revogar em cada cartão permite encerrar qualquer convite antes que ele expire.

Higiene de convites#

Alguns hábitos, sugeridos e não obrigatórios, que evitam que os convites virem uma ponta solta:

  • Prefira convites por e-mail de uso único para indivíduos e reserve links de múltiplos usos para lotes genuínos. Um link encaminhado além do público pretendido é a forma clássica de um convite acabar em algum lugar inesperado.
  • Mantenha as expirações curtas. O padrão de 7 dias é um bom teto para links postados no chat: a conversa rola para longe, e o link também deveria. O intervalo completo é de 1 a 30 dias.
  • Revise a aba Pending Invites ocasionalmente e revogue qualquer coisa que nunca tenha sido usada.
  • Convide como Member por padrão; o owner pode promover para Admin depois, quando a necessidade for real.

O que a pessoa convidada vê#

O link de convite mostra o nome do workspace, a função com a qual ela entrará e a expiração. Se não estiver conectada, ela pode fazer login ou criar uma conta ali mesmo; após o login, o convite é aceito automaticamente e ela chega ao dashboard. Se o workspace estiver sem assentos, ela vê uma mensagem clara de "cannot join" e você precisará adicionar um assento primeiro.

Assentos#

O Launch inclui 1 assento e o Scale inclui 5; assentos extras custam $5/month cada. O uso de assentos aparece no cabeçalho Team, e à medida que você se aproxima do limite a página avisa com um banner "Almost at Seat Limit" ("You have N seats remaining") e depois um banner "Seat Limit Reached"; os avisos levam à cobrança, onde owners e admins podem adicionar assentos. Remover um membro libera o assento dele imediatamente.

Ao planejar assentos, conte as pessoas que precisam do dashboard: esses são assentos de dashboard, controlando quem pode fazer login para visualizar análises e gerenciar o workspace. Como remover um membro libera o assento imediatamente, os assentos são reciclados de forma limpa quando alguém sai, e a $5/month, manter um assento de reserva é uma forma barata de evitar um convite bloqueado no pior momento possível.

Transferindo a propriedade e saindo#

O owner pode promover ou rebaixar membros entre Admin e Member, remover membros e usar Transfer Ownership para entregar o workspace a outro membro. A transferência começa a partir do cartão do membro alvo (o ícone de coroa), e uma caixa de diálogo de confirmação detalha o que acontece: ele se torna o novo Owner, você é rebaixado para Admin e você não pode desfazer a ação por conta própria. Digitar TRANSFER confirma a passagem. Excluir o workspace inteiramente fica em Settings, Account e é exclusivo do owner.

Múltiplos workspaces#

Você pode pertencer a qualquer número de workspaces (o da sua própria organização, além de quaisquer para os quais tenha sido convidado). O workspace switcher no menu do usuário da barra lateral do dashboard move entre eles; cada workspace tem seu próprio plano, equipe, repositórios e dados. A Latchkey lembra o último workspace usado entre os logins.

Perguntas comuns#

Um workspace pode ter dois Owners?

Não. Há exatamente um Owner por workspace: a pessoa que instalou o GitHub App, a menos que a propriedade tenha sido transferida. Para uma segunda pessoa com controle total do dia a dia, conceda Admin; para entregar o workspace inteiramente, use Transfer Ownership.

Um convite pode conceder a função de Owner?

Não. Os convites concedem apenas Admin ou Member. A propriedade se move exclusivamente através de Transfer Ownership.

O que acontece se alguém abrir um convite quando estamos sem assentos?

Ela vê uma mensagem clara de "cannot join" em vez de entrar. Adicione um assento primeiro; os avisos de proximidade do limite no cabeçalho Team levam à cobrança, onde owners e admins podem adicionar um.

Por que não consigo ver a página Team?

A página Team é para owners e admins; os members usam os dashboards sem gerenciamento de equipe. No plano Developer, a colaboração em equipe fica totalmente desativada, então não há equipe para gerenciar.

Posso estar em mais de um workspace?

Sim, qualquer número: o da sua própria organização, além de quaisquer para os quais tenha sido convidado. Cada um tem seu próprio plano, equipe, repositórios e dados, e o workspace switcher no menu do usuário da barra lateral move entre eles.