# Mapas de Calor

Mapas de calor por Curso, Assunto e Questões

# Documentação - Mapas de Calor para Parceiros

#  Mapas de Calor 

## Para Criadores de Conteúdo e Parceiros da Plataforma

Esta ferramenta permite que você **monitore o desempenho do seu conteúdo** e identifique oportunidades de melhoria nos seus cursos, questões e materiais didáticos.

---

## Para começar:   


Para começar e visualizar os mapas de calor basta fazer o login em seu painel, acessar a aba Academico, conforme o print:

[![image.png](https://wiki.edustore.online/uploads/images/gallery/2025-12/scaled-1680-/IsUimage.png)](https://wiki.edustore.online/uploads/images/gallery/2025-12/IsUimage.png)

Entra em conteúdo:

[![image.png](https://wiki.edustore.online/uploads/images/gallery/2025-12/scaled-1680-/Ejdimage.png)](https://wiki.edustore.online/uploads/images/gallery/2025-12/Ejdimage.png)

Entre em questões:

[![image.png](https://wiki.edustore.online/uploads/images/gallery/2025-12/scaled-1680-/FtRimage.png)](https://wiki.edustore.online/uploads/images/gallery/2025-12/FtRimage.png)

Dentro de questões acesse Relatórios:

[![image.png](https://wiki.edustore.online/uploads/images/gallery/2025-12/scaled-1680-/BfMimage.png)](https://wiki.edustore.online/uploads/images/gallery/2025-12/BfMimage.png)

E por fim entre me mapas de calor:

[![image.png](https://wiki.edustore.online/uploads/images/gallery/2025-12/scaled-1680-/yYSimage.png)](https://wiki.edustore.online/uploads/images/gallery/2025-12/yYSimage.png)

## Sistema de Classificação  
  


[![image.png](https://wiki.edustore.online/uploads/images/gallery/2025-12/scaled-1680-/bEEimage.png)](https://wiki.edustore.online/uploads/images/gallery/2025-12/bEEimage.png)

### Como Funciona

Seu conteúdo é classificado automaticamente em 5 níveis baseados na porcentagem de acerto dos alunos:

<table id="bkmrk-n%C3%ADvel-faixa-cor-o-qu"><thead><tr><th>Nível</th><th>Faixa</th><th>Cor</th><th>O que significa para você</th></tr></thead><tbody><tr><td>**Ótimo**</td><td>70-100%</td><td>🟢 Verde Escuro</td><td>Seu conteúdo está excelente, alunos dominam o tema</td></tr><tr><td>**Bom**</td><td>56-69%</td><td>🟢 Verde Claro</td><td>Conteúdo funciona bem, pequenos ajustes podem elevar</td></tr><tr><td>**Médio**</td><td>50-55%</td><td>🟡 Amarelo</td><td>No limite - precisa de atenção para não piorar</td></tr><tr><td>**Ruim**</td><td>30-49%</td><td>🟠 Laranja</td><td>**Ação necessária** - revise o material</td></tr><tr><td>**Crítico**</td><td>&lt;30%</td><td>🔴 Vermelho</td><td>**Urgente** - conteúdo precisa de refatoração</td></tr></tbody></table>

### Filtro de Desempenho

[![image.png](https://wiki.edustore.online/uploads/images/gallery/2025-12/scaled-1680-/tmEimage.png)](https://wiki.edustore.online/uploads/images/gallery/2025-12/tmEimage.png)

No canto superior direito, você pode filtrar para ver apenas os níveis específicos:

- **Use "Crítico" e "Ruim"** → Para priorizar o que precisa de correção urgente
- **Use "Médio"** → Para identificar conteúdo que está no limiar e pode melhorar
- **Use "Ótimo" e "Bom"** → Para validar o que está funcionando bem e replicar práticas

---

## Mapa de Cursos Geral

[![image.png](https://wiki.edustore.online/uploads/images/gallery/2025-12/scaled-1680-/wFRimage.png)](https://wiki.edustore.online/uploads/images/gallery/2025-12/wFRimage.png)

### O que você vê

Cada card representa um dos seus cursos com:

#### Identificação

- **\#ID do Curso** (ex: #10, #188)
- **Badge de Desempenho** com cor e classificação

#### Informações Temporais

- **Data de Criação**: Quando você criou o curso
- **Tempo desde criação**: "Criado há X meses"

#### Métricas de Performance

- **Total de Questões**: Quantas questões seu curso tem
- **Total de Respostas**: Engajamento - quantas vezes foi respondido
- **Porcentagem de Acerto**: Performance geral do curso
- **Barra Visual**: Representação gráfica do desempenho

### Exemplo Real da Imagem

**Curso #10** (Verde Claro - Bom)

```
📅 12/02/2025 (Criado há 10 meses)
237 questões | 3148 respostas

56.48% DE ACERTO
✓ 1778 acertos
✗ 1370 erros

DESEMPENHO: Bom

```

### Como Interpretar

**Alto engajamento (3148 respostas) + 56.48% de acerto:**

- ✅ Curso popular - alunos estão fazendo
- ⚠️ Performance boa mas não ótima
- 💡 **Oportunidade**: Com pequenos ajustes, você pode levar para 70%+

**Ações sugeridas:**

1. Vá para "Por Assunto" para identificar tópicos específicos ruins
2. Foque nos assuntos com classificação "Ruim" ou "Crítico"
3. Revise material didático desses tópicos
4. Reescreva questões confusas

---

## Visualização Por Assunto

[![image.png](https://wiki.edustore.online/uploads/images/gallery/2025-12/scaled-1680-/7ybimage.png)](https://wiki.edustore.online/uploads/images/gallery/2025-12/7ybimage.png)

### Para que serve

Identifica **quais tópicos específicos** do seu conteúdo estão problemáticos.

### Informações por Assunto

Cada card mostra:

- **Nome do Assunto/Tópico**
- **Número de questões** neste assunto
- **Total de respostas** recebidas
- **Porcentagem de acerto**
- **Badge de classificação**

### Exemplo da Imagem

**Assunto com 3 questões e 4859 respostas - 50.09% (Médio/Amarelo)**

### O que isso significa para você

**Alto volume (4859 respostas) + baixo acerto (50.09%):**

- ⚠️ Tópico muito acessado mas mal compreendido
- 🎯 **Alta prioridade** para revisão - impacta muitos alunos
- 💰 **Alto ROI** - melhorar isso beneficia milhares de alunos

**Ações práticas:**

1. Revise o material didático deste assunto
2. Verifique se as explicações estão claras
3. Considere adicionar exemplos práticos
4. Vá para "Por Questão" para ver questões específicas

### Filtros Disponíveis

- **Pesquisar Assunto**: Encontre tópicos específicos
- **Filtro de Desempenho**: Foque nos problemáticos
- **Botão Criar**: Adicione novos assuntos

---

## Visualização Por Questão

[![image.png](https://wiki.edustore.online/uploads/images/gallery/2025-12/scaled-1680-/wgximage.png)](https://wiki.edustore.online/uploads/images/gallery/2025-12/wgximage.png)

### Análise Individual de Questões

Aqui você vê cada questão do seu conteúdo individualmente.

### Informações Detalhadas

#### Cabeçalho

- **\#ID da Questão** (ex: #14, #141)
- **Badge de Performance**
- **Enunciado** (primeiras linhas)

#### Contexto

- **🎓 Curso**: A qual curso pertence
- **📚 Assuntos**: Tags dos tópicos relacionados
- **✓ Resposta Correta**: Qual é a alternativa certa

#### Estatísticas

- **Total de respostas**
- **Acertos e erros**
- **Porcentagem de acerto**

### Exemplos da Imagem

#### Questão #14 (30% - Ruim/Laranja)

```
20 RESPOSTAS | 6 ACERTOS | 14 ERROS
30% ACERTO
Resposta Correta: Alternativa 2

```

**O que fazer:**

- ❌ 70% dos alunos erraram
- 🔍 Questão mal formulada OU conceito não explicado
- ✏️ **Ação**: Expanda para ver distribuição de respostas

#### Questão #141 (30% - Ruim/Laranja)

```
250 RESPOSTAS | 75 ACERTOS | 175 ERROS
30% ACERTO
Resposta Correta: Alternativa 4

```

**O que fazer:**

- ❌ Alto volume (250 respostas) com baixo acerto
- ⚠️ Problema crítico - muito impacto
- 🎯 **Prioridade máxima** para revisão

### Filtros e Pesquisa

- **ID da Questão**: Busque questões específicas
- **Palavras-chave**: Encontre por conteúdo
- **Filtro de Desempenho**: Foque nas problemáticas

---

## Análise de Distribuição de Respostas

[![image.png](https://wiki.edustore.online/uploads/images/gallery/2025-12/scaled-1680-/SvZimage.png)](https://wiki.edustore.online/uploads/images/gallery/2025-12/SvZimage.png)

### O Recurso Mais Importante para Você

Ao expandir uma questão, você vê **como os alunos estão respondendo**.

### Exemplo da Imagem

**Questão #255 - 70% de acerto (Ótimo/Verde)**

```
Distribuição:

1 [Vermelho]
3 respostas                                30%
████████████░░░░░░░░░░░░░░░░░░░░░░░░░░

2 [Verde] ← CORRETA
7 respostas                                70%
██████████████████████████████████░░░░

3 [Vermelho]
0 respostas                                0%
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░

4 [Vermelho]
0 respostas                                0%
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░

5 [Vermelho]
0 respostas                                0%
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░

```

### Como Analisar

#### ✅ Padrão Saudável (como na imagem)

- 70% na alternativa correta (2)
- 30% em uma alternativa incorreta específica (1)
- 0% nas demais

**Interpretação:**

- Questão bem formulada
- Alternativa 1 é um bom "distrator" para separar quem estudou de quem não estudou
- Demais alternativas são claramente incorretas (como deve ser)

#### ❌ Padrões Problemáticos

**Problema 1: Alternativa incorreta &gt; 50%**

```
1 [Vermelho] ← Maioria escolhe esta (ERRADA)
8 respostas                                80%

2 [Verde] ← CORRETA mas pouco escolhida
2 respostas                                20%

```

**O que significa:**

- Alternativa incorreta está mais convincente que a correta
- ⚠️ **Ação**: Reescreva a questão - há confusão

**Problema 2: Distribuição uniforme**

```
1: 20% | 2: 20% | 3: 20% | 4: 20% | 5: 20%

```

**O que significa:**

- Alunos estão "chutando"
- Material não foi estudado OU conceito não foi ensinado
- ⚠️ **Ação**: Revise material didático deste tópico

**Problema 3: Alternativa correta com 0%**

```
1 [Verde] ← CORRETA
0 respostas                                0%

```

**O que significa:**

- 🚨 **Crítico** - NINGUÉM acerta
- Questão impossível ou erro no gabarito
- ⚠️ **Ação urgente**: Revise imediatamente

---

### Filtro Avançado:

Você também pode utilizar o **filtro avançado para análises cruzadas**. Ao selecionar um curso específico na busca, o sistema refina automaticamente as abas de 'Assuntos' e 'Questões'. Assim, você visualizará apenas os conteúdos vinculados àquele curso e seus respectivos indicadores de desempenho.

[![image.png](https://wiki.edustore.online/uploads/images/gallery/2025-12/scaled-1680-/hYtimage.png)](https://wiki.edustore.online/uploads/images/gallery/2025-12/hYtimage.png)

[![image.png](https://wiki.edustore.online/uploads/images/gallery/2025-12/scaled-1680-/MG4image.png)](https://wiki.edustore.online/uploads/images/gallery/2025-12/MG4image.png)

[![image.png](https://wiki.edustore.online/uploads/images/gallery/2025-12/scaled-1680-/Bvximage.png)](https://wiki.edustore.online/uploads/images/gallery/2025-12/Bvximage.png)

### Casos de Uso Reais

#### Caso 1: Curso novo com baixo desempenho

**Situação:**

- Curso criado há 2 meses
- 500 respostas
- 35% de acerto (Ruim)

**Diagnóstico:**

1. Identifique assuntos com &lt;30%
2. Revise material didático desses assuntos
3. Foque em clareza e exemplos práticos

**Resultado esperado:**

- Em 1 mês: 45-50% (Médio)
- Em 3 meses: 55-60% (Bom)

#### Caso 2: Questão específica problemática

**Situação:**

- Questão com 200 respostas
- 25% de acerto
- 60% escolhem alternativa 3 (incorreta)

**Diagnóstico:**

- Alternativa 3 está melhor redigida que a correta
- OU conceito da alternativa 3 é mais intuitivo

**Ação:**

1. Reescreva a alternativa correta
2. Adicione um "porque" na explicação
3. Torne alternativa 3 menos plausível

**Resultado esperado:**

- Inversão: 60%+ na correta

#### Caso 3: Assunto com muito engajamento mas baixo acerto

**Situação:**

- Assunto: "Conceitos Avançados"
- 5000 respostas (muito popular)
- 48% de acerto (Ruim)

**Diagnóstico:**

- Tópico difícil MAS popular
- Alto impacto se melhorado

**Ação:**

1. Quebre em sub-tópicos menores
2. Adicione material introdutório
3. Crie questões mais fáceis para começar

**Resultado esperado:**

- 55-65% de acerto
- Impacto em milhares de alunos

### Metas de Performance

**Por tipo de conteúdo:**

<table id="bkmrk-tipo-meta-m%C3%ADnima-met"><thead><tr><th>Tipo</th><th>Meta Mínima</th><th>Meta Ideal</th></tr></thead><tbody><tr><td>Conceitos básicos</td><td>60%</td><td>75%+</td></tr><tr><td>Conceitos intermediários</td><td>55%</td><td>65%+</td></tr><tr><td>Conceitos avançados</td><td>45%</td><td>55%+</td></tr><tr><td>Questões de raciocínio</td><td>40%</td><td>50%+</td></tr></tbody></table>

**Importante:**

- Questões com 90%+ podem estar muito fáceis
- Busque equilíbrio, não facilidade extrema
- Curva de dificuldade é saudável

### Monitoramento de Evolução

#### Use Exportação CSV

**Mensal:**

1. Exporte CSV no dia 1 do mês
2. Guarde com nome: `heatmap_YYYYMM.csv`
3. Compare com mês anterior
4. Identifique: 
    - ✅ Melhorias (celebre!)
    - ❌ Pioras (investigue)
    - ➡️ Estagnações (mude estratégia)

#### Dashboard Pessoal

Crie planilha com:

- Data
- Curso/Assunto/Questão
- % Acerto Antes
- Ação Tomada
- % Acerto Depois
- Resultado (+/- pontos percentuais)

---

## Dicas Avançadas

### 1. Priorização por Impacto

**Alto Volume + Baixo Desempenho = Máxima Prioridade**

Exemplo:

- Item A: 50 respostas, 30% acerto
- Item B: 5000 respostas, 45% acerto

→ Priorize Item B (muito mais alunos impactados)

### 2. Análise de Padrões Temporais

Compare:

- Questões antigas vs novas
- Assuntos iniciais vs finais do curso
- Desempenho por período do ano

Pode revelar:

- Fadiga dos alunos em cursos longos
- Sazonalidade (férias, provas)
- Efeito de atualizações de conteúdo

### 3. Benchmark com Seus Outros Cursos

Compare seus próprios cursos:

- Qual tem melhor performance?
- O que você fez diferente?
- Replique práticas bem-sucedidas

### 4. Não Confunda Dificuldade com Qualidade

**Questão difícil ≠ Questão ruim**

Se:

- Distribuição mostra padrão lógico
- Alunos com base escolhem correta
- É conceito avançado

→ Pode manter mesmo com 40-50% acerto

### 5. Teste A/B de Questões

Para questões críticas:

1. Crie 2 versões da mesma questão
2. Use em turmas diferentes
3. Compare desempenho
4. Adote a melhor

---

## Perguntas Frequentes

### "Meu curso tem 40% de acerto. É ruim?"

**Depende do contexto:**

- Curso básico? Sim, é baixo.
- Curso avançado? Pode ser aceitável.
- Cresceu de 30% para 40%? Está melhorando!

**Ação:** Compare com média da plataforma (se disponível) e seus outros cursos.

### "Uma questão tem 15% de acerto. Devo removê-la?"

**Não imediatamente!**

1. Veja a distribuição de respostas
2. Se uniforme → Material ruim, não questão
3. Se focada em 1 alternativa → Reescreva questão
4. Se é conceito muito avançado → Considere mover para módulo posterior
5. Remova só se claramente mal formulada

### "Como sei se minha mudança funcionou?"

**Aguarde volume suficiente:**

- Mínimo: 20-30 novas respostas após mudança
- Ideal: 50+ novas respostas

**Compare:**

- % acerto antes vs depois
- Distribuição de respostas antes vs depois

**Melhoria significativa:** +10 pontos percentuais ou mais

### "Posso ter todos os itens em 'Ótimo'?"

**Não é realista nem desejável:**

- Mix de dificuldades é saudável
- Questões muito fáceis não agregam valor
- Alunos precisam de desafio

**Meta razoável:**

- 10-20% em Ótimo
- 40-50% em Bom
- 20-30% em Médio
- 10-20% em Ruim
- 0-10% em Crítico

### "Com que frequência devo revisar?"

**Recomendações:**

- **Novos conteúdos**: Diariamente (primeira semana)
- **Conteúdos estabelecidos**: Semanalmente
- **Conteúdos maduros**: Quinzenalmente
- **Análise profunda**: Mensalmente

---

## Exportação e Relatórios

### Botão "Exportar CSV"

Localizado no canto superior direito, gera planilha com todos os dados visíveis.

### O que vem no CSV

- IDs dos itens
- Nomes/Enunciados
- Estatísticas completas
- Distribuição de alternativas
- Classificações
- Datas

### Como Usar

**No Excel/Google Sheets:**

1. Importe o CSV
2. Crie tabelas dinâmicas
3. Gere gráficos de evolução
4. Cruze dados com outras métricas

**Para Relatórios:**

- Compare períodos diferentes
- Mostre evolução após melhorias
- Documente decisões tomadas
- Apresente para stakeholders

---

## Suporte

### Reportar Problemas nos Dados

Se encontrar:

- Números que não batem
- Questões duplicadas
- Classificações incorretas

**Entre em contato com:**

- Email: suporte@plataforma.com
- Inclua: ID do item, screenshot, descrição

### Sugestões de Melhorias

Suas ideias são valiosas! Sugestões para:

- Novos filtros
- Métricas adicionais
- Comparações entre períodos
- Alertas automáticos

---

## Conclusão

Os Mapas de Calor são sua ferramenta para **melhoria contínua do seu conteúdo**.

**Lembre-se:**

- Dados mostram onde agir, não julgam você
- Pequenas melhorias têm grande impacto
- Questão ruim ≠ Você é ruim criador
- Todos os grandes criadores iteram constantemente

**Seu sucesso = Sucesso dos seus alunos**

Use esta ferramenta para criar o melhor conteúdo possível!

---

**Última atualização**: Dezembro 2024  
**Versão**: 1.0 - Documentação para Parceiros