折扣卡管理系统搭建，卡券发放核销源码方案-创锋一号

折扣卡管理系统搭建，卡券发放核销源码方案

折扣卡管理系统是本地商户数字化营销的基础载体，核心能力包含卡券创建、批量发放、用户领券、门店核销、记录查询。很多自研项目只实现简单领券功能，缺少库存控制、防重复核销、状态流转、操作日志等能力，上线后容易出现超发、重复核销、数据对账困难等问题。本文基于SpringBoot + MySQL + Redis技术栈，介绍整套折扣卡管理系统搭建思路，同时提供卡券发放与核销模块Java源码方案。

一、传统卡券管理业务痛点

很多小型商户使用表格或者简易工具管理折扣卡，在数字化系统开发时会遇到一系列共性问题。

1.1 卡券库存不可控，存在超发风险

卡券总发放数量没有统一管控，并发领券场景下没有锁机制，出现实际发放数量大于预设总库存，造成营销成本失控。

1.2 核销缺少防重机制，同一张券多次核销

没有唯一核销标识与状态锁，门店重复扫码即可多次核销，给商户带来直接损失。缺少有效期、适用门店校验，过期券、跨门店券也能被核销。

1.3 卡券状态流转混乱，溯源困难

卡券缺少完整生命周期管理，创建、发放、领取、核销、过期、作废状态没有统一维护，发生对账纠纷时无法快速定位领券人和核销记录。

1.4 批量发放性能差，接口响应缓慢

大批量发卡活动时，循环插入数据库不做优化，数据库压力大，接口超时，活动高峰期系统稳定性差。

二、系统整体架构与技术选型

系统采用前后端分离架构，后台管理端用于商户/平台管理员维护卡券，小程序端供用户领券展示核销码，门店端负责扫码核销。

2.1 技术栈

后端：SpringBoot + MyBatis-Plus + Java
缓存：Redis，用于库存扣减、分布式锁、热点卡券信息缓存
数据库：MySQL，持久化卡券、用户卡券、核销记录
定时任务：Spring Task，自动扫描并标记过期卡券

2.2 核心业务流程

管理员后台创建折扣卡，设置面额、门槛、总库存、有效期；后台支持批量发放卡券给用户；用户在小程序领取卡券，生成唯一核销码；门店扫码核销，系统校验状态并锁定券；核销完成生成核销日志，支持后台查询统计。

三、核心模块设计

3.1 卡券基础信息模块

管理员创建折扣卡模板，配置卡券名称、抵扣金额、最低消费门槛、总库存、生效时间、过期时间、适用门店范围。卡券模板是所有发放卡券的基础，修改模板不影响已经发放出去的卡券实例。

3.2 卡券发放与领取模块

支持两种发放模式：后台定向批量发放给指定用户，或者用户在小程序主动领取。发放时生成用户卡券实例，每个实例拥有独立唯一核销码，同时扣减库存。使用Redis预扣库存，防止并发超发。

3.3 卡券核销模块

门店输入或扫描核销码，系统依次校验：券是否存在、状态是否未使用、是否在有效期、门店是否有权限核销。校验通过后使用分布式锁锁定券，更新状态为已核销，写入核销记录。

3.4 卡券生命周期与定时任务模块

卡券状态分为：未发放、未使用、已核销、已过期、已作废。定时任务每日扫描，将过期卡券自动更新状态，回收剩余库存，减少无效数据。

3.5 核销记录与日志模块

每次核销保存核销码、用户ID、门店ID、核销人、核销时间，生成操作日志，支持后台多条件查询，用于对账和问题排查。

四、Java源码实现方案

4.1 用户持有卡券实体类

