🔐Guía del Administrador - ToLearn

Esta guía proporciona instrucciones completas para administradores del sistema ToLearn sobre gestión de usuarios, configuración, mantenimiento y seguridad.

📋 Tabla de Contenidos

• Panel de Administración

• Gestión de Usuarios

• Gestión de Cursos

• Configuración del Sistema

• Traducciones e Idiomas

• Mantenimiento

• Seguridad

• Monitoreo y Logs

• Backups y Recuperación

🎛️ Panel de Administración

Acceso al Panel Admin

URL: https://tolearn.online/admin
Usuario: tu_usuario_admin
Contraseña: tu_contraseña_segura

Dashboard del Administrador

┌─────────────────────────────────────────┐
│  TOLEARN - PANEL DE ADMINISTRACIÓN      │
├─────────────────────────────────────────┤
│  Usuarios: 1,250                        │
│  Profesores: 45    Estudiantes: 1,205   │
│  Cursos Activos: 85                     │
│  Evaluaciones: 342                      │
│  Almacenamiento: 45GB / 100GB          │
│  Uptime: 99.8%                          │
├─────────────────────────────────────────┤
│  [👥 Usuarios] [📚 Cursos]              │
│  [📝 Evaluaciones] [⚙️ Configuración]  │
│  [📊 Estadísticas] [🔒 Seguridad]      │
└─────────────────────────────────────────┘

Interfaz Django Admin

ToLearn utiliza Django Admin personalizado con Django Unfold para una interfaz moderna:

• Diseño moderno: Interfaz limpia y responsive

• Búsqueda avanzada: Filtros y búsqueda rápida

• Acciones masivas: Operaciones en múltiples objetos

• Historial de cambios: Auditoría completa

👥 Gestión de Usuarios

Crear Usuario

Método 1: Desde Admin Panel

Admin → Usuarios → [+ Agregar Usuario]

1. Información Básica:
   - Username: usuario_nuevo
   - Email: [email protected]
   - Contraseña: [Generar Segura]
   
2. Información Personal:
   - Nombre: Juan
   - Apellidos: Pérez López
   
3. Permisos:
   - Staff status: ☐ No  ☑ Sí (si es admin/profesor)
   - Superuser: ☐ No  ☑ Sí (solo para admins)
   - Groups: [Seleccionar grupo]
     ○ student
     ○ teacher
     ○ administrator

[Guardar]  [Guardar y agregar otro]

Método 2: Por Comando

# Crear superusuario
python manage.py createsuperuser

# Crear usuario programáticamente
python manage.py shell
>>> from django.contrib.auth.models import User, Group
>>> user = User.objects.create_user('username', '[email protected]', 'password')
>>> student_group = Group.objects.get(name='student')
>>> user.groups.add(student_group)
>>> user.save()

Grupos y Permisos

Grupos Predefinidos

1. Student (Estudiante)

Permisos:
- Ver cursos asignados
- Completar evaluaciones
- Ver calificaciones
- Participar en webinars
- Descargar materiales

2. Teacher (Profesor)

Permisos de Estudiante +
- Crear cursos
- Crear evaluaciones
- Calificar tareas
- Gestionar webinars
- Ver estadísticas de estudiantes
- Enviar notificaciones

3. Administrator (Administrador)

Permisos de Profesor +
- Gestión completa de usuarios
- Configuración del sistema
- Acceso a logs
- Gestión de almacenamiento
- Configuración de seguridad

Asignar Permisos Personalizados

Admin → Usuarios → Seleccionar usuario → Permisos

☑ Permisos de Usuario:
  ☑ Can add course
  ☑ Can change course
  ☐ Can delete course
  ☑ Can view course
  ☑ Can add lesson
  ☑ Can change lesson
  ...

Grupos:
  ☑ teacher

Gestión Masiva de Usuarios

Importar Usuarios desde CSV

Admin → Usuarios → [📥 Importar]

Formato CSV:
username,email,first_name,last_name,group
juan.perez,[email protected],Juan,Pérez,student
maria.lopez,[email protected],María,López,student

[Seleccionar Archivo] [Importar]

