# Papéis e permissões

> Os níveis de acesso da Memberfy (do visitante ao proprietário), quem dá cada papel, como eles se combinam com a visibilidade e as regras de cada espaço, e por que um botão aparece para uma pessoa e não para outra.

Tudo o que alguém pode fazer numa comunidade sai da combinação de duas coisas:

1. **O papel da pessoa naquela comunidade**: proprietário, administrador, moderador, financeiro ou membro. Ele vale para a comunidade inteira.
2. **As regras de cada seção e de cada espaço**: quem vê (a visibilidade), quem cria conteúdo dentro dele e o que exige para entrar (um plano, um produto, um grupo).

O papel diz **o que você pode fazer**. As regras do espaço dizem **onde você pode fazer isso**. Este artigo explica as duas coisas e como elas se cruzam. Vale lê-lo antes de montar [seções](/conceitos/secoes) e [espaços](/conceitos/espacos), porque toda escolha que você faz lá depende dele.

## Os níveis, do menor ao maior

| Nível | Quem é | Como chega lá |
|---|---|---|
| **Visitante** | Quem abre o endereço da comunidade sem estar logado | Basta ter o link |
| **Membro** | Quem tem conta e perfil na comunidade | Convite, cadastro aberto ou compra |
| **Financeiro** | Contador, sócio ou quem cuida do dinheiro | Dado por um proprietário ou administrador |
| **Moderador** | Quem cuida das conversas e do conteúdo | Dado por um proprietário ou administrador |
| **Administrador** | Quem gerencia a comunidade no dia a dia | Dado por um proprietário ou administrador |
| **Proprietário** | Dono da comunidade | Dado só por outro proprietário (ou pela equipe da Memberfy) |
| **SuperAdmin** | A equipe da Memberfy, para suporte | Não é dado por ninguém da comunidade |

A ordem de poder é **Proprietário › Administrador › Moderador › Membro**. O **Financeiro** fica **ao lado** dessa escada, não acima do membro: ele lê as finanças e, fora delas, é um membro comum.

### Visitante

Não tem conta, ou não está logado. Vê só o que está marcado como **Público**: seções e espaços públicos, a página de preços da comunidade (`/pricing`) e o link de uma oferta de última chance recebido por e-mail (`/oferta/…`). Para comentar, reagir, comprar ou ver qualquer outra coisa, precisa entrar.

### Membro

O papel padrão de quem entra. Participa dos espaços a que tem acesso: lê, comenta, reage, confirma presença em eventos, se matricula em cursos e cria conteúdo **nos espaços que deixam qualquer membro criar**. Vê também o próprio **Faturamento** (assinaturas, cartões, cobranças) e o próprio perfil. Não vê a área de **Administração**.

### Financeiro

Pensado para o contador ou para o financeiro da empresa. Abre **Monetização** e vê tudo o que é dinheiro: o painel **Geral** (total arrecadado, disponível, retido, pendente), o extrato, os saques, os produtos, os planos, os cupons e o uso deles, as taxas, e a aba **Pagamentos** (dados da empresa e bancários). **Não muda nada** ali: não cria produto, não edita plano, não pede saque, não altera dados bancários nem documentos. A exceção são as assinaturas: em **Membros › Assinaturas** (no menu, o item **Membros** abre direto nessa aba, a única que ele vê), o financeiro age sobre cada assinatura, como o proprietário e o administrador. Ver [Gestão de assinaturas](/pagamentos/gestao-de-assinaturas). Fora disso, é um membro como qualquer outro: não modera, não gerencia membros nem espaços.

### Moderador

Cuida da convivência. Vê **todos** os espaços, inclusive os privados, e:

- edita e exclui posts, comentários e imagens de outras pessoas nos espaços de conteúdo, galeria e comentários;
- fixa e desafixa itens no topo do Feed;
- cria e edita eventos e inicia a transmissão;
- organiza as tags dos membros;
- consulta e decide a fila de moderação (por enquanto pela API; a tela está chegando);
- abre **Administração › Membros**.

Não convida pessoas, não troca papéis, não cria seções nem espaços, não acessa **Configurações** nem **Monetização**.

### Administrador

