2026-08-28 消费流水日志存储与格式调整记录

变更原因

用户现场查看后确认两点：消费流水应与项目已有日志统一放在设备根目录的 Log 目录；原始 JSONL 的英文 key 不利于直接排查，需要把核心字段名改成中文。

代码变更

• 抽取并复用 LocalFileRecorder.getLogDirectory()，统一指向外部存储根目录 /Log/。
• ConsumptionFlowLog 改为向统一目录写入 consumption-flow-YYYY-MM-DD.jsonl。
• 应用升级初始化时，将旧版内部 files/consumption_flow_logs/ 中的消费流水迁移到 /Log/；重名时使用轮转序号，复制成功后才删除源文件。
• JSON 格式版本升级为2，核心 key 改为中文；动态明细中的常用 key 同步转换为中文。
• 日志查看入口从同一个 /Log/ 目录枚举 .txt 和 .jsonl，消费流水继续显示 [消费流水] 前缀。
• 查看格式化器兼容新版中文 key 和旧版英文 key，并补充展示接口、服务端追踪号和完整明细。

示例

{"格式版本":2,"时间":"2026-08-28T10:20:31.256+08:00","事件":"DEBIT_RESULT","业务流水号":"FLOW-1","订单号":"ORDER-1","结果":"FAILED","金额(分)":68,"错误码":"PSAM_ERROR","明细":{"卡片是否在位":false}}

业务与安全边界

• 不修改消费状态机、订单金额、读卡器协议、接口 B/C 或失败分类。
• 中文化仅改变本地业务日志结构；订单号等业务值和事件稳定码保持原值，便于程序检索。
• Token、HTTP headers、完整卡片和人员标识、余额快照、APDU、完整接口报文仍不落入消费流水。
• 日志迁移或写入失败只记录 Logcat，不得中断消费业务。

验证

• 针对性单测覆盖中文字段、嵌套明细、旧英文 key 兼容、旧目录迁移以及既有轮转规则并通过。
• JDK 8 执行 :app:testDebugUnitTest :app:assembleDebug：BUILD SUCCESSFUL，最终复验耗时21秒。
• 共94个单元测试，0 failure、0 error、0 skipped；git diff --check 通过。
• Debug APK：app/build/outputs/apk/debug/app-debug.apk，约61 MB。

Git 边界

本次仅编辑和验证，不执行暂存、提交、推送、分支切换、合并、清理或历史改写。