# Espaços

> O espaço é a área onde as coisas acontecem: fica dentro de uma seção, tem um módulo, e define quem vê, quem cria conteúdo e o que é preciso para entrar.

O **espaço** é cada item do menu lateral, dentro de uma [seção](/conceitos/secoes): "Feed", "Aulas", "Agenda", "Galeria de fotos". É onde o conteúdo vive. Todo espaço tem um [módulo](/conceitos/modulos), escolhido na criação, que diz o que ele é (um feed, uma lista de eventos, cursos…).

<div class="flow">
<div class="flow-row"><span class="flow-node">Seção</span><span class="flow-arrow">→</span><span class="flow-node">Espaço</span><span class="flow-arrow">→</span><span class="flow-node">Módulo (um só)</span><span class="flow-arrow">→</span><span class="flow-node">Itens do espaço</span></div>
</div>

## Para que serve

O espaço é a unidade de acesso e de organização. Cada um responde a três perguntas:

1. **O que é?** O módulo: Feed, Conteúdo, Eventos, Cursos, Galeria, Ranking, Link, Chamada, Loja ou Certificados.
2. **Quem vê?** A visibilidade: Público, Membros, Assinantes ou Privada.
3. **Quem publica?** A regra **Quem pode postar**: Qualquer um, Equipe ou Admins.

Exemplos reais:

| Espaço | Módulo | Visibilidade | Quem pode postar |
|---|---|---|---|
| Avisos da empresa | Feed | Membros | Equipe |
| Mural dos residentes do coworking | Feed | Privada (plano Residente) | Qualquer um |
| Aulas do curso | Cursos | Privada (produto do curso) | Admins |
| Agenda de lives | Eventos | Membros | Equipe |
| Blog aberto | Conteúdo | Público | Admins |
| Fotos do evento | Galeria | Membros | Qualquer um |

## Como funciona

### O que um espaço tem

| Campo | Para quê |
|---|---|
| **Módulo** | O tipo do espaço. Escolhido no primeiro passo |
| **Ícone** | Ao lado do nome no menu |
| **Título** | O nome no menu. Obrigatório |
| **Slug** | O pedaço do endereço. O espaço fica em `/<seção>/<espaço>`. Gerado do título; único dentro da seção |
| **Descrição** | Opcional |
| **Visibilidade** | Quem vê o espaço. Nunca mais aberta que a da seção |
| **Quem tem acesso** | Com **Privada**: grupos, produtos ou planos que liberam |
| **Quem pode postar** | Quem cria itens dentro do espaço |
| **Configuração do módulo** | O que o módulo pedir: o endereço externo do Link, o tipo da Chamada… |

### Visibilidade e acesso

A visibilidade padrão de um espaço novo é **Membros**. As regras completas, e o que o membro vê quando não tem acesso, estão em [Visibilidade e acesso](/conceitos/visibilidade-e-acesso). O resumo:

- **Público**: qualquer pessoa, até sem login.
- **Membros**: quem é da comunidade.
- **Assinantes**: quem tem qualquer assinatura ativa. Para os outros, o espaço não aparece.
- **Privada**: só quem está na lista. Se a lista tem um **plano** ou um **produto**, quem não tem aparece o espaço com um cadeado (*Exige um plano* / *Exige uma compra*); se a lista só tem **grupos**, o espaço some do menu para quem não está neles.

Proprietários, administradores e moderadores veem todos os espaços.

### Quem pode postar

| Opção | Quem cria itens no espaço |
|---|---|
| **Qualquer um** | Quem o tipo de item permite (o padrão) |
| **Equipe** | Proprietários, administradores e moderadores |
| **Admins** | Proprietários e administradores |

