Update README.md

README.md

@@ -6,116 +6,108 @@ colorTo: purple
 sdk: gradio
 pinned: false
 license: mit
-sdk_version: 5.49.1
 ---
 
-# 🎓 English Helper - AI-Powered Language Learning Platform
+# 🎓 English Helper - AI English Learning Platform
 
-## 🌟 Overview
+Sistema completo de aprendizado de inglês com inteligência artificial, curadoria de conteúdo personalizada e painel administrativo avançado.
 
-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.
+## 🌟 Funcionalidades Principais
 
-## ✨ Key Features
+- 🤖 **Chat IA**: Conversação em inglês com correções em tempo real
+- 📚 **Flashcards**: Geração automática baseada nas conversas
+- 📰 **Curadoria**: Artigos personalizados por nível de proficiência  
+- 📅 **Plano de Estudos**: Cronograma adaptativo com IA
+- 🎵 **TTS**: Síntese de voz para pronunciação
+- 📊 **Analytics**: Dashboard administrativo completo
+- � **Multi-usuário**: Sistema de autenticação e perfis
 
-### 🤖 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
+## ⚙️ Configuração Obrigatória
 
-### 📚 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
+### 🔐 Repository Secrets (Settings → Repository secrets)
 
-### 📊 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
+Configure estas variáveis como secrets no Hugging Face:
 
-### 🔐 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
+| Secret Name | Obrigatório | Exemplo | Descrição |
+|-------------|-------------|---------|-----------|
+| `GROQ_API_KEY` | ✅ SIM | `gsk_abc123...` | API para conversação IA |
+| `GEMINI_API_KEY` | ✅ SIM | `AIzaSyA123...` | API para análise de conteúdo |
+| `SECRET_KEY` | ✅ SIM | `XYZ789...` | Chave de segurança Flask |
+| `BASE_URL` | ✅ SIM | `https://huggingface.co/spaces/amauricunha/englishhelper` | URL deste Space |
+| `ADMIN_USERNAME` | ✅ SIM | `admin` | Username do painel admin |
+| `ADMIN_PASSWORD` | ✅ SIM | `MinhaSenh@123!` | Senha do painel admin |
 
-## 🚀 Quick Start
+### 🔑 Como Gerar SECRET_KEY
 
-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
+Execute no terminal:
+```bash
+python3 -c "import secrets; print(secrets.token_urlsafe(32))"
+```
 
-## 🎯 Learning Levels Supported
+## 🚀 Como Usar
 
-- **A1-A2**: Basic to Elementary
-- **B1-B2**: Intermediate to Upper-Intermediate  
-- **C1-C2**: Advanced to Proficiency
+### 1. **Dashboard Principal** 
+Interface Gradio com status do sistema e links de acesso.
 
-## 🌍 Learning Contexts
+### 2. **Sistema Completo**
+Acesse as funcionalidades através dos links no dashboard:
+- **Chat IA**: Pratique conversação
+- **Flashcards**: Revise vocabulário
+- **Curadoria**: Leia artigos personalizados
+- **Planos**: Acompanhe seu progresso
 
-- **Professional/Business**: Corporate communication and presentations
-- **Technical/IT**: Technology and software development terminology
-- **General/Social**: Everyday conversation and social interactions
+### 3. **Painel Administrativo**
+Acesse `/admin` com suas credenciais configuradas nos secrets.
 
-## 🛠️ Technology Stack
+## 🛠️ Stack Tecnológico
 
-- **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
+- **Frontend**: Gradio + HTML5/CSS3/JavaScript
+- **Backend**: Flask + Python 3.8+
+- **Database**: SQLite
+- **IA**: Groq API + Google Gemini
+- **Audio**: Google Text-to-Speech
+- **Deploy**: Hugging Face Spaces
 
-## 📱 Usage
+## 📊 Arquitetura
 
-### 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
+```
+app.py                    # Interface Gradio (entrada HF Spaces)
+flask_app.py             # Sistema Flask completo
+admin_module.py          # Painel administrativo
+database.py              # Gerenciamento de dados
+content_curator.py       # Curadoria com IA
+study_planner.py         # Planos de estudo
+templates/
+├── admin.html          # Interface administrativa
+└── index.html          # Interface principal
+```
 
-### 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
+## 🔒 Segurança
 
-## 🔧 Configuration
+- ✅ Autenticação segura com hash de senhas
+- ✅ Proteção CSRF em formulários  
+- ✅ Sanitização de dados de entrada
+- ✅ Rate limiting em APIs
+- ✅ HTTPS automático no HF Spaces
 
-The app requires several environment variables to be set (configured automatically in Hugging Face):
+## 🎯 Primeiros Passos
 
-- `GROQ_API_KEY`: For AI conversations
-- `GEMINI_API_KEY`: For content analysis  
-- `SMTP_*`: For email functionality (optional)
-- `ADMIN_*`: For administrative access
+1. **Configurar secrets** (obrigatório)
+2. **Aguardar build** (~2-5 minutos)
+3. **Testar dashboard** Gradio
+4. **Acessar sistema** via links
+5. **Login admin** com suas credenciais
 
-## 📚 Educational Impact
+## 🆘 Troubleshooting
 
-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
+### Problemas Comuns:
+- **500 Error**: Verifique se todos os secrets obrigatórios estão configurados
+- **Admin não acessa**: Confirme ADMIN_USERNAME e ADMIN_PASSWORD
+- **APIs não funcionam**: Teste chaves Groq e Gemini individualmente
 
-## 🎓 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
+### Logs:
+Verifique `Settings → Logs` para debug detalhado.
 
 ---
 
-**Start your English learning journey with AI-powered assistance!** 🚀📚✨
+**🎓 English Helper** - Aprenda inglês com IA de forma inteligente e personalizada! 🚀