启动页连续失败后启用离线消费模式实施记录

记录日期：2026-08-19
项目仓库：/Users/liang/AndroidStudioProjects/CusumptionMachine
实施分支：improve_offline_mode

需求与范围

启动页连续两次获取人员列表失败后，在原有取消和再次请求按钮之间增加“启用离线模式”按钮。只有配对及消费配置完整、本地人员列表不为空，并满足既有初始化和人脸授权条件时，才允许使用本地缓存进入主页继续离线消费。

实施内容

• 启动页统一累计接口业务失败、网络失败和空响应；人员列表成功返回后清零连续失败次数。
• 第一次失败保留“取消、再次请求”，第二次及后续失败展示“取消、启用离线模式、再次请求”。
• 公共提示弹框增加默认隐藏的第三操作按钮，不影响其他双按钮弹框。
• 离线资格校验返回明确原因，重点校验配对信息、离线消费配置和本地人员数量。
• 点击离线按钮时再次实时校验，通过后复用本地人脸模型和人脸库初始化链路，不直接绕过启动初始化。
• 通过 Intent 标记和进程内状态向主页传递离线模式；主页跳过在线初始化接口并启动现有定时同步，消费页返回主页时也保持离线状态。
• 正常在线初始化成功或重新进入启动页时清除本次进程的离线状态。

主要文件

• app/src/main/java/com/cpt/cusumption/LaunchActivity.java
• app/src/main/java/com/cpt/cusumption/activity/HomeActivity.java
• app/src/main/java/com/cpt/cusumption/utils/OfflineStartupPolicy.java
• app/src/main/java/com/cpt/cusumption/utils/OfflineModeManager.java
• app/src/main/java/com/cpt/cusumption/utils/Constants.java
• app/src/main/java/com/cpt/cusumption/view/NewSingleTipPop.java
• app/src/main/res/layout/single_tip_pop_layout.xml
• app/src/main/res/values/strings.xml

验证

• JAVA_HOME=$(/usr/libexec/java_home -v 1.8) bash gradlew :app:compileDebugJavaWithJavac --no-daemon：通过。
• JAVA_HOME=$(/usr/libexec/java_home -v 1.8) bash gradlew :app:testDebugUnitTest :app:assembleDebug --no-daemon：通过，BUILD SUCCESSFUL。
• git diff --check：通过。

验收边界

• 当前已完成静态差异检查、单元测试和 Debug APK 构建。
• 仍需在设备上模拟连续两次请求失败，确认横竖屏弹框按钮布局、离线人脸库加载、离线订单落库以及联网后的补传行为。
• 未执行 Git 提交、推送或分支切换。