← 返回项目库

在线学习管理系统 · 学途 LMS

面向课程、班级与学习进度管理的开源中文学习管理系统。

项目基于 Frappe Learning，提供课程—章节—课时组织、直播班级、测验作业、证书与学习统计等完整 LMS 能力。交付包保留正式 Frappe 服务端接入路径，并新增显式开启的 VITE_PREVIEW_MODE=1 本地中文演示层，用于无需数据库的界面评估；演示数据不代表真实生产数据。

真实界面

项目截图

共 6 张

学习工作台
课程中心
课程详情
课程学习
学习班级
学习分析

Capabilities

核心功能

✓课程、章节、课时三级内容组织
✓课程中心搜索、分类与课程详情
✓学习班级、批次成员与直播活动管理
✓测验、作业提交与课程证书流程
✓学习进度、连续学习和统计分析
✓Frappe API、会话与 Socket.IO 正式接入路径
✓显式 VITE_PREVIEW_MODE=1 的中文本地演示数据层

适用场景

搭建企业内训或在线课程的内容与学习管理入口
用班级和直播活动组织训练营式学习
在无数据库环境下评估 LMS 信息架构与中文界面
以 Vue 3 前端和 Frappe 应用为起点进行二次开发

适合谁

需要课程发布、企业内训、训练营管理或二次开发的小型教育、内容和服务团队。

商业化思路

AGPL 开源源码交付与合规部署、定制服务；使用者需自行承担基础设施和第三方服务费用，并遵守上游许可证及依赖许可。

你会拿到什么

  • ✓Frappe Learning 全量源码与原始 license.txt
  • ✓中文 README、显式本地演示层和构建配置
  • ✓与本次交付绑定的构建、测试、截图和发布验收记录

部署流程

  1. 1本地演示：进入 frontend 执行 yarn install --frozen-lockfile 与 yarn build:preview。
  2. 2将 lms/public/frontend 交给支持 SPA 回退的静态服务器，并挂载到 /assets/lms/frontend/；VITE_PREVIEW_MODE=1 仅用于本地演示。
  3. 3正式服务：不要设置 VITE_PREVIEW_MODE=1，按 docker/docker-compose.yml、docker/init.sh 与 Frappe 环境要求启动服务端。
  4. 4首次部署后配置站点、数据库、Redis 和邮件等基础设施，再通过课程、班级、测验和证书流程验证业务数据。

真实验证结果

已在固定 Chrome 单页会话中运行六个中文功能页面，并验证搜索筛选、加入学习计划、完成课程、班级详情和统计周期切换；截图为 1440×900、deviceScaleFactor=1，HTTP、标题、业务数据、破图、横向溢出和控制台门禁均通过。完整 Frappe 后端未在本次本地验收中启动。

部署前须知

本次本地验收使用显式本地演示数据层，未启动完整 Frappe、数据库和 Redis 服务；演示数据只保存在当前浏览器且不会同步到生产 API。完整服务部署仍需按环境准备站点、数据库、队列、邮件与可选视频/直播服务，并由使用者自行履行 AGPL v3 及第三方依赖的合规义务。

部署难度

较高

最低配置

本地中文演示需要 Node.js 18+、Yarn 1.x 和支持 SPA 回退的静态文件服务器；完整 LMS 部署需要 Docker Compose 或 Frappe Bench，并按部署配置准备 MariaDB、Redis 等依赖。

开源许可证

GNU Affero General Public License v3.0 (AGPL-3.0)

最后验证

2026-09-01

技术栈

Vue 3ViteFrappe UIPiniaFrappe Framework / PythonMariaDB 与 RedisSocket.IO

授权说明

仓库中的 license.txt 保留 GNU Affero General Public License v3（19 November 2007）全文。本交付保留原始许可证、版权声明和上游来源，并包含中文说明、中文本地演示层及独立运行所需的小范围适配修改；对应源码随包提供。将修改版本作为网络服务运行时，运营者应按 AGPL v3 履行源码提供、许可证告知和其他适用义务。本目录不授予上游之外的额外权利。

Release notes

版本记录

1 个已发布版本

vcn-34ba7f5195ae 当前推荐

补充显式中文本地演示模式，修复缺少 Bench 配置时的 Socket.IO 构建阻断，清理交付 README 的许可证指引，并完成六页交互式中文界面验收。

部署要求：本地演示需要 Node.js 18+、Yarn 1.x 和 SPA 静态服务器；完整服务需要 Docker Compose 或 Frappe Bench、MariaDB、Redis 及相应站点配置。

已知问题：当前版本的独立界面验收基于本地演示数据；正式 Frappe API 模式需在目标环境完成依赖、站点和权限配置。

登录后领取