班级事件
例如一年级一班开始放学，进入通知中心、大屏状态和语音播报。
00 / 架构说明
功能规格属于同一业务
功能规格属于同一业务平台，不按终端重复建设
学校、组织、放学规则、任务成员快照、角色权限、四态同步、通知端任务、大屏输出和审计日志构成共同业务底座。各终端只呈现与当前身份和已开通模块相关的操作。
01 / 总览
一套围绕学校放学现场
一套围绕学校放学现场构建的流程系统
青鸽放学不是单点工具，而是一套围绕学校放学现场构建的流程系统。系统从放学触发开始，经过身份权限校验、学校配置读取、批次规则判断、统一状态机流转、通知任务生成、大屏与语音更新、家长查看和后台追溯，形成完整闭环。
02 / 触发
操作入口与设备事件
操作入口与设备事件进入同一套放学流程
| 触发方式 | 当前边界 | 适用场景 |
|---|---|---|
| 老师小程序 | 按已开通模块执行本班放学、留堂、完成和撤销 | 小程序版、班主任操作 |
| 平板指挥版 | 按角色与范围执行单班、多班、年级或全校操作 | 指挥版、门岗/年级组/校领导 |
| 班主任刷卡 | 操作卡关联班主任和可操作班级，刷卡规则按项目配置 | 刷卡版；可用于纯内网部署组合 |
| 学生刷卡/校牌 | 已具备设备事件接入机制；新增品牌按协议完成字段映射 | 已有校牌或刷卡设备的学校 |
| 闸机/身份事件 | 通过供应商协议接收身份与通行事件并进入统一记录 | 封闭式校园、已有闸机学校 |
| 后台应急操作 | 管理员或校长在授权范围内人工处理 | 异常和应急情况 |
03 / 权限配置
先校验权限，
先校验权限，再读取学校配置
操作人身份校验角色权限校验班级、年级、学校范围校验套餐和模块开关放学时段和上学回刷时间批次规则大屏显示范围通知规则
04 / 状态机
所有操作进入统一放学
所有操作进入统一放学状态机
| 操作类型 | 状态变化 |
|---|---|
| 开始放学 | 未放学 / 留堂 / 已回刷 -> 放学中 |
| 完成放学 | 放学中 / 留堂 -> 已放学 |
| 留堂 | 未放学 / 放学中 -> 留堂中 |
| 解除留堂 | 留堂中 -> 未放学 |
| 撤销放学 | 放学中 / 已放学 / 留堂中 -> 未放学 |
| 学生个人离校（设备接入后） | 在校 -> 已离校 |
05 / 融合事件模型
班级状态与学生实际出
班级状态与学生实际出校是两类事件，不能混成一次通知
| 事件层级 | 典型入口 | 状态语义 | 通知与追溯 |
|---|---|---|---|
| 班级/学生状态 | 小程序、指挥端、教师操作卡 | 开始放学、留堂、完成、撤销 | 记录操作权限、范围、前后状态和通知结果 |
| 学生实际出校 | 闸机、人脸、学生卡、UHF-RFID | 学生发生有效出校事件 | 校验身份、方向、时段和重复事件后记录或通知 |
| 异常事件 | 任一入口或设备 | 身份不匹配、方向不明、重复、离线、发送失败 | 按学校规则拦截、降级、转人工并保留失败原因 |
05 / 事件通知
状态变化后，
状态变化后，系统生成事件和通知任务
学生事件
完成校牌或闸机设备接入后，学生刷卡出校或通过闸机可生成个人离校记录。
留堂事件
学生或班级进入留堂状态，按规则通知或仅记录。
撤销事件
状态撤销，按学校配置决定是否通知和播报。
通知任务
站内通知、公众号通知、短信通知和详情页查看路径进入发送、重试、去重流程。
06 / 显示播报
通知家长的同时，
通知家长的同时，也同步校内显示与播报
大屏显示
支持矩阵型、宫格型和状态分区；不同大屏可按星期、放学时段、年级、班级及当前批次过滤展示范围。
语音播报
支持按配置播报次数、按模板播报内容，并可配置撤销后是否播报。
07 / 查询追溯
家长看得到，学校查得到
家长查看
小程序通知列表、公众号链接详情、短信内容、已读/未读记录。
学校后台
通知记录、发送失败原因、手动重发、黑匣子日志、回刷日志、前后状态和操作追踪编号。
08 / 版本关系
不同部署方式，
不同部署方式，共用同一套系统能力
| 部署/版本 | 重点能力 |
|---|---|
| 指挥版 | 平板指挥、大屏状态、多班级批量操作 |
| 刷卡版 | 班主任刷卡、学生卡及 UHF-RFID 事件与操作记录 |
| 纯内网部署方式 | 指挥版、刷卡版、闸机版均可按学校条件支持纯内网/本地化 |
| 闸机版 | 通过设备协议接收闸机或身份事件，形成离校与通行记录 |
| 小程序版 | 教师端操作、家长通知、留堂与撤销 |
FAQ
常见问题
青鸽放学的功能边界是什么？
青鸽放学覆盖放学触发、权限校验、学校配置、状态机、事件通知、大屏显示、语音播报、家长查看和后台追溯。具体能力会随学校版本、部署方式和权益配置组合。
刷卡、闸机、小程序是否是独立系统？
它们可以作为不同学校的入口和部署形态，但进入系统后应尽量共用同一套权限、配置、状态、通知和日志追溯逻辑。