Opciones:
☑ Enviar email de bienvenida
☑ Generar contraseña automática
☐ Activar inmediatamente

Exportar Usuarios

Admin → Usuarios → [☑ Seleccionar todos] → [📤 Exportar]

Formatos:
- CSV
- Excel
- JSON

Incluir:
☑ Información básica
☑ Grupos y permisos
☐ Contraseñas (hasheadas)
☑ Estadísticas

Operaciones Masivas

Admin → Usuarios → [☑ Seleccionar múltiples]

Acciones disponibles:
- Activar usuarios seleccionados
- Desactivar usuarios
- Eliminar usuarios
- Cambiar grupo
- Resetear contraseñas
- Enviar email masivo

[Ejecutar]

Gestionar Perfiles de Usuario

Admin → User Profiles → Seleccionar perfil

┌─────────────────────────────────────────┐
│  PERFIL: Juan Pérez                     │
├─────────────────────────────────────────┤
│  Usuario: juan.perez                    │
│  Email: [email protected]                │
│  Idioma Preferido: Español             │
│  Avatar: [📁 Cambiar]                   │
│  Bio: Estudiante de 3er año...         │
│                                         │
│  Configuración de Notificaciones:       │
│  ☑ Email de nuevas tareas              │
│  ☑ Recordatorios de fechas límite      │
│  ☐ Newsletter semanal                  │
└─────────────────────────────────────────┘

Resetear Contraseña de Usuario

Admin → Usuarios → Seleccionar → [🔐 Cambiar contraseña]

Opción 1: Establecer nueva contraseña
Nueva contraseña: [_______________]
Confirmar: [_______________]
☑ Requerir cambio en próximo login

Opción 2: Enviar enlace de reset
☑ Enviar email con enlace de recuperación

[Guardar]

📚 Gestión de Cursos

Supervisión de Cursos

Admin → Courses → Courses

Vista de Todos los Cursos:
┌─────────────────────────────────────────┐
│  ID │ Título            │ Estado │ Est. │
├─────┼───────────────────┼────────┼──────┤
│  1  │ Biología          │ Activo │  45  │
│  2  │ Química           │ Activo │  38  │
│  3  │ Física            │ Nuevo  │   0  │
│  4  │ Matemáticas 2023  │ Archivo│  52  │
└─────┴───────────────────┴────────┴──────┘

Filtros:
- Estado: [Todos ▼]
- Profesor: [Todos ▼]
- Fecha: [Rango de fechas]

Gestionar Acceso a Cursos

Admin → Courses → Course → Seleccionar curso

CONTROL DE ACCESO:

Estudiantes con Acceso Directo:
- Ana García (desde: 01/09/2024)
- Luis Martínez (desde: 01/09/2024)
[+ Agregar estudiante]

Clases con Acceso:
- Clase 3-A (25 estudiantes)
- Grupo Avanzado (12 estudiantes)
[+ Agregar clase]

Total de Estudiantes con Acceso: 45

Gestionar Aulas (ClassRooms)

Admin → Dashboard → ClassRooms

CREAR AULA:
Nombre: Clase 3-A
Estudiantes:
  [🔍 Buscar y agregar...]
  - Juan Pérez
  - María López
  - Carlos Ruiz
  [+ Agregar más]

ACCIONES MASIVAS:
- Asignar curso a toda la clase
- Enviar notificación grupal
- Exportar lista de estudiantes
- Clonar aula

⚙️ Configuración del Sistema

Acceso a Configuración

Admin → Configuración del Sistema

O editar directamente:
testfox/settings.py

Configuraciones Principales

Configuración General

# testfox/settings.py

# Información del Sitio
SITE_NAME = 'ToLearn'
SITE_DOMAIN = 'tolearn.online'
SITE_ID = 1

# Seguridad
DEBUG = False  # ¡SIEMPRE False en producción!
SECRET_KEY = 'tu-clave-secreta-muy-larga'
ALLOWED_HOSTS = ['tolearn.online', 'www.tolearn.online']

# HTTPS
SECURE_SSL_REDIRECT = True
SESSION_COOKIE_SECURE = True
CSRF_COOKIE_SECURE = True
SECURE_HSTS_SECONDS = 31536000

