socialcomputing/elas-official-backend-4-e3selector

E3Selector服务 Docker镜像文档

1. 镜像概述

E3Selector服务是ELAS（Exploratory Learning Analytics toolkit for Students）项目的核心组件之一，该项目由杜伊斯堡-埃森大学社会计算小组开发。E3Selector服务作为后端微服务，采用Django框架构建，提供学习分析相关的功能支持，旨在为学生提供个性化的学习分析工具和资源推荐。

主要用途

• 支持学习分析应用的核心业务逻辑处理
• 提供数据处理和分析能力
• 作为ELAS平台的关键后端服务组件

2. 核心功能和特性

• 学习资源选择与推荐
• 数据处理和分析任务调度
• 与前端应用的API接口服务
• 支持异步任务处理（通过Celery）
• 任务监控能力（通过Flower）

3. 使用场景和适用范围

E3Selector服务主要适用于：

• 杜伊斯堡-埃森大学的学生学习分析平台
• 教育数据分析与学习资源推荐系统
• 学习行为模式识别与分析
• 个性化学习路径规划

4. 技术架构

E3Selector服务基于Django框架构建，采用以下技术栈：

• Python 3.10.10
• Django后端框架
• Celery用于异步任务处理
• SQLite作为默认数据库
• 支持通过环境变量进行配置

5. 安装和部署

5.1 Docker镜像获取

bash
# 拉取E3Selector服务镜像
docker pull ude-soco/elas-e3selector:latest

5.2 Docker Run部署

bash
# 基本运行命令
docker run -d \
  --name elas-e3selector \
  -p 8000:8000 \
  -v ./env:/app/.env \
  ude-soco/elas-e3selector:latest

5.3 Docker Compose部署

创建docker-compose.yml文件：

yaml
version: '3.8'

services:
  e3selector:
    image: ude-soco/elas-e3selector:latest
    container_name: elas-e3selector
    ports:
      - "8000:8000"
    volumes:
      - ./env:/app/.env
    environment:
      - DEBUG=False
      - ALLOWED_HOSTS=localhost,127.0.0.1
    depends_on:
      - redis
    restart: unless-stopped

  redis:
    image: redis:latest
    container_name: elas-redis
    ports:
      - "6379:6379"
    volumes:
      - redis-data:/data
    restart: unless-stopped

volumes:
  redis-data:

启动服务：

bash
docker compose up -d

6. 配置说明

6.1 环境变量

E3Selector服务通过环境变量或.env文件进行配置，主要参数包括：

6.2 配置文件

创建.env文件进行配置：

DEBUG=False
SECRET_KEY=your-secret-key-here
ALLOWED_HOSTS=localhost,127.0.0.1,your-domain.com
DATABASE_URL=sqlite:///db.sqlite3
REDIS_URL=redis://redis:6379/0
SERVICE_REGISTRY_URL=http://service-registry:8761/eureka/
HOST=0.0.0.0
PORT=8000

7. 使用方法

7.1 基本操作

bash
# 启动服务
docker start elas-e3selector

# 停止服务
docker stop elas-e3selector

# 查看日志
docker logs -f elas-e3selector

# 重启服务
docker restart elas-e3selector

7.2 数据库迁移

首次启动或更新模型后需要执行数据库迁移：

bash
docker exec -it elas-e3selector python manage.py makemigrations
docker exec -it elas-e3selector python manage.py migrate

7.3 启动Celery Worker

E3Selector服务使用Celery处理异步任务：

bash
# 启动Celery Worker (4核以上系统)
docker exec -it elas-e3selector celery -A server worker --concurrency=4 -l info -P eventlet

# 启动Celery Worker (4核以下Windows系统)
docker exec -it elas-e3selector celery -A server worker -l info -P eventlet

# 启动Flower监控
docker exec -it elas-e3selector flower -A server --port=5555

8. 开发设置

8.1 本地开发环境

bash
# 克隆代码仓库
git clone https://github.com/ude-soco/elas-official.git
cd elas-official/backend/4-e3selector

# 创建虚拟环境
pip install pipenv
pipenv install
pipenv shell

# 创建环境变量文件
cp example.env .env

# 编辑.env文件配置环境变量

# 数据库迁移
python manage.py makemigrations
python manage.py migrate

# 启动开发服务器
python manage.py runserver

8.2 依赖要求

• Python 3.10.10
• pipenv
• Redis服务器
• Node.js (前端开发)