ZhctWeightingTableYoukate 报警与提示现状说明

文档日期：2026-08-05 · 代码范围：当前 add_banlance_tip 分支工作区
适用范围：防逃单 A01、A02、A03 报警，以及对应报警开关关闭后的普通提示

1. 总体结论

A01余额不足：新餐盘进入取餐流程并取得就餐人信息后，客户端仅按余额汇总判断。

A02未放餐盘取餐：打餐前、无餐盘时，稳定重量相对基线下降达到阈值。

A03餐盘未绑定：通过餐盘码查询人员信息，结果明确表示未绑定。

三类规则在设置页分别有独立开关，默认开启。开关开启时进入正式报警：全屏锁页、循环语音、持续红灯闪烁，并记录报警触发和解除。开关关闭时不创建正式报警，而是执行该类型的普通提示回退。

2. 行为总表

类型	业务含义	精确触发口径	开关开启	开关关闭
A01	余额不足	新餐盘取得有效人员信息后，余额汇总 ≤ 0；余额为空或非法时不触发，累计金额不参与报警判断	全屏锁页并显示余额/累计金额；语音每 5 秒播放；红灯持续闪烁；先拿盘再扫 `888888`	不锁页；`WarnPop` 显示 1.5 秒“余额不足”和余额/累计金额；红灯闪 3 次；余额语音播放 1 次
A02	未放餐盘取餐	打餐前、无餐盘、重量稳定，当前重量相对稳定基线累计下降达到阈值；默认 5g	全屏锁页；放盘语音每 5 秒播放；红灯持续闪烁；可直接扫 `888888`	显示原 1.5 秒提示页；红灯闪 3 次；放盘语音播放 1 次；保留重量变化日志
A03	餐盘未绑定	查询成功但人员为空；或失败消息去空格后严格等于“餐盘未绑定”	全屏锁页；绑定语音每 5 秒播放；红灯持续闪烁；先拿盘再扫 `888888`	成功空数据时显示 Toast、单次语音、持续闪红灯至拿盘；失败消息分支当前只记失败日志

3. 正式报警的统一行为

3.1 页面锁定

使用不可取消的全屏报警页面，A01、A02、A03 分别显示对应报警图片。
禁止点击页面外部关闭，拦截返回键，隐藏状态栏和导航栏；应用内部正常操作被报警状态拦截。
不限制退出应用；应用进入后台或退出时，当前报警按 APP_EXIT 自动解除。
A01、A03 拿走餐盘后显示“餐盘已拿开，请工作人员刷解除卡”，页面仍保持锁定。
A01 正式报警图片显示余额和累计金额，水平居中；按当前 1600×1000 页面距底边约 240dp。确认拿盘后金额继续保留，并同时显示刷卡处理提示。

3.2 语音和灯光

语音立即播放，之后每 5 秒重复一次。
红灯立即点亮，之后每 500ms 切换一次亮灭状态。
正式报警声光不受普通“语音开关”和“灯光开关”拆分控制。
同一时刻只允许存在一个正式报警，重复触发不会覆盖当前报警。

3.3 工作人员解除

统一解除码为 888888，本地执行，不区分角色，不请求服务端。

报警类型	解除前置条件	扫描结果
A01	餐盘已拿走	餐盘仍在时不解除；拿走后扫描解除
A02	无额外条件	扫描后直接解除
A03	未绑定餐盘已拿走	餐盘仍在时不解除；拿走后扫描解除

餐盘拿走按连续 3 个空扫码帧确认。解除后关闭页面、停止循环语音和红灯、清除活动报警快照。

4. 报警开关关闭后的普通提示

4.1 A01 余额不足

仍执行余额判断，但不创建报警状态。
复用 A02 的 WarnPop 页面结构显示“余额不足”，约 1500ms 后自动关闭。
显示“余额：xx 元　累计：xx 元”，字号 22sp，水平居中并位于“余额不足”标题下方的设计红框区域，距图片底边约 22dp。
红灯闪 3 次，每次约亮 100ms、灭 100ms。
余额不足语音播放 1 次，总“语音开关”关闭时不播放。
不锁页，不生成报警触发/解除记录。
未传自定义文案和金额时仍显示原“请先放置餐盘！”，已有同类提示时不叠加第二层。

4.2 A02 未放餐盘取餐

