Workspaces organizam pessoas, repositórios, políticas, credenciais, cobrança e auditoria. Cada workspace representa uma organização, unidade, cliente ou ambiente administrativo separado.
Quem pode acessar
- Admin de workspace administra todas as configurações do workspace, incluindo áreas restritas a administradores.
- Billing Manager gerencia as áreas relacionadas à cobrança do workspace.
- Maintainer e Member podem visualizar as áreas permitidas por sua função.
As funções são conjuntos fixos de capacidades definidos pela Acrity. Não são configuráveis por organização.
Quando usar
Use as configurações do workspace para:
- revisar dados básicos do workspace;
- ajustar idioma padrão;
- configurar domínios permitidos para cadastro;
- transferir propriedade;
- consultar estado de onboarding e pendências;
- acessar as áreas administrativas do workspace.
Configurações principais
Você pode editar o Nome e a Descrição do workspace, além dos Domínios permitidos e do seletor de Idioma. O Slug é um identificador somente leitura: você pode copiá-lo, mas não pode alterá-lo aqui.
| Campo | Para que serve | Recomendação |
|---|
| Nome | Nome exibido no Console e em áreas administrativas. | Use o nome público da organização ou área. |
| Slug | Identificador permanente e somente leitura atribuído quando o workspace é criado. | Copie-o quando precisar referenciar o workspace; ele não pode ser editado aqui. |
| Descrição | Contexto do workspace para Admins de workspace. | Explique a área ou finalidade do workspace. |
| Domínios permitidos | Domínios de e-mail autorizados para associação ou cadastro quando habilitado. | Inclua apenas domínios controlados pela organização. |
| Idioma | Idioma padrão usado pela experiência do workspace e por saídas de revisão quando não houver override. | Escolha o idioma esperado pelos times que recebem comentários. |
Idioma do workspace
O idioma do workspace define a preferência padrão para comunicações e saídas de revisão. Um repositório pode ter idioma próprio quando uma equipe precisa receber revisões em outro idioma.
Para configurar:
- Selecione o workspace correto.
- Abra as configurações do workspace.
- Localize a configuração de idioma.
- Selecione o idioma desejado.
- Salve as alterações.
Transferir propriedade
Transferir propriedade muda o responsável principal pelo workspace.
Antes de transferir:
- confirme que o novo responsável já tem acesso adequado;
- revise cobrança e faturas pendentes;
- avise Admins de workspace afetados;
- mantenha pelo menos um Admin de workspace ativo no workspace.
Não transfira propriedade para uma conta pessoal ou temporária. Use uma conta administrada pela organização.
Domínios permitidos
Domínios permitidos ajudam a controlar quais e-mails podem se associar ao workspace em fluxos que usam domínio corporativo.
Boas práticas:
- use apenas domínios da organização;
- remova domínios antigos após migrações;
- não inclua domínios públicos como provedores gratuitos de e-mail;
- combine essa configuração com revisão periódica de membros.
Checklist inicial do workspace
- Workspace criado com nome e descrição claros.
- Idioma padrão definido.
- Admins de workspace convidados.
- Cobrança ou trial configurado.
- Aplicativos conectados instalados ou credenciais cadastradas.
- Repositórios conectados.
- Política de revisão padrão revisada no Policy Engine.
- API Keys e webhooks criados apenas quando houver integração externa.
Problemas comuns
| Sintoma | O que verificar |
|---|
| Não vejo as configurações do workspace | Sua função pode não ter acesso. Use o seletor de workspace ou peça acesso a um Admin de workspace. |
| Não consigo salvar alterações | Verifique campos obrigatórios, permissões e mensagens de validação da tela. |
| O idioma da revisão não mudou | Veja se o repositório possui idioma próprio configurado. O idioma do repositório pode sobrescrever o padrão do workspace. |
| Um usuário não consegue acessar | Confirme convite, função atribuída e domínio de e-mail permitido. |
Próximos passos
Depois de configurar o workspace, continue com:
