story-generator/PROJECT_CONTEXT.md
Lucas Santana 9840fe76b0 feat: aprimora interface do exercício de formação de palavras
- 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
2025-01-01 10:09:59 -03:00

1.7 KiB

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