Docs
Guia

Workspace

A tela Workspace reúne a identidade da empresa e as pessoas com acesso ao ambiente compartilhado. Para chegar até ela, abra o seletor de workspace na barra lateral e clique em Gerenciar workspace. Como toda rota do app vive sob o nome do workspace, o endereço fica #/{nome-do-workspace}/workspace. A gestão de membros acontece só aqui: não há uma página separada para isso. A tela empilha dois blocos, o card Dados do Workspace e o card Membros.

Dados do Workspace

Este card mostra a identidade da conta ativa em dois campos, ambos somente-leitura:

  • Nome do workspace: o nome da conta ativa. Enquanto os dados carregam, o campo exibe "Carregando…".
  • Proprietário do workspace: o e-mail do membro cujo papel é Proprietário.

Nenhum dos dois se edita por aqui. Não existe foto ou logo de workspace, botão de upload, nem botão "Salvar": o card apenas exibe.

O nome é definido uma única vez, na criação, pelo diálogo Criar novo workspace do mesmo seletor da barra lateral que leva até esta tela. Depois disso o app não oferece renomear.

Papéis

Cada membro tem um de quatro papéis, do mais alto ao mais baixo:

PapelO que pode fazer
ProprietárioTudo, inclusive transferir a propriedade. É o único que transfere.
AdministradorGerencia o workspace, exceto transferir a propriedade: convida, muda o papel e remove membros (menos o Proprietário), além de usar todas as funcionalidades.
PadrãoAcesso completo às funcionalidades: cria e edita no workspace, mas não gerencia membros.
Somente LeituraApenas visualização, sem edições. O servidor recusa a esse papel toda operação de escrita.

Membros

O card Membros lista quem tem acesso ao workspace e concentra as ações de convite, mudança de papel, remoção e transferência de propriedade. No topo há uma barra de busca (placeholder "Buscar por nome ou e-mail") que filtra a lista em tempo real por nome ou e-mail.

O botão Convidar membro (ícone de pessoa com "+") aparece para quem é Administrador ou Proprietário, e o servidor aplica a mesma fronteira ao convite.

Convidar um membro

O botão abre o modal Convidar Novo Membro, com a descrição "Envie um convite por email para adicionar um novo membro à sua conta." Preencha:

  • Nome Completo: obrigatório, com no mínimo 2 caracteres.
  • Email: obrigatório, validado como e-mail.
  • Nível de Acesso: um seletor com três opções, nesta ordem: Administrador ("Gerencia o workspace, exceto transferir a propriedade"), Padrão ("Acesso completo às funcionalidades") e Somente Leitura ("Apenas visualização, sem edições"). Padrão já vem marcado. Não dá para convidar alguém direto como Proprietário.

O modal destaca o aviso "Um email será enviado com um link seguro para aceitar o convite." Clique em Enviar Convite (que vira "Enviando…" durante o envio) ou em Cancelar para fechar sem convidar.

No sucesso, o app avisa "Convite enviado com sucesso para {email}!". Se o envio falhar, a mensagem depende do motivo:

SituaçãoMensagem
Sem permissão"Você não tem permissão para convidar membros"
Dados inválidos"Dados inválidos. Verifique os campos e tente novamente"
Outra recusa, inclusive e-mail que já é membro"Não foi possível enviar o convite. Verifique se este email já é membro do workspace e tente novamente."

A tabela de membros

A tabela tem três colunas nomeadas, Membro, Papel e Status, mais uma coluna de ações à direita com cabeçalho vazio.

A coluna Membro combina nome e e-mail: o nome na primeira linha e, logo abaixo, o e-mail em fonte monoespaçada, com um botão de copiar que surge ao passar o cursor. Na sua própria linha aparece "(Você)" ao lado do nome.

A coluna Papel é texto simples, não um badge, com um dos quatro rótulos da seção Papéis. A coluna Status é um badge que indica se o convite já foi aceito:

StatusSignificado
AtivoE-mail verificado, acesso liberado
PendenteE-mail ainda não verificado, convite aguardando aceite

Clicar no cabeçalho ordena a tabela num ciclo de três estados: ascendente, descendente e sem ordenação. No primeiro clique, Membro ordena por nome, Papel segue a ordem Proprietário, Administrador, Padrão e Somente Leitura, e Status traz os Pendentes primeiro; os Ativos sobem no segundo clique.

A tabela começa com 20 linhas por página. A barra de paginação só aparece quando há mais de 5 membros, e traz o seletor Linhas por página com as opções 5, 10, 20 e 50 e um contador com o intervalo exibido e o total. Em telas pequenas a tabela passa a um modo de cartão.

Quando a busca não encontra ninguém, a tabela mostra "Nenhum membro encontrado com os filtros aplicados". Sem filtros ativos, a mensagem é "Nenhum membro encontrado". As duas vêm acompanhadas de um ícone de pessoas.

Mudar o papel de um membro

As ações sobre um membro ficam num menu "..." (kebab) na coluna de ações. Ele só aparece quando você é Administrador ou Proprietário e a linha é de outro membro que não é você nem um Proprietário; nos demais casos a célula fica vazia.

No topo do menu há um item Tornar {Papel} para cada papel entre Administrador, Padrão e Somente Leitura diferente do papel atual do membro. O clique aplica a mudança na hora, sem modal de confirmação, e o app avisa "{nome} agora é {Papel}." com a lista já atualizada.

A mudança é protegida contra edição simultânea. Se ela falhar:

SituaçãoMensagem
Outra pessoa alterou o membro desde que a lista carregou"Este membro foi alterado por outra pessoa. Recarregue a página e tente de novo."
Sem permissão"Você não tem permissão para alterar papéis neste workspace"
Outro erro"Não foi possível alterar o papel deste membro. Tente novamente."

Ninguém vira Proprietário por esse caminho: o menu não oferece essa opção e o servidor recusa. Para passar a titularidade, use Transferir Propriedade.

Remover um membro

Remover membro fica no mesmo menu, abaixo de um separador, e vale a mesma condição de quem vê o menu. Ele abre o modal de confirmação Remover Membro, cuja mensagem cita o nome e o e-mail do membro e avisa que a ação não pode ser desfeita. Confirme em Remover.

Transferir a propriedade

O item Transferir Propriedade tem uma condição própria: só o Proprietário o vê no menu. Um Administrador vê os itens Tornar {Papel} e Remover membro, mas não vê a transferência. Para um membro com status "Pendente", o item aparece desabilitado com o subtexto "O membro precisa verificar o e-mail primeiro"; só membros "Ativos" recebem a propriedade.

O item abre o modal de confirmação Transferir Propriedade. Para liberar o botão, digite o e-mail exato do membro no campo de confirmação. A mensagem avisa que você perderá os privilégios de proprietário. Confirme em Transferir Propriedade.

O servidor aplica estas regras à transferência:

  • O destinatário precisa ser membro deste workspace e estar com o e-mail verificado (status "Ativo").
  • O antigo Proprietário passa a ter o papel Padrão, não Administrador.
  • A troca é transacional: se o destinatário não for membro desta conta, nada muda e ninguém é rebaixado.

Quando a transferência é recusada, o app mostra uma destas mensagens:

SituaçãoMensagem
Sem permissão"Apenas o proprietário atual pode transferir a propriedade da conta"
E-mail do destinatário não verificado"Este membro precisa verificar o e-mail antes de receber a propriedade da conta"
Destinatário não é membro"Este usuário não é membro desta workspace"

Concluída a transferência, o app avisa "Propriedade da conta transferida com sucesso para {email}!" e recarrega a página cerca de 2 segundos depois, para refletir os novos papéis.

Veja também