Gerencia a comunidade: convida e remove membros, troca papéis (inclusive promovendo alguém a administrador), cria e organiza seções e espaços, configura a comunidade, cria produtos, planos, cupons, cuida da Informação Comercial e da conta bancária e pede saques. A única coisa que **não** pode é prejudicar um proprietário: não remove, não rebaixa e não edita o perfil de um proprietário, e não torna ninguém proprietário.

### Proprietário

Pode tudo o que o administrador pode, e mais: excluir a comunidade, tornar alguém proprietário e mexer no perfil de outro proprietário. Uma comunidade pode ter mais de um proprietário. O proprietário não consegue simplesmente sair da comunidade: *"O proprietário não pode sair da comunidade"*.

### SuperAdmin

A equipe da Memberfy, para suporte. Passa por todas as regras acima. Quando um SuperAdmin age numa comunidade, ele aparece nela com um perfil de proprietário. Trocar o **e-mail de login** ou o **telefone** de alguém é exclusivo do SuperAdmin, porque essa troca afeta a pessoa em todas as comunidades dela.

## Quem dá e tira cada papel

| Ação | Proprietário | Administrador | Moderador, Financeiro, Membro |
|---|:-:|:-:|:-:|
| Convidar ou criar membro, financeiro, moderador | ✔ | ✔ | — |
| Convidar ou criar administrador | ✔ | ✔ | — |
| Promover alguém a administrador ou moderador | ✔ | ✔ | — |
| Dar o papel **financeiro** | ✔ | ✔ | — |
| Tornar alguém **proprietário** | ✔ | — | — |
| Editar, rebaixar ou remover um **proprietário** | ✔ | — | — |
| Editar, rebaixar ou remover um administrador | ✔ | ✔ | — |
| Rebaixar a si mesmo | ✔ | ✔ | ✔ |

Duas regras importantes:

- **Ninguém entra como proprietário pelo convite.** Os papéis que se dão no convite e no **Novo Membro** são administrador, moderador, membro e financeiro. Para ter outro proprietário, convide a pessoa e depois promova-a, sendo você proprietário.
- **A proteção do proprietário vale em toda parte**: na tela de membros, na API e ao agir em nome de outro perfil.

O passo a passo de trocar o papel está em [Gerenciar membros](/membros/gerenciar-membros).

## As regras de cada espaço

Cada espaço (e cada seção) tem três controles que se somam ao papel:

### 1. Visibilidade: quem vê

| Visibilidade | Quem vê |
|---|---|
| **Público** | Qualquer pessoa, inclusive visitante |
| **Membros** | Qualquer membro da comunidade |
| **Assinantes** | Quem tem **qualquer** assinatura ativa |
| **Privada** | Só quem estiver na lista **Quem tem acesso**: pessoas de um **grupo**, quem comprou um **produto** ou quem assina um **plano** específico |

Proprietários, administradores e moderadores veem **sempre**, qualquer que seja a visibilidade. O financeiro, não: para ele vale a mesma regra de um membro.

A visibilidade da seção é o piso dos espaços dela: um espaço nunca é mais aberto que a seção. Os detalhes estão em [Visibilidade e acesso](/conceitos/visibilidade-e-acesso).

### 2. Quem pode criar: quem publica dentro do espaço

Cada espaço tem a regra **Quem pode postar**:

| Opção | Quem cria posts, status, eventos, cursos e imagens no espaço |
|---|---|
| **Qualquer um** | Todo mundo que pode criar aquele tipo de item (o padrão) |
| **Equipe** | Proprietários, administradores e moderadores |
| **Admins** | Só proprietários e administradores |

Essa regra é sobre **criar**. Comentar e reagir continuam abertos a quem vê o espaço. O papel **financeiro** conta como membro aqui: num espaço "Equipe", ele não cria.

Alguns tipos de item têm, além disso, um papel mínimo próprio, independente do espaço:

| Item | Quem pode criar |
|---|---|
| Post de conteúdo, status do Feed, imagem da galeria | Qualquer membro (respeitando o **Quem pode postar**) |
| Evento | Proprietário, administrador e moderador |
| Curso, módulo e aula | Proprietário e administrador |
| Chamada de trabalhos | Proprietário e administrador (e quem a chamada definir) |

### 3. Participação e moderação

