2026-08-26 消费页自动寻卡与人员全量同步

变更结论

已在 ConsumptionActivity 接入两条并行启动链路：自动发现、授权并连接新开普 USB 读卡器后持续寻卡；连接新开普一卡通 WebService，每批拉取 1000 条人员形成完整 SQLite 快照，随后通过项目当前业务 Base URL 分批调用 POST /api/oneCardTerminal/syncPersons。

设置项

• 新增“一卡通服务器地址”和“一卡通 AppID”，默认值分别为 http://10.128.1.19/WebService/Newcapec.eCard.ProxyWebService.asmx 和 6。
• 地址要求 HTTP/HTTPS 且以 .asmx 结尾；AppID 要求正整数。
• 两项配置通过 MMKV 独立保存；通用 ValidatedSettingInputPop 由业务模块注入校验规则。

人员同步实现

• 源端使用 GetCustomerCount 和 GetCustomerByNum，每批最多 1000 条。
• SQLite 只允许读取状态为 SUCCESS 的完整快照，并按 customerId 游标分页。
• 严格映射 BM/XH/NAME/SEX/CUSTOMERID/CARDNO/STATUS/CARDSN，不截断或伪造非法数据。
• 业务接口复用当前 Base URL、鉴权与日志拦截器；每批顺序上传并汇总 total/created/updated/failed 和 trace_id。
• 单条业务失败会累计并继续；协议、响应或网络整体失败会停止后续批次。
• 协调器保证完整拉取后才上传，并始终断开一卡通客户端。

读卡器实现

• ConsumptionCardSearchManager 管理 USB 权限、广播、连接、寻卡与释放。
• 寻卡和人员同步使用不同的单线程执行器。
• 每 500ms 寻卡；发现卡片后等待移卡，连续三次无卡才恢复寻卡。
• onStart/onStop/onDestroy 分别负责启动、暂停和永久释放。

页面展示

• 继续使用通用标题栏和 @drawable/home_bac。
• 新增等尺寸的读卡器状态卡片和人员同步状态卡片。
• 文案集中在 strings.xml，尺寸集中在 dimens.xml。

自动化验证

• JDK 8 下 :app:testDebugUnitTest 通过：23 tests，0 failure，0 error。
• :app:assembleDebug 通过；APK 约 61 MB。
• git diff --check 和尾随空白扫描通过。

尚未执行的设备验收

• 未安装 APK，未在实体读卡器验证 USB 授权、寻卡和移卡循环。
• 未连接 10.128.1.19 拉取真实人员，未调用真实业务同步接口。
• 接口契约依据用户提供的请求示例、响应示例和字段截图实现。

Git 边界

未执行 Git 暂存、提交、推送、分支切换、工作树创建或其他 Git 写操作；仅执行只读检查。