Comentar e reagir continuam abertos a quem vê o espaço. Lembre que alguns itens já têm papel mínimo próprio: evento é de moderador para cima, curso é de administrador para cima. Ver [Papéis e permissões](/conceitos/papeis-e-permissoes#2-quem-pode-criar-quem-publica-dentro-do-espaco).

### Moderação prévia

A configuração do módulo de Feed e de Conteúdo traz a chave **Exigir aprovação antes de publicar** (*"Todo conteúdo precisará de aprovação do admin antes de ficar visível"*).

> [!SOON]
> A aprovação prévia ainda não tem efeito: o que se publica aparece na hora. A fila de aprovação e a tela de moderação estão chegando. Ver [Moderação](/membros/moderacao).

### Quem cria e organiza espaços

Criar, editar, mover e excluir espaços é de **proprietários e administradores**.

## Passo a passo

### Criar um espaço

*Papel: proprietário ou administrador.*

1. No menu, embaixo da seção onde o espaço vai morar, clique em **Adicionar Espaço**.
2. **Módulo**: na aba **Comunidade**, escolha um dos módulos (Conteúdo, Eventos, Cursos, Ranking, Feed, Link, Galeria, Chamada, Certificados) e clique em **Próximo**. As abas **Planejamento & RH** e **Coworking** mostram módulos que ainda não estão disponíveis.
3. **Configuração › Detalhes do espaço**: escolha o **Ícone**, escreva o **Título** e, se quiser, o **Slug** e a **Descrição**. O slug do espaço não pode começar com `_`: *"Este endereço não pode ser usado…"*.
4. Escolha a **Visibilidade**. Com **Privada**, adicione em **Quem tem acesso** os grupos, produtos ou planos.
5. Escolha **Quem pode postar**.
6. Em **Configuração do módulo**, preencha o que aparecer (para **Link**, o endereço; para **Chamada**, quantas chamadas e o tipo).
7. Clique em **Criar Espaço**. Ele aparece na seção, no fim da lista.

![O segundo passo da criação de espaço](/screens/espaco-configuracao.png "Configuração: ícone, título, slug, descrição, visibilidade, quem pode postar e a configuração do módulo.")

### Editar

Passe o mouse sobre o espaço no menu, abra **Opções do espaço › Editar espaço**, mude e salve. O **Tipo de Módulo** aparece na edição, mas trocá-lo num espaço que já tem conteúdo esconde esse conteúdo (um evento não aparece num Feed de outro módulo). Prefira criar um espaço novo.

### Mover para outra seção e reordenar

Arraste o espaço pelo menu: para cima e para baixo muda a ordem; para outra seção, muda de lugar. Se o slug já existir na seção de destino, ele é ajustado. O espaço continua respeitando a visibilidade da seção nova: num lugar mais fechado, ele fica mais fechado.

### Excluir

Abra **Opções do espaço › Excluir espaço** e confirme. O espaço some do menu para todos, com o que estava dentro. A exclusão não pode ser desfeita pela tela.

Não existe "arquivar": para tirar um espaço de circulação sem excluí-lo, ponha-o como **Privada** com a lista vazia (só a equipe vê) ou mova-o para uma seção da equipe.

## O que o membro vê

- No menu, só os espaços que pode abrir, e os trancados por plano ou produto com o cadeado.
- Dentro do espaço, a tela do módulo: a linha do tempo do Feed, a lista de eventos, os cursos.
- O botão de criar (**Novo Status**, **Criar Conteúdo**, **Criar Evento**…) só para quem pode criar ali.

## Erros comuns e como resolver

| Mensagem | O que fazer |
|---|---|
| *Este espaço não pode ser mais aberto que a seção "…", que é …* | Feche o espaço ou abra a seção |
| *A concessão de acesso "…" não existe nesta comunidade.* | Tire da lista o grupo, produto ou plano excluído |
| *Seção não encontrada ou não pertence a esta comunidade.* | A seção foi excluída; escolha outra |
| *Apenas membros da equipe (admin, proprietário, moderador) podem realizar esta ação* | O espaço está como **Equipe** e a pessoa é membro |
| *Apenas administradores (admin, proprietário) podem realizar esta ação* | O espaço está como **Admins** |
| *Você não tem acesso a este espaço.* | A pessoa não tem o plano, o produto ou o grupo da lista |

## Perguntas frequentes

**Um espaço pode estar em duas seções?**
Não. Cada espaço pertence a uma seção. Para aparecer em dois lugares, use um espaço de **Link** apontando para o outro.

**Posso ter dois Feeds?**
Pode, e é comum: um Feed geral e um Feed da turma, por exemplo. O Feed geral mostra o que vem dos espaços que a pessoa pode ver.

**Quem não tem acesso vê que o espaço existe?**
Depende: com plano ou produto na lista, vê com cadeado (é uma vitrine); com grupo ou com **Assinantes**, não vê.

**O que acontece com o conteúdo quando mudo a visibilidade?**
Nada é apagado. Só muda quem consegue ver.

## Na API

`POST /api/spaces` (com `sectionId`, `title`, `module`, `visibility`, `access`, `canCreate`), `PUT /api/spaces/{id}`, `DELETE /api/spaces/{id}`, `POST /api/spaces/reorder` e `GET /api/spaces/modules`. Ver [Sections & Spaces](/api/referencia/sections-spaces) e a [Ordem de criação](/api/ordem-de-criacao).

## Relacionados

- [Seções](/conceitos/secoes)
- [Módulos](/conceitos/modulos)
- [Papéis e permissões](/conceitos/papeis-e-permissoes)
- [Visibilidade e acesso](/conceitos/visibilidade-e-acesso)