VWCG-1072 滨州一卡通当前分支对接盘点与后续方案

1. 当前分支盘点结论

2. 已完成的接口范围

3. 尚未完成的核心对接

• 未看到 payservice/preorder、payservice/orderhandle、payservice/orderquery、payservice/correct 的业务实现。
• 未看到 thirdappservice/qrcodetransaction、thirdappservice/correctorder、thirdappservice/orderquery 的业务实现。
• 未看到一卡通交易表，例如 ydy_one_card_trade_order，也未看到订单幂等、查单、补偿状态表。
• 未看到退款/冲正先走一卡通、成功后再走本地退款成功逻辑的接入点。
• 卡状态和账户状态已经同步到本地，但消费下单链路尚未确认已新增一卡通状态专属拦截。

4. 后续接入方案

4.1 store 负责真实一卡通能力

• 继续集中管理 one_card 配置、token、签名和接口调用。
• 新增一卡通交易表，记录扣款、冲正、查单、补偿状态。
• 实现 preorder -> orderhandle -> orderquery -> correct 主链路。
• 实现 OneCardTradeRepair 补偿命令，处理远端成功但本地失败、未知状态和查单恢复。

4.2 ai_api 只调用 store 内部能力

• ai_api 不保存一卡通 appid/appsecret，不直接访问一卡通。
• 小程序/H5 订餐、直接消费、普通商城支付时，通过内部接口调用 store 的一卡通扣款能力。
• 若一卡通远端成功、本地订单失败，由 ai_api 自己负责本地业务补偿重放。

4.3 订单来源覆盖建议

5. 推荐实施顺序

1. 新增支付配置：payment_enable、payment_mode、payment_business_num、payment_device_num、payment_retry_times。
2. 新增 ydy_one_card_trade_order，先把幂等、查单、补偿状态设计稳定。
3. 在 store 实现查余额、预下单、扣款、查单、冲正服务和测试。
4. 接入 store 侧消费来源：绑盘机、消费机、外部消费、闸机、点餐机。
5. 开放 store 内部支付接口给 ai_api，再接小程序/H5 与普通商城。
6. 联调前保持 payment_enable=false，验证通过后按商户灰度开启。

6. 验收口径

• 一卡通为余额主数据源，本地余额只作为同步快照。
• 消费以本地订单号、设备流水号或外部订单号做幂等，不允许重复扣款。
• 退款/冲正以退款单号或冲正流水做幂等，不允许重复退款。
• 一卡通失败时，本地订单不得进入支付成功。
• 一卡通成功但本地失败时，必须可查、可补偿、可人工处理。
• 离职、挂失、冻结等状态必须阻断真实消费。