Spaces:
Sleeping
Sleeping
Update README.md
Browse files
README.md
CHANGED
|
@@ -4,9 +4,9 @@ emoji: 🎓
|
|
| 4 |
colorFrom: blue
|
| 5 |
colorTo: purple
|
| 6 |
sdk: gradio
|
|
|
|
| 7 |
pinned: false
|
| 8 |
license: mit
|
| 9 |
-
sdk_version: 5.49.1
|
| 10 |
---
|
| 11 |
|
| 12 |
# 🎓 English Helper - AI English Learning Platform
|
|
@@ -47,18 +47,23 @@ python3 -c "import secrets; print(secrets.token_urlsafe(32))"
|
|
| 47 |
|
| 48 |
## 🚀 Como Usar
|
| 49 |
|
| 50 |
-
### 1. **
|
| 51 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 52 |
|
| 53 |
-
### 2. **
|
| 54 |
-
Acesse
|
| 55 |
-
-
|
| 56 |
-
-
|
| 57 |
-
-
|
| 58 |
-
-
|
| 59 |
|
| 60 |
-
### 3. **
|
| 61 |
-
Acesse `/
|
| 62 |
|
| 63 |
## 🛠️ Stack Tecnológico
|
| 64 |
|
|
@@ -72,17 +77,21 @@ Acesse `/admin` com suas credenciais configuradas nos secrets.
|
|
| 72 |
## 📊 Arquitetura
|
| 73 |
|
| 74 |
```
|
| 75 |
-
app.py #
|
| 76 |
-
flask_app.py #
|
| 77 |
-
admin_module.py # Painel administrativo
|
| 78 |
-
database.py #
|
| 79 |
-
content_curator.py # Curadoria com IA
|
| 80 |
-
study_planner.py # Planos de estudo
|
| 81 |
templates/
|
| 82 |
├── admin.html # Interface administrativa
|
| 83 |
-
└── index.html # Interface principal
|
| 84 |
```
|
| 85 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 86 |
## 🔒 Segurança
|
| 87 |
|
| 88 |
- ✅ Autenticação segura com hash de senhas
|
|
@@ -93,11 +102,17 @@ templates/
|
|
| 93 |
|
| 94 |
## 🎯 Primeiros Passos
|
| 95 |
|
| 96 |
-
1. **Configurar secrets** (obrigatório)
|
| 97 |
2. **Aguardar build** (~2-5 minutos)
|
| 98 |
-
3. **
|
| 99 |
-
4. **
|
| 100 |
-
5. **
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 101 |
|
| 102 |
## 🆘 Troubleshooting
|
| 103 |
|
|
|
|
| 4 |
colorFrom: blue
|
| 5 |
colorTo: purple
|
| 6 |
sdk: gradio
|
| 7 |
+
app_file: app.py
|
| 8 |
pinned: false
|
| 9 |
license: mit
|
|
|
|
| 10 |
---
|
| 11 |
|
| 12 |
# 🎓 English Helper - AI English Learning Platform
|
|
|
|
| 47 |
|
| 48 |
## 🚀 Como Usar
|
| 49 |
|
| 50 |
+
### 1. **Aplicação Principal**
|
| 51 |
+
Acesse diretamente a aplicação completa de aprendizado de inglês:
|
| 52 |
+
- **Chat IA**: Pratique conversação em tempo real
|
| 53 |
+
- **Flashcards**: Sistema de vocabulário interativo
|
| 54 |
+
- **Curadoria**: Artigos personalizados por nível
|
| 55 |
+
- **Planos**: Cronograma de estudos com IA
|
| 56 |
+
- **Analytics**: Acompanhe seu progresso
|
| 57 |
|
| 58 |
+
### 2. **Painel Administrativo**
|
| 59 |
+
Acesse `/admin` com suas credenciais para:
|
| 60 |
+
- 👥 Gerenciar usuários
|
| 61 |
+
- 📊 Visualizar analytics completo
|
| 62 |
+
- 🔧 Configurar sistema
|
| 63 |
+
- 📈 Monitorar uso de tokens
|
| 64 |
|
| 65 |
+
### 3. **Dashboard de Sistema**
|
| 66 |
+
Acesse `/dashboard` para monitoramento técnico e status das APIs.
|
| 67 |
|
| 68 |
## 🛠️ Stack Tecnológico
|
| 69 |
|
|
|
|
| 77 |
## 📊 Arquitetura
|
| 78 |
|
| 79 |
```
|
| 80 |
+
app.py # Entry point - Flask principal + Gradio dashboard
|
| 81 |
+
flask_app.py # Aplicação Flask completa (porta 7860)
|
| 82 |
+
admin_module.py # Painel administrativo avançado
|
| 83 |
+
database.py # Sistema SQLite com 10+ tabelas
|
|
|
|
|
|
|
| 84 |
templates/
|
| 85 |
├── admin.html # Interface administrativa
|
| 86 |
+
└── index.html # Interface principal com rodapé
|
| 87 |
```
|
| 88 |
|
| 89 |
+
### 🏗️ **Nova Arquitetura (2024)**
|
| 90 |
+
- **Flask Único**: Porta 7860 (aplicação completa)
|
| 91 |
+
- **Dashboard HTML**: Rota `/dashboard` (monitoramento simples)
|
| 92 |
+
- **Sem Conflitos**: Uma única aplicação web
|
| 93 |
+
- **Links Integrados**: Rodapé com admin/status/dashboard
|
| 94 |
+
|
| 95 |
## 🔒 Segurança
|
| 96 |
|
| 97 |
- ✅ Autenticação segura com hash de senhas
|
|
|
|
| 102 |
|
| 103 |
## 🎯 Primeiros Passos
|
| 104 |
|
| 105 |
+
1. **Configurar secrets** (obrigatório - veja tabela acima)
|
| 106 |
2. **Aguardar build** (~2-5 minutos)
|
| 107 |
+
3. **Acessar aplicação** - Vai direto para o sistema completo
|
| 108 |
+
4. **Criar conta** ou fazer login
|
| 109 |
+
5. **Admin**: Acesse `/admin` com suas credenciais
|
| 110 |
+
|
| 111 |
+
### 🔗 **URLs Principais**
|
| 112 |
+
- **Principal**: `https://seu-space.hf.space/` → Aplicação completa
|
| 113 |
+
- **Admin**: `https://seu-space.hf.space/admin` → Painel administrativo
|
| 114 |
+
- **Status**: `https://seu-space.hf.space/auth/check` → Health check
|
| 115 |
+
- **Dashboard**: `https://seu-space.hf.space/dashboard` → Monitor sistema
|
| 116 |
|
| 117 |
## 🆘 Troubleshooting
|
| 118 |
|