Repository navigation
v0.3 · 房间化课堂运营 + 课程包 + 讲师管理 + 嵌入/MCP
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:
/mcpJSON-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