# Email
EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
EMAIL_HOST = 'smtp.gmail.com'
EMAIL_PORT = 587
EMAIL_USE_TLS = True
EMAIL_HOST_USER = '[email protected]'
EMAIL_HOST_PASSWORD = 'tu-app-password'
DEFAULT_FROM_EMAIL = '[email protected]'

Configuración de Base de Datos

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'tolearn_production',
        'USER': 'tolearn_user',
        'PASSWORD': 'password-seguro',
        'HOST': 'localhost',
        'PORT': '5432',
        'CONN_MAX_AGE': 600,
        'OPTIONS': {
            'connect_timeout': 10,
        }
    }
}

Configuración de Redis

CHANNEL_LAYERS = {
    "default": {
        "BACKEND": "channels_redis.core.RedisChannelLayer",
        "CONFIG": {
            "hosts": [("redis", 6379)],
            "capacity": 1500,
            "expiry": 10,
        },
    },
}

CACHES = {
    'default': {
        'BACKEND': 'django_redis.cache.RedisCache',
        'LOCATION': 'redis://127.0.0.1:6379/1',
        'OPTIONS': {
            'CLIENT_CLASS': 'django_redis.client.DefaultClient',
            'PARSER_CLASS': 'redis.connection.HiredisParser',
        }
    }
}

Configuración de Almacenamiento (S3)

# AWS S3 Configuration
AWS_ACCESS_KEY_ID = 'tu_access_key'
AWS_SECRET_ACCESS_KEY = 'tu_secret_key'
AWS_STORAGE_BUCKET_NAME = 'tolearn-media'
AWS_S3_REGION_NAME = 'ru-1'
AWS_S3_ENDPOINT_URL = 'https://s3.twcstorage.ru'
AWS_DEFAULT_ACL = 'public-read'

# Media Storage
DEFAULT_FILE_STORAGE = 'testfox.settings.MediaStorage'
MEDIA_URL = f'{AWS_S3_ENDPOINT_URL}/{AWS_STORAGE_BUCKET_NAME}/media/'

Configuración de Límites

# Límites de Archivo
DATA_UPLOAD_MAX_MEMORY_SIZE = 10485760  # 10MB
FILE_UPLOAD_MAX_MEMORY_SIZE = 10485760  # 10MB

# Límites de Evaluaciones
MAX_QUESTIONS_PER_ASSIGNMENT = 100
MAX_ATTEMPTS_PER_STUDENT = 3

# Límites de Webinar
MAX_PARTICIPANTS_PER_WEBINAR = 50
WEBINAR_MAX_DURATION_HOURS = 3

OAuth y Autenticación Social

# Google OAuth
SOCIALACCOUNT_PROVIDERS = {
    'google': {
        'APP': {
            'client_id': 'tu-client-id.apps.googleusercontent.com',
            'secret': 'tu-client-secret',
            'key': ''
        },
        'SCOPE': [
            'profile',
            'email',
        ],
        'AUTH_PARAMS': {
            'access_type': 'online',
        }
    }
}

# Configuración allauth
ACCOUNT_EMAIL_VERIFICATION = 'none'
SOCIALACCOUNT_AUTO_SIGNUP = False
SOCIALACCOUNT_ADAPTER = 'accounts.adapter.NoSignupSocialAccountAdapter'

🌍 Traducciones e Idiomas

Gestión de Idiomas

ToLearn soporta múltiples idiomas usando django-modeltranslation y django-rosetta.

Idiomas Configurados

# settings.py
LANGUAGES = [
    ('ru', 'Русский'),
    ('en', 'English'),
    ('es', 'Español'),
]

LANGUAGE_CODE = 'ru'  # Idioma predeterminado

MODELTRANSLATION_DEFAULT_LANGUAGE = 'ru'
MODELTRANSLATION_LANGUAGES = ('ru', 'en', 'es')

Django-Rosetta (Interfaz de Traducción)

Acceso a Rosetta

URL: https://tolearn.online/rosetta
(Solo accesible para administradores)

Traducir Cadenas

Rosetta → Seleccionar idioma: Español

