一卡通消费流水上传默认开启变更记录

• 日期：2026-09-12
• 项目：ZhctTrayBindingMachine

结论：一卡通消费流水上传在没有已保存配置时默认开启；已有设备显式保存的开关值继续优先，不被覆盖。

Compact Use Case

• Use Case ID / 状态 / DoR：UC-ONECARD-DEFAULT-001 / Done / READY
• 角色、触发与目标：设备管理员首次安装或尚未保存一卡通消费上传设置时，系统默认启用消费流水上传，避免订单长期停留在本地待上传队列。
• In Scope / Out of Scope：仅调整统一默认值和回归断言；不迁移或覆盖已有 MMKV 配置，不改变上传协议、队列、重试、扣卡和业务服务器反馈逻辑。
• 主流程：设置页和后台补传 Worker 在配置键不存在时读取统一默认值 true，设置页显示开启，Worker 执行一卡通消费流水上传。
• 边界或异常/恢复：已有显式配置继续按保存值执行；网络或服务端失败仍沿用既有可靠队列和重试规则。
• 业务规则与不应影响逻辑：BR-001 未保存配置时默认开启；BR-002 已保存配置优先。不得因默认值变化重复扣卡或覆盖用户选择。
• 验收标准：AC-001 默认常量为 true；AC-002 设置页和 Worker 均引用该常量；AC-003 完整单元测试与 Debug 构建通过。
• 测试与证据：OnecardSettingsTest.confirmedDefaultsAreValid 先在旧值下失败，改值后通过；完整 :app:testDebugUnitTest --rerun-tasks 共 185 个测试，0 failure、0 error；:app:assembleDebug 构建成功。
• 性能/安全：不适用，仅改变缺省布尔值，不新增接口、数据结构、权限或计算路径。
• 待确认项：无。

实现

• OnecardSettings.DEFAULT_CONSUMPTION_UPLOAD_ENABLED 从 false 调整为 true，并注释默认值与已保存配置的优先边界。
• OnecardSettingsTest 增加默认开启断言。
• 设置页 SetOnecardFragment 与后台 ConsumptionReportSyncWorker 已共用该默认常量，无需重复修改。

验证结果

• 定向测试：OnecardSettingsTest 共 5 个测试通过。
• 完整单元测试：185 个测试通过，0 failure、0 error。
• Debug 构建：成功。
• APK：app/build/outputs/apk/debug/app-debug.apk，SHA-256 74fbf3c7b6cf1759e012f9a1a531c43c9268e825a207d948e63750b865baf65a。

兼容性与现场说明

• 默认值仅在 setting_onecard_consumption_upload_enabled 尚未保存时生效。
• 当前现场设备已经存在该配置键，且运行日志显示当前保存值为关闭；仅安装新 APK 不会覆盖该选择，需要在设置页手动开启或另行确认迁移策略。
• 本次没有安装 APK、修改设备设置或触发订单上传。

Git 边界

本次未执行暂存、提交、推送、拉取、分支切换或其他 Git 写操作。