健身电商小程序
健身电商小程序
项目简介
这是一个完整的健身电商平台系统,包含微信小程序端和PC管理后台。系统实现了商品展示、购物车、订单管理、地址管理、商品评价、收藏等核心电商功能,采用前后端分离架构,适合作为微信小程序全栈开发学习项目或计算机设计参考。
技术栈
后端技术
| 技术 | 版本/说明 |
|---|---|
| 运行环境 | Node.js |
| Web框架 | Express 4.16.1 |
| 数据库 | MySQL 5.7+ |
| 数据库驱动 | mysql |
| 身份认证 | jsonwebtoken (JWT) |
| 文件上传 | multer |
| 跨域处理 | cors |
| UUID生成 | uuid |
| 热重载 | nodemon |
管理后台技术
| 技术 | 版本/说明 |
|---|---|
| 前端框架 | Vue 2.6.11 |
| UI组件库 | Element UI 2.15.6 |
| 路由管理 | Vue Router 3.0.7 |
| 状态管理 | Vuex 3.4.0 |
| HTTP请求 | Axios 0.24.0 |
| 图表库 | ECharts 5.3.1 |
| 富文本编辑器 | Quill 1.3.7 |
| CSS预处理器 | Less |
| 粒子效果 | vue-particles |
小程序端技术
| 技术 | 版本/说明 |
|---|---|
| 开发框架 | 微信小程序原生框架 |
| 开发语言 | JavaScript (ES6+) |
| 样式语言 | WXSS |
| 模板语言 | WXML |
| 富文本解析 | wxParse |
项目特点
- 前后端分离:后端提供RESTful API,前端独立开发部署
- 完整电商流程:涵盖商品浏览、购物车、下单、支付、评价全流程
- SKU规格管理:支持商品多规格(颜色、尺寸、重量等)
- 地址管理:支持多地址管理和默认地址设置
- 订单状态流转:待支付→已付款→待收货→已签收完整状态
- 数据可视化:管理后台集成ECharts图表展示
- 富文本支持:支持富文本商品详情编辑和展示
功能模块
小程序端功能
1. 首页模块 (pages/index)
- 轮播图展示
- 商品分类导航
- 热门商品推荐
- 最新商品展示
- 搜索功能入口
2. 商品分类模块 (pages/cate)
- 按分类浏览商品
- 分类列表展示
- 商品筛选
3. 商品详情模块 (pages/detail)
- 商品图片轮播展示
- 商品基本信息(名称、价格、规格)
- SKU规格选择
- 商品详情富文本展示
- 收藏功能
- 加入购物车
- 立即购买
4. 搜索模块 (pages/search)
- 关键词搜索
- 搜索结果展示
5. 购物车模块 (pages/shopCart)
- 购物车商品列表
- 商品数量修改
- 商品删除
- 全选/取消全选
- 价格计算
- 去结算
6. 订单模块
- 订单确认 (
pages/comfirm) - 订单列表 (
pages/orderList) - 订单详情 (
pages/orderDetail) - 订单状态查看
7. 地址管理模块
- 地址列表 (
pages/addressList) - 新增/编辑地址 (
pages/addressAddUpdate) - 设置默认地址
- 省市区选择
8. 评价模块 (pages/comment)
- 商品评价
- 上传评价图片
- 评价列表查看
9. 个人中心模块 (pages/my)
- 用户信息展示
- 我的收藏 (
pages/star) - 我的订单
- 问题反馈 (
pages/question) - 用户信息编辑 (
pages/userInfo)
管理后台功能
1. 首页仪表盘 (Welcome.vue)
- 数据统计概览
- 图表展示
2. 分类管理 (Cate)
- 商品分类列表
- 新增/编辑/删除分类
- 分类图标上传
3. 商品管理 (Product)
- 商品信息列表
- 新增/编辑/删除商品
- 商品图片上传
- SKU规格管理
- 热门/最新标记
- 富文本详情编辑
4. 订单管理 (Order)
- 订单列表
- 订单状态管理
- 发货处理
- 订单详情查看
5. 用户管理 (User.vue)
- 用户列表
- 用户信息查看
6. 收藏管理 (Star.vue)
- 收藏记录列表
7. 问题反馈 (Question.vue)
- 用户反馈列表
- 回复处理
项目结构
fitShop_min_express_mysql_all/ ├── admin/ # 管理后台(Vue2 + Element UI) │ ├── public/ # 静态资源 │ ├── src/ │ │ ├── api/ # API接口封装 │ │ ├── assets/ # 静态资源 │ │ ├── components/ # 公共组件 │ │ ├── filters/ # 过滤器 │ │ ├── router/ # 路由配置 │ │ ├── store/ # Vuex状态管理 │ │ ├── utils/ # 工具函数 │ │ ├── views/ # 页面视图 │ │ │ ├── Cate/ # 分类管理 │ │ │ ├── Order/ # 订单管理 │ │ │ ├── Product/ # 商品管理 │ │ │ ├── Home.vue # 主布局 │ │ │ ├── Login.vue # 登录页 │ │ │ ├── Question.vue # 问题反馈 │ │ │ ├── Star.vue # 收藏管理 │ │ │ ├── User.vue # 用户管理 │ │ │ └── Welcome.vue # 首页仪表盘 │ │ ├── App.vue # 根组件 │ │ └── main.js # 入口文件 │ ├── package.json │ └── vue.config.js # Vue配置 │ ├── express/ # 后端服务(Express + MySQL) │ ├── bin/ │ │ └── www # 启动入口 │ ├── config/ │ │ ├── db.js # 数据库配置 │ │ └── index.js # 全局配置 │ ├── public/ │ │ └── images/ # 上传图片存储 │ ├── routes/ │ │ ├── admin/ # 管理端API │ │ │ ├── alldata.js # 统计数据接口 │ │ │ ├── cate.js # 分类接口 │ │ │ ├── comment.js # 评论接口 │ │ │ ├── index.js # 路由入口 │ │ │ ├── order.js # 订单接口 │ │ │ ├── product.js # 商品接口 │ │ │ ├── question.js # 问题反馈接口 │ │ │ ├── star.js # 收藏接口 │ │ │ └── user.js # 用户接口 │ │ ├── web/ # 小程序端API │ │ │ ├── address.js # 地址接口 │ │ │ ├── cate.js # 分类接口 │ │ │ ├── comment.js # 评论接口 │ │ │ ├── index.js # 路由入口 │ │ │ ├── order.js # 订单接口 │ │ │ ├── product.js # 商品接口 │ │ │ ├── question.js # 问题反馈接口 │ │ │ ├── shopcart.js # 购物车接口 │ │ │ ├── star.js # 收藏接口 │ │ │ └── user.js # 用户接口 │ │ ├── index.js # 路由入口 │ │ └── upload.js # 文件上传 │ ├── util/ │ │ ├── index.js # 工具函数 │ │ └── wechat.js # 微信相关工具 │ ├── app.js # Express应用配置 │ └── package.json │ ├── min/ # 微信小程序 │ ├── components/ # 自定义组件 │ │ ├── productItem/ # 商品列表项组件 │ │ └── wxParse/ # 富文本解析组件 │ ├── images/ # 图片资源 │ │ ├── order/ # 订单相关图标 │ │ └── tabbar/ # TabBar图标 │ ├── pages/ # 页面目录 │ │ ├── index/ # 首页 │ │ ├── cate/ # 分类页 │ │ ├── search/ # 搜索页 │ │ ├── detail/ # 商品详情 │ │ ├── shopCart/ # 购物车 │ │ ├── comfirm/ # 订单确认 │ │ ├── orderList/ # 订单列表 │ │ ├── orderDetail/ # 订单详情 │ │ ├── addressList/ # 地址列表 │ │ ├── addressAddUpdate/ # 地址编辑 │ │ ├── comment/ # 评价页 │ │ ├── star/ # 我的收藏 │ │ ├── my/ # 个人中心 │ │ ├── userInfo/ # 用户信息 │ │ └── question/ # 问题反馈 │ ├── utils/ │ │ ├── api.js # API接口封装 │ │ ├── request.js # 请求封装 │ │ ├── feedback.js # 反馈工具 │ │ └── util.js # 工具函数 │ ├── app.js # 小程序入口 │ ├── app.json # 小程序配置 │ ├── app.wxss # 全局样式 │ └── project.config.json # 项目配置 │ ├── 图片资源/ # 项目图片资源 ├── 截图/ # 项目截图 ├── 小程序审核材料/ # 小程序审核相关 ├── fitShop.sql # 数据库SQL文件 ├── mysql.sh # MySQL脚本 ├── mysql操作手册.md # MySQL操作说明 ├── 数据库创建方法.md # 数据库创建说明 ├── 运行必读.docx # 运行说明文档 ├── 电商小程序.xmind # 项目思维导图 ├── 健身商城-小程序.mp4 # 小程序演示视频 └── 商城商城-admin.mp4 # 管理后台演示视频数据模型
用户表 (users)
{id:int,// 用户IDphone:varchar(255),// 手机号password:varchar(255),// 密码username:varchar(255),// 用户名sex:varchar(255),// 性别nickname:varchar(255),// 昵称openId:varchar(1100),// 微信OpenIDavatar:varchar(255),// 头像role:int// 角色 (0普通用户, 99管理员)}商品表 (product)
{id:int,// 商品IDtitle:varchar(255),// 商品名称content:longtext,// 商品详情(富文本)cover:varchar(255),// 封面图imgs:longtext,// 图集is_hot:int,// 是否热门 (0否 1是)is_new:int,// 是否最新 (0否 1是)is_like:int,// 是否推荐 (0否 1是)remark:varchar(100),// 备注cate_id:int,// 分类IDprice_max:double,// 最高价格price_min:double,// 最低价格limit:int,// 限购数量sku_length:int,// SKU数量create_time:timestamp,// 创建时间update_time:timestamp// 更新时间}分类表 (cate)
{id:int,// 分类IDtitle:varchar(100),// 分类名称cover:varchar(100),// 分类图标create_time:timestamp,// 创建时间update_time:timestamp// 更新时间}订单表 (orders)
{id:int,// 订单IDuser_id:int,// 用户IDtotal_price:double,// 订单总价phone:varchar(100),// 联系电话username:varchar(100),// 收货人address:varchar(100),// 收货地址status:int,// 状态 (0待支付 1已付款 2待收货 3已签收 4已取消 5已退款)order_no:varchar(30),// 订单号express_num:varchar(30),// 快递单号create_time:timestamp,// 下单时间pay_time:timestamp,// 付款时间send_time:timestamp,// 发货时间update_time:timestamp// 更新时间}订单详情表 (order_detail)
{id:int,// 详情IDuser_id:int,// 用户IDorder_id:int,// 订单IDproduct_id:int,// 商品IDproduct_title:varchar(1000),// 商品名称product_cover:varchar(1000),// 商品图片product_price:double,// 商品单价product_count:int,// 商品数量product_price_total:double,// 商品总价sku_id:int,// SKU IDspecs:varchar(1000),// 规格信息create_time:timestamp,// 创建时间update_time:timestamp// 更新时间}地址表 (address)
{id:int,// 地址IDuser_id:int,// 用户IDusername:varchar(100),// 收货人phone:varchar(100),// 联系电话province:varchar(100),// 省份city:varchar(100),// 城市district:varchar(100),// 区县address:varchar(1000),// 详细地址address_detail:varchar(100),// 门牌号is_default:int,// 是否默认 (0否 1是)create_time:timestamp,// 创建时间update_time:timestamp// 更新时间}商品属性键表 (product_attr_key)
{id:int,// 属性IDproduct_id:int,// 商品IDname:varchar(255),// 属性名称(如颜色、尺寸)created_at:timestamp,// 创建时间updated_at:timestamp// 更新时间}商品SKU表 (product_sku)
{id:int,// SKU IDproduct_id:int,// 商品IDspecs:varchar(255),// 规格值price:double,// 价格stock:int,// 库存created_at:timestamp,// 创建时间updated_at:timestamp// 更新时间}评论表 (comment)
{id:int,// 评论IDuser_id:int,// 用户IDproduct_id:int,// 商品IDorder_id:int,// 订单IDcontent:varchar(1000),// 评论内容cover:varchar(1000),// 评论图片create_time:timestamp,// 创建时间update_time:timestamp// 更新时间}收藏表 (star)
{id:int,// 收藏IDuser_id:int,// 用户IDproduct_id:int// 商品ID}问题反馈表 (question)
{id:int,// 反馈IDuser_id:int,// 用户IDcover:varchar(2000),// 图片remark:varchar(1000),// 反馈内容email:varchar(100),// 邮箱reply:varchar(1000),// 回复内容create_time:timestamp,// 创建时间update_time:timestamp// 更新时间}TabBar配置
{"tabBar":{"selectedColor":"#FF6B35","list":[{"pagePath":"pages/index/index","text":"首页"},{"pagePath":"pages/cate/cate","text":"分类"},{"pagePath":"pages/shopCart/shopCart","text":"购物车"},{"pagePath":"pages/my/my","text":"我的"}]}}商品分类
| 分类名称 | 说明 |
|---|---|
| 运动补剂 | 蛋白粉、氨基酸等 |
| 代餐零食 | 燕麦、代餐粉等 |
| 服饰配件 | 运动袜、运动鞋等 |
| 低卡饮品 | 电解质水、益生菌等 |
| 肉类蛋白 | 鸡肉肠、牛肉等 |
| 生鲜粗粮 | 玉米、荞麦面等 |
| 器械装备 | 筋膜枪、哑铃等 |
| 道件护具 | 弹力圈、泡沫轴等 |
运行环境要求
后端环境
- Node.js 14.0+
- MySQL 5.7+
- npm 或 yarn
管理后台
- Node.js 14.0+
- npm 或 yarn
- 现代浏览器(Chrome、Firefox、Edge等)
小程序端
- 微信开发者工具(最新稳定版)
- 基础库版本 2.19.0+
- 需要有效的AppID
快速开始
1. 数据库配置
- 创建MySQL数据库
CREATEDATABASEfitShopCHARACTERSETutf8mb4COLLATEutf8mb4_general_ci;- 导入数据库文件
mysql-uroot-pfitShop<fitShop.sql- 修改数据库配置
编辑express/config/db.js:
vardb=mysql.createConnection({database:"fitShop",// 数据库名称port:"3306",// 端口号host:"localhost",// 主机地址user:"root",// 用户名password:"root",// 密码(修改为你的密码)});2. 启动后端服务
# 进入后端目录cdexpress# 安装依赖npminstall# 启动服务(开发模式)npmrun dev后端服务默认运行在http://localhost:5002
3. 启动管理后台
# 进入管理后台目录cdadmin# 安装依赖npminstall# 启动开发服务器npmrun dev管理后台默认运行在http://localhost:8080
4. 运行小程序
- 打开微信开发者工具
- 选择"导入项目"
- 选择
min目录 - 填入AppID(可使用测试号)
- 点击"导入"
5. 配置小程序API地址
编辑min/utils/request.js,修改API基础地址:
constbaseUrl='http://localhost:5002'// 修改为你的后端地址默认账号
管理后台
- 手机号:18715023xxxx
- 密码:123456
小程序端
- 支持微信授权登录
- 或使用手机号登录
订单状态说明
| 状态码 | 状态名称 | 说明 |
|---|---|---|
| 0 | 待支付 | 订单已创建,等待支付 |
| 1 | 已付款 | 支付成功,等待发货 |
| 2 | 待收货 | 已发货,等待收货 |
| 3 | 已签收 | 订单完成 |
| 4 | 已取消 | 订单已取消 |
| 5 | 已退款 | 订单已退款 |
界面预览
项目包含演示视频文件:
健身商城-小程序.mp4- 小程序端完整功能演示商城商城-admin.mp4- 管理后台完整功能演示
扩展建议
如需进一步完善项目,可考虑以下扩展:
- 微信支付:集成微信支付功能
- 优惠券系统:添加优惠券领取和使用
- 积分系统:购物积分累计和兑换
- 会员等级:VIP会员体系
- 秒杀活动:限时秒杀功能
- 拼团功能:多人拼团购买
- 分销系统:推广返佣机制
- 物流追踪:接入物流查询API
- 数据统计:完善销售数据分析
- 消息推送:订单状态推送通知
注意事项
- 本项目为学习演示项目,部分数据为模拟数据
- 生产环境部署需要配置HTTPS
- 小程序上线需要完成微信认证和相关资质审核
- 涉及电商交易需符合相关法规要求
- 建议定期备份数据库数据
常见问题
Q: 数据库连接失败?
A: 检查MySQL服务是否启动,数据库配置是否正确
Q: 图片无法显示?
A: 检查后端服务是否启动,图片路径配置是否正确
Q: 小程序无法请求后端?
A: 检查request.js中的baseUrl配置,开发时需在微信开发者工具中关闭"不校验合法域名"
Q: 管理后台登录失败?
A: 确认数据库中users表有管理员账号(role=99)
Q: 商品SKU无法选择?
A: 检查商品是否正确配置了SKU规格信息
许可证
本项目仅供学习交流使用,请勿用于商业用途。