┌─────────────────────────────────────────┐
│  CADENAS A TRADUCIR                     │
├─────────────────────────────────────────┤
│  Original (Ruso):                       │
│  "Новый курс"                           │
│                                         │
│  Traducción (Español):                  │
│  [Nuevo curso_____________]             │
│                                         │
│  Contexto: courses/models.py:23         │
│  Usado en: Course.STATUS_NEW            │
└─────────────────────────────────────────┘

[Guardar] [Siguiente]

Compilar Traducciones

Después de hacer cambios en Rosetta:

# Compilar mensajes
python manage.py compilemessages

# Reiniciar servidor para aplicar cambios
sudo systemctl restart tolearn

Agregar Nuevo Idioma

# 1. Agregar idioma a settings.py
LANGUAGES = [
    ('ru', 'Русский'),
    ('en', 'English'),
    ('es', 'Español'),
    ('fr', 'Français'),  # Nuevo
]

# 2. Crear archivos de traducción
python manage.py makemessages -l fr

# 3. Traducir en locale/fr/LC_MESSAGES/django.po

# 4. Compilar
python manage.py compilemessages

# 5. Reiniciar servidor

Traducir Modelos con modeltranslation

Algunos modelos tienen campos traducibles:

# courses/translation.py
from modeltranslation.translator import translator, TranslationOptions
from .models import Course, Lesson

class CourseTranslationOptions(TranslationOptions):
    fields = ('title', 'description')

translator.register(Course, CourseTranslationOptions)

Esto crea campos como:

• title_ru, title_en, title_es

• description_ru, description_en, description_es

En el admin panel, verás pestañas para cada idioma.

🔧 Mantenimiento

Tareas de Mantenimiento Regulares

Limpieza de Base de Datos

# Eliminar sesiones expiradas
python manage.py clearsessions

# Eliminar archivos huérfanos
python manage.py cleanup_files

# Optimizar base de datos
python manage.py dbshell
>>> VACUUM ANALYZE;
>>> \q

Actualizar Índices de Búsqueda

# Si usas búsqueda full-text
python manage.py update_index

Limpiar Cache

# Redis
redis-cli FLUSHALL

# Django cache
python manage.py clear_cache

Actualizaciones del Sistema

Actualizar Django

# 1. Backup completo primero
python manage.py dumpdata > backup.json

# 2. Actualizar dependencias
pip install --upgrade django

# 3. Ejecutar migraciones
python manage.py migrate

# 4. Recopilar estáticos
python manage.py collectstatic --noinput

# 5. Reiniciar servidor
sudo systemctl restart tolearn daphne nginx

Aplicar Parches de Seguridad

# Ver paquetes con vulnerabilidades
pip list --outdated

# Actualizar paquetes específicos
pip install --upgrade package-name

# O actualizar todos (con precaución)
pip install --upgrade -r requirements.txt

Monitoreo de Salud del Sistema

# Ver uso de memoria
free -h

# Ver uso de disco
df -h

# Ver procesos de Django
ps aux | grep gunicorn
ps aux | grep daphne

# Ver conexiones de base de datos
sudo -u postgres psql -c "SELECT count(*) FROM pg_stat_activity;"

# Ver estado de Redis
redis-cli INFO

🔒 Seguridad

Checklist de Seguridad

Configuración de Django

# ✅ Verificar en settings.py

# Debug DEBE estar en False
DEBUG = False

# Secret key única y segura (50+ caracteres)
SECRET_KEY = 'clave-super-secreta-aleatoria-muy-larga'

# HTTPS obligatorio
SECURE_SSL_REDIRECT = True
SESSION_COOKIE_SECURE = True
CSRF_COOKIE_SECURE = True

# HSTS
SECURE_HSTS_SECONDS = 31536000
SECURE_HSTS_INCLUDE_SUBDOMAINS = True
SECURE_HSTS_PRELOAD = True

# XSS Protection
SECURE_BROWSER_XSS_FILTER = True
SECURE_CONTENT_TYPE_NOSNIFF = True
X_FRAME_OPTIONS = 'DENY'

Seguridad de Base de Datos

