# Downloads

> O espaço que partilha ficheiros (folhas de cálculo, e-books, PDFs, modelos) num repositório ou num ficheiro só, grátis, vendido ou incluído no plano. Quem envia, a aprovação, o carimbo nos PDFs, Os meus downloads e os contadores da equipa.

O módulo **Downloads** é o lugar para distribuir ficheiros à comunidade: uma folha de cálculo, um e-book, um PDF, um modelo, um pacote ZIP. O espaço pode ser um **repositório** (vários itens, cada um com um ou mais ficheiros) ou **um ficheiro só**. Cada item é grátis para quem vê o espaço, vendido por um [produto](/monetizacao/produtos) ou incluído num [plano](/monetizacao/planos).

Os ficheiros ficam guardados numa área **privada**. Ninguém recebe um endereço permanente: cada download gera, no momento, um link que vale **5 minutos**.

## Para que serve

| Comunidade | Downloads |
|---|---|
| Escola online | O e-book do curso, vendido à parte, e a folha de exercícios, grátis para os alunos |
| Associação | Atas, estatutos e modelos de documento, só para os associados |
| Consultoria | Um kit de modelos em ZIP, incluído no plano premium |
| Coworking | O manual da casa, em PDF, num espaço de um ficheiro só |

## Como funciona

### Repositório ou um ficheiro só

Na criação do espaço, o passo **Como o espaço funciona** pede o modo:

| Modo | O que o espaço mostra |
|---|---|
| **Repositório** (padrão) | Vários itens, cada um com um ou mais ficheiros, filtráveis por categoria. Não há limite de itens nem de ficheiros por item |
| **Um ficheiro só** | O espaço mostra um único ficheiro, diretamente. Para o trocar, **substitua** o ficheiro: um segundo item ou um segundo ficheiro é recusado |

Em **Repositório**, as **categorias** são opcionais (o ecrã sugere *Folhas de cálculo*, *E-books* e *Modelos*). Cada item tem no máximo uma categoria, e uma categoria que tem itens só pode ser removida depois de mover ou apagar esses itens.

### O item

