socialcomputing/coursemapper-webserver-coursemapper-kg Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

CourseMapper 镜像文档

概述和主要用途

CourseMapper是一个协作式课程标注与分析平台，旨在促进围绕PDF/视频学习材料的协作与互动，并提供可视化学习分析支持。该平台包含多个服务组件，如webserver（后端服务）、webapp（前端应用）和coursemapper-kg（知识图谱服务），适用于教育场景中学习材料的协作标注、互动讨论及学习数据分析。

核心功能和特性

• 协作标注：支持多用户对PDF和视频学习材料进行标注和评论
• 互动功能：促进用户间围绕学习材料的实时互动与讨论
• 可视化学习分析：提供学习行为和标注数据的可视化分析与展示
• 多服务架构：采用微服务架构，包含前端、后端、知识图谱等独立服务
• 容器化部署：支持通过Docker Compose快速部署，确保环境一致性和便捷性

使用场景和适用范围

• 教育机构：师生协作标注课程材料，增强课堂互动与课后复习效果
• 在线学习平台：集成协作标注功能，提升用户学习体验和知识掌握程度
• 课程开发：课程设计者共同标注和完善教学材料，优化课程内容
• 学习分析研究：收集和分析学习行为数据，为教学策略优化提供依据

使用方法和配置说明

快速启动

通过Docker Compose一键运行应用：

bash
make up

访问本地代理服务（端口8000）即可使用应用。

开发环境下自动重建（使用Tilt）：

bash
make tilt

挂载本地源码运行（开发调试用）：

bash
make mounted

应用栈组件

项目包含以下Docker镜像（托管于Docker Hub）：

• webapp：socialcomputing/coursemapper-webserver-webapp（前端Angular应用）
• webserver：socialcomputing/coursemapper-webserver-webserver（后端Node.js服务）
• coursemapper-kg：socialcomputing/coursemapper-webserver-coursemapper-kg（知识图谱服务）
• MongoDB：mongo（官方镜像）（主数据库）
• proxy：未发布，仅用于无内置HTTP路由的环境

开发环境搭建指南

步骤1：前置条件

安装以下依赖软件：

• NodeJS (v16.14.2)：官方下载
• Python (v3.7.2)：官方下载
• Java JDK 17：官方下载
• 代码编辑器：IntelliJ Ultimate或Visual Studio Code
• MongoDB Community Server和MongoDB Compass：下载地址
• Neo4j Desktop：官方下载（需启动服务器并登录）
• Redis：发布页下载
• Elmo包：链接1和链接2，保存至coursemapper-kg/app/algorithms文件夹
• StanfordCoreNLP：下载地址，解压至coursemapper-kg/app/algorithms，确保文件夹名为stanford-corenlp-full-2018-02-27
• Postman：下载地址
• Github Desktop：官方下载

步骤2：webserver服务安装

1. 进入webserver目录，复制example.env为.env
2. 打开终端，安装依赖：

   bash
   npm ci
   

   若遇问题，尝试npm install或npm install --force（注意：可能更新package-lock.json，不建议提交此文件变更）
3. 启动服务：

   bash
   npm run watch:dev
   

   服务运行于http://localhost:8080，按Ctrl + C停止

步骤3：webapp应用安装

1. 进入webapp目录，打开终端，安装Angular CLI：

   bash
   npm i -g @angular/cli
   

2. 安装依赖：

   bash
   npm ci
   

3. 启动应用：

   bash
   ng serve
   

   应用运行于http://localhost:4200，按Ctrl + C停止

步骤4：coursemapper-kg服务安装

1. 进入coursemapper-kg目录，复制example.env为.env，修改环境变量（NEO4J_USER、NEO4J_PASSWORD、REDIS_PASSWORD）为自定义值
2. 打开终端（Windows需管理员权限），安装并激活Python虚拟环境：

   bash
   # 安装pipenv（首次）
   pip install pipenv
   # 安装依赖（首次）
   pipenv install
   # 激活虚拟环境（每次启动）
   pipenv shell
   

3. 下载spacy包（首次）：

   bash
   python -m spacy download en
   

4. 下载nltk和sentence transformer包（首次）：

   bash
   python -c "import nltk;nltk.download('stopwords'); nltk.download('punkt'); nltk.download('wordnet'); import spacy; spacy.cli.download('en_core_web_sm'); from sentence_transformers import SentenceTransformer; SentenceTransformer('all-mpnet-base-v2'); from flair.embeddings import TransformerDocumentEmbeddings;  TransformerDocumentEmbeddings('sentence-transformers/msmarco-distilbert-base-tas-b'); from app.services.course_materials.kwp_extraction.model import KeyphraseExtractor; KeyphraseExtractor(); KeyphraseExtractor('squeezebert/squeezebert-mnli');"
   

5. 运行worker：

   bash
   pipenv run python -m app.worker
   

步骤5：Postman配置

打开Postman，导入docs文件夹下的CourseMapper.postman_collection.json文件

步骤6：MongoDB Compass配置

打开MongoDB Compass，在URI文本框输入mongodb://localhost:27017并连接，在左侧面板找到数据库coursemapper_v2