README 当前功能重整变更记录

• 日期：2026-09-13
• 项目：ZhctTrayBindingMachine
• 变更类型：项目说明文档重整
• 源码文档：/Users/liang/AndroidStudioProjects/ZhctTrayBindingMachine/README.md

变更原因

源码仓库原 README 仅描述早期“扫码餐盘 + 离线人脸识别 + 上传绑定关系”功能，未覆盖当前已经实现的固定运行模式、一卡通消费、人员同步、本地消费记录、双目标上传、补传管理及多机型硬件适配，无法支持开发接手、构建部署和现场排查。

本次调整

• 结合当前工作区代码重新说明绑盘模式与消费模式的功能边界和完整主流程。
• 补充 F700_HW、YF_029E 两类已适配设备及扫码、二维码、刷卡、USB 一卡通读卡器等硬件要求。
• 补充基础设置、一卡通设置和高级设置的配置项及安全注意事项。
• 按实际构建脚本记录 JDK 8、Gradle 5.1.1、Android Gradle Plugin 3.4.1、SDK、ABI 和 APK 输出路径。
• 补充模块职责、数据与日志位置、离线补传策略、常见问题和维护约束。
• 明确冷启动由固定运行模式直接分发；FunctionSelectActivity 中的订单管理仍为“开发中”。

事实依据

• app/build.gradle、各库模块 build.gradle、gradle/wrapper/gradle-wrapper.properties
• AndroidManifest.xml、ModeDispatchActivity、DeviceRunModeStore、ModeConfigurationPolicy
• HomeActivity、ConsumptionStartActivity、ConsumptionActivity
• DeviceProfileManager、ReaderFactory
• SetBasicFragment、SetOnecardFragment、SetSeniorFragment
• ConsumptionReportSyncScheduler、ConsumptionReportSyncWorker
• ConsumptionPersonSyncCoordinator、CustomerFullFetchService

验证结果

• README 标题层级、代码围栏和 git diff --check -- README.md 检查通过。
• 首次按 ./gradlew 验证时发现仓库脚本没有执行权限，已将文档命令修正为 bash gradlew。
• JAVA_HOME=$(/usr/libexec/java_home -v 1.8) bash gradlew :app:assembleDebug：通过，BUILD SUCCESSFUL。
• JAVA_HOME=$(/usr/libexec/java_home -v 1.8) bash gradlew :app:testDebugUnitTest：执行 202 项，199 项通过、3 项失败；失败均位于 CustomerFullFetchServiceTest 的分页预期，属于当前工作区已有业务代码与测试状态，本次未修改业务代码。
• 未连接现场设备，未验证真实扫码、人脸、串口、USB 读卡、扣款或服务端反馈。

影响范围

源码仓库仅修改 README.md，不改变应用代码、资源、配置、数据库或协议行为。另在提示词工程目录新增本变更记录的 Markdown 与 HTML 配对文件。

Git 边界

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