Files
ClassHelper/docs/app/index.md
T

3.7 KiB

title, description
title description
应用帮助 ClassHelper每一项功能怎么用:课表、作业、通知、叫人、成绩、班级、灵动岛、外观与导入。

应用帮助

这一章按功能讲,重点是行为上的约定——什么时段会弹、谁看得见、什么情况下不动。 很多"看起来像故障"的现象其实是设计行为,下面每一页都会点出来。

页面 讲什么
课表 周视图与「今天」时间轴、单双周、学期周数、课表来源
作业 按所属日期归类、看板与全屏看板、教室机器录入、未交名单
通知与提醒 三档优先级、上课时段策略、二次确认、已读与红点
叫人 普通叫人与紧急叫人的差别、快捷短语、谁能叫谁
成绩 录入方式、导入、等级分布、学生看到的是什么
班级、学生与教师 班级账号、名单、班主任与各科任课老师、谁看得见什么
灵动岛 胶囊与卡片、多条通知的竖排列表、停靠与外观、触摸屏
外观、主题与动效 深浅色、设计令牌、动效语言、降低动态效果
表格与课表导入 成绩 / 名单 / 教师表格导入与 ClassIsland 档案导入

贯穿所有功能的三条规则

一、角色决定可见范围。 同一个页面,管理员、班主任、科任老师看到的数据与能点的按钮都不一样。 前端会按权限隐藏入口,但真正拦人的是服务端——直接调接口一样会被拒。完整矩阵在 角色与权限。

二、上课时段不打扰课堂。 「上课时段」由课表实时判定,普通通知与普通叫人只进队列、下课补弹; 紧急通知与紧急叫人才会立刻打断。客户端与灵动岛共用这套规则。 细节见通知与提醒。

三、实时推送只走班级房间。 老师一发内容,服务端写库后按班级房间广播,客户端立刻更新, 不靠轮询。教室机器断线重连后会自动补上漏掉的数据,灵动岛也会把上课期间暂存的通知补弹出来。

两端的差异

同一件事在 Web 管理端和桌面客户端上不一定完全一样,这是有意的:

事情 Web 管理端(老师) 桌面客户端(教室机器)
作业 发布 / 编辑 / 删除 / 看未交名单 看作业 + 录入作业 + 勾未交名单,不显示"完成 / 待完成"
成绩 录入 / 导入 / 改 / 删,带统计 只看全班总览
课表 排课、导入、改 只看(周视图 + 今天时间轴)
通知 发布 / 删除 / 看已读 看、标为已读
班级与人员 管理员可管 只能看本班

客户端没有"修改密码"入口,是刻意移除的:防止教室机器上误改班级密码后, 别的教室机器被锁在门外。班级密码由管理员在 Web 端维护。