# Conteúdo programado

> Como abrir módulos e aulas aos poucos para o aluno: a programação, as regras e a entrega que liga as duas. Com exemplos e os erros mais comuns.

O conteúdo programado decide **quando** cada módulo e cada aula abre para o aluno. Por exemplo: o módulo 2 abre 7 dias depois da compra. Ele não decide **quem** tem acesso ao curso; isso é a matrícula.

## A ideia em um minuto

Pense no curso como um prédio. O produto é a porta do prédio, cada módulo é a porta de um andar e cada aula é a porta de uma sala.

- Uma **regra** diz quando uma porta abre. Por exemplo: "7 dias após a compra" ou "em 10 de março".
- Uma **programação** é um conjunto de regras com um nome, como "Turma de março".
- Uma **entrega** é o que o aluno compra. Ela diz qual programação vale para ele.

Para uma sala abrir, a porta do prédio, a do andar e a da sala precisam estar abertas.

**A regra mais importante:** uma programação sozinha não faz nada. Ela só vale para o aluno quando a entrega dele usa essa programação. Sem programação na entrega, o aluno vê todas as aulas no mesmo dia.

## Os tipos de regra

Você escolhe uma regra para o produto, para cada módulo e para cada aula. A janela se chama **Quando isto abre para o aluno?**.

| Regra | Quando abre | Você preenche |
|---|---|---|
| **Liberado** | Agora. Esta porta não tem tranca | Nada |
| **Dias após a compra** | Depois de N dias, contados da compra de cada aluno. Pode fechar N dias depois da mesma compra | **Abre depois de** e, se quiser, **Fecha depois de** |
| **Em uma data** | Na mesma data e hora para todos os alunos. Pode fechar numa data | **Abre em** e, se quiser, **Fecha em** |
| **Aprovação em prova** | Quando o aluno é aprovado numa prova. A prova pode ser de outro produto | **Prova** |
| **Em breve** | Nunca sozinho. O aluno vê a aula fechada, sem data e com uma mensagem fixa. Quando o conteúdo estiver pronto, você troca a regra | Nada |
| **Oculto** | Nunca. O aluno não vê a aula na lista. Num módulo, esconde também as aulas dele. Não existe para o produto | Nada |

Antes de salvar, a janela mostra uma frase com o resultado, por exemplo "7 dias após a compra". A mesma frase aparece na lista de módulos e aulas.

## Como a Cademí decide se uma aula abre

A Cademí confere três portas, nesta ordem: o produto, o módulo e a aula. Se uma porta não tem regra própria, ela segue a porta de cima. A lista mostra isso em itálico, por exemplo "Segue o módulo: abre em 10/03/26". Se uma linha tem regra própria e a porta de cima também tem tranca, a lista acrescenta "e também a regra do módulo".

```mermaid
flowchart TD
    accTitle: Quando uma aula abre
    accDescr: Se a entrega do aluno não usa uma programação, a aula abre. Se usa, a regra do produto, a do módulo e a da aula precisam passar, nessa ordem. Se uma delas não passa, a aula fica fechada ou oculta.
    entrega{"A entrega usa uma programação?"}
    produto{"A regra do produto passa?"}
    modulo{"A regra do módulo passa?"}
    aula{"A regra da aula passa?"}
    abre["Aula aberta"]
    bloqueada["Aula fechada ou oculta"]
    entrega -->|Não| abre
    entrega -->|Sim| produto
    produto -->|Não| bloqueada
    produto -->|Sim| modulo
    modulo -->|Não| bloqueada
    modulo -->|Sim| aula
    aula -->|Não| bloqueada
    aula -->|Sim| abre
    classDef destaque stroke:#ff005c,stroke-width:2px
    class abre destaque
```

O que isso quer dizer na prática:

- **Liberado** numa aula não abre essa aula antes do módulo. A porta do andar continua fechada.
- Uma regra no produto vale para o curso inteiro.
- Uma regra no módulo vale para as aulas que ficam direto nele. As aulas de um submódulo seguem o produto e o próprio submódulo.
- **Oculto** é a exceção: um módulo oculto esconde tudo o que está dentro dele.

## Quando abre e quando fecha

**Dias após a compra**