Quem vê um espaço pode participar dele: comentar, reagir, confirmar presença, se matricular. A equipe pode moderar o que os outros publicaram.

## A matriz: papel × ação

Num espaço que a pessoa consegue ver, com **Quem pode postar = Qualquer um**:

| Ação | Visitante | Membro | Financeiro | Moderador | Administrador | Proprietário |
|---|:-:|:-:|:-:|:-:|:-:|:-:|
| Ver espaço público | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| Ver espaço de membros, assinantes ou privado | — | se tiver acesso | se tiver acesso | ✔ | ✔ | ✔ |
| Publicar post ou status | — | ✔ | ✔ | ✔ | ✔ | ✔ |
| Comentar e reagir | — | ✔ | ✔ | ✔ | ✔ | ✔ |
| Editar ou excluir o que é seu | — | ✔ | ✔ | ✔ | ✔ | ✔ |
| Editar ou excluir post e comentário dos outros | — | — | — | ✔ | ✔ | ✔ |
| Fixar no topo do Feed | — | — | — | ✔ | ✔ | ✔ |
| Criar e editar evento | — | — | — | ✔ | ✔ | ✔ |
| Excluir evento | — | — | — | — | ✔ | ✔ |
| Criar curso | — | — | — | — | ✔ | ✔ |
| Criar, editar e excluir seção ou espaço | — | — | — | — | ✔ | ✔ |
| Abrir Membros | — | — | só **Assinaturas** | ✔ | ✔ | ✔ |
| Agir sobre assinaturas (cortesia, desconto, cancelar, link de pagamento) | — | — | ✔ | — | ✔ | ✔ |
| Convidar e trocar papéis | — | — | — | — | ✔ | ✔ |
| Ver Monetização (saldo, extrato, vendas) | — | — | ✔ | — | ✔ | ✔ |
| Criar e editar produtos, planos e cupons | — | — | — | — | ✔ | ✔ |
| Pedir e cancelar saque | — | — | — | — | ✔ | ✔ |
| Enviar Informação Comercial, documentos e conta bancária | — | — | — | — | ✔ | ✔ |
| Mudar Configurações da comunidade | — | — | — | — | ✔ | ✔ |
| Excluir a comunidade | — | — | — | — | — | ✔ |

Uma diferença sutil: no **status do Feed** (o post curto), só proprietário e administrador editam ou excluem o status de outra pessoa; o moderador modera os comentários dele.

## Exemplos de combinação

**Espaço de avisos: só a equipe publica, todos comentam.**
Seção ou espaço **Membros**, módulo Feed ou Conteúdo, **Quem pode postar = Equipe**. Todo membro lê e comenta; só moderadores, administradores e proprietários publicam.

**Curso pago: só quem tem o plano Growth vê.**
Espaço de Cursos com visibilidade **Privada** e o plano **Growth** em **Quem tem acesso › Planos**. Quem não assina vê o espaço com um cadeado e a indicação *Exige um plano*; quem assina entra. Ver [Planos](/monetizacao/planos).

**Espaço aberto onde qualquer membro posta.**
Visibilidade **Membros**, **Quem pode postar = Qualquer um**. É o padrão de um espaço novo.

**Vitrine pública com conversa só para membros.**
Espaço **Público** de Conteúdo: o visitante lê os artigos; para comentar, precisa entrar.

**O financeiro vê o saldo, mas não mexe em plano.**
Dê o papel **Financeiro** ao contador. Ele abre **Monetização**, confere vendas, extrato e saques e exporta o CSV, mas os botões de criar, editar, pedir saque e os formulários bancários ficam em modo leitura (*"Visualização somente leitura: estes dados são mantidos pelo proprietário ou por um administrador da comunidade."*).

**Sala da diretoria.**
Espaço **Privada** liberado só para o grupo **Diretoria**. Quem não está no grupo não vê o espaço no menu (grupos não mostram cadeado).

## Seção, espaço e o que aparece no menu

A seção tem visibilidade e lista de acesso **próprias**, com as mesmas opções do espaço. Ela não é só um título: se a pessoa não passa pela seção, não vê nada dentro dela, mesmo que um espaço lá dentro seja mais aberto.

No menu lateral, para quem **não** pode entrar:

