基于微信小程序的非遗传承商城系统-附源码

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */
#content_views .toc,
/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */
#content_views.markdown_views > p:empty:has(+ .toc),
#content_views.markdown_views > .toc + p:empty,
/* 富文本旧版目录标记 */
#content_views.htmledit_views #main-toc,
#content_views.htmledit_views #hr-toc,
#content_views.htmledit_views p[id*=\”-toc\”] {
display: none !important;
}
/* 目录去掉后，紧跟的首个标题不再多出一块上边距 */
#content_views.markdown_views > .toc + h1,
#content_views.markdown_views > .toc + h2,
#content_views.markdown_views > .toc + h3,
#content_views.markdown_views > .toc + h4,
#content_views.markdown_views > .toc + p:empty + h1,
#content_views.markdown_views > .toc + p:empty + h2,
#content_views.markdown_views > .toc + p:empty + h3,
#content_views.markdown_views > .toc + p:empty + h4 {
margin-top: 0 !important;
}

温馨提示：本人主页置顶文章(点我)开头有 CSDN 平台官方提供的学长联系方式的名片！

摘要

本系统后端采用SpringBoot框架，前端为微信小程序，搭配Vue管理后台，MySQL作为数据库，面向普通消费者、非遗手艺人、平台管理员三类角色。系统围绕非遗文创商品线上售卖与文化传播业务，包含非遗项目展示、传承人介绍、非遗商品分类、商品浏览下单、手工定制预约、订单管理、评价晒单、非遗资讯、直播预约、数据统计等功能模块。消费者在小程序内浏览非遗技艺介绍与文创商品，下单购买刺绣、木雕、竹编、陶艺等手工艺品，可按需提交定制需求；手艺人入驻后维护自己的商品与传承故事；管理员审核入驻资质、管控商品内容、统计销售与传播数据。系统为非遗文化搭建线上传播与销售渠道，让传统手艺对接现代消费市场，拓宽传承人收入来源，助力非遗文化的活化传承与推广。

技术栈

后端采用SpringBoot作为核心开发框架，结合MyBatis-Plus简化数据库操作，快速实现商品、订单、传承人等业务数据持久化。MySQL存储用户、非遗项目、商品、订单、评价等业务数据，Redis缓存热门非遗商品、首页推荐内容、小程序登录token，缓解数据库压力。前端微信小程序采用原生开发，使用WXML、WXSS、JS构建页面；管理后台使用Vue3搭配Element Plus组件库，ECharts绘制商品销量、非遗项目热度等统计图表。项目通过Maven管理依赖，JWT结合微信openid完成登录认证，区分消费者、手艺人、管理员权限。集成OSS上传商品图片与技艺视频，EasyExcel导出订单报表，微信消息订阅推送订单通知，全局异常处理器统一捕获接口异常。整套技术方案适配小程序生态，开发调试便捷，便于后续拓展直播带货、定制工坊等功能。

系统设计

系统采用表现层、业务逻辑层、数据访问层三层架构，按业务划分为六大功能模块。用户模块实现微信一键登录、身份绑定、收货地址管理；非遗展示模块维护非遗项目分类、传承人档案、技艺介绍与视频；商品模块支持手艺人上架商品、编辑库存、商品检索筛选、详情展示；交易模块实现加入购物车、提交订单、支付、订单状态跟踪、确认收货；互动模块包含商品评价、晒单分享、收藏关注；后台管理模块实现手艺人与商品审核、订单处理、内容管理与数据统计。三类角色权限相互隔离，消费者侧重浏览下单、评价互动；手艺人只能管理自己的商品与定制订单；管理员拥有全部审核与管控权限。各模块低耦合，通过接口交互，便于后续拓展直播预约、线下体验课报名等功能。

具体实现截图

## 核心代码
```java
@RestController
@RequestMapping("/heritageMall")
public class HeritageMallController {
@Autowired
private IHeritageGoodsService heritageGoodsService;

// 分页查询非遗商品
@GetMapping("/goodsList")
public Result goodsList(@RequestParam(defaultValue = "1") Integer pageNum,
@RequestParam(defaultValue = "10") Integer pageSize,
@RequestParam(required = false) Long projectId,
@RequestParam(required = false) String keyword) {
Page<HeritageGoods> page = new Page<>(pageNum, pageSize);
LambdaQueryWrapper<HeritageGoods> wrapper = Wrappers.lambdaQuery();
if (projectId != null) {
wrapper.eq(HeritageGoods::getProjectId, projectId);
}
if (StringUtils.isNotEmpty(keyword)) {
wrapper.like(HeritageGoods::getGoodsName, keyword);
}
wrapper.eq(HeritageGoods::getStatus, 1);
wrapper.orderByDesc(HeritageGoods::getSales);
return Result.success(heritageGoodsService.page(page, wrapper));
}

// 手艺人上架非遗商品
@PostMapping("/publishGoods")
public Result publishGoods(@RequestBody HeritageGoods goods) {
boolean flag = heritageGoodsService.save(goods);
return flag ? Result.success("商品上架成功，等待管理员审核") : Result.error("上架失败");
}

// 提交商品订单
@PostMapping("/submitOrder")
public Result submitOrder(@RequestBody GoodsOrder order) {
boolean flag = heritageGoodsService.createOrder(order);
return flag ? Result.success("下单成功，手艺人将尽快发货") : Result.error("下单失败，商品库存不足");
}
}

数据库设计

数据库基于 MySQL 设计，根据非遗商城业务实体建立数据表，设置关联关系保证数据完整性。核心数据表包括用户表 user，存储微信 openid、昵称、头像、角色、创建时间；非遗项目表 project，记录项目名称、类别、级别、技艺介绍、传承人 id；传承人表 inheritor，保存姓名、技艺流派、从艺年限、简介；非遗商品表 heritage_goods，关联项目 id 与传承人 id，记录商品名称、图片、价格、库存、销量、审核状态；订单表 goods_order，记录订单编号、买家 id、总金额、订单状态、收货地址；评价表 review，关联订单 id 与商品 id，保存评分、评价内容与晒单图片。所有数据表统一设置自增主键，添加创建时间、更新时间字段，针对商品名称、非遗项目分类查询建立索引，优化查询性能，减少数据冗余，满足非遗商城业务的数据存储需求。

系统测试

系统采用单元测试结合黑盒功能测试开展测试工作。单元测试重点对商品审核、订单库存扣减、权限校验等核心逻辑编写测试用例，验证超库存下单拦截、越权操作判断是否正确。黑盒测试模拟消费者、手艺人和管理员三类角色，依次测试微信登录、浏览非遗项目、商品检索、下单购买、支付、确认收货、评价晒单、手艺人上架商品、后台审核等完整业务流程。同时覆盖异常场景，库存不足下单、重复提交订单、未审核商品被下单、越权修改他人商品、空表单提交、非法参数等，记录小程序端与后台页面展示效果、接口返回结果和数据变化，及时修复发现的缺陷。经过多轮测试，系统运行稳定，交易流程准确，审核机制有效，权限控制可靠，数据读写无误，页面交互流畅，满足非遗传承商城系统的业务需求。