支付成功弹框余额显示开关变更记录

记录日期：2026-09-01

项目仓库：/Users/liang/AndroidStudioProjects/CusumptionMachine

实施分支：fix_pay_by_face

变更背景

基础版 ShowPaymentSuccessPop 和营养增强版 ShowPaymentSuccessWithNutritionPop 原先仅根据接口返回的余额字符串是否为空决定是否展示余额。支付设置中没有统一开关，设备管理员无法按现场隐私要求关闭支付成功结果中的余额信息。

实施内容

• 在“设置 > 支付设置”中增加“支付成功显示余额”开关。
• 新增本地偏好键 PAYMENT_SUCCESS_BALANCE_VISIBLE，默认值为 true，保证旧设备升级后继续显示非空余额。
• 设置页进入时读取持久化配置，用户切换后立即保存，下一次结果弹框开始生效。
• 新增纯 Java 策略类 PaymentSuccessBalanceVisibilityPolicy，集中维护“配置开启且余额非空才显示”的规则。
• 基础版弹框的普通支付、记账和订单核验结果统一调用余额绑定方法。
• 营养增强版弹框使用相同策略控制 pay_success_show_balance_tv。
• 关闭开关或余额为空时，将余额视图设置为 View.GONE；重新开启且余额非空时恢复显示。
• 不修改8个调用 Activity 的现有构造、传参和展示方式。

影响文件

• app/src/main/java/com/cpt/cusumption/payment/PaymentSuccessBalanceVisibilityPolicy.java
• app/src/test/java/com/cpt/cusumption/payment/PaymentSuccessBalanceVisibilityPolicyTest.java
• app/src/main/java/com/cpt/cusumption/utils/Constants.java
• app/src/main/java/com/cpt/cusumption/fragment/FragmentPayment.java
• app/src/main/res/layout/fragment_payment_layout.xml
• app/src/main/res/values/strings.xml
• app/src/main/res/values/dimens.xml
• app/src/main/java/com/cpt/cusumption/view/ShowPaymentSuccessPop.java
• app/src/main/java/com/cpt/cusumption/view/ShowPaymentSuccessWithNutritionPop.java

自动验证

• 按 TDD 先运行 PaymentSuccessBalanceVisibilityPolicyTest，生产常量和策略类缺失时出现 5 个预期编译错误。
• 补充最小实现后，定向策略测试 2 个通过，失败 0、错误 0。
• 使用 JDK 8 执行完整 Debug 单元测试和 Debug APK 构建：BUILD SUCCESSFUL。
• Debug 单元测试共 51 个，跳过 0、失败 0、错误 0。
• git diff --check 通过，无空白符错误。
• 新增及修改文本文件均为 UTF-8 无 BOM，新增中文使用简体中文。
• 新增文案位于 strings.xml，开关尺寸位于 dimens.xml，配置键及默认值位于 Constants，未新增可避免的业务硬编码。
• Debug APK：app/build/outputs/apk/debug/app-debug.apk。
• APK SHA-256：d7721f67add14982c9eef53230f3cd1f015c45f80e593cb13cf76d7cd9416201。
• 构建仍输出项目既有的 Build Tools 版本、flatDirs、过时 API 及 JDK 8 读取高版本 YNHAPI 字节码警告，本次没有新增构建失败或测试失败。

真机验收要求

• 首次进入支付设置时，“支付成功显示余额”默认开启。
• 关闭开关、退出并重新进入设置页，开关仍保持关闭。
• 基础版支付成功弹框不显示 show_payment_success_pop_show_balance_tv。
• 营养增强版支付成功弹框不显示 pay_success_show_balance_tv。
• 订单核验成功弹框同样不显示余额。
• 重新开启开关后，以上弹框在余额非空时恢复显示余额。
• 开关开启但返回余额为空时，余额行仍隐藏。
• 支付结果弹框时长、支付声音、订单保存、自动关闭回调和客显副屏行为保持不变。

交付边界

• 本次只控制支付成功结果中的余额字段显隐。
• 不调整支付接口、订单结构、支付方式、营养数据和支付页面调用签名。
• 未安装 APK，未执行 Git 暂存、提交或推送。