文章目录一、概述二、四层开发规范与架构设计2.1 项目分层结构2.2 Entity 层开发规范2.3 Mapper 层开发2.4 Service 层开发2.5 Controller 层开发规范三、三端 API 隔离设计3.1 店铺端 Controller 分布（54 个）3.2 移动端 Controller 分布（24 个）3.3 管理端（admin）概览四、商品管理模块详解4.1 商品数据模型4.2 单规格 vs 多规格设计4.3 商品发布流程4.4 商品分类缓存4.5 商品查询 API五、订单管理模块详解5.1 订单数据模型5.2 订单生命周期5.3 订单状态编码5.4 下单流程5.5 订单金额计算体系5.6 店铺端订单管理5.7 移动端订单接口5.8 售后退款5.9 支付成功工厂模式六、用户体系6.1 用户注册与登录6.2 用户等级体系6.3 购物车管理6.4 收藏与地址管理6.5 会员数据模型整体视图七、优惠券系统7.1 优惠券类型7.2 优惠券生命周期7.3 优惠券使用校验八、门店管理与订单核销8.1 门店实体8.2 订单核销流程九、页面装修（DIY）与文章管理9.1 页面装修数据模型9.2 文章管理9.3 店铺端权限管理（RBAC 模型）9.4 数据统计十、定时任务与分布式锁10.1 ShedLock 分布式锁机制10.2 ShedLock 配置10.3 订单定时任务详解10.4 优惠券定时任务10.5 ShedLock 参数详解十一、微信生态集成11.1 SDK 选型11.2 微信支付配置11.3 微信小程序登录流程11.4 微信支付回调处理11.5 前端支付调用十二、多云存储集成12.1 工厂模式设计12.2 各云存储 SDK 依赖12.3 存储配置与上传接口12.4 文件上传配置十三、快递查询集成13.1 快递100 SDK13.2 物流查询接口13.3 预置物流公司十四、小票打印集成14.1 打印机工厂14.2 飞鹅打印机实现14.3 打印机管理接口十五、短信服务集成十六、Knife4j API 文档16.1 配置16.2 访问与使用16.3 接口注解示例十七、Excel 导出与二维码生成17.1 Excel 导出（Apache POI）17.2 二维码生成（ZXing）十八、代码生成器（Generator）十九、完整购物流程 API 调用链二十、常见问题与解答Q1：下单减库存 vs 付款减库存有什么区别？Q2：订单号是怎么生成的？Q3：如何处理并发下单的库存超卖问题？Q4：多规格商品如何管理 SKU？Q5：软删除如何过滤？Q6：ShedLock 锁失效怎么办？Q7：微信支付回调签名验证失败？Q8：微信支付回调如何保证不丢失？Q9：文件上传后无法访问？Q10：如何在本地测试微信支付回调？二十一、实践练习练习1：追踪下单流程练习2：实现商品搜索接口练习3：新增定时任务练习4：使用代码生成器练习5：为订单添加权限控制二十二、总结一、概述在 Java 企业级电商系统开发中，如何设计清晰的分层架构、实现灵活可扩展的核心业务模块、并高效集成第三方服务，是衡量系统工程质量的核心标准。本文基于WindShop（JJJ Shop）单商户电商系统的真实源码，系统地拆解其后端开发全流程，涵盖：四层开发架构规范、三端 API 隔离设计、商品/订单/用户/优惠券等核心业务模块的完整实现，以及微信支付、多云存储、ShedLock 分布式定时任务、快递查询、小票打印、Knife4j API 文档等进阶功能的集成方案。本文面向具备 Spring Boot 和 MyBatis-Plus 基础知识的开发者，适合正在搭建或深入学习电商后端系统的技术同学阅读。二、四层开发规范与架构设计2.1 项目分层结构WindShop 后端严格遵循四层架构：Entity → Mapper → Service → Controller，并通过多模块设计实现三端 API 隔离。wind-common（公共模块） ├── common/entity/ # 实体类（数据库表映射） ├── common/mapper/ # Mapper 接口（数据访问层） ├── common/service/ # Service 接口定义 ├── common/service/impl/ # Service 实现 ├── common/vo/ # 视图对象