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