# PostgreSQL: Usar contraseñas fuertes
sudo -u postgres psql
\password tolearn_user
# Ingresa contraseña segura (16+ caracteres, mezcla)

# Configurar pg_hba.conf para autenticación md5
sudo nano /etc/postgresql/14/main/pg_hba.conf
# Cambiar 'peer' o 'trust' a 'md5'
local   all   all   md5
host    all   all   127.0.0.1/32   md5

# Reiniciar PostgreSQL
sudo systemctl restart postgresql

Seguridad de Redis

# Configurar contraseña en redis.conf
sudo nano /etc/redis/redis.conf

# Buscar y descomentar:
requirepass tu-password-redis-muy-seguro

# Bind a localhost solamente
bind 127.0.0.1

# Reiniciar Redis
sudo systemctl restart redis-server

Auditoría de Seguridad

Ver Logs de Autenticación

# Ver intentos de login fallidos
grep "Failed login" /var/log/tolearn/django.log

# Ver accesos al admin panel
grep "admin" /var/log/tolearn/django.log | grep "POST"

Revisar Usuarios con Permisos Elevados

# Django shell
python manage.py shell

>>> from django.contrib.auth.models import User
>>> superusers = User.objects.filter(is_superuser=True)
>>> for user in superusers:
...     print(f"{user.username} - Last login: {user.last_login}")

>>> staff = User.objects.filter(is_staff=True, is_superuser=False)
>>> print(f"Staff users: {staff.count()}")

Escanear Vulnerabilidades

# Usar safety para verificar dependencias
pip install safety
safety check

# Usar bandit para análisis de código
pip install bandit
bandit -r . -f json -o security_report.json

Respuesta a Incidentes

Usuario Comprometido

1. Desactivar cuenta inmediatamente:
   Admin → Usuario → is_active = False

2. Resetear contraseña

3. Revisar logs de actividad:
   - ¿Qué cursos accedió?
   - ¿Modificó datos?
   - ¿Descargó información?

4. Notificar al usuario real

5. Investigar cómo se comprometió

Brecha de Datos

1. Aislar el problema
   - Desconectar servicios afectados
   - Prevenir más acceso no autorizado

2. Evaluar el daño
   - ¿Qué datos fueron accedidos?
   - ¿Cuántos usuarios afectados?

3. Contener la brecha
   - Parchear vulnerabilidad
   - Cambiar credenciales

4. Notificar
   - Usuarios afectados
   - Autoridades si es requerido

5. Documentar todo
   - Cronología de eventos
   - Acciones tomadas
   - Lecciones aprendidas

📊 Monitoreo y Logs

Configuración de Logging

# settings.py
LOGGING = {
    'version': 1,
    'disable_existing_loggers': False,
    'formatters': {
        'verbose': {
            'format': '{levelname} {asctime} {module} {message}',
            'style': '{',
        },
    },
    'handlers': {
        'file': {
            'level': 'INFO',
            'class': 'logging.handlers.RotatingFileHandler',
            'filename': '/var/log/tolearn/django.log',
            'maxBytes': 1024*1024*15,  # 15MB
            'backupCount': 10,
            'formatter': 'verbose',
        },
        'error_file': {
            'level': 'ERROR',
            'class': 'logging.handlers.RotatingFileHandler',
            'filename': '/var/log/tolearn/errors.log',
            'maxBytes': 1024*1024*5,  # 5MB
            'backupCount': 5,
            'formatter': 'verbose',
        },
    },
    'loggers': {
        'django': {
            'handlers': ['file', 'error_file'],
            'level': 'INFO',
            'propagate': True,
        },
    },
}

Ver Logs

# Logs en tiempo real
tail -f /var/log/tolearn/django.log

# Ver errores
tail -f /var/log/tolearn/errors.log

# Buscar errores específicos
grep "ERROR" /var/log/tolearn/django.log

# Ver logs de Nginx
tail -f /var/log/nginx/access.log
tail -f /var/log/nginx/error.log

# Ver logs de Gunicorn/Daphne
sudo journalctl -u tolearn -f
sudo journalctl -u daphne -f

Monitoreo de Rendimiento

Herramientas Recomendadas

# htop - Monitor de procesos
sudo apt install htop
htop

