mirror of
https://github.com/lucasrcsantana/story-generator.git
synced 2025-12-17 13:57:51 +00:00
177 lines
3.1 KiB
Markdown
177 lines
3.1 KiB
Markdown
# Sistema de Exercícios
|
|
|
|
## Visão Geral
|
|
O sistema de exercícios oferece diferentes tipos de atividades para reforçar o aprendizado da leitura e compreensão textual.
|
|
|
|
## Tipos de Exercícios
|
|
|
|
### 1. Formação de Palavras
|
|
```typescript
|
|
interface WordFormationExercise {
|
|
word: string;
|
|
syllables: string[];
|
|
hints?: string[];
|
|
difficulty: 'easy' | 'medium' | 'hard';
|
|
}
|
|
```
|
|
|
|
### 2. Completar Sentenças
|
|
```typescript
|
|
interface SentenceCompletionExercise {
|
|
sentence: string;
|
|
options: string[];
|
|
correctAnswer: string;
|
|
context: string;
|
|
}
|
|
```
|
|
|
|
### 3. Prática de Pronúncia
|
|
```typescript
|
|
interface PronunciationExercise {
|
|
word: string;
|
|
phonemes: string[];
|
|
audioUrl?: string;
|
|
examples: string[];
|
|
}
|
|
```
|
|
|
|
## Fluxo de Exercícios
|
|
|
|
### 1. Seleção
|
|
- Baseada no nível do aluno
|
|
- Progressão gradual
|
|
- Adaptação por desempenho
|
|
- Variedade de tipos
|
|
|
|
### 2. Execução
|
|
- Instruções claras
|
|
- Feedback imediato
|
|
- Dicas contextuais
|
|
- Suporte visual
|
|
|
|
### 3. Avaliação
|
|
- Pontuação automática
|
|
- Feedback detalhado
|
|
- Sugestões de melhoria
|
|
- Registro de progresso
|
|
|
|
## Componentes Principais
|
|
|
|
### 1. ExercisePlayer
|
|
- Controle de fluxo
|
|
- Timer integrado
|
|
- Sistema de pontuação
|
|
- Feedback visual
|
|
|
|
### 2. ExerciseFactory
|
|
- Criação dinâmica
|
|
- Validação de respostas
|
|
- Adaptação de dificuldade
|
|
- Geração de feedback
|
|
|
|
## Integração com Banco de Dados
|
|
|
|
### 1. Tabelas Relacionadas
|
|
```sql
|
|
-- Exercícios
|
|
create table exercises (
|
|
id uuid primary key,
|
|
type text,
|
|
difficulty text,
|
|
content jsonb,
|
|
created_at timestamptz
|
|
);
|
|
|
|
-- Progresso
|
|
create table exercise_progress (
|
|
student_id uuid,
|
|
exercise_id uuid,
|
|
score numeric,
|
|
completed_at timestamptz
|
|
);
|
|
```
|
|
|
|
### 2. Métricas Armazenadas
|
|
- Tempo de conclusão
|
|
- Taxa de acerto
|
|
- Tentativas realizadas
|
|
- Padrões de erro
|
|
|
|
## Acessibilidade
|
|
|
|
### 1. Visual
|
|
- Alto contraste
|
|
- Fontes ajustáveis
|
|
- Ícones intuitivos
|
|
- Animações suaves
|
|
|
|
### 2. Auditiva
|
|
- Instruções em áudio
|
|
- Feedback sonoro
|
|
- Controle de volume
|
|
- Legendas
|
|
|
|
### 3. Motora
|
|
- Controles simplificados
|
|
- Atalhos de teclado
|
|
- Tempo ajustável
|
|
- Pausas automáticas
|
|
|
|
## Gamificação
|
|
|
|
### 1. Sistema de Pontos
|
|
- Pontuação base
|
|
- Bônus por velocidade
|
|
- Combos de acertos
|
|
- Conquistas especiais
|
|
|
|
### 2. Progressão
|
|
- Níveis de dificuldade
|
|
- Desbloqueio gradual
|
|
- Medalhas e troféus
|
|
- Rankings opcionais
|
|
|
|
### 3. Recompensas
|
|
- Novos conteúdos
|
|
- Personalização
|
|
- Badges especiais
|
|
- Poder de escolha
|
|
|
|
## Monitoramento
|
|
|
|
### 1. Métricas Coletadas
|
|
```typescript
|
|
interface ExerciseMetrics {
|
|
timeSpent: number;
|
|
correctAnswers: number;
|
|
totalAttempts: number;
|
|
hintsUsed: number;
|
|
score: number;
|
|
}
|
|
```
|
|
|
|
### 2. Análise de Desempenho
|
|
- Padrões de erro
|
|
- Tempo de resposta
|
|
- Uso de dicas
|
|
- Evolução temporal
|
|
|
|
## Próximas Melhorias
|
|
|
|
1. **Novos Tipos**
|
|
- Exercícios de ritmo
|
|
- Compreensão auditiva
|
|
- Produção textual
|
|
- Jogos educativos
|
|
|
|
2. **Personalização**
|
|
- Temas customizados
|
|
- Níveis adaptativos
|
|
- Conteúdo dinâmico
|
|
- Preferências salvas
|
|
|
|
3. **Interatividade**
|
|
- Multiplayer
|
|
- Desafios em grupo
|
|
- Compartilhamento
|
|
- Competições |