A01/A02/A03 报警独立开关实施方案

GOAL_CONTRACT

Goal：在 ZhctWeightingTableYoukate 设置页提供 A01、A02、A03 三个独立报警开关；关闭时只抑制锁屏报警，并执行对应的普通提示回退。

Why：让现场工作人员可以按项目需要启停不同防逃单规则，同时保持权限、状态和审计边界清晰。

Target：SetActivity 设置页、MMKV 本地配置、HomeActivity 防逃单报警入口和 A02 重量检测器。

Success criteria：

三个开关默认开启，升级和重启后保持状态。
任一开关关闭后，对应报警不创建状态、不锁页、不写报警触发/解除记录，但执行该类型规定的普通声光提示。
A01 关闭后显示 1.5 秒“余额不足”提示页、播放一次余额不足语音并红灯闪 3 次；A02 关闭后恢复原提示并红灯闪 3 次；A03 关闭后恢复原提示并持续闪红灯至餐盘拿走。
三类开关互不影响；A02 关闭时清除新报警检测基线，重新开启后从新稳定重量开始检测。
每次实际开关变化写一条本地配置审计日志。

Non-goals：

不新增服务端接口或远程配置。
不改变 A01/A02/A03 判定口径、解除码和退出处理。
不让普通语音开关、灯带开关拆分报警的声光组成。
不通过关闭开关自动解除已经活动的报警。

Constraints：使用当前 Java 8、MMKV、SwitchButton 和本地日志体系；保留当前分支已有未提交改动；不执行 Git 提交或推送。

Evidence required：规则单测、完整 testDebugUnitTest、assembleDebug、设置页代码检查、Markdown/HTML 方案和变更记录。

Next route：/spec → /plan → /build → 验证。

规格

目标行为

类型	设置项	默认值	关闭后的行为
A01	余额不足报警	开	不进入报警，复用 `WarnPop` 显示 1.5 秒“余额不足”，红灯闪 3 次，按普通语音开关播放一次余额不足语音
A02	未放餐盘取餐报警	开	恢复原 1.5 秒提示页、单次放盘语音、红灯闪 3 次和重量变化日志
A03	餐盘未绑定报警	开	恢复原 Toast、单次绑定语音、查询日志和既有上报，持续闪红灯至餐盘拿走

三个报警开关控制页面锁定、循环语音、红灯闪烁、活动快照和报警事件记录这一整套行为。开启时完整执行声光报警；关闭后的单次普通语音继续遵守总“语音开关”。

A01 无论开关开启还是关闭，页面都显示当前“余额”和“累计金额”。金额单行水平居中：正式报警页按当前 1600×1000 页面距底边约 240dp；关闭状态 WarnPop 位于“余额不足”标题下方的设计红框区域，字号为 22sp，距图片底边约 22dp。正式报警确认餐盘拿走后继续保留金额，同时显示刷卡处理提示。

关闭状态的灯光按防逃单业务规则强制执行，不受普通“灯光开关”拆分：A01、A02 复用现有红灯三次短闪；A03 复用报警级持续闪烁。A03 连续收到 3 个空扫码帧确认餐盘拿走后停止；应用退出或更换为另一餐盘时也停止。

A01 关闭状态复用 A02 的 WarnPop 页面结构和 1500ms 自动关闭时长，覆盖主文案为“余额不足”，并传入“余额：xx 元　累计：xx 元”明细。未传文案和明细参数时仍显示原“请先放置餐盘！”，已有 WarnPop 正在显示时不叠加第二层。

设置与权限

在“基础设置”的可滚动页面增加独立的“防逃单报警”卡片。
使用现有 SwitchButton 视觉规格，三行分别显示 A01、A02、A03。
正常设置入口继续由现有管理员密码保护；不新增密码体系。
开关保存到 MMKV，缺少配置时按 true 读取。

生效和状态边界

HomeActivity 每次进入前台时按 AlarmType 将三个开关刷新到内存，关闭时在创建报警对象前进入普通提示路径。
A02 关闭时重置 NoTrayPickDetector，由 DarkPickBeforeFragment 恢复原重量变化提示；重新开启后使用新稳定重量建立报警基线。
设置页在报警锁页期间不可进入，所以配置只影响后续报警；当前报警仍按既有方式解除。
非报警状态扫描 888888 的现有忽略和去重日志逻辑不变。

本地审计

只在工作人员真正改变开关时记录：

ANTI_ESCAPE_CONFIG|type=A01|enabled=false|source=SETTINGS

页面初始化 setChecked 不产生配置日志；关闭报警后遇到匹配条件也不额外写“已抑制”日志，避免 A02 高频重量数据造成日志膨胀。

技术环境与命令

Java 8、Android Gradle Plugin 3.4.1、Gradle 5.1.1。
测试：JAVA_HOME=$(/usr/libexec/java_home -v 1.8) ./gradlew testDebugUnitTest
构建：JAVA_HOME=$(/usr/libexec/java_home -v 1.8) ./gradlew assembleDebug
格式检查：git diff --check

项目结构与代码风格

配置键：utils/Constants.java
设置页行为：activity/SetActivity.java
设置页布局：res/layout/activity_set.xml
文案：res/values/strings.xml
报警门禁和 A02 基线：activity/HomeActivity.java
纯 Java 规则与测试：antiescape/、src/test/.../antiescape/
继续使用当前项目的 Java 匿名监听器、MMKV 直接读写和简洁业务注释，不引入依赖或通用配置框架。

实施任务

先写三类型独立开关的纯 Java 规则测试，验证默认开启和互不影响。
新增三个 MMKV 键，在设置页增加三行开关并记录配置变更。
增加类型门禁和关闭状态回退：A01 单次语音，A02/A03 原提示。
完整回归三类报警、解除码、退出行为和现有日志精简功能。
补齐变更记录并核对 Markdown/HTML 内容一致。

验收矩阵

A01 开启：正式报警图片显示余额和累计金额，水平居中、距底边约 240dp；拿盘后金额继续保留并同时显示刷卡提示。
A01 关闭：显示 1.5 秒“余额不足”及余额/累计金额，金额以 22sp 水平居中显示在标题下方红框区域、距图片底边约 22dp；红灯闪 3 次并播放一次余额不足语音。
A02 关闭：恢复原 1.5 秒页面和放盘语音，红灯闪 3 次且不进入报警。
A03 关闭：恢复原 Toast 和绑定语音，保留原日志，不锁页；红灯持续闪烁，连续 3 个空扫码帧确认餐盘拿走后停止。
A03 持续闪烁期间退出应用或更换餐盘：立即停止，不影响下一餐盘。
三者全关：不产生防逃单活动报警，但保留上述普通提示；888888 仍按非报警特殊码处理。
关闭 A02 后再开启：先建立新基线，不能立即用旧差值报警。
重启应用：三个开关状态保持；首次升级默认全开。

风险和回滚

风险：仅在统一报警入口判断会让 A02 检测器消耗一次触发，因此 A02 必须在重量入口同步重置基线。
风险：把开关放到高级设置会因当前布局不可滚动产生显示不全，因此使用基础设置独立卡片。
回滚只需移除三个设置项、MMKV 键和报警门禁，不涉及接口、数据库和数据迁移。