# iotop - Monitor de I/O
sudo apt install iotop
sudo iotop

# netstat - Conexiones de red
netstat -tuln | grep LISTEN

Django Debug Toolbar (Solo Desarrollo)

# settings.py (solo si DEBUG=True)
INSTALLED_APPS += ['debug_toolbar']
MIDDLEWARE += ['debug_toolbar.middleware.DebugToolbarMiddleware']
INTERNAL_IPS = ['127.0.0.1']

Alertas y Notificaciones

Configurar Monitoreo con Sentry (Recomendado)

pip install sentry-sdk

# settings.py
import sentry_sdk
from sentry_sdk.integrations.django import DjangoIntegration

sentry_sdk.init(
    dsn="https://[email protected]/proyecto",
    integrations=[DjangoIntegration()],
    traces_sample_rate=1.0,
    send_default_pii=True
)

💾 Backups y Recuperación

Estrategia de Backup

Backup Diario Automático

# Script: /home/tolearn/backup.sh

#!/bin/bash
BACKUP_DIR="/home/tolearn/backups"
DATE=$(date +%Y%m%d_%H%M%S)

# Crear directorio
mkdir -p $BACKUP_DIR

# Backup de PostgreSQL
pg_dump -U tolearn_user -h localhost tolearn_production | gzip > $BACKUP_DIR/db_$DATE.sql.gz

# Backup de media files (si no están en S3)
tar -czf $BACKUP_DIR/media_$DATE.tar.gz /home/tolearn/Tolearn/mediafiles/

# Backup de configuración
tar -czf $BACKUP_DIR/config_$DATE.tar.gz /home/tolearn/Tolearn/testfox/settings.py /home/tolearn/Tolearn/.env

# Eliminar backups antiguos (más de 30 días)
find $BACKUP_DIR -type f -mtime +30 -delete

# Opcional: Subir a almacenamiento remoto
# aws s3 sync $BACKUP_DIR s3://tolearn-backups/

echo "Backup completado: $DATE"

Programar con Cron

# Editar crontab
crontab -e

# Agregar línea para backup diario a las 2 AM
0 2 * * * /home/tolearn/backup.sh >> /var/log/tolearn/backup.log 2>&1

Restaurar desde Backup

Restaurar Base de Datos

# 1. Detener servicios
sudo systemctl stop tolearn daphne

# 2. Crear backup de seguridad de BD actual
pg_dump -U tolearn_user tolearn_production > current_backup.sql

# 3. Restaurar desde backup
gunzip < backup_20241210.sql.gz | psql -U tolearn_user -d tolearn_production

# 4. Reiniciar servicios
sudo systemctl start tolearn daphne

Restaurar Archivos Media

# Extraer archivos
tar -xzf media_20241210.tar.gz -C /

# Verificar permisos
sudo chown -R tolearn:www-data /home/tolearn/Tolearn/mediafiles
sudo chmod -R 755 /home/tolearn/Tolearn/mediafiles

Backup en la Nube

AWS S3 Sync

# Instalar AWS CLI
pip install awscli

# Configurar credenciales
aws configure

# Sincronizar backups a S3
aws s3 sync /home/tolearn/backups/ s3://tolearn-backups/

📞 Soporte y Recursos

Contactos de Emergencia

Administrador Principal: [email protected]
Soporte Técnico: [email protected]
Seguridad: [email protected]
Teléfono 24/7: +X-XXX-XXX-XXXX

Documentación Adicional

• Guía de Instalación

• Arquitectura del Sistema

• Guía de Desarrollo

• Django Documentation

• PostgreSQL Documentation

Herramientas Útiles

# PostgreSQL
psql --version

# Redis
redis-cli --version
redis-cli INFO

# Django
python manage.py --version
python manage.py check
python manage.py showmigrations

# Sistema
df -h           # Espacio en disco
free -h         # Memoria
uptime          # Uptime del sistema
systemctl status  # Estado de servicios

---

Administración Responsable 🔐

Recuerda: Con gran poder viene gran responsabilidad. Mantén la plataforma segura, actualizada y funcionando de manera óptima para todos los usuarios.