# VivaVoz — Leitor de Texto em Áudio, Narração Neural & IA Contextual

> VivaVoz é uma aplicação web de alta performance voltada para leitura acessível de múltiplos formatos de documentos (PDF, EPUB, DOCX, ODT, PPTX, TXT, Markdown e artigos da web via URL), narração de texto em áudio neural sincronizado em tempo real com realce de sentenças, personalização tipográfica e assistência inteligente de estudos alimentada pelo Google Gemini.

## Rotas Públicas Principais

- [Leitor de Documentos](/): Ambiente principal de leitura e narração em áudio, com suporte a upload de múltiplos formatos, sincronização de trechos, seleção de templates e interação com assistente de IA.
- [Leitor Dedicado](/leitor): Rota direta para o leitor e player completo de documentos.
- [Biblioteca de Leituras](/leituras): Painel local (IndexedDB) para gerenciar documentos arquivados, retomar posições de leitura, buscar títulos, gerenciar favoritos e baixar arquivos originais.
- [Apoio e Contribuição Voluntária](/apoiar): Página com QR Code Pix, chave Pix direta e canais de apoio comunitário ao VivaVoz.

## Endpoints e Serviços Estruturados

- [/api/tts](/api/tts): Endpoint POST para sintetização de voz neural (Google Cloud TTS / Gemini TTS) com controle fino de voz, pitch e velocidade de reprodução.
- [/api/ask](/api/ask): Endpoint POST para streaming de respostas e análises contextuais sobre documentos via Google Gemini.
- [/api/sync/backup](/api/sync/backup): Endpoint POST para backup seguro de documentos e notas na pasta oculta Google Drive appDataFolder.
- [/api/sync/restore](/api/sync/restore): Endpoint GET para restauração de dados cross-device a partir do Google Drive.

## Ferramentas WebMCP (Agent-Ready Capabilities)

- **uploadDocument** (`data-webmcp-tool="uploadDocument"`): Carrega e processa documentos em múltiplos formatos — PDF, EPUB, DOCX, ODT, PPTX, TXT, Markdown — ou extrai artigos da web a partir de uma URL pública. O conteúdo é segmentado em sentenças indexadas e capítulos para reprodução sequencial em áudio.
- **configureGeminiApiKey** (`data-webmcp-tool="configureGeminiApiKey"`): Conecta e persiste com segurança no navegador a chave de API do Google AI Studio.
- **ttsPlaybackControl** (`data-webmcp-tool="ttsPlaybackControl"`): Executa comandos de reprodução, pausa, navegação entre trechos, alteração de velocidade e seleção de vozes neurais.
- **askDocumentAI** (`data-webmcp-tool="askDocumentAI"`): Envia perguntas e instruções ao assistente de IA com base nas sentenças e páginas do documento ativo.
- **searchLibrary** (`data-webmcp-tool="searchLibrary"`): Filtra e consulta leituras armazenadas na base local do navegador.
- **configureReaderPreferences** (`data-webmcp-tool="configureReaderPreferences"`): Ajusta temas de contraste (Clean, Papel Zen, Escuro), famílias tipográficas e modos de exibição.
- **supportProject** (`data-webmcp-tool="supportProject"`): Disponibiliza dados e QR Code Pix para contribuição voluntária e links de apoio ao desenvolvimento comunitário no GitHub.
- **contactDeveloper** (`data-webmcp-tool="contactDeveloper"`): Permite envio direto de sugestões de novos recursos, relatórios de bugs, feedback de usabilidade e contato direto com o desenvolvedor.
- **installVivaVozPwa** (`data-webmcp-tool="installVivaVozPwa"`): Abre o diálogo de instalação e orientações de PWA para execução nativa e leitura offline do VivaVoz.