@Data @TableName("user_card") public class UserCard { @TableId(type = IdType.AUTO) private Long id; // 卡券模板ID private Long cardTemplateId; // 用户ID private Long userId; // 唯一核销码 private String verifyCode; // 卡券状态 0未使用 1已核销 2已过期 3作废 private Integer cardStatus; // 领取时间 private LocalDateTime receiveTime; // 过期时间 private LocalDateTime expireTime; // 核销门店ID private Long shopId; // 核销时间 private LocalDateTime verifyTime; }

4.2 卡券发放、库存扣减服务

@Service public class CardIssueService { @Autowired private CardTemplateMapper templateMapper; @Autowired private UserCardMapper userCardMapper; @Autowired private RedisTemplate<String,Object> redisTemplate; private static final String CARD_STOCK_KEY = "card:stock:"; @Transactional(rollbackFor = Exception.class) public ResultVO issueCard(Long templateId, Long userId) { String stockKey = CARD_STOCK_KEY + templateId; // Redis扣减库存 Long remainStock = redisTemplate.opsForValue().decrement(stockKey); if(remainStock != null && remainStock < 0){ // 库存不足，回滚 redisTemplate.opsForValue().increment(stockKey); return ResultVO.fail("卡券库存不足"); } CardTemplate template = templateMapper.selectById(templateId); if(template == null || template.getCardStatus() != 1){ return ResultVO.fail("卡券模板无效"); } // 生成用户卡券实例 UserCard userCard = new UserCard(); userCard.setCardTemplateId(templateId); userCard.setUserId(userId); userCard.setVerifyCode(generateVerifyCode()); userCard.setCardStatus(0); userCard.setReceiveTime(LocalDateTime.now()); userCard.setExpireTime(template.getExpireTime()); userCardMapper.insert(userCard); return ResultVO.success("领券成功",userCard.getVerifyCode()); } // 简易生成核销码，生产环境可替换雪花算法 private String generateVerifyCode(){ return UUID.randomUUID().toString().replace("-","").substring(0,12); } }

4.3 卡券核销核心代码，分布式锁防重复核销

@Service public class CardVerifyService { @Autowired private UserCardMapper userCardMapper; @Autowired private RedisTemplate<String,Object> redisTemplate; private static final String VERIFY_LOCK_PREFIX = "card:verify:lock:"; @Transactional(rollbackFor = Exception.class) public ResultVO verifyCard(String verifyCode, Long shopId){ String lockKey = VERIFY_LOCK_PREFIX + verifyCode; Boolean lock = redisTemplate.opsForValue().setIfAbsent(lockKey,"1",10, TimeUnit.SECONDS); if(!lock){ return ResultVO.fail("正在核销，请不要重复提交"); } try { UserCard userCard = userCardMapper.selectByVerifyCode(verifyCode); if(userCard == null){ return ResultVO.fail("核销码不存在"); } if(!userCard.getCardStatus().equals(0)){ return ResultVO.fail("卡券已核销或失效"); } if(LocalDateTime.now().isAfter(userCard.getExpireTime())){ return ResultVO.fail("卡券已过期"); } // 更新核销状态 userCard.setCardStatus(1); userCard.setShopId(shopId); userCard.setVerifyTime(LocalDateTime.now()); userCardMapper.updateById(userCard); return ResultVO.success("核销成功"); }finally { redisTemplate.delete(lockKey); } } }

4.4 定时任务自动过期卡券

@Component @EnableScheduling public class CardExpireTask { @Autowired private UserCardMapper userCardMapper; // 每日凌晨两点执行 @Scheduled(cron = "0 0 2 * * ?") public void autoExpireCard(){ LambdaUpdateWrapper<UserCard> wrapper = Wrappers.lambdaUpdate(); wrapper.eq(UserCard::getCardStatus,0) .lt(UserCard::getExpireTime,LocalDateTime.now()) .set(UserCard::getCardStatus,2); userCardMapper.update(null,wrapper); } }

五、系统优化与风险控制

5.1 库存双层校验

采用Redis预扣库存 + 数据库最终校验双层机制，Redis负责高并发领券拦截，数据库作为最终数据基准，防止超发。活动结束后同步核对Redis库存与数据库实际发放数量，做数据补偿。

5.2 核销安全校验

核销接口增加门店权限校验，限制卡券可使用门店范围；增加接口限流，短时间多次提交核销请求直接拦截，防止暴力扫描核销码。

5.3 批量发放性能优化

大批量发卡时，不要单条循环insert，使用MyBatis批量插入。同时异步化处理，通过线程池批量生成用户卡券，避免接口长时间阻塞。

5.4 数据对账能力

后台提供核销报表，按时间、门店、卡券类型统计领券数量、核销数量、核销率。每一条核销记录永久保存，支持按核销码、用户ID检索，方便商户对账。

六、总结

折扣卡管理系统搭建，核心是管好卡券的全生命周期，从模板创建、发放领券到门店核销、过期回收。这套源码方案基于SpringBoot实现，通过Redis分布式锁解决并发领券与重复核销问题，同时完善状态管理与定时任务。方案可以直接用于本地生活商户的折扣卡小程序、门店营销后台开发，支持后续扩展分佣、推广返利等增值模块。

企业官网建设流程全解析