2026-08-28 消费模块临时服务地址变更记录

状态：已于 2026-08-29 撤销。当前消费接口统一使用基础设置中的 API 地址，详见 2026-08-29-consumption-use-global-api-address.md。

1. 变更目标

按用户要求，消费模块访问以下接口时临时使用 http://192.168.10.38/：

POST /api/oneCardTerminal/acquireByPlate
POST /api/oneCardTerminal/report
POST /api/oneCardTerminal/syncPersons

用户消息中的 http://192.168.10.38。 末尾为中文句号，不能作为 Retrofit 合法基地址；代码按实际主机规范化为带 / 的 http://192.168.10.38/。

2. 实现边界

新增 ConsumptionNetworkProvider，集中保存消费模块临时基地址并复用一个独立 NetworkService。
ConsumptionActivity 的订单查询和接口 C 前台反馈改用该独立服务。
ConsumptionReportSyncWorker 的接口 C 后台补传改用同一独立服务，避免首次反馈与3分钟补传发送到不同服务端。
独立服务本身包含 acquireOrderByPlate、reportOneCardDebitResult 和 syncPersons 三个方法，因此消费页后续注入人员同步时使用同一服务即可。
当前版本的 ConsumptionActivity 没有实际调用 syncPersons，本次不额外新增人员同步行为，避免超出“修改请求地址”的范围。
未修改 NetworkManager、设置中的全局 API 地址或其他绑盘、心跳、MQTT、人员同步调用方。

3. 日志与维护

消费页创建时记录 CONSUMPTION_NETWORK_CONFIG，内容为当前临时基地址，便于现场确认请求目标。
临时地址只在 ConsumptionNetworkProvider 中维护，Activity 和 Worker 不复制地址字面量。
恢复正式环境时只需调整或移除该提供器，不需要修改三个接口声明。

4. 测试过程

RED

先新增 ConsumptionNetworkProviderTest。
首次定向运行因 ConsumptionNetworkProvider 尚不存在产生3个编译错误，证明测试先锁定临时地址和服务复用行为。

GREEN

定向测试命令：

JAVA_HOME=/Users/liang/Library/Java/JavaVirtualMachines/corretto-1.8.0_482/Contents/Home \
  bash gradlew :app:testDebugUnitTest \
  --tests 'com.zhct.traybinding.consumption.ConsumptionNetworkProviderTest' \
  --no-daemon --console=plain

定向结果：BUILD SUCCESSFUL in 16s。
验证内容：地址带 Retrofit 必需的末尾 /；消费前台和补传调用方复用同一服务实例。

5. 完整验证

命令：JAVA_HOME=.../corretto-1.8.0_482/Contents/Home bash gradlew :app:testDebugUnitTest :app:assembleDebug --no-daemon --console=plain。
结果：BUILD SUCCESSFUL in 46s。
单测：86个测试，0 failure、0 error、0 skipped。
静态检查：git diff --check 通过。
APK：app/build/outputs/apk/debug/app-debug.apk，约61 MB。

6. 风险与恢复

这是临时联调地址，设备必须能够访问 192.168.10.38，否则订单查询和反馈会失败并进入既有提示/补传逻辑。
接口 C 待上传记录会继续发往该临时地址，切回正式环境前需要确认是否仍存在待补传记录，避免测试数据和正式数据混发。
本次未执行 Git 暂存、提交、推送、拉取、分支切换、合并、重置或清理。

7. 撤销结果（2026-08-29）

已删除 ConsumptionNetworkProvider 及其固定地址契约测试。
ConsumptionActivity 的订单查询和前台反馈改回 NetworkManager 全局服务。
ConsumptionReportSyncWorker 的后台补传改回同一全局服务。
三个接口路径保持不变，Base URL 统一由基础设置 SETTING_API_ADDRESS 控制。