# Espaços de trabalho

> Com organizações, escolas e equipes trabalham juntas no Nodaro Cloud. Veja espaços de trabalho, funções, convites, códigos e como compartilhar e alternar.

Source: https://nodaro.ai/pt-BR/docs/concepts/workspaces

Uma **organização** permite que uma escola ou uma equipe trabalhe em conjunto no Nodaro Cloud. Um **espaço de trabalho** é onde os membros fazem esse trabalho: uma turma em uma escola ou uma equipe em uma empresa. Cada pessoa também mantém um **espaço pessoal** para o próprio trabalho, a menos que a organização o desative. Você alterna entre o seu espaço pessoal e os seus espaços de trabalho pelo menu abaixo do logotipo do Nodaro.

## Organizações, espaços de trabalho e o seu espaço pessoal
| Termo | O que é |
| --- | --- |
| **Organização** | O grupo: uma escola ou uma equipe. Tem um proprietário, qualquer número de administradores e membros e configurações para todos os espaços de trabalho dela. |
| **Espaço de trabalho** | Onde os membros trabalham juntos. Pertence a uma organização e tem os próprios administradores, membros e configurações. |
| **Espaço pessoal** | O seu próprio trabalho, fora de qualquer organização. É onde você trabalha quando **Pessoal** está selecionado. |

As organizações são um recurso do Nodaro Cloud. As instalações self-hosted não as incluem.

## Escolas e equipes
Quando você cria uma organização, escolhe o tipo dela. O tipo define as palavras que o app usa e as configurações padrão. Não é possível mudar o tipo depois.

| | Escola | Equipe |
| --- | --- | --- |
| **Um espaço de trabalho se chama** | Turma | Equipe |
| **Administrador do espaço de trabalho** | Professor | Líder |
| **Membro do espaço de trabalho** | Aluno | Membro |
| **Onde o trabalho novo começa** | Privado para quem o criou | Visível para a equipe inteira |
| **Administradores e o trabalho de um membro** | Podem ver e alterar | Podem ver |
| **Membros e o trabalho compartilhado com o espaço de trabalho** | Podem ver | Podem ver e alterar |
| **Membros podem criar os próprios projetos** | Não | Sim |

## Funções
| Função | Escopo | O que a função pode fazer |
| --- | --- | --- |
| **Proprietário** | Organização | Tudo o que um administrador pode, mais transferir a propriedade e excluir a organização. Cada organização tem exatamente um proprietário. |
| **Administrador** | Organização | Gerenciar as configurações, os membros e os espaços de trabalho da organização. Um administrador também é administrador de todos os espaços de trabalho da organização. |
| **Membro** | Organização | Pertencer à organização e trabalhar nos espaços de trabalho a que for adicionado. |
| **Administrador do espaço de trabalho**, como um professor ou um líder | Espaço de trabalho | Gerenciar as configurações e as pessoas do espaço de trabalho. |
| **Membro do espaço de trabalho**, como um aluno | Espaço de trabalho | Trabalhar no espaço de trabalho. |

Um administrador da organização pode ser adicionado a um espaço de trabalho com a função de membro comum. Essa função explícita passa a valer naquele espaço de trabalho.

## Criar uma organização
### Abrir o menu
Clique no logotipo do Nodaro, no topo da barra lateral, e escolha **Criar organização**.

### Escolher o tipo, o nome e o endereço
Escolha **Escola** ou **Equipe** e insira um nome. O **Endereço** é gerado a partir do nome; você pode editá-lo usando letras minúsculas, dígitos e hífens. Uma escola também exige que você confirme que tem autoridade para matricular os alunos dela e que aceita os termos da organização em nome dela.

### Aguardar a aprovação
As novas organizações passam por uma análise antes de serem abertas. Enquanto você espera, o menu mostra a organização como aguardando aprovação, e não é preciso fazer mais nada.

### Criar turmas ou equipes
Depois que a organização é aprovada, crie os espaços de trabalho dela com **Nova turma** ou **Nova equipe** e traga as pessoas.

## Trazer pessoas
### Convidar por e-mail
Use **Convidar pessoas** e cole os endereços de e-mail do jeito que você os tiver: separados por vírgulas, ponto e vírgula ou quebras de linha. Você pode enviar até 200 endereços de uma vez.