- A contagem começa na compra do aluno, com a hora. Uma compra às 15:00 com "7 dias" abre às 15:00 do sétimo dia.
- A contagem usa a compra mais antiga que ainda vale. Comprar de novo não recomeça a contagem e não fecha o que já abriu.
- Se você usa **Fecha depois de**, o conteúdo fica aberto até o fim daquele dia. O dia de fechar precisa ser depois do dia de abrir.
- Se a matrícula do aluno tem uma data de encerramento própria, é essa data que vale. O **Fecha depois de** não conta.

**Em uma data**

- Abre na data e na hora que você marcou.
- Um fechamento com hora fecha naquele minuto. Um fechamento só com a data fecha no fim do dia.
- Uma data de fechamento no produto encerra o acesso ao produto. Num módulo ou numa aula, fecha só essa parte.

**Aprovação em prova**

- Abre quando o aluno é aprovado na prova.
- Ser reprovado conclui a aula da prova, mas não abre a tranca.
- Uma prova sem nota mínima abre a tranca quando a tentativa termina. Veja [Provas](https://help.cademi.cloud/pt/conteudo/provas.md).

## Quando o aluno tem duas compras do mesmo curso

Cada compra traz a programação da própria entrega. A Cademí usa a regra **mais aberta**, nesta ordem:

1. **Liberado** (ou uma entrega sem programação)
2. **Dias após a compra**
3. **Em uma data**
4. **Aprovação em prova**
5. **Em breve**
6. **Oculto**

A Cademí compara o tipo de regra, não a data. "7 dias após a compra" vence "abre em 10 de março", mesmo se 10 de março chegar antes. **Oculto** só vale se todas as compras ocultam.

**Atenção: é aqui que mais acontece erro.** A Ana compra o curso com a programação semanal. Depois, ela ganha um bônus. A entrega do bônus inclui o mesmo curso, mas não usa programação. Resultado: no dia do bônus, a Ana vê todos os módulos. Para evitar isso, use a mesma programação em toda entrega que inclui o curso.

## Passo a passo

### Criar uma programação

1. Abra **Conteúdo > Conteúdo programado**.
2. Clique em **Nova programação**.
3. Em **Tag**, escolha uma tag ou clique em **Criar tag**. O nome da tag é o nome da programação.
4. Em **Produto**, escolha o produto.
5. Clique em **Criar programação**.

A tela abre o produto com a lista de módulos e aulas. No começo, tudo está **Liberado**.

Você também pode começar dentro do produto, na aba **Conteúdo programado**. Clique em **Nova programação** e escolha a tag. Se essa programação já existe neste produto, a tela abre a que já existe.

### Colocar as regras

1. No painel **Programações**, clique na programação.
2. Na lista, clique na linha do produto, do módulo ou da aula.
3. Na janela **Quando isto abre para o aluno?**, escolha a regra e preencha os campos.
4. Confira a frase de resultado.
5. Clique em **Salvar**. Cada linha salva sozinha.

Para usar a mesma programação em outro produto, volte a **Conteúdo > Conteúdo programado**, abra a programação e clique em **Adicionar produto**.

### Ligar a programação a uma entrega

Sem este passo, nada muda para os alunos. Escolha um dos dois caminhos:

- **Pela entrega.** Abra a entrega em **Vendas > Entregas**. Na linha do produto, escolha a programação no seletor **Liberação**. Veja [Entregas](https://help.cademi.cloud/pt/vendas/entregas.md).
- **Pela programação.** No menu da programação, clique em **Usar em entregas**. Dentro do produto, o nome é **Usar em uma entrega**. Marque as entregas e clique em **Aplicar em N entregas**.

Antes de aplicar, a tela mostra o que muda em cada entrega: "já está nesta programação", "troca Turma A por esta programação" ou "não faz parte desta entrega". Só aparecem as entregas ativas que incluem um produto da programação. A tela diz quantas entregas ficaram de fora.

A opção **Também adicionar a tag ... aos alunos destas entregas** dá a tag a quem comprar. A liberação das aulas não depende dessa tag.

**A mudança vale na hora para quem já comprou.** Se você troca a programação de uma entrega, ou muda uma regra, o calendário muda para todos os alunos dessa entrega.

### Mudar só um aluno

No perfil do aluno, aba **Produtos**:

- **Alterar cronograma de liberação** coloca só esse aluno em outra programação do mesmo produto.
- **Liberação** em **Imediata** tira as regras de dias, data e prova desse aluno. **Oculto** e **Em breve** continuam.

Veja [Matrículas e acessos](https://help.cademi.cloud/pt/alunos/matriculas-e-acessos.md).

### Excluir e restaurar

- **Excluir**, no menu da programação, manda as regras de todos os produtos dela para a lixeira. Os alunos não perdem o acesso.
- Você não pode excluir uma programação que uma entrega ativa usa. Tire a programação da entrega antes.
- **Remover da programação**, no menu de um produto, tira só esse produto. Dentro do produto, o botão **Excluir** faz o mesmo.
- A **Lixeira** guarda o que você excluiu. Clique em **Restaurar** para trazer de volta.

## O que o aluno vê

| Regra | Na área do aluno |
|---|---|
| Dias ou data que ainda não chegou | A aula fechada, com **Abre em** e a data |
| Em breve | A aula fechada, com **Em breve** |
| Aprovação em prova | A aula fechada, com **Você precisa ser aprovado na prova:** e o nome da prova |
| Oculto | A aula não aparece |
| Fechamento que já passou | **Encerrado em** e a data |

## Três exemplos prontos

**Um módulo por semana, para cada aluno.**

1. Produto: **Liberado**.
2. Módulo 1: **Liberado**.
3. Módulo 2: **Dias após a compra**, 7 dias.
4. Módulo 3: **Dias após a compra**, 14 dias.
5. Use a programação em toda entrega que inclui o curso.

Cada aluno recebe um módulo por semana, a partir da própria compra.

**Uma turma com datas.**

1. Crie uma tag com o nome da turma e uma programação com essa tag.
2. Em cada módulo, use **Em uma data**. Por exemplo: módulo 1 em 10 de março às 08:00, módulo 2 em 17 de março.
3. Nos módulos sem data, use **Em breve**.
4. Use a programação numa entrega nova, só para esta turma.

Para a próxima turma, crie outra tag, outra programação e outra entrega. Se você muda esta programação, a turma atual muda junto.

**Segurar um módulo durante a garantia.**

1. Produto: **Liberado**.
2. No módulo que você quer segurar, use **Dias após a compra** com o número de dias da garantia.

O resto do curso abre na hora.

## Bom saber

- **Uma programação, várias entregas.** Se você muda uma regra, a mudança vale para todas as entregas que usam a programação. Para uma turma nova, crie outra programação e outra entrega.
- **Produto grátis.** Um produto com **Liberar este produto gratuitamente** ligado conta como "sem programação". Ele abre o curso inteiro e vence uma programação paga do mesmo curso. Para evitar isso, escolha a **Regra de liberação** no painel **Produto grátis**, na aba **Geral**. Veja [Produtos e formatos](https://help.cademi.cloud/pt/conteudo/produtos.md).
- **Programação de outra conta.** Uma programação que vem de outra conta só abre para leitura. Você a muda na conta de origem.
- **Conteúdo removido.** Se um módulo ou uma aula sai do produto, a regra dele não conta mais. A lista mostra só o que existe hoje.
- **Prova excluída.** Se a prova de uma regra foi excluída, a regra aparece como liberada, com um aviso. O aluno passa. Escolha outra prova ou troque a regra.

## Perguntas frequentes

**Criei a programação e nada mudou para os alunos.** A programação ainda não está numa entrega. Use **Usar em entregas** ou escolha a programação no seletor **Liberação** da entrega.

**Um aluno vê todos os módulos de uma vez.** Ele tem outra compra do mesmo curso sem programação, ou um produto grátis do mesmo curso. A regra mais aberta vence. Use a mesma programação em toda entrega que inclui o curso.

**Quero abrir o módulo 2 uma semana depois que cada aluno entra.** Use **Dias após a compra** no módulo 2, com 7 dias. Use a mesma programação em toda entrega do curso. Uma data fixa abriria no mesmo dia para todos.

**Posso esconder um módulo bônus de uma turma só?** Sim. Use **Oculto** no módulo, na programação dessa turma. Um aluno que comprou as duas turmas vê o bônus, porque basta uma compra que mostra.

**O aluno comprou de novo e a contagem não recomeçou.** A contagem usa a compra mais antiga que ainda vale. Para recomeçar, revogue o acesso e conceda de novo. Isso só funciona se nenhuma outra compra cobre o produto.

**Liberei uma aula, mas o aluno ainda não vê.** O módulo ou o produto dessa aula ainda está fechado. Abra a porta de cima também.