| Campo | Para quê |
|---|---|
| **Título** | Obrigatório |
| **Descrição** | Texto formatado |
| **Capa** | Opcional. JPG, PNG, WEBP ou GIF, até 20 MB |
| **Categoria** | Uma das categorias do espaço (só no repositório) |
| **Ficheiros** | Os ficheiros do item, enviados na página dele |
| **Carimbar PDF** | Ver [Carimbar PDFs](#carimbar-pdfs) |

Um item novo nasce em **Rascunho** (só a equipa e o autor o veem). **Publicar** exige pelo menos **um ficheiro**. Despublicar devolve o item a rascunho.

### Ficheiros aceites

| Tipo | Formatos |
|---|---|
| Imagens | PNG, JPG, WEBP, GIF |
| Folhas de cálculo | XLS, XLSX, ODS, CSV |
| PDF | PDF |
| Documentos | DOC, DOCX, ODT, TXT, MD, PPT, PPTX |
| Comprimidos | ZIP |

- **Até 200 MB por ficheiro.** Não há limite de quantidade de ficheiros.
- **Nenhum executável** e nenhum outro tipo de ficheiro. A Memberfy confere o **conteúdo** do ficheiro, não só a extensão: um executável renomeado para `.pdf` é recusado e apagado.
- O envio vai diretamente do seu navegador para o armazenamento, com barra de progresso, e é possível enviar vários ficheiros de uma vez, arrastando-os.
- Os ficheiros entram na conta de armazenamento da comunidade, que **só avisa** quando passa do limite: o envio nunca é bloqueado.
- Cada pessoa pode fazer até **60 envios de multimédia por hora** (ficheiros de Downloads e outra multimédia alojada); passado isso, o ecrã pede para tentar de novo mais tarde.
- **Substituir** põe outro ficheiro no lugar; **Remover** pede confirmação (*"Quem já descarregou fica com a cópia."*). Quem descarregar depois recebe o ficheiro novo. Remover o último ficheiro de um item publicado devolve-o a rascunho.
- A ordem dos ficheiros muda com **Subir** e **Descer**.

### Quem envia e quem configura

| Ação | Quem |
|---|---|
| Configurar o espaço (modo, categorias, aprovação) | Proprietário e administrador |
| Criar item e enviar ficheiros | Quem o **Quem pode postar** do espaço permite. Por padrão, só a equipa (proprietário, administrador, moderador e financeiro), também quando o espaço é criado pela API ou pelo assistente |
| Editar, trocar ficheiros, publicar e apagar um item | O autor do item e a equipa |
| Descarregar | Quem tem acesso ao item, como descrito em [Quem descarrega](#quem-descarrega) |
| Ver os contadores | A equipa |

O proprietário e o administrador podem abrir o envio aos **membros** em **Quem pode postar**. Isso soma-se à regra de acesso do espaço: quem não vê o espaço não envia nem descarrega.

### Aprovação dos itens dos membros

Com **Analisar os itens dos membros** ligado na configuração do espaço, o item criado por um membro fica **Em análise**, invisível para os outros, até a equipa decidir pela fila de [moderação](/membros/moderacao). O separador **Em análise** do espaço mostra a fila.

- **Aprovar** publica o item **no momento**, se ele já tiver ficheiro (o autor não precisa de publicar outra vez).
- **Recusar** pede o motivo, e o autor é avisado.
- **Editar** um item publicado de um membro **devolve-o à análise**.
- Os itens da equipa não passam pela fila.

### Preço e venda

Cada item nasce com um **produto** ligado a ele, em rascunho e **gratuito**. Na página do item, a equipa vê a faixa **Preço e venda**, que abre o produto para definir preço, stock, planos e publicar. Esse produto tem o tipo **Download** e não se apaga à parte: apagar o item arquiva o produto. Ver [Tipos de produto](/monetizacao/produtos#tipos-de-produto).

### Quem descarrega

| Situação do item | Quem descarrega |
|---|---|
| Sem preço (produto em rascunho, inativo ou de preço zero) | Qualquer pessoa que veja o espaço |
| Com preço e produto publicado | Quem **comprou** (compra confirmada e ativa) e quem tem um **plano que inclui o produto** |
| Sempre | A equipa e o autor do item |

- **Quem não tem acesso** vê o item com um cadeado: título, capa, preço e o botão **Comprar**, sem os nomes dos ficheiros e sem link.
- **Reembolso, contestação (chargeback), fim do prazo de acesso e saída do plano** fecham o acesso a novos downloads. Quem já descarregou fica com a cópia que tem, mas **ter descarregado antes não garante acesso**: vale só a regra atual.
- **Item que era grátis e passa a ter preço:** quem não comprou e não tem um plano que o inclua passa a precisar de comprar, mesmo que já o tenha descarregado antes.
- **Stock (opcional):** se o produto tem stock e este acaba, o item aparece como esgotado e entra a [lista de espera](/monetizacao/produtos#vagas-e-lista-de-espera). Com stock definido, até um item de preço zero passa por uma confirmação de "obter grátis" para ficar com a unidade.
- O e-mail de confirmação da compra de um download leva a **Os meus downloads** (pede início de sessão), nunca a um link de ficheiro.

### Os meus downloads

Cada membro vê o que pode descarregar em **Faturação › Minhas compras › Os meus downloads**: os itens comprados, incluídos no plano ou gratuitos, com a origem do acesso (**Comprado**, **No teu plano**, **Grátis**), a data da compra, o último download e, quando há prazo, *"Acesso até"*. A lista só mostra o que a pessoa pode realmente descarregar, com as datas no fuso horário da comunidade.

### Carimbar PDFs

Em **Editar** o item, quem gere um item que tem pelo menos um PDF vê o interruptor **Carimbar PDF** (desligado por padrão). Ligado, **quem descarregar um PDF** recebe uma **cópia** com uma linha pequena, a cinzento, no rodapé da **última página**: *"Descarregado por {e-mail} em {data e hora}"*, no fuso horário da comunidade.

- **A equipa e o autor descarregam sem carimbo**, para conferir o ficheiro. O original nunca é alterado.
- **PDF acima de 25 MB**, protegido por palavra-passe ou corrompido sai **sem carimbo**, e o download funciona normalmente.
- Outros tipos de ficheiro não recebem carimbo.
- O carimbo **ajuda a rastrear uma fuga, mas não a impede**: quem tem o ficheiro pode partilhá-lo.

### Contadores para a equipa

Na página do item, a equipa vê quantos downloads houve, no total e por pessoas diferentes, por item e por ficheiro, e a data do último. Os downloads da própria equipa não entram na conta. O membro não vê contadores. Os números mostram quantos, não quem.

## Passo a passo

### Criar o espaço

*Papel: proprietário ou administrador.*

1. Em **Adicionar Espaço**, escolha o módulo **Downloads**.
2. No passo **Como o espaço funciona**, escolha **Repositório** ou **Um ficheiro só**.
3. No repositório, acrescente as **Categorias** (opcional) e, se os membros forem enviar, ligue **Analisar os itens dos membros**.
4. Defina a visibilidade e **Quem pode postar**, e crie o espaço.

Para mudar o modo, as categorias ou a aprovação mais tarde, use **Configurar o espaço** na barra **Gestão do espaço**. Passar para **Um ficheiro só** com um item de dois ou mais ficheiros é recusado.

### Criar um item e enviar os ficheiros

*Papel: quem o espaço deixa criar.*

1. No espaço, clique em **Novo download** (no modo de um ficheiro, **Adicionar o ficheiro**).
2. Preencha **Título**, **Descrição**, **Categoria** e a **Capa**, e clique em **Criar e adicionar ficheiros**.
3. Na página do item, em **Ficheiros**, arraste os ficheiros ou use **Escolher ficheiros**.
4. Quando todos terminarem, clique em **Publicar**.

### Vender o item

*Papel: proprietário ou administrador.*

1. Na página do item, clique em **Preço e venda**.
2. Defina o **Preço** e, se quiser, o stock, os planos em que o item é incluído, e publique o produto. Ver [Produtos](/monetizacao/produtos). Publicar um produto com preço pede a [Informação Comercial](/pagamentos/informacao-comercial) aprovada; um produto gratuito não pede.
3. Quem não tem acesso passa a ver o preço e **Comprar**.

### Descarregar

1. Abra o item e clique em **Descarregar** ao lado do ficheiro (*"O link de download é gerado quando clicas e vale por 5 minutos."*).
2. Para rever o que tem, abra **Os meus downloads**.

## Exemplos

**E-book do curso.** Espaço **Materiais** (Repositório, visibilidade **Privada**). O item *E-book Excel do Zero* é publicado com preço de R$ 29. Os alunos veem o cadeado e **Comprar · R$ 29,00**; quem comprou descarrega. O item *Folha de exercícios*, sem preço, é de todos os alunos.

**Manual da casa.** Espaço **Manual** no modo **Um ficheiro só**: só a equipa envia, e todo o membro descarrega o PDF. Para publicar uma versão nova, a equipa usa **Substituir** no ficheiro.

**Modelos dos associados.** Repositório com a categoria *Modelos*. O administrador abre o envio aos membros e liga a análise: o modelo enviado por um associado só aparece depois de a equipa o aprovar.

## Erros comuns e como resolver

| Mensagem | O que fazer |
|---|---|
| *Esse tipo de ficheiro não é aceito. Usa PDF, folhas de cálculo, documentos, imagens ou ZIP.* | Converta para um dos formatos aceites |
| *O ficheiro tem mais de …* | O limite é de 200 MB por ficheiro; reduza ou divida |
| *O ficheiro está vazio.* | Escolha outro ficheiro |
| *Ainda não tens acesso a este ficheiro.* | O item é pago: compre-o, ou use o plano que o inclui |
| *Este item está esgotado.* | Entre na lista de espera |
| *Downloads demais em pouco tempo. Tenta de novo em alguns minutos.* | Espere alguns minutos |
| O botão **Publicar** não funciona | Envie pelo menos um ficheiro antes |
| O membro não vê **Novo download** | O **Quem pode postar** do espaço é só da equipa |

## Perguntas frequentes

**O link do ficheiro pode ser partilhado?**
Vale 5 minutos e é gerado para quem clicou. Quem quiser rastrear a origem de uma fuga de PDF pode ligar o [carimbo](#carimbar-pdfs).

**Posso vender um ficheiro sem criar um produto?**
Não: todo o item tem o seu produto, em rascunho e gratuito, e o preço é definido nele.

**Quem comprou o item perde o acesso se eu trocar o ficheiro?**
Não. O ficheiro novo vale para os próximos downloads; o acesso continua.

**É possível descarregar todos os ficheiros de um item de uma vez?**
Ainda não: cada ficheiro tem o seu botão.

**Há antivírus?**
Não. A Memberfy bloqueia executáveis e confere o tipo pelo conteúdo, mas não analisa os ficheiros à procura de vírus.

## Pelo assistente

O assistente configura o espaço, cria os itens, envia os ficheiros (por link ou ficheiro), publica, mostra os contadores e, para quem descarrega, lista os downloads e entrega o link de 5 minutos. Ver [Ferramentas · Downloads](/mcp/ferramentas-downloads).

## Na API

`GET` e `PUT /api/downloads/spaces/{spaceId}` (modo, categorias, aprovação); `GET` e `POST /api/downloads/items`, `GET`, `PUT` e `DELETE /api/downloads/items/{id}`; os ficheiros em `/api/downloads/items/{id}/files` (`upload-url`, `confirm`, `reorder`, `{fileId}/replace` e `DELETE {fileId}`); `POST /api/downloads/files/{fileId}/download` (devolve o link de 5 minutos e `stamped`); `GET /api/me/downloads`; `GET /api/downloads/items/{id}/stats`; e a fila `GET /api/moderation/downloads/pending`. A comunidade vem do cabeçalho `X-CommunityId`. O produto 1:1 vem no campo `product` do item.

## Relacionados

- [Produtos](/monetizacao/produtos)
- [Planos](/monetizacao/planos)
- [Moderação](/membros/moderacao)
- [Módulos](/conceitos/modulos)
- [Faturamento do membro](/pagamentos/faturamento-do-membro)