- Escolha a **Função na organização**: **Membro** ou **Administrador**.
- Se quiser, adicione as pessoas a uma turma ou equipe ao mesmo tempo.
- Cada pessoa recebe um e-mail com um link. Quando não for possível enviar o e-mail para um endereço, você recebe o link: use **Copiar link** e repasse-o. O convite existe de qualquer forma.

Quem abre o link vê quem fez o convite e para quê, e entra com o endereço de e-mail convidado para aceitar. Os convites valem por 14 dias. **Reenviar** cria um novo link, e o link antigo deixa de funcionar. Você também pode cancelar um convite que ninguém aceitou ainda. Uma organização pode enviar até 500 convites por dia.

Proprietários e administradores sempre podem convidar. Os administradores de espaços de trabalho, como os professores, podem convidar novas pessoas para o próprio espaço de trabalho quando a organização permite.

### Compartilhar um código de entrada
Um **código de entrada** tem oito caracteres, curto o bastante para ser lido em voz alta em uma sala ou escrito no quadro. Ele torna a pessoa um membro comum de um espaço de trabalho.

1. Um administrador do espaço de trabalho abre as configurações do espaço de trabalho e ativa **Permitir entrada com código** em **Código de entrada**.
2. Compartilhe o código, por exemplo `BCDF-GHJK`.
3. As pessoas abrem o menu abaixo do logotipo do Nodaro, escolhem **Entrar com código**, digitam o código e clicam em **Entrar**.

O hífen é opcional, e letras que costumam ser confundidas ao ouvir são aceitas, como a letra O no lugar do dígito zero. **Novo código** substitui o código, e o código antigo deixa de funcionar na hora. A organização pode limitar os códigos a determinados domínios de e-mail, como o domínio da sua escola. Um código nunca remove uma suspensão. Depois de muitas tentativas erradas, espere um minuto e tente de novo.

## Alternar entre espaços de trabalho
Clique no logotipo do Nodaro, no topo da barra lateral. Em **Espaços de trabalho**, o menu lista **Pessoal** e, para cada organização, as turmas ou equipes de que você faz parte. Escolha uma opção para trabalhar nela.

- **O trabalho novo fica onde você está.** Um workflow ou projeto que você cria enquanto um espaço de trabalho está selecionado pertence a esse espaço de trabalho.
- **Os espaços de trabalho arquivados continuam na lista.** Você ainda pode abri-los e ler tudo, mas nada novo pode ser adicionado.
- **Algumas organizações desativam o espaço pessoal.** Nesse caso, tudo o que um membro cria pertence à organização, e você cria o trabalho dentro de um espaço de trabalho.

## Compartilhar trabalho
Um workflow em um espaço de trabalho é privado para quem o criou ou visível para o espaço de trabalho inteiro. As configurações da organização definem onde o trabalho novo começa.

Para mudar quem pode acessar um workflow, abra a aba **Apresentar** do editor e a caixa de diálogo de compartilhamento dela:

- **Todos neste espaço de trabalho** ou **Só as pessoas com quem eu compartilhar** define a visibilidade do workflow. Só quem criou o workflow ou um administrador do espaço de trabalho pode alterá-la.
- **Pessoas com acesso** adiciona uma pessoa por e-mail, com a permissão **Pode visualizar** ou **Pode editar**. O acesso começa na hora, sem etapa de aceite.

Algumas regras mantêm o trabalho compartilhado seguro:

- **Pessoas de fora do espaço de trabalho só podem ver.** Quem não é membro recebe acesso de visualização, mesmo com permissão de edição.
- **Executar exige ser membro.** Só membros ativos do espaço de trabalho podem executar os workflows dele.
- **Colaboradores não podem excluir.** Só quem criou o workflow ou um administrador do espaço de trabalho pode excluí-lo.
- **Sair é sempre permitido.** Qualquer pessoa pode remover o próprio acesso.

Os workflows compartilhados com você fora dos seus espaços de trabalho aparecem na página **Compartilhados comigo**.

## Configurações do espaço de trabalho
As configurações funcionam em camadas. Uma configuração do espaço de trabalho prevalece sobre a configuração da organização, que prevalece sobre o padrão do tipo de organização.

