山姆拼团小程序

一、立项背景和目标
山姆会员店商品多为大容量家庭装，个人/小家庭用户常面临单品分量过大、不易储存或单独购买起送门槛高的问题。本项目旨在打造一款专为山姆商品设计的“社区/同城拼单与分装小程序”，支持用户快速发起拼单、凑单分装、分摊会员优惠与配送费，降低购买门槛，提升商品流通与履约效率。

二、软件功能与核心功能模块
1. 商品与拼团管理模块：支持山姆商品目录展示、拼单发起（支持按份数/按件拆分拼团）、拼团时效倒计时与成团状态流转。
2. 订单与支付分账模块：集成微信支付与预授权机制，支持成团自动扣款、拼团失败自动原路退款及差额多退少补。
3. 履约配送与自提核销：支持团长代收分装、同城配送对接、社区自提点选择及到货动态取件码核销。
4. 社交裂变与通知提醒：提供拼团海报一键生成、微信群转发分享及基于模板消息的成团/发货进度实时提醒。

三、业务流程与功能路径
团长/用户选择山姆商品并发起拼单 -> 设定拼团规则（成团人数/件数/有效时间）并分享至微信群或好友 -> 参团成员加车支付参团 -> 满员触发成团事件与采购通知（未满员超时自动退款） -> 商品到货团长分装/核销自提 -> 完成订单闭环。

一、整体架构与技术栈
1. 前端技术栈：采用微信小程序原生开发，结合 TailwindCSS / Vant Weapp 组件库构建轻量高效的移动端交互界面。
2. 后端技术栈：采用 Spring Boot / Node.js (Express/NestJS) 构建微服务/RESTful API，集成 Redis 实现拼团分布式锁与倒计时延迟队列。
3. 数据与中间件：MySQL 存储用户、商品与订单状态流；集成微信支付商户 API、微信服务通知 API 以及腾讯云 COS 存储商品图文资源。

二、“我”的负责模块与结果
1. 拼团核心业务逻辑实现：主导设计拼团生命周期状态机，通过 Redis + Redisson 分布式锁解决多人高并发抢拼、库存超卖与并发支付一致性问题，成团成功率与系统稳定性达 99.9% 以上。
2. 支付与退款链路闭环：完成了微信支付统一下单、异步回调校验及拼团失败的自动化退款流水线，资金流转与结算零差错。
3. 前端交互与性能调优：封装拼团倒计时卡片、动态海报 Canvas 绘制及自提扫码核销组件，首屏加载时间优化至 1.2 秒内。

三、“我”遇到的难点、坑与解决方案
1. 高并发下的库存超卖与拼团状态死锁：多人同时支付最后一份拼团可能导致超拼或状态竞争。
解决方案：引入 Lua 脚本原子性预扣减 Redis 拼单配额，并配合分布式延时队列（RabbitMQ / Redis Keyspace Notification）处理拼团超时未满的自动解冻与退款。
2. 小程序端 Canvas 动态海报跨端渲染与清晰度问题：不同机型 DPI 差异易导致分享海报文字模糊或绘制错位。
解决方案：采用离屏 Canvas 2D API 配合设备像素比（dpr）动态缩放画布尺寸，统一字体加载与图片预下载机制，大幅提升了海报生成效率与视觉清晰度。