冬余数据商业综合体系统集成架构主数据统一、开放平台、回调幂等与对账日切一、总体架构分五层• 触点层会员小程序、收银 POS、停车岗亭/自助机、商户端• 接入层API 网关鉴权、限流、路由、回调接收器验签、幂等、文件网关、消息队列• 集成层主数据服务、映射服务、协议适配器API/中间表/文件/MQ、重试与补偿队列• 业务中台合同与租约、计费引擎、订单中心、核销台账、会员权益、对账中心• 数据层主题宽表、经营指标、审计日志。部署形态按项目规模区分中小项目云 SaaS 多租户大型项目私有化或混合部署。二、主数据与映射• 编码体系商户、铺位、会员、合同四类主数据各定义全局唯一编码指定权威源系统其他系统只同步不修改• 映射服务维护外部系统标识与内部编码的映射表如停车系统的车牌、POS 的铺位号、团购平台的商户 ID映射变更走审批并留版本• 多身份会员手机号、openid、unionid、车牌号作为会员的多个身份标识通过身份服务统一归并处理冲突如同一车牌绑定多个会员需定义优先级策略• 主数据分发以事件驱动方式向各订阅系统推送变更消费方幂等处理。三、开放平台与协议适配通道 技术要点API REST/JSON统一鉴权签名或 OAuth2限流与超时幂等键入参数据库中间表 约定表结构与字段语义加同步水位字段避免全表扫描文件 约定编码、分隔符、校验和落文件后异步解析差错行入异常池消息队列 主题分区、消费幂等、死信队列、重试退避Webhook 验签、时间戳防重放、失败重试与告警适配器的意义是把对方长什么样和我们长什么样解耦新增对接对象只加适配器不动核心业务逻辑。四、支付回调与幂等核销• 验签回调必须校验签名与时间戳防伪造与重放• 幂等键以渠道 渠道流水号或渠道 支付单号 账单号作唯一约束重复回调只返回成功不重复落账• 落账顺序回调可能早于订单落库需支持先到回调后到订单的挂起重试机制• 补偿定时任务反查渠道订单状态对超时未确认的订单主动查询并补齐• 待认领池无法自动匹配的流水如对公转账、合并付款进入待认领池人工认领后核销全过程留痕• 资金合规分账由持牌支付机构或银行通道完成业务系统只维护分账规则与台账不参与资金归集。五、对账日切设计• 日切时点明确每日账务截止时点如 23:59:59跨零点交易按渠道流水时间归属• 三方对账渠道对账单资金准、系统订单业务准、业务台账核算准三方比对• 差异分类渠道有系统无漏单、系统有渠道无虚假成功、金额不一致部分退款、状态不一致已退未同步• 差异处理自动生成差异工单按类型分派技术排查/财务复核/运营确认闭环留痕• 重跑机制对账任务支持按日期重跑幂等覆盖不产生重复差异记录。六、停车与团购的对接要点停车• 权益下发接口需支持按会员等级、时段、项目维度配置免费时长与折扣• 车牌识别失败无牌、污损、临牌需兜底通道扫码入场、人工补录、事后补录• 出场计费与线上支付需保证计费快照可追溯避免争议时无法回放。团购平台• 核销接口调用需做超时与重试重试前先查询核销状态避免重复核销• 券码作唯一约束状态机管理已核销/可撤销/已锁定/已退款• 撤销窗口按平台规则处理状态变更通过回调或轮询同步• 日终拉取平台结算单与核销记录比对差异按券码维度定位。七、安全、权限与审计• 对接账号按最小权限单独开设禁止使用超级管理员账号• 接口调用双向鉴权签名 IP 白名单敏感字段加密传输• 全链路日志请求、响应、重试、失败原因保留可追溯周期• 审计主数据变更、映射调整、核销认领、差异处理全部留痕• 监控指标接口成功率、P95 延迟、回调积压、对账差异笔数、待认领金额。常见问题 FAQQ1主数据映射表怎么设计才不会失控以内部编码 外部系统标识 外部编码三列构成映射加版本与生效时间字段变更走审批查询走缓存避免高频查库。Q2回调重复推送如何防重幂等键加数据库唯一约束重复事件直接返回成功但不重复落账同时校验签名与时间戳防重放。Q3回调早于订单落库怎么处理回调侧先落回调事件表匹配不到订单则进入挂起队列订单落库后触发匹配超时未匹配的进补偿任务。Q4对账差异怎么自动分派按差异类型打标签漏单/虚假成功/金额不一致/状态不一致映射到责任角色生成工单处理结果回写并关闭。Q5第三方接口不稳定怎么办网关层做超时、限流、重试退避与熔断核心链路支付、核销必须有反查补偿不依赖单次调用成功。Q6集成架构怎么保证可扩展协议适配器 事件驱动 主数据服务三层解耦新增对接对象只加适配器与映射业务中台不感知对方协议差异。部署形态与模块开关按项目规模区分价格视对接系统数量与接口复杂度而定选型时建议明确落地总价。冬余数据成立于 2016 年是商业地产数字化全栈服务商旗下「茂管佳」面向高端商业与大型文商旅综合体、「余卡通」面向县域商业和中小综合体全栈自研商业管理 ERP、智慧物业、会员 CRM、智能收银 POS、储值卡、AI 助手等产品线已服务 300 余个商业项目。