| Configuração | Opções |
| --- | --- |
| **O que os administradores podem fazer com o trabalho de um membro?** | Ver, ou ver e alterar |
| **Onde o trabalho novo começa?** | Privado para quem o criou, ou visível para o espaço de trabalho |
| **O que os membros podem fazer com o trabalho compartilhado em cada espaço de trabalho?** | Ver, ou ver e alterar |
| **Os membros podem criar os próprios projetos?** | Sim, ou o trabalho acontece dentro dos lugares que você cria |
| **Os membros mantêm um espaço pessoal?** | Sim, ou tudo o que um membro cria pertence à organização |
| **Os administradores dos espaços de trabalho podem convidar novas pessoas?** | Sim, ou só os administradores da organização adicionam novas pessoas |
| **Os colaboradores podem convidar outros colaboradores?** | Sim, ou o compartilhamento fica com a pessoa dona do trabalho |
| **Quem pode entrar com código** | Qualquer pessoa com o código, ou só os domínios de e-mail que você listar |

## Arquivar, suspender e sair
- **Arquive um espaço de trabalho** quando uma turma terminar. Tudo o que está nele continua disponível para leitura, nada novo pode ser adicionado, e você pode tirar trabalhos dele. Um administrador pode reabri-lo.
- **Suspenda um membro** para impedir que ele aja, sem removê-lo. Uma suspensão na organização vale em todos os espaços de trabalho. **Reativar** encerra a suspensão.
- **Remova alguém de um espaço de trabalho**, e a pessoa continua na organização. Remova-a da organização, e ela sai de todos os espaços de trabalho da organização.
- **Saia de uma organização** a qualquer momento, o que também remove você dos espaços de trabalho dela. O proprietário precisa antes transferir a propriedade para um administrador.
- **Exclua uma organização** só depois que todos os espaços de trabalho forem arquivados. Só o proprietário pode excluí-la.

## Histórico
Proprietários e administradores da organização podem ler o **Histórico** da organização. Ele registra quem foi convidado, quem entrou ou saiu, mudanças de função e suspensões. Também registra espaços de trabalho criados ou arquivados, mudanças de configuração e mudanças de código de entrada. O histórico continua disponível para leitura mesmo enquanto a organização está suspensa.

## Automações em um espaço de trabalho
Um [gatilho](https://nodaro.ai/docs/guides/automations) executa um workflow em nome da pessoa que o configurou. Toda vez que um gatilho de agendamento, de webhook ou do Telegram dispara, o Nodaro verifica se essa pessoa ainda pode executar o workflow. Quando ela perdeu o acesso, por exemplo porque a participação dela foi suspensa ou o espaço de trabalho foi arquivado, a automação para. O histórico de execuções do workflow então mostra uma execução com falha que explica o motivo.

Trate a URL de um gatilho de webhook como uma senha. Qualquer pessoa que a tenha pode iniciar o workflow.

## Por código
A API REST, o [SDK](https://nodaro.ai/docs/developers/sdk) e a [CLI](https://nodaro.ai/docs/developers/cli) podem criar organizações, adicionar pessoas, enviar convites e gerenciar códigos de entrada. Eles também escolhem o espaço de trabalho em que uma requisição atua. Os assistentes conectados via [MCP](https://nodaro.ai/docs/mcp) podem listar os seus espaços de trabalho e selecionar um. Veja a [API de espaços de trabalho](https://nodaro.ai/docs/developers/api/workspaces).

## Frequently asked questions

### Qual é a diferença entre uma organização e um espaço de trabalho?

Uma organização é o grupo inteiro, uma escola ou uma equipe, com um proprietário. Um espaço de trabalho é onde os membros trabalham juntos dentro dela, como uma turma em uma escola ou uma equipe em uma empresa. Uma organização pode ter vários espaços de trabalho.

### Como entro em uma turma com um código?

Abra o menu abaixo do logotipo do Nodaro, no topo da barra lateral, e escolha “Entrar com código”. Digite o código de oito caracteres que você recebeu; o hífen é opcional. O código torna você membro apenas daquele espaço de trabalho.

### Por quanto tempo um convite é válido?

Um link de convite vale por 14 dias. Entre com o endereço de e-mail para o qual ele foi enviado. Se ele tiver expirado, peça um novo; reenviar um convite cria um novo link, e o link antigo deixa de funcionar.

### Um professor pode ver o trabalho de um aluno?

Em uma escola, o trabalho começa privado para o aluno que o criou, e os administradores, como os professores, podem ver e alterar o trabalho de um membro por padrão. A organização pode mudar as duas configurações.

### Para onde vai o meu trabalho quando eu mudo para um espaço de trabalho?

Tudo o que você cria enquanto um espaço de trabalho está selecionado fica nesse espaço de trabalho. Volte para “Pessoal” para trabalhar de novo no seu próprio espaço.