| Situação | O que a pessoa vê |
|---|---|
| Espaço privado liberado por **plano** | O espaço com um cadeado: *Exige um plano* |
| Espaço privado liberado por **produto** | O espaço com um cadeado: *Exige uma compra* |
| Espaço privado liberado só por **grupo**, ou sem ninguém na lista | Nada: o espaço não aparece |
| Espaço **Assinantes**, para quem não assina nada | Nada: o espaço não aparece |
| Espaço **Membros**, para visitante | Nada |

O cadeado existe para vender: quem vê o que está trancado sabe o que ganha ao assinar ou comprar.

## Permissões por item

Além do papel e das regras do espaço, **cada item** (post, comentário, evento, imagem) chega do servidor dizendo o que você pode fazer com ele: **editar**, **excluir**, **moderar**. É por isso que o mesmo post mostra o menu de editar para o autor e para um moderador, e não mostra para outro membro. A tela não decide sozinha: ela mostra o que o servidor autorizou, e o servidor confere de novo quando você clica.

## Erros comuns e como resolver

| Mensagem | O que significa | O que fazer |
|---|---|---|
| *Você não é membro desta comunidade.* | A conta não tem perfil nesta comunidade | Peça um convite, ou entre pelo **Cadastre-se** se o cadastro estiver aberto |
| *Apenas membros da equipe (admin, proprietário, moderador) podem realizar esta ação* | O espaço está como **Equipe**, ou a ação é de moderação | Peça a alguém da equipe |
| *Apenas administradores (admin, proprietário) podem realizar esta ação* | O espaço está como **Admins**, ou a ação é de gestão (produto, plano, cupom) | Peça a um administrador |
| *Só um owner ou um SuperAdmin pode remover, rebaixar ou alterar um owner.* | Um administrador tentou mexer num proprietário | Só outro proprietário faz isso |
| *Só um owner ou um SuperAdmin pode tornar alguém owner.* | Tentativa de promover a proprietário sem ser proprietário | Peça a um proprietário |
| *Apenas proprietários e administradores podem atribuir o papel financeiro.* | Um moderador tentou dar o papel financeiro | Peça a um administrador |
| *Você não tem acesso a este espaço.* | A visibilidade ou a lista de acesso não incluem você | Veja o cadeado: assine o plano ou compre o produto indicado |

## Perguntas frequentes

**Posso ter mais de um proprietário?**
Sim. Convide a pessoa como administradora e, sendo proprietário, promova-a a proprietário em **Membros**.

**Um administrador pode me remover, se eu sou o proprietário?**
Não. Nenhuma ação de um administrador alcança um proprietário.

**O moderador vê os espaços pagos?**
Sim. Proprietários, administradores e moderadores veem todos os espaços, para poder moderá-los. O financeiro não: para ele vale a regra do membro.

**O financeiro pode pedir saque?**
Não. Ele vê saldo e saques; pedir e cancelar saque é do proprietário e do administrador.

**Por que um membro não vê o botão de criar evento?**
Criar evento é de moderador para cima, em qualquer espaço. Para que membros sugiram encontros, use um espaço de Conteúdo ou o Feed.

**Mudar o papel de alguém muda o que ele vê na hora?**
Sim. Na próxima tela que a pessoa abrir, o menu e os botões já seguem o papel novo.

**O papel vale em todas as comunidades da pessoa?**
Não. O papel é do perfil naquela comunidade. A mesma pessoa pode ser proprietária de uma e membro de outra. Ver [Conta e perfil](/conceitos/conta-e-perfil).

## Na API

O papel é `profile.role`: `owner`, `admin`, `moderator`, `finance` ou `member`. A comunidade é a do header `X-CommunityId`, e é nela que o papel é conferido. Quem pode criar num espaço é `space.canCreate`: `anyone`, `staff` ou `admins`. Ver [X-CommunityId](/api/x-community-id) e [Sections & Spaces](/api/referencia/sections-spaces).

## Relacionados

- [Seções](/conceitos/secoes)
- [Espaços](/conceitos/espacos)
- [Visibilidade e acesso](/conceitos/visibilidade-e-acesso)
- [Gerenciar membros](/membros/gerenciar-membros)
- [Convidar membros](/membros/convidar-membros)