2.0 业务逻辑体系 · 总图
+
-
适应窗口
1:1
滚轮缩放 · 拖拽平移 · 双击复位
2.0 业务逻辑体系总图
四端(PC / 家长小程序 / 商户 APK / Windows 终端)业务逻辑收敛设计 · v0.1 · 2026-10-25
A · 业务全景:五条主链路与四端角色
从一个孩子被摄像头拍到,到这条记录最终归档:一条预警要走完的六步,以及每一步主要由谁负责;① 底库的三类来源在 A2 展开
① 底库准入
教育局包 + 公安特征 + 人员库
主责:PC
② 抓拍比对
设备抓拍 + 比对 + 年龄初筛
主责:设备 / PC
③ 预警生成
等级判定 + 时限 + 投递任务
主责:系统
④ 送达与处置
3 通道触达 + 场所结论 + 证据
主责:APK / 终端 / 家长
⑤ 复核与纠错
公安定性 + 申诉 / 撤销
主责:PC / 家长
⑥ 归档与统计
台账 / 报表 / 大屏 / 导出审批
主责:PC
家长(监护人)
授权方 · 知情方
① 每孩 CTID + 绑定审核 + 签授权书
决定「能不能看」
② 小程序内查看告知
仅自己孩子 · 仅疑似 · 90 天
③ 申诉 / 撤回授权
撤回即解绑,预警立即不可见
虚线 = 家长参与主链路的两个入口:④「能不能看」、⑤「能否被推翻」;①②③⑥ 家长不参与。
角色:
PC 公安后台
家长小程序(监护人)
商户 APK / Android
Windows 终端
A2 · 底库准入展开:三类来源,命中后各自带来什么
教育局包是主源;公安侧既有离线特征,也有治安重点与高危两个人员库——三者的等级与时限不同
教育局学生照片包(主源)
照片 + 文件名带学籍号、姓名、学校、班级
命中:疑似(二级)· 48h · 家长端可见
治安重点人员库(二级)
公安人员库;已有治安风险记录的人员
命中:疑似(二级)· 48h · 进场所即提示
高危人员库(一级)
公安人员库;最高风险名单,优先核查
命中:高危(一级)· 24h · 优先触达公安
三类来源共同带来的帮助
· 预警可追溯到命中来源,统计能按三类分组
· 误报可回流对应底库,持续提升比对质量
· 等级 / 时限 / 触达优先级由来源唯一决定
注:级别由类别唯一派生——security_focus → 疑似,high_risk → 高危(mock/base.ts:261);学生库命中同样落疑似,但只有学生库记录会进入家长可见链路。
B · 业务逻辑分层与职责边界
四层分工:谁接收请求、谁按规则判断、谁负责定时与送达、数据存在哪一层
L1 接入层
公安后台接口
/api/v1
终端接口
/tap/v1
家长小程序接口
/api/wx/v1
演示原型
不联网
L2 业务规则层
状态机引擎
进度表 · 防重复 · 防并发
规则校验
18 条 BC-R 规则
审计留痕
每次改状态都记一笔
查询裁剪
可见范围 / 证据字段
L3 支撑层
时限与升级
24h / 48h
多通道送达
手机 / 电脑 / 小程序
导出 · 水印 · 审批
参数与字典
L4 数据层
业务数据
预警 / 绑定 / 导出
留痕数据
处置记录 / 审计日志
照片与特征
证据链
演示数据
三端需同源
C · 一条预警的进度:业务规定 7 步,代码里多出 1 步
对应业务:场所收到预警后必须限期处置并留证据,公安再复核;场所或家长认为判错,可以申诉推翻。
实线 = 业务规定允许的走法(共 7 态);红色虚线 = 当前代码多出来的「撤销待复核」(第 8 态),需要二选一裁定。
送达成功
送达失败 / 超时
场所处置
超 dispose_deadline
补处置
公安定性
复核通过
申诉
申诉
成立
驳回
撤销申请
复核通过
复核驳回
pending 待送达
系统生成
delivered 已送达
系统投递
disposed 已处置
场所处置
reviewed 已复核
公安复核
revoked 已撤销
公安批准
escalated 已升级
超时自动上报
revoking 撤销待复核
代码多出此态
appealing 申诉中
场所或家长发起
业务规定允许的 7 步
代码多出的第 8 步:撤销待复核
两种改法:① 把「撤销」并入申诉,删掉 revoking(推荐);② 承认第 8 步,写进业务规定与字典。二选一,不能两套并存。