1. 项目背景与核心需求胶州作为山东半岛重要的商贸集散地酒水批发行业具有明显的区域集群特征。当地酒水供应商普遍面临客户信息分散、订单跟踪困难、促销活动触达率低等痛点。传统的手工记账或Excel管理方式已无法满足日均200订单的业务规模急需一套轻量化的移动端客户关系管理解决方案。经过对当地12家酒水批发商的实地调研我们发现以下核心需求客户分级管理批发商/零售商/终端客户扫码快速建档减少手工输入错误促销活动精准推送基于消费频次和金额账期管理30/60/90天不同结算周期移动开单支持离线模式应对仓库网络不稳定2. 技术架构设计2.1 整体技术栈选型采用SpringBoot 2.7 Uni-app MySQL 8.0组合主要考虑因素开发效率SpringBoot的自动配置特性可快速搭建RESTful API跨平台兼容Uni-app编译生成微信小程序代码后续可扩展H5版本数据安全MySQL的RBAC权限控制满足多角色访问需求成本控制全部使用开源技术栈避免商业软件授权费用技术架构图[小程序端] -- HTTPS -- [SpringBoot API] -- JPA -- [MySQL] ↑ ↑ JWT认证 Spring Security2.2 数据库关键设计客户表核心字段示例CREATE TABLE customer ( id bigint NOT NULL AUTO_INCREMENT, qr_code varchar(32) COMMENT 扫码生成的唯一标识, type tinyint NOT NULL COMMENT 1-批发商 2-零售商 3-终端, credit_line decimal(10,2) DEFAULT 0, payment_terms tinyint DEFAULT 30 COMMENT 账期天数, location point NOT NULL COMMENT GIS坐标, PRIMARY KEY (id), SPATIAL KEY idx_location (location) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;特别注意point类型字段需MySQL 5.7版本支持用于后续LBS营销功能扩展3. 核心功能实现3.1 客户二维码管理采用ZXing库生成包含客户ID的QR Code实现小程序端扫码自动填充客户基础信息仓库人员快速核对出货单地推人员现场登记时防重复录入关键代码片段GetMapping(/qrcode/{customerId}) public void generateQRCode(HttpServletResponse response, PathVariable Long customerId) { String content cust:// customerId ?v DigestUtils.md5Hex(customerId salt); QRCodeWriter.writeToStream(content, 300, 300, PNG, response.getOutputStream()); }3.2 账期预警功能通过Spring Schedule定时任务每日凌晨统计即将到期账款Scheduled(cron 0 0 3 * * ?) public void checkPaymentDue() { LocalDate warningDate LocalDate.now().plusDays(3); ListOrder orders orderRepository.findByPaymentDueDateBetween( LocalDate.now(), warningDate ); orders.forEach(order - { String openid customerService.getOpenid(order.getCustomerId()); wxPushService.sendTemplateMsg(openid, 您的订单即将到期, ...); }); }4. 性能优化实践4.1 小程序端缓存策略首次加载全量客户列表最多500条后续更新采用增量同步lastUpdateTime过滤本地SQLite存储关键数据支持离线操作4.2 服务端响应优化实测对比效果优化措施平均响应时间(ms)QPS原生JPA32045增加二级缓存18078启用Gzip压缩150105SQL语句优化后901325. 典型问题解决方案5.1 微信小程序审核驳回问题首次提交因虚拟支付被拒 解决方案移除预存金额功能入口将账期结算改为线下流程说明增加明显的本小程序不直接处理资金提示5.2 高并发下单冲突场景促销活动期间出现超卖 处理方案Transactional public OrderResult createOrder(OrderDTO dto) { // 使用SELECT...FOR UPDATE加锁 Product product productRepository.findLockById(dto.getProductId()); if (product.getStock() dto.getQuantity()) { throw new BusinessException(库存不足); } // 扣减库存 productRepository.reduceStock(dto.getProductId(), dto.getQuantity()); // 创建订单记录 return orderRepository.save(dto.toOrder()); }6. 部署实施要点6.1 服务器配置建议最低配置2核4G实测支持50并发推荐配置4核8G带Redis缓存必须设置JVM参数-Xmx不要超过物理内存70%6.2 微信小程序配置域名备案必须HTTPS业务域名设置包含图片存储域名消息模板ID申请至少需要3个模板在胶州某酒水批发商的实际运行数据显示系统上线后客户信息录入时间减少65%订单错误率下降82%促销活动参与率提升3倍 这套方案特别适合年营业额在500-2000万的中小型酒水批发企业后续可扩展供应商管理模块实现全链路数字化。
