LoveChengke
c7f215a09c
- 增加课件上传、班级可见范围、设备补收与传输进度 - 整合自定义灵动岛编辑器和相关客户端交互 - 同步三端契约、数据库迁移、部署配置与隔离回归 - 按源码统一文档与官网说明，移除过时任务书和审查记录 - 保持产品版本为 1.4.0
3.4 KiB
3.4 KiB
title, description
| title | description |
|---|---|
| 通知与提醒 | 优先级、课堂确认与经典/自定义常驻模式的提醒区别。 |
通知与提醒
Web 发布通知需 notification:publish 和班级范围权限。通知按本地 assignDate 归档，支持按日期、发布人查看与批量发布。 服务端保存后立即广播；上课暂存与是否自动展开是客户端本机展示规则。
优先级与本机展示
共享优先级为 LOW（低）、NORMAL（普通）、HIGH（重要）、URGENT（紧急）。 经典固定模式和自定义常驻模式有不同展示：
| 场景 | 经典 fixed | 自定义 custom |
|---|---|---|
| 普通/重要/低通知、作业 | 课间显示胶囊；上课暂存，下课补弹 | 常驻内容旁提示铃铛与去重数量，点击查看 |
| 紧急通知/紧急叫人 | 无论是否上课立即展开 | 提示铃铛，由用户主动展开 |
| 普通叫人 | 上课保留可点击胶囊，不自动展开；课间可展开 | 提示铃铛，可主动查看 |
| 主动查看 | 普通通知受课堂状态限制，叫人和紧急可点开 | 上课也可主动展开 |
经典紧急通知默认约 45 秒收起；列表与消息处理见灵动岛。课件传输另显示专用进度。
课堂发布紧急通知
上课时发布 URGENT，服务端先返回 409 URGENT_DURING_CLASS。 Web 显示全屏确认和倒计时，再次请求带 confirmDuringClass:true 才放行。 这是服务端发布校验，不受客户端选择 fixed/custom 影响；普通叫人和紧急叫人走叫人的接口规则。
已读与撤回
客户端通知页有未读数，打开详情可标已读；班级会话的已读操作代表全班在读学生。 删除需相应员工权限和范围，实时撤回会清理客户端列表、缓存与岛队列。 同 id 的通知与叫人双播合并，不重复计数。
接口入口
以下省略 /api，均先鉴权；具体功能键及范围见REST API。
| 方法与路径 | 用途 |
|---|---|
| GET /notifications | 列表；classId、priority、unreadOnly、keyword、date/from/to、createdBy |
| GET /notifications/days、/notifications/creators | 日期与发布人归档 |
| GET /notifications/unread-count | 未读数 |
| POST /notifications、/notifications/bulk | 单班/批量发布，批量逐班返回结果 |
| POST /notifications/:id/read、/notifications/read-all | 标记已读 |
| DELETE /notifications/:id | 撤回 |
ClassIsland 在线提醒渠道已移除；本机提醒设置不会写回旧渠道字段。