在本地生活服务场景中碰碰好评卡是商家提升用户好评率、拉动复购的常用运营工具近期我们团队完成了一套可支持多商家、多端访问的碰碰好评卡系统从需求拆解到全量上线的完整开发本文将从技术视角分享全流程的实战经验为同类系统的开发提供可复用的落地思路。需求拆解与核心功能建模碰碰好评卡的核心业务逻辑是用户完成线下消费后商家发放实体NFC碰卡或电子好评卡用户扫码/碰卡完成好评提交后可激活对应权益优惠券、免单资格、积分等后续到店消费时可核销使用。我们首先对需求做了角色拆分和流程抽象避免后续开发出现逻辑遗漏。角色与功能划分参考多角色服务系统的设计思路我们将系统拆分为三类角色的功能集合用户端支持扫码/碰卡激活、好评凭证提交、卡包权益查询、核销码展示、权益消费记录查询等功能需兼容小程序、公众号H5、iOS、Android多端访问满足不同用户的使用习惯。商家端支持好评卡批量生成、权益规则配置、核销核验、订单数据统计、门店信息管理等功能采用H5开发商家无需下载APP即可通过浏览器操作。平台管理端支持商家准入审核、卡模板全局配置、运营数据大盘查看、风控规则调整等功能为平台运营人员提供全链路的管控能力。核心流程与状态机设计我们梳理了核心业务的流转链路用户到店消费→商家发放好评卡→用户扫码绑定对应消费订单→提交好评凭证→系统/商家审核→权益生效→用户到店核销。为了避免状态错乱我们为好评卡设计了明确的状态机未发放→待激活→待审核→已生效→已核销→已过期每个状态的流转仅能通过指定操作触发比如只有待审核状态的卡审核通过后才能进入已生效状态所有状态变更都要记录操作日志方便后续问题排查。技术架构选型与分层设计结合团队的技术栈积累和系统的多端支持需求我们选择了成熟的Java生态技术方案兼顾开发效率和系统稳定性技术栈选型后端服务采用Spring Boot JPA MySQL的组合Spring Boot的开箱即用特性可以快速搭建服务框架JPA简化ORM层开发适合业务快速迭代的场景MySQL作为关系型数据库存储核心业务数据支持事务保证数据一致性。用户端采用UniApp开发一套代码可以编译到小程序、H5、iOS、Android等多个端大幅减少多端重复开发的工作量同时可以快速适配不同端的特性。管理端采用Vue ElementUI的组合组件库丰富开发效率高适合内部管理系统的快速搭建。中间件使用Redis做缓存存储活跃用户的卡包数据、验证码、风控规则使用RabbitMQ做异步解耦将消息推送、数据统计更新等非核心流程异步处理减少主流程的响应时间。分层架构设计我们将系统分为四层各层职责明确模块解耦便于后续扩展表现层对接多端用户请求负责参数校验、权限校验返回统一格式的响应配置全局异常处理器统一处理业务异常和系统异常避免敏感信息泄露。业务层处理核心业务逻辑封装好评卡生成、激活审核、权益核销、风控校验等核心能力每个模块通过接口抽象实现方便后续业务迭代时快速替换实现逻辑。数据访问层基于JPA实现数据的增删改查复杂查询使用Query注解自定义SQL避免JPA自动生成的SQL性能过差的问题。基础服务层封装通用的工具能力包括文件上传、位置服务、OCR识别、消息推送等多个业务模块可以复用这些能力减少重复开发。核心模块开发实战好评卡批量生成模块商家可以自定义权益类型、有效期、发放数量批量生成好评卡每张卡生成的16位卡号和6位核销码数据库层面给卡号加索引防止重复卡生成。核心代码示例如下ServicepublicclassCardService{AutowiredprivateCardRepositorycardRepository;Transactional(rollbackForException.class)publicListCardbatchGenerateCard(CardGenerateDTOdto,LongmerchantId){ListCardcardListnewArrayList();// 批量生成卡每次多生成10000张避免单次操作耗时过长intgenerateCountMath.min(dto.getCount(),10000);for(inti0;igenerateCount;i){CardcardnewCard();// 生成16位卡号card.setCardNo(UUID.randomUUID().toString().replace(-,).substring(0,16));// 生成6位数字核销码card.setVerifyCode(RandomUtil.randomNumbers(6));card.setMerchantId(merchantId);card.setBenefitType(dto.getBenefitType());card.setBenefitContent(dto.getBenefitContent());card.setExpireTime(dto.getExpireTime());card.setStatus(CardStatusEnum.UNISSUED.getCode());cardList.add(card);}returncardRepository.saveAll(cardList);}}权益核销模块核销是核心的敏感操作我们设计了多重校验逻辑避免出现资损首先校验卡的状态是否为已生效其次校验当前操作的用户是否为卡的绑定持有人然后如果是到店核销场景调用位置服务校验用户当前位置和商家门店位置的距离是否在指定范围内后校验卡的有效期是否有效。所有校验通过后才可以完成核销同时扣减对应权益记录核销日志整个操作包裹在事务中保证原子性避免重复核销的问题。风控模块为了防止恶意刷好评卡的情况我们配置了多层风控规则每个消费订单只能绑定一张好评卡数据库层面给订单ID加索引同一个用户7天内只能领取同一个商家的一张好评卡提交的好评凭证通过OCR识别关键词防止用户提交无效截图。所有规则支持在管理端动态配置无需发版即可调整规则阈值。上线前测试与性能优化测试覆盖我们完成了全链路的功能测试覆盖卡生成、激活、审核、核销、过期的所有流程同时做了多端兼容性测试覆盖主流手机机型、小程序版本、浏览器版本避免出现适配问题。性能测试阶段使用JMeter对核销接口做压测初始压测结果为300QPS响应时间500ms不满足业务预期我们针对性做了性能优化。优化方案缓存优化将已生效的好评卡数据缓存到Redis缓存有效期和卡的有效期保持一致查询卡信息时先查缓存缓存未命中再查DB大幅减少DB查询压力优化后接口响应时间降低到150ms。数据库优化给高频查询的字段卡号、商家ID、用户ID、状态加索引复杂查询拆分为单表查询避免多表联查超过3张表JPA查询时使用fetch join避免N1问题慢SQL占比从15%降低到1%以下。异步优化将非核心流程比如消息推送、数据统计更新改成异步处理通过RabbitMQ解耦主流程不再等待非核心操作完成接口QPS提升到1200满足业务峰值需求。上线时采用灰度发布策略先开放给小范围商家试点观察系统运行7天无异常后再全量上线上线后通过Prometheus Grafana监控接口响应时间、错误率、DB连接数等核心指标出现异常及时告警处理目前系统运行稳定支持多场景的好评卡运营需求。
