mirror of
https://github.com/lucasrcsantana/story-generator.git
synced 2025-12-17 05:47:52 +00:00
9840fe76b0
- Adiciona barra de progresso e feedback visual - Implementa lista de palavras encontradas - Melhora interatividade e estados visuais - Adiciona validação de palavras repetidas - Otimiza transições e animações - Mantém consistência com outros exercícios type: feat scope: exercises breaking: false
51 lines
1.7 KiB
Markdown
51 lines
1.7 KiB
Markdown
# Story Generator - Plataforma Educacional de Leitura
|
|
|
|
## Visão Geral
|
|
Plataforma educacional focada em crianças de 6-12 anos para prática e desenvolvimento de leitura, utilizando histórias geradas por IA e análise de áudio para feedback em tempo real.
|
|
|
|
## Principais Funcionalidades
|
|
1. **Geração de Histórias**
|
|
- Histórias personalizadas por IA
|
|
- Adaptação ao nível do aluno
|
|
- Imagens ilustrativas geradas por IA
|
|
|
|
2. **Sistema de Leitura**
|
|
- Gravação de áudio da leitura
|
|
- Análise de pronúncia e fluência
|
|
- Destaque de palavras importantes (WordHighlighter)
|
|
- Modal de detalhes para palavras difíceis
|
|
|
|
3. **Análise de Performance**
|
|
- Métricas de leitura (fluência, pronúncia, etc.)
|
|
- Dashboard de progresso
|
|
- Histórico de gravações
|
|
- Conversão de áudio WebM para MP3
|
|
|
|
## Arquitetura
|
|
|
|
### Frontend (React + TypeScript)
|
|
- `/src/components/learning/` - Componentes educacionais
|
|
- `/src/components/story/` - Componentes de história
|
|
- `/src/pages/student-dashboard/` - Dashboard do aluno
|
|
- `/src/utils/` - Utilitários (conversão de áudio, etc.)
|
|
|
|
### Backend (Supabase)
|
|
- Functions:
|
|
- `process-audio` - Análise de áudio e feedback
|
|
- `generate-story` - Geração de histórias
|
|
|
|
### Storage
|
|
- `recordings/` - Áudios das leituras
|
|
- `story-images/` - Imagens das histórias
|
|
|
|
## Decisões Técnicas
|
|
1. Uso de Supabase para backend serverless
|
|
2. FFmpeg.js para conversão de áudio no cliente
|
|
3. Testes com Vitest e Testing Library
|
|
4. Tailwind CSS para estilização
|
|
5. Radix UI para componentes acessíveis
|
|
|
|
## Estado Atual
|
|
- Implementado sistema de gravação e análise de áudio
|
|
- Desenvolvido componente WordHighlighter com testes
|
|
- Sistema de deleção de histórias com limpeza de recursos |