story-generator/docs/geracao-historia.md

Geração de Histórias

Visão Geral

O sistema de geração de histórias permite criar conteúdo personalizado baseado em parâmetros fornecidos pelo usuário, utilizando IA para gerar narrativas educativas e envolventes.

Parâmetros de Entrada

StoryChoices

interface StoryChoices {
  protagonist: string;         // Nome/tipo do protagonista
  setting: string;            // Ambiente da história
  theme: string;              // Tema principal
  genre: string;              // Gênero da história
  educationalGoal: string;    // Objetivo educacional
  ageGroup: string;           // Faixa etária
  length: 'short' | 'medium' | 'long'; // Extensão da história
  complexity: 'easy' | 'medium' | 'hard'; // Nível de complexidade
  language: 'pt-BR';          // Idioma (fixo em português)
}

Modos de Entrada

1. Formulário

• Interface gráfica com campos estruturados
• Validação em tempo real
• Sugestões pré-definidas
• Preview instantâneo

2. Comando de Voz

• Reconhecimento de fala natural
• Extração automática de parâmetros
• Confirmação por voz
• Correção por voz ou texto

3. Texto Livre

• Processamento de linguagem natural
• Identificação de parâmetros-chave
• Sugestão de complementos
• Refinamento interativo

Fluxo de Geração

1. Coleta de Parâmetros

// Exemplo de validação de parâmetros
const validateStoryParams = (choices: StoryChoices): boolean => {
  return (
    !!choices.protagonist &&
    !!choices.setting &&
    !!choices.theme &&
    !!choices.genre &&
    !!choices.educationalGoal &&
    !!choices.ageGroup
  );
};

2. Processamento

1. Validação

   • Verificação de campos obrigatórios
   • Validação de conteúdo apropriado
   • Checagem de restrições de idade

2. Preparação

   • Formatação dos parâmetros
   • Ajuste de complexidade
   • Definição de estrutura

3. Geração

   • Criação do conteúdo via IA
   • Revisão automática
   • Formatação do texto

3. Pós-processamento

• Verificação de adequação
• Ajustes de formatação
• Adição de metadados
• Geração de recursos visuais

Controles de Qualidade

1. Adequação de Conteúdo

• Filtro de conteúdo impróprio
• Verificação de complexidade
• Adequação à faixa etária
• Alinhamento educacional

2. Estrutura Narrativa

• Coerência da história
• Desenvolvimento de personagens
• Arco narrativo apropriado
• Conclusão educativa

3. Linguagem

• Vocabulário adequado
• Estruturas gramaticais
• Pontuação correta
• Ritmo de leitura

Integração com Modo Foco

1. Formatação Adaptativa

• Ajuste automático de fonte
• Espaçamento otimizado
• Quebras de linha estratégicas
• Destaque de palavras-chave

2. Recursos de Acessibilidade

• Suporte a leitura em voz alta
• Marcadores visuais
• Controles de navegação
• Ajustes de contraste

Armazenamento

1. Estrutura de Dados

interface Story {
  id: string;
  title: string;
  content: string;
  parameters: StoryChoices;
  metadata: {
    wordCount: number;
    readingTime: number;
    complexity: number;
    keywords: string[];
  };
  created_at: string;
  updated_at: string;
}

2. Indexação

• Busca por parâmetros
• Filtros de complexidade
• Tags educacionais
• Histórico de geração

Próximas Melhorias

1. Personalização Avançada

   • Perfis de aprendizado
   • Adaptação dinâmica
   • Temas customizados
   • Integração curricular

2. Geração Multimodal

   • Ilustrações automáticas
   • Efeitos sonoros
   • Animações simples
   • Recursos interativos

3. Análise de Impacto

   • Métricas de engajamento
   • Progresso educacional
   • Feedback do usuário
   • Ajustes automáticos

4. Colaboração

   • Edição compartilhada
   • Biblioteca de recursos
   • Compartilhamento social
   • Feedback comunitário