story-generator/CHANGELOG.md

# Changelog

Todas as mudanças notáveis neste projeto serão documentadas neste arquivo.

O formato é baseado em [Keep a Changelog](https://keepachangelog.com/pt-BR/1.0.0/),
e este projeto adere ao [Semantic Versioning](https://semver.org/lang/pt-BR/).

## [0.5.1] - 2024-01-31

### Técnico
- Corrigido erro de constraint na tabela stories ao atualizar status
- Removida tentativa de atualizar coluna inexistente error_message
- Ajustados os status da história para valores válidos: 'pending', 'published', 'failed'
- Melhorada validação e logs durante o processo de geração da história

### Modificado
- Alterado fluxo de status da história para usar estados válidos do banco de dados
- Melhorada mensagem de erro para usuário final em caso de falha na geração

## [1.0.0] - 2024-03-20

### Adicionado

#### Sistema de Exercícios Fônicos
- Criação do sistema de exercícios fônicos com categorias e tipos
- Implementação de exercícios de rima, aliteração, sílabas e sons
- Sistema de progresso do estudante com pontuação e estrelas
- Sistema de conquistas e recompensas

#### Banco de Dados
- Tabelas para categorias de exercícios (`phonics_exercise_categories`)
- Tabelas para tipos de exercícios (`phonics_exercise_types`)
- Tabela principal de exercícios (`phonics_exercises`)
- Tabela de palavras e suas características fonéticas (`phonics_words`)
- Tabela de relação exercício-palavras (`phonics_exercise_words`)
- Sistema de mídia para exercícios (`media_types`, `phonics_exercise_media`)
- Sistema de progresso do estudante (`student_phonics_progress`)
- Sistema de tentativas e respostas (`student_phonics_attempts`, `student_phonics_attempt_answers`)
- Sistema de conquistas (`achievement_types`, `phonics_achievements`, `student_phonics_achievements`)

#### Funcionalidades
- Categorização de exercícios por nível e tipo
- Sistema de pontuação e progresso
- Registro detalhado de tentativas e respostas
- Sistema de conquistas com diferentes tipos (sequência, conclusão, maestria)
- Suporte a diferentes tipos de mídia (imagens, sons, animações)

#### Segurança
- Políticas de acesso baseadas em Row Level Security (RLS)
- Proteção de dados específicos do estudante
- Controle de acesso para diferentes tipos de usuários

#### Performance
- Índices otimizados para consultas frequentes
- Estrutura de dados normalizada
- Relacionamentos e chaves estrangeiras para integridade dos dados

### Técnico
- Implementação de migrações do banco de dados
- Criação de índices para otimização de consultas
- Implementação de políticas de segurança RLS
- Estrutura de dados normalizada com relacionamentos apropriados

### Modificado
- N/A (primeira versão)
- Todas as páginas principais para usar texto adaptativo
- Componentes de exercícios para suportar transformação de texto
- Movido controle de sílabas para a página de histórias

### Removido
- N/A (primeira versão)

## [1.1.1] - 2024-05-21

### Adicionado
- Componente `TextCaseToggle` para alternar entre maiúsculas e minúsculas
- Componente `AdaptiveText` para renderização adaptativa de texto
- Hook `useUppercasePreference` para gerenciar preferências de texto
- Suporte a texto adaptativo em exercícios fônicos

### Modificado
- Atualização do layout do dashboard para incluir controle de texto
- Integração do sistema de texto adaptativo em componentes existentes
- Melhorias na acessibilidade dos componentes de texto

### Técnico
- Refatoração dos componentes de texto para suportar transformação dinâmica
- Otimização do sistema de preferências do usuário
- Melhorias na performance de renderização de texto

## [1.1.0] - 2024-03-21

### Adicionado
- Novo recurso "Modo Foco" para melhorar a experiência de leitura
  - Ativação automática ao iniciar gravação
  - Desativação automática ao parar gravação
  - Interface adaptativa com foco no texto
  - Controles de acessibilidade (tamanho da fonte, espaçamento)
  - Destaque automático de palavras durante a leitura

### Técnico
- Integração entre componentes `AudioRecorder` e `StoryPage` para gerenciamento do Modo Foco
- Adição de novos props no componente `AudioRecorder`:
  - `onFocusModeToggle`
  - `focusModeActive`
  - `onRecordingStart`
  - `onRecordingStop`
- Otimização de código com remoção de variáveis não utilizadas

### Modificado
- Atualizado o componente `AudioRecorder` para incluir tipagem correta e melhor gerenciamento de estado
- Corrigido o gerenciamento de gravações no `StoryPage` com inicialização adequada de métricas
- Melhorado o tratamento de erros e feedback do usuário durante a gravação
- Otimizado o fluxo de upload e processamento de áudio

### Técnico
- Adicionada interface `StoryRecording` com todas as propriedades necessárias
- Corrigido tipo do callback `onAudioUploaded` no `AudioRecorder`
- Removidos imports não utilizados e variáveis redundantes
- Implementada lógica de fallback para usuários não autenticados

### Adicionado
- Suporte para conversão de áudio WebM para MP3
- Feedback visual durante o processamento do áudio
- Inicialização de métricas zeradas para novas gravações

## [1.2.0] - 2024-03-21

### Adicionado
- Novo Modo Foco para leitura e gravação
- Estilos específicos para o Modo Foco
- Timer de gravação no Modo Foco
- Transições suaves entre modos
- Controles flutuantes durante o Modo Foco
- Documentação completa da estrutura do banco de dados em `/docs/banco-dados.md`:
  - Escolas e Classes
  - Sistema de Alunos
  - Histórias
  - Interesses
  - Sistema de Conquistas
  - Sistema Fonético completo
  - Relacionamentos e índices
  - Políticas de segurança
  - Triggers e funções
  - Considerações de performance

### Modificado
- Componente AudioRecorder atualizado para suportar Modo Foco
- Interface do StoryPage reorganizada para Modo Foco
- Comportamento de gravação integrado com Modo Foco
- Melhorias na experiência do usuário durante a leitura

### Técnico
- Novo arquivo CSS para estilos do Modo Foco
- Interface FocusMode para gerenciamento de estado
- Callbacks de início e fim de gravação
- Sistema de transição entre modos normal e foco
- Otimização de performance para transições suaves
- Atualização das definições de tabelas para refletir a estrutura atual do Supabase
- Adição de diagramas ER para visualização dos relacionamentos
- Documentação de índices e políticas de segurança
- Inclusão de considerações de performance e backup

## [1.3.0] - 2024-01-31

### Adicionado
- Suporte a múltiplos idiomas na geração de histórias:
  - Português (Brasil)
  - Inglês (EUA)
  - Espanhol (Espanha)
- Nova etapa de seleção de idioma no fluxo de criação de história
- Instruções específicas para cada idioma no prompt da IA

### Modificado
- Fluxo de geração de história para incluir seleção de idioma
- Interface do gerador de histórias com novo passo de idioma
- Adaptação do prompt da IA para considerar o idioma selecionado

### Técnico
- Adicionada constante `LANGUAGE_OPTIONS` com opções de idiomas suportados
- Implementada validação de idioma antes da geração
- Atualizado payload da Edge Function para incluir `language_type`
- Melhorada tipagem para suporte a múltiplos idiomas

## [1.4.0] - 2024-01-31

### Adicionado
- Integração completa com a tabela `languages` do banco de dados
- Suporte para ícones de bandeira nos seletores de idioma
- Instruções específicas por idioma na interface
- Hook `useLanguages` para gerenciamento centralizado de idiomas

### Modificado
- Removido `LANGUAGE_OPTIONS` hard coded do `StoryGenerator`
- Atualizado `CreateStoryPage` para usar `DEFAULT_LANGUAGE` do type
- Melhorada a validação de idiomas usando dados do banco
- Aprimorada a UX do seletor de idiomas com ícones e instruções

### Técnico
- Refatorado o sistema de idiomas para usar dados dinâmicos do banco
- Adicionada tipagem forte para dados de idioma
- Implementada validação robusta de códigos de idioma
- Melhorada a estrutura de componentes para suportar dados dinâmicos