Skip to content

v0.3 · 房间化课堂运营 + 课程包 + 讲师管理 + 嵌入/MCP

Choose a tag to compare

@jorinyang jorinyang released this 21 Oct 10:37
· 205 commits to main since this release

v0.3 · 房间化课堂运营 + 课程包 + 讲师管理 + 嵌入 / MCP

课堂层

  • 房间:一节课一个房间(4 位码),学员、投票、答题、作业、积分互相隔离;ROOM0 兼容旧数据
  • 操作台 /ops?room=:投票、抽签分组(上限 1–10)、多轮抢答、课堂表现分、学员管理、四个标签(课堂/作业/答题/模型)
  • 大屏 /screen?room=:投票实时条、抢答赢家、答题进度、积分榜、工作坊倒计时,SSE 推送 + 轮询降级
  • 遥控器 /remote?room=:手机发起/结束投票、抢答、结束答题、计时、推送行动卡
  • 学员页 /join?room=:抽签、投票、抢答、答题、行动卡与素材、六类作业上传
  • 课堂报告 /report?room=:学员、小组、答题、作业汇总,CSV 导出

教学工作坊

  • 工作坊计时:开始/暂停/重置,大屏同步倒计时
  • 行动卡推送:一键让所有学员页出现任务卡与素材下载(PPT 讲课也能用,不再依赖课件页)

教学内容层

  • 课程包 /packages:上传 HTML、预览、删除;/shell?pkg= 框架播放,保留顶部导航与后台入口
  • AI 生成课程包:素材 → 模型出大纲 → 模板渲染成单文件 HTML
  • 课程包模板:内容 JSON + 构建脚本(templates/course-package-template/)

身份与权限

  • 讲师登录 /login:钉钉 OAuth2 扫码(需应用凭证)或本地口令;HMAC Cookie
  • 讲师管理 /teachers:讲师名单、角色(超管/讲师/助教/观察)、钉钉 unionId
  • 钉钉部门同步:登录时按 unionid 取部门,自动补全讲师部门(需 CorpId 与通讯录权限)
  • 强制登录:REQUIRE_AUTH=1 时页面 302 到登录、管理接口 401,大屏保持公开

集成层

  • 嵌入组件:/embed.js + /embed,投票 / 抢答 / 答题 / 积分四类小组件
  • MCP:/mcp JSON-RPC,10 个工具(建房、房间状态、投票、抢答、发布答题、调分、报告、大屏地址等)
  • REST API:房间、状态、投票、答题、作业、报告

部署

  • 局域网:node server.mjs;公网:Node 主机 + HTTPS + 钉钉回调白名单
  • Docker:docker build -t gtscdt . / docker run -p 8899:8899 ...

文档

  • README 重写为能力全景:每项能力的能力、使用方法、适用场景
  • 新增 docs/06-课堂使用说明-按课程流程.md:按课前 → 开场 → 上午 → 工作坊 → 评分 → 复盘的顺序,说明用什么、怎么用、什么效果

验证

  • 现场接口回归 30/30;v0.3 功能 21/21;MCP 与嵌入 7/7;讲师与课程包管理 14/14;计时与报告 10/10;鉴权 6/6
  • 钉钉:授权跳转与回调代码已就绪,真实扫码需要应用凭证,尚未联调

Full Changelog: v0.2...v0.3