amauricunha commited on
Commit
4649493
·
verified ·
1 Parent(s): 8b71511

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +37 -22
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. **Dashboard Principal**
51
- Interface Gradio com status do sistema e links de acesso.
 
 
 
 
 
52
 
53
- ### 2. **Sistema Completo**
54
- Acesse as funcionalidades através dos links no dashboard:
55
- - **Chat IA**: Pratique conversação
56
- - **Flashcards**: Revise vocabulário
57
- - **Curadoria**: Leia artigos personalizados
58
- - **Planos**: Acompanhe seu progresso
59
 
60
- ### 3. **Painel Administrativo**
61
- Acesse `/admin` com suas credenciais configuradas nos secrets.
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 # Interface Gradio (entrada HF Spaces)
76
- flask_app.py # Sistema Flask completo
77
- admin_module.py # Painel administrativo
78
- database.py # Gerenciamento de dados
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. **Testar dashboard** Gradio
99
- 4. **Acessar sistema** via links
100
- 5. **Login admin** com suas credenciais
 
 
 
 
 
 
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