Update README.md

README.md

@@ -1,229 +1,120 @@
-# 🎓 English Helper - Advanced AI Language Learning Platform
-
-## 🌟 Visão Geral
-
-O English Helper é uma plataforma avançada de aprendizado de inglês que combina inteligência artificial, curadoria de conteúdo personalizada, e planejamento de estudos inteligente para oferecer uma experiência de aprendizado imersiva e personalizada.
-
-## 🚀 Funcionalidades Principais
-
-### 1. 🤖 Motor de Curadoria de Conteúdo Personalizado
-- **Busca Inteligente**: Encontre artigos e conteúdos relevantes baseados em seus interesses
-- **Análise de Conteúdo com IA**: Avaliação automática de dificuldade e relevância
-- **Gerenciamento de Interesses**: Sistema dinâmico de interesses do usuário
-- **Recomendações Personalizadas**: Sugestões baseadas no nível de proficiência e contexto
-- **Feeds RSS Integrados**: Acesso a fontes confiáveis de conteúdo em inglês
-- **Extração de Texto**: Processamento automático de URLs para extração de conteúdo
-
-### 2. 🎯 Ambiente de Imersão Interativo
-- **Sistema de Flashcards**: Criação e revisão de vocabulário personalizado
-- **Conversação com IA**: Prática de conversação com feedback inteligente
-- **Exercícios de Escrita**: Prática guiada com correção automática
-- **Geração de Imagens**: Criação de imágenes contextuais para vocabulário
-- **Síntese de Voz**: Pronúncia e áudio com Google Text-to-Speech
-- **Contextos Personalizados**: Adaptação para diferentes contextos (profissional, técnico, social)
-
-### 3. 📊 Planejador de Estudos e Painel de Análise
-- **Planos de Estudo Personalizados**: Cronogramas adaptativos baseados em IA
-- **Análise de Progresso**: Métricas detalhadas de desempenho
-- **Sistema de Marcos**: Objetivos e checkpoints de progresso
-- **Recomendações Adaptativas**: Ajustes automáticos baseados no desempenho
-- **Dashboard de Analytics**: Visualizações de progresso e estatísticas
-- **Tracking de Atividades**: Monitoramento detalhado de todas as atividades
-
-## 🏗️ Arquitetura Técnica
-
-### Backend (Python/Flask)
-- **app.py**: Aplicação principal Flask com todas as rotas
-- **database.py**: Gerenciamento de banco de dados SQLite
-- **content_curator.py**: Motor de curadoria de conteúdo
-- **study_planner.py**: Sistema de planejamento de estudos com IA
-
-### Frontend (HTML/CSS/JavaScript)
-- **index.html**: Interface responsiva e interativa
-- **Design Moderno**: Interface limpa com Tailwind CSS
-- **SPA Experience**: Navegação fluida sem recarregamento
-
-### Banco de Dados
-```sql
--- Tabelas principais
-users                    -- Usuários e autenticação
-user_settings            -- Configurações personalizadas
-flashcards              -- Sistema de flashcards
-study_sessions          -- Sessões de estudo
-user_articles           -- Artigos salvos pelo usuário
-user_interests          -- Interesses do usuário
-content_recommendations -- Recomendações de conteúdo
-study_plans             -- Planos de estudo
-study_plan_activities   -- Atividades dos planos
-user_analytics          -- Métricas e analytics
-```
-
-### Integrações de IA
-- **Groq**: Processamento de linguagem natural rápido
-- **Google Gemini**: Análise avançada de conteúdo
-- **Google Text-to-Speech**: Síntese de voz
-- **BeautifulSoup**: Web scraping inteligente
-- **FeedParser**: Processamento de feeds RSS
-
-## 🛠️ Instalação e Configuração
-
-### Pré-requisitos
-- Python 3.8+
-- Chaves de API:
-  - `GROQ_API_KEY`: Para processamento de linguagem
-  - `GEMINI_API_KEY`: Para análise de conteúdo
-  - `SECRET_KEY`: Para segurança da sessão
-
-### Instalação
-```bash
-# Clone o repositório
-git clone <repository-url>
-cd englishhelper
-
-# Instale as dependências
-pip install -r requirements.txt
-
-# Configure as variáveis de ambiente
-export GROQ_API_KEY="sua-chave-groq"
-export GEMINI_API_KEY="sua-chave-gemini"
-export SECRET_KEY="sua-chave-secreta"
-
-# Execute a aplicação
-python run.py
-```
-
-### Configuração de Desenvolvimento
-```bash
-# Para desenvolvimento
-export FLASK_DEBUG=true
-python app.py
-```
-
-## 📚 Como Usar
-
-### 1. Criação de Conta
-1. Acesse a aplicação no navegador
-2. Registre-se com email e senha
-3. Confirme seu email (opcional)
-4. Configure seu perfil (nível, interesses, contexto)
-
-### 2. Curadoria de Conteúdo
-1. **Buscar Conteúdo**: Use a barra de busca para encontrar artigos
-2. **Salvar Artigos**: Clique em "Salvar" para adicionar à sua biblioteca
-3. **Gerenciar Interesses**: Configure seus tópicos de interesse
-4. **Recomendações**: Receba sugestões personalizadas baseadas em IA
-
-### 3. Estudo Interativo
-1. **Flashcards**: Crie e revise vocabulário
-2. **Conversação**: Pratique com o bot de IA
-3. **Escrita**: Complete exercícios guiados
-4. **Imagens**: Gere imagens para contextualizar vocabulário
-
-### 4. Planejamento de Estudos
-1. **Gerar Plano**: Configure seu nível atual e objetivo
-2. **Seguir Atividades**: Complete as atividades sugeridas
-3. **Marcar Progresso**: Registre suas atividades concluídas
-4. **Acompanhar Analytics**: Monitore seu progresso
-
-## 🎯 Níveis Suportados
-
-O sistema suporta todos os níveis do Quadro Europeu Comum:
-- **A1**: Básico - vocabulário essencial e frases simples
-- **A2**: Elementar - situações cotidianas e tempos verbais básicos
-- **B1**: Intermediário - conversas mais complexas e opiniões
-- **B2**: Intermediário Superior - textos complexos e apresentações
-- **C1**: Avançado - textos acadêmicos e expressões sofisticadas
-- **C2**: Proficiência - fluência nativa e literatura
-
-## 🔧 Contextos de Aprendizado
-
-### Profissional/Negócios
-- Vocabulário corporativo
-- Apresentações e relatórios
-- Comunicação formal
-- Networking e reuniões
-
-### Técnico/TI
-- Terminologia técnica
-- Documentação especializada
-- Comunicação em equipes de desenvolvimento
-- Artigos de tecnologia
-
-### Geral/Social
-- Conversação cotidiana
-- Mídias sociais
-- Entretenimento
-- Viagens e cultura
-
-## 📈 Analytics e Métricas
-
-### Métricas Individuais
-- Tempo total de estudo
-- Palavras aprendidas
-- Artigos lidos
-- Atividades completadas
-- Progresso por nível
-
-### Visualizações
-- Gráficos de progresso temporal
-- Distribuição de atividades
-- Comparação de performance
-- Tendências de aprendizado
-
-## 🚀 Funcionalidades Avançadas
-
-### Sistema de Recomendações
-- Análise de padrões de aprendizado
-- Sugestões adaptativas de conteúdo
-- Personalização baseada em performance
-- Machine Learning para otimização
-
-### Planejamento Inteligente
-- Cronogramas adaptativos
-- Balanceamento de habilidades
-- Ajustes baseados em progresso
-- Marcos e objetivos personalizados
-
-### Curadoria Automática
-- Busca em tempo real
-- Filtros de qualidade
-- Análise de relevância
-- Diversificação de fontes
-
-## 🔐 Segurança e Privacidade
-
-- Autenticação segura com hash de senhas
-- Sessões criptografadas
-- Dados locais em SQLite
-- Sem compartilhamento de dados pessoais
-- Conformidade com boas práticas de segurança
-
-## 🚀 Roadmap Futuro
-
-### Próximas Funcionalidades
-- [ ] Integração com mais APIs de IA
-- [ ] Sistema de gamificação
-- [ ] Comunidade de learners
-- [ ] Certificações integradas
-- [ ] App móvel
-- [ ] Integração com calendários
-- [ ] Suporte a múltiplos idiomas
-
-### Melhorias Técnicas
-- [ ] Cache inteligente
-- [ ] Otimização de performance
-- [ ] Testes automatizados
-- [ ] Deploy em cloud
-- [ ] Monitoramento avançado
-
-## 🤝 Contribuição
-
-Este é um projeto de demonstração das capacidades avançadas de IA para educação. Sugestões e melhorias são bem-vindas!
-
-## 📄 Licença
-
-Projeto desenvolvido para fins educacionais e demonstração de tecnologias avançadas de IA aplicadas ao aprendizado de idiomas.
+---
+title: English Helper
+emoji: 🎓
+colorFrom: blue
+colorTo: purple
+sdk: docker
+pinned: false
+license: mit
+---
+
+# 🎓 English Helper - AI-Powered Language Learning Platform
+
+## 🌟 Overview
+
+English Helper is an advanced AI-powered English learning platform that combines intelligent content curation, interactive immersive environment, and personalized study planning to provide a comprehensive language learning experience.
+
+## ✨ Key Features
+
+### 🤖 AI-Powered Learning
+- **Smart Conversation Practice**: Natural conversations with AI tutors
+- **Personalized Content Curation**: AI-recommended articles and materials
+- **Intelligent Study Planning**: Adaptive learning schedules
+- **Real-time Feedback**: Pronunciation and grammar assistance
+
+### 📚 Interactive Learning Tools
+- **Flashcard System**: Spaced repetition vocabulary learning
+- **Writing Exercises**: Guided practice with AI feedback
+- **Reading Comprehension**: Curated articles with difficulty assessment
+- **Image Generation**: Visual vocabulary reinforcement
+
+### 📊 Advanced Analytics
+- **Progress Tracking**: Detailed performance metrics
+- **Study Analytics**: Time management and efficiency analysis
+- **Personalized Recommendations**: AI-driven content suggestions
+- **Achievement System**: Milestone tracking and motivation
+
+### 🔐 Admin Panel
+- **User Management**: Complete user administration
+- **Token Usage Monitoring**: API cost tracking and analytics
+- **System Health**: Real-time performance monitoring
+- **Data Export**: CSV exports and reporting
+
+## 🚀 Quick Start
+
+1. **Create Account**: Register with your email
+2. **Set Your Level**: Choose from A1 to C2
+3. **Define Interests**: Select your learning focus areas
+4. **Start Learning**: Use flashcards, chat with AI, read articles
+5. **Track Progress**: Monitor your improvement over time
+
+## 🎯 Learning Levels Supported
+
+- **A1-A2**: Basic to Elementary
+- **B1-B2**: Intermediate to Upper-Intermediate  
+- **C1-C2**: Advanced to Proficiency
+
+## 🌍 Learning Contexts
+
+- **Professional/Business**: Corporate communication and presentations
+- **Technical/IT**: Technology and software development terminology
+- **General/Social**: Everyday conversation and social interactions
+
+## 🛠️ Technology Stack
+
+- **Backend**: Python Flask with SQLite
+- **Frontend**: Responsive HTML/CSS/JavaScript
+- **AI APIs**: Groq (fast processing) + Google Gemini (advanced analysis)
+- **Features**: Real-time chat, content curation, study planning
+
+## 📱 Usage
+
+### For Learners:
+1. Register and set your English level
+2. Use the conversation feature to practice speaking
+3. Create and review flashcards for vocabulary
+4. Read curated articles matching your interests
+5. Follow your personalized study plan
+6. Track your progress in the analytics dashboard
+
+### For Administrators:
+1. Access the admin panel at `/admin`
+2. Monitor user activity and system health
+3. Track API usage and costs
+4. Export data for analysis
+5. Manage users and content
+
+## 🔧 Configuration
+
+The app requires several environment variables to be set (configured automatically in Hugging Face):
+
+- `GROQ_API_KEY`: For AI conversations
+- `GEMINI_API_KEY`: For content analysis  
+- `SMTP_*`: For email functionality (optional)
+- `ADMIN_*`: For administrative access
+
+## 📚 Educational Impact
+
+English Helper leverages cutting-edge AI to provide:
+- **Personalized Learning Paths**: Adaptive content based on user progress
+- **Real-world Application**: Practical scenarios and contexts
+- **Immediate Feedback**: Instant corrections and suggestions
+- **Motivation Systems**: Progress tracking and achievement unlocking
+
+## 🎓 Perfect For:
+
+- **Students** preparing for English proficiency exams
+- **Professionals** improving business English skills
+- **Developers** learning technical English terminology
+- **Anyone** wanting to improve their English systematically
+
+## 🔒 Privacy & Security
+
+- User data stored securely with SQLite
+- Session management with encrypted cookies
+- Admin access protected with authentication
+- No data sharing with third parties
 
 ---
 
-**English Helper** - Transformando o aprendizado de inglês com inteligência artificial! 🎓✨
+**Start your English learning journey with AI-powered assistance!** 🚀📚✨