WHAT — Draft and review a Tech…

# 连锁餐饮SaaS新会员积分系统 TRD（技术需求文档）

一、项目概述

• 目标：建设覆盖微信小程序端与后端的会员积分系统，支持积分获取、兑换、支付，并实现300家门店的实时数据同步。
• 范围：会员体系、积分引擎、兑换商城、支付集成、门店数据同步机制。

二、微信小程序端需求

1. 会员模块

• 微信授权登录（wx.login + 手机号快捷授权）
• 会员卡展示（电子会员卡、等级、积分余额）
• 积分明细查询（获取/消耗/过期流水，分页加载）

2. 积分兑换模块

• 兑换商城列表（商品/优惠券/实物，支持分类、筛选）
• 兑换流程：纯积分兑换、积分+现金混合支付
• 兑换券核销码（二维码/条形码，门店扫码核销）
• 兑换记录与售后入口

3. 支付模块

• 微信支付集成（JSAPI支付）
• 积分抵扣规则展示（下单时实时计算可抵扣金额）
• 支付结果回调页面、异常订单处理（超时、失败重试）
• 退款流程展示

4. 非功能要求

• 首屏加载性能优化（骨架屏、接口合并）
• 兼容主流机型与微信基础库版本

三、后端需求

1. 积分引擎

• 积分获取规则配置化（消费返积分比例、签到、活动赠送）
• 积分账户服务：余额、冻结、扣减，需保证幂等与防超兑
• 积分过期策略（滚动过期，定时任务清理）
• 积分流水不可篡改，支持审计追溯

2. 支付服务

• 微信支付统一下单、回调验签、对账（日终对账文件处理）
• 积分+现金混合支付的分布式事务一致性（如TCC或本地消息表方案）
• 退款与积分回退机制

3. 兑换服务

• 库存管理（热门兑换品防超卖，可用分布式锁/预扣库存）
• 核销接口（门店POS/核销端调用，验证码有效性+防重复核销）

4. 300家门店数据同步

• 架构建议：中心化云平台 + 门店节点，通过消息队列（如Kafka/RocketMQ）异步分发
• 同步内容：会员信息、积分变更、兑换券核销状态、门店营业数据回流
• 同步时效：增量同步秒级~分钟级；全量对账每日执行
• 容错设计：断网续传、消息重试与死信队列、冲突以云端为准的最终一致性策略
• 监控告警：同步延迟、积压量、失败率监控

四、非功能与安全需求

• 安全：接口鉴权、敏感数据加密存储（手机号脱敏）、防刷积分风控规则
• 性能：核心接口响应时间目标（一般建议P99在数百毫秒级，按实际压测确定）
• 可用性：核心服务多可用区部署，目标可用性99.9%以上
• 合规：符合《个人信息保护法》及微信平台审核规范

五、交付里程碑（建议）

1. 需求确认与接口设计（1-2周）

2. 积分引擎与支付联调（2-4周）

3. 小程序端开发与门店同步联调（3-4周）

4. 灰度试点门店验证后全量推广

> 注：具体价格、QPS等指标需结合业务量测算后补充，本文档不预设不可核实数据。