fundocker/ralph

学习分析终极工具箱镜像文档

概述

本镜像提供学习分析的终极工具箱，专为教育技术领域设计，集成xAPI（经验API）支持，可实现学习数据的收集、处理、分析及报告生成。它整合了数据处理工具、可视化引擎和xAPI兼容组件，帮助教育平台、企业培训系统和研究机构高效管理学习过程数据。

核心功能与特性

• xAPI支持：完整兼容xAPI规范，可接收、存储和处理xAPI学习活动语句
• 数据可视化：内置多种图表工具，直观展示学习行为、进度和成果数据
• 多源数据集成：支持与LMS（学习管理系统）、LRS（学习记录存储）、数据库等多种数据源对接
• 自定义报告：提供模板系统，可生成符合教育评估标准的自定义分析报告
• API接口：提供RESTful API，方便与现有教育平台或应用集成
• 数据安全：内置数据加密和访问控制机制，保障学习隐私数据安全

使用场景与适用范围

• 教育平台学习分析：在线教育平台集成，追踪学生学习行为与成效
• 企业培训数据追踪：企业培训系统中监控员工学习进度与培训效果
• 教育研究支持：教育研究者收集和分析学习模式、教学效果数据
• LMS集成：与Moodle、Canvas等主流学习管理系统集成，增强数据分析能力
• 学习数据可视化展示：为教育管理者提供直观的学习数据仪表盘

使用方法与配置说明

快速启动

使用以下命令快速启动容器：

bash
docker run -d -p 8080:8080 --name learning-analytics-toolbox [镜像名称]:latest

环境变量配置

启动时可通过环境变量自定义配置：

• DB_CONNECTION：数据库连接字符串（默认：sqlite:///data/learning_analytics.db）
• XAPI_LRS_ENDPOINT：外部LRS端点URL（如需对接外部学习记录存储）
• XAPI_API_KEY：xAPI认证密钥（对接外部LRS时必填）
• ADMIN_PASSWORD：管理控制台密码（默认：admin123，建议修改）
• LOG_LEVEL：日志级别（可选：DEBUG, INFO, WARN, ERROR，默认：INFO）

示例（带环境变量配置）：

bash
docker run -d -p 8080:8080 \
  -e DB_CONNECTION="postgresql://user:pass@db-host:5432/learning_analytics" \
  -e XAPI_LRS_ENDPOINT="https://your-lrs.example.com/xapi" \
  -e XAPI_API_KEY="your-xapi-key" \
  -e ADMIN_PASSWORD="secure-password" \
  --name learning-analytics-toolbox [镜像名称]:latest

数据持久化

为避免容器重启后数据丢失，建议挂载数据目录：

bash
docker run -d -p 8080:8080 \
  -v /host/path/to/data:/data \
  --name learning-analytics-toolbox [镜像名称]:latest

/data目录包含数据库文件、配置和生成的报告。

配置文件挂载

可通过挂载自定义配置文件覆盖默认设置，配置文件路径为/app/config.yaml，支持xAPI处理、可视化参数、集成配置等自定义：

bash
docker run -d -p 8080:8080 \
  -v /host/path/to/config.yaml:/app/config.yaml \
  --name learning-analytics-toolbox [镜像名称]:latest

基本操作

1. 启动服务：执行上述docker run命令启动容器
2. 访问控制台：打开浏览器访问http://localhost:8080，使用ADMIN_PASSWORD登录
3. 数据导入：通过控制台"数据导入"功能上传xAPI语句或连接数据源
4. 生成报告：在"报告"模块选择模板，配置参数后生成分析报告
5. 查看日志：通过docker logs learning-analytics-toolbox查看服务运行日志

注意事项

• 首次启动需初始化数据库，可能需要3-5分钟
• 生产环境建议使用外部数据库（如PostgreSQL）替代默认SQLite
• 对接外部LRS时需确保网络通畅，并正确配置API密钥
• 高并发场景下建议通过--memory和--cpus参数调整资源限制