恢复原重量变化提示链路；达到“忽略重量”阈值且距上次提示超过 3500ms 时显示 WarnPop。
WarnPop 为全屏提示，约 1500ms 后自动消失。
红灯闪 3 次，放盘语音播放 1 次，并写原重量变化日志。
语音受总语音开关控制；三次红灯按防逃单提示强制执行。

4.3 A03 餐盘未绑定

查询成功但人员为空时，显示原 Toast，保留查询日志和既有上报。
绑定语音播放 1 次，并持续闪红灯至连续 3 个空扫码帧确认餐盘拿走。
更换餐盘或退出应用也会停止持续闪烁。
此时没有正式报警状态，扫描 888888不能停止灯光，只按非报警特殊码处理。

当前分支差异：接口返回非 0 且消息明确为“餐盘未绑定”时，A03 开启会正式报警；A03 关闭则只记录查询失败，不执行 Toast、语音和持续红灯。是否统一，建议作为后续确认项。

5. 总开关关系

能力	A01/A02/A03 类型开关	总语音开关	总灯光开关
正式报警页面与状态	控制	不影响	不影响
正式报警循环语音	开启时强制执行	不影响	-
正式报警持续红灯	开启时强制执行	-	不影响
关闭类型开关后的单次语音	关闭时进入回退	控制	-
关闭类型开关后的红灯	A01/A02 三闪，A03 持续至拿盘	-	当前实现不受影响

类型开关保存在本地 MMKV，默认均开启，应用进入前台时刷新；工作人员真实切换时写配置审计日志。

6. 记录与恢复

6.1 正式报警记录

报警记录只写本地日志，不调用新增服务端接口：

ANTI_ESCAPE|event=TRIGGER|type=A01|content=...|triggerAt=...
ANTI_ESCAPE|event=RESOLVE|type=A01|content=...|triggerAt=...|resolveMethod=UNLOCK_CARD|resolvedAt=...

UNLOCK_CARD：解除码正常解除。
APP_EXIT：退出或进入后台时解除。
DIALOG_SHOW_FAILED：报警页面显示失败时安全回滚。
PROCESS_INTERRUPTED：进程异常结束后，下次启动补记中断解除。

正常退出后不恢复报警；异常中断后也不恢复页面，只补记记录并清除快照。

6.2 非报警提示记录

A01 的“余额不足”弹框、普通语音和三闪不写正式报警记录。
A02 普通提示继续写原重量变化日志。
A03 普通提示继续使用原人员查询日志及既有上报，不写正式报警记录。
非报警状态首次连续读到 888888 时记录一次“已忽略”，同一连续周期后续重复码静默处理。
配置变化格式：ANTI_ESCAPE_CONFIG|type=A01|enabled=false|source=SETTINGS。

7. 页面和资源映射

类型	页面图片	语音资源
A01	`anti_escape_alarm_a01.png`	`voice_pay_balance_not_enough.mp3`
A02	`anti_escape_alarm_a02.png`	`please_put_the_tray_first`
A03	`anti_escape_alarm_a03.png`	`please_bind_the_tray_first`

三张图片均为 1586 × 992，位于 drawable-nodpi。未知报警编号显示兜底提示：“报警信息异常，请工作人员刷卡解除”。

8. 当前验证状态

软件验证：JDK 8 单元测试 53 条通过，0 失败、0 错误；调试包构建成功；git diff --check 通过。

已覆盖余额边界、稳定减重阈值、未绑定结果、解除码、独立开关、报警快照和日志策略。红灯实际节奏、扫码器 3 个空帧的现场时间和语音音量仍需目标设备验收。

9. 建议的现场验收清单

分别关闭 A01、A02、A03，验证普通提示和灯光规则；A01 应显示“余额不足”及正确金额。
分别开启三类报警，确认锁页、5 秒循环语音和持续红灯。
A01、A03 在餐盘未拿走时扫描 888888，确认不能解除；拿走后可解除。
A02 直接扫描 888888，确认可解除。
A03 关闭时拿走餐盘，确认 3 个空扫码帧后停止红灯；扫描解除码不应停止。
报警中退出再进入，确认不恢复报警，并存在 APP_EXIT 解除记录。
验证总语音开关只影响普通单次语音，不影响正式报警循环语音。
确认 A03 失败消息分支在关闭开关时是否也需要普通声光回退。
A01 开启时金额应水平居中、距正式图片底边约 240dp，拿走餐盘后仍保持显示并同时出现刷卡提示；关闭时以 22sp 显示在 WarnPop 标题下方红框区域、距图片底边约 22dp。