Membros do Workspace vs. Licenças de PR: São completamente separados e não se afetam.
- Membros do Workspace: Admins que configuram as configurações do Kodus (ilimitado)
- Licenças de PR: Desenvolvedores da sua organização Git que recebem revisões do Kody (baseado no seu plano)
Entendendo as Licenças de PR
As licenças de PR são detectadas automaticamente a partir dos seus repositórios Git com base nos desenvolvedores que abriram PRs nos últimos meses. Por que um desenvolvedor não está aparecendo? Se um desenvolvedor não está aparecendo na sua contagem de licenças de PR, significa que o Kody não está instalado em um repositório onde esse desenvolvedor abriu PRs. Exemplo: Você pode ter 1 admin de workspace gerenciando as configurações, enquanto 20 desenvolvedores recebem revisões automatizadas. Todos os planos incluem PRs ilimitados — seu plano apenas determina quais desenvolvedores têm acesso a revisões.Visão Geral
Os workspaces do Kodus suportam Controle de Acesso Baseado em Funções (RBAC), permitindo gerenciar permissões de usuário e níveis de acesso dentro da sua organização. Cada membro do workspace pode receber uma das quatro funções distintas, cada uma com permissões e capacidades específicas.Funções Disponíveis
Cada função fornece diferentes níveis de acesso e capacidades dentro do workspace:Owner (Proprietário)
Acesso administrativo completo ao workspace e todos os seus recursos. Pode visualizar, editar e excluir todas as configurações em todos os repositórios.Billing Manager (Gestor de Cobrança)
Acesso de gerenciamento financeiro e de cobrança com acesso ao gerenciamento de faturamento/assinatura e acesso de visualização à maioria das configurações, mas sem acesso de edição às configurações de revisão de código.Repository Admin (Admin de Repositório)
Acesso de gerenciamento de repositório focado no gerenciamento de configurações de revisão de código para os repositórios que possui, com acesso completo a issues, cockpit e plugins.Contributor (Colaborador)
Acesso básico para membros da equipe que precisam visualizar configurações de repositórios aos quais estão atribuídos. Limitado a acesso somente de visualização para a maioria dos recursos.Matriz de Permissões por Função
Aqui está um detalhamento do que cada função pode fazer, com base na matriz de permissões real:Legenda: V = Visualizar, E = Editar, D = Excluir, (all) = Todos os repositórios, (own) = Apenas repositórios próprios, - = Sem acesso
| Permissão | Owner | Billing Manager | Repository Admin | Contributor |
|---|---|---|---|---|
| Configuração Global de Code Review | V (all) / E (all) | V (all) | V (all) | V (all) |
| Configuração de Repositório de Code Review | V (all) / E (all) / D (all) | V (all) | V (own) / E (own) | V (own) |
| Configuração de Pasta de Code Review | V (all) / E (all) / D (all) | V (all) | V (own) / E (own) | V (own) |
| Faturamento / Assinatura | V (all) / E (all) / D (all) | V (all) / E (all) / D (all) | - | - |
| Cockpit | V (all) / E (all) | - | V (own) | - |
| Issues | V (all) / E (all) | - | V (all) / E (own) | V (own) |
| Log de Atividade | V (all) | V (all) | V (own) | V (own) |
| Configurações Git | V (all) / E (all) / D (all) | V (all) | V (all) | V (all) |
| Pull Request | V (all) / E (all) / D (all) | V (all) | V (all) | - |
| Plugins | V (all) / E (all) / D (all) | V (all) | V (all) | - |
Gerenciando Membros do Workspace
Adicionando Novos Membros
- Navegue até a seção Membros do seu workspace
- Clique no botão “Convidar membro”
- Insira o endereço de e-mail do membro
- Selecione a função adequada para o novo membro
- Envie o convite
Auto-Join para Membros do Workspace
Habilite o auto-join para permitir que usuários com domínios de e-mail correspondentes entrem no seu workspace automaticamente. Como habilitar:- Vá para Configurações da Organização
- Habilite o auto-join para sua organização
- Atualmente funciona apenas com o domínio de e-mail da sua conta registrada
- Precisa de um domínio diferente? Entre em contato conosco na comunidade
- Usuários que se cadastram com o seu domínio de e-mail podem escolher entrar na sua organização
- Eles devem confirmar o e-mail após escolher entrar
- Todos os usuários de auto-join entram com a função de Contributor sem acesso a repositórios
- Como Owner, você precisa atribuí-los a repositórios e ajustar sua função, se necessário
Alterando Funções de Membros
- Vá para a seção Membros do seu workspace
- Encontre o membro cuja função deseja alterar
- Clique no dropdown de função atual
- Selecione a nova função das opções disponíveis
- A alteração entra em vigor imediatamente
Removendo Membros
- Na seção Membros, localize o membro a ser removido
- Clique no menu “Ações” (três pontos)
- Selecione “Remover do workspace”
- Confirme a remoção no diálogo
Considerações de Segurança
- Princípio do Menor Privilégio: Sempre atribua a função com o mínimo de permissões necessárias
- Auditorias Regulares: Revise periodicamente as funções dos membros e ajuste conforme necessário
- Revisões de Acesso: Realize revisões trimestrais de acesso e permissões do workspace
- Revogação Imediata: Remova o acesso imediatamente quando um membro sair da organização
Solução de Problemas
Não consigo convidar novos membros para o workspace
Não consigo convidar novos membros para o workspace
Soluções:
- Verifique se você tem a função de Owner ou Repository Admin
- Verifique se o seu workspace atingiu algum limite do sistema
- Certifique-se de que você tem as permissões corretas na sua conta
Um membro não consegue editar configurações de revisão de código
Um membro não consegue editar configurações de revisão de código
Soluções:
- Confirme que o membro tem a função Repository Admin ou Owner para o repositório específico
- Verifique se o membro tem permissões “own” para o repositório que deseja editar
- Verifique se a atribuição de função do membro está correta
Informações de faturamento não são visíveis para um membro da equipe
Informações de faturamento não são visíveis para um membro da equipe
Soluções:
- Certifique-se de que o membro tem a função Owner ou Billing Manager
- Verifique se os recursos de faturamento estão habilitados para o seu workspace
- Verifique se o acesso do membro não foi restringido
Um membro não consegue acessar os recursos do cockpit
Um membro não consegue acessar os recursos do cockpit
Soluções:
- Confirme que o membro tem a função Repository Admin ou Owner
- Verifique se o membro está atribuído aos repositórios que deseja acessar
- Verifique se a atribuição de função do membro está correta
Um desenvolvedor não está aparecendo nas licenças de PR
Um desenvolvedor não está aparecendo nas licenças de PR
Soluções:
- Verifique se o Kody está instalado nos repositórios onde este desenvolvedor abre PRs
- Verifique se o desenvolvedor abriu PRs nos últimos meses
- Lembre-se: as licenças de PR vêm da atividade Git, não dos membros do workspace
- Certifique-se de que o webhook do repositório está configurado corretamente