使用说明
拼豆星球手工体验馆一站式经营管理系统。顾客可在前台完成预约体验、线上购物、会员签到等操作；门店员工可在后台管理会员、处理预约与订单、维护商品库存并查看经营数据。前台还有会员交互 拼豆游戏 适合
一、系统简介
系统分为两个端：
| 端 | 使用人 | 访问地址 | 主要用途 |
|---|---|---|---|
| 前台门户 | 顾客 / 会员 | http://localhost:5173 | 浏览门店信息、预约到店体验、线上购买商品、会员中心管理 |
| 后台管理 | 店长 / 店员 / 运营 | http://localhost:5173/login （管理员登录） | 会员管理、预约与订单处理、商品库存维护、活动营销、数据统计 |
二、运行环境与启动步骤
1. 环境要求
-
JDK 17
-
MySQL 8.0（数据库名
springbootpindou，账号 root / 密码 abc123） -
Node.js 16 及以上（含 npm）
-
现代浏览器（推荐 Chrome / Edge）
2. 启动顺序
第一步：启动数据库 ，确认 MySQL 服务运行，并已导入 backend/sql/pindou.sql（含建表语句与测试数据）。
第二步：启动后端（端口 8080，接口前缀 /api）：
cd backend
mvn spring-boot:run第三步：启动前端（端口 5173）：
cd frontend
npm install # 首次运行需要安装依赖
npm run dev启动成功后，浏览器访问 http://localhost:5173 即可进入前台首页。
注意：请按"数据库 → 后端 → 前端"的顺序启动；若页面提示网络错误，请先检查后端是否已启动。
三、登录说明
在浏览器打开 http://localhost:5173/login 进入登录页。页面右侧提供 管理员登录 与 会员登录 两个选项卡，按身份切换即可。
测试账号（可直接登录体验）
| 身份 | 账号 | 密码 | 说明 |
|---|---|---|---|
| 超级管理员 | admin | 123456 | 拥有后台全部权限 |
| 店员 | dianyuan | 123456 | 负责核销、订单履约 |
| 运营 | yunying | 123456 | 负责商品与活动维护 |
| 会员 | 13800000001 | 123456 | 豆豆妈妈（银卡会员） |
| 会员 | 13800000002 | 123456 | 手工小达人（金卡会员） |
| 会员 | 13800000004 | 123456 | 拼豆俱乐部（钻石会员） |
新顾客可在"会员登录"选项卡中使用手机号快速注册，注册成功即可获得新人礼包。
四、前台操作指南（顾客 / 会员）
1. 首页浏览
打开网站首先进入首页。首页顶部为导航栏（首页、预约体验、线上商城、会员中心、登录/注册）；页面中部展示门店招牌轮播图、营业时间、地址电话与营业状态；下方按分类展示体验套餐（单人、亲子、情侣、团建、定制），并可查看活动公告、成品案例与精选商品。
操作提示：点击任意套餐卡片可查看套餐详情；点击页面上的"预约"按钮可直接跳转到预约页。
2. 预约到店体验
点击顶部导航"预约体验"进入预约页，按三个步骤完成预约：
-
选择预约日期：页面列出从今天起 14 天的日期，第一个按钮"今天"显示当天日期，点击选中；
-
选择体验时段：每个时段卡片实时显示"剩余 X / Y 名额"，满员时段不可选；
-
选择套餐并填写信息：
-
在"体验套餐"下拉框中选择想要的套餐；
-
通过 ＋ / － 调整到店人数；
-
可勾选增值服务：成品熨烫、成品装框、加急服务；
-
填写联系人姓名、11 位手机号；
-
选择预约方式：定金预约 （支付 20% 定金锁定时段）或 免费预约（到店核销付款）；
-
如有特殊需求可在"预约备注"中说明（如配色要求、团建需求）。
-
确认信息无误后提交，系统自动生成预约单号（YY 开头）。到店后由店员在后台核销即可。
3. 线上商城购物
点击顶部导航"线上商城"进入商城页：
-
上方可按分类筛选（拼豆成品、DIY 材料套装、拼豆颗粒、工具配件、礼盒包装）；
-
支持关键词搜索与按价格、销量排序；
-
每个商品卡片显示图片、名称、已售数量、库存与价格，点击卡片进入详情页。
商品详情页展示商品大图、价格、原价、分类、商品详情、库存、运费、售后规则以及其他用户的评价。选择购买数量后，可点击 加入购物车 或 去购物车结算：
结算流程：
-
点击商城右上角"购物车"打开购物车抽屉，可调整数量、删除商品、勾选要结算的商品；
-
点击"去结算"，在弹窗中选择取货方式：到店自提 （免运费）或 同城配送（需运费）；
-
系统自动按会员等级计算折扣，并可选择可用优惠券；
-
点击"提交订单"，订单生成（DD 开头），随后完成支付即可。
4. 会员中心
登录会员后点击顶部导航"会员中心"进入。顶部会员卡区域显示头像、昵称、会员等级、积分、余额、消费次数与累计消费，右侧为"每日签到 +5 分"和"余额充值"按钮。
下方共 6 个选项卡：
| 选项卡 | 功能说明 |
|---|---|
| 我的预约 | 查看全部预约单（套餐、日期、时段、人数、金额、状态）；"待核销"状态可点击"取消" |
| 我的订单 | 查看购物订单；可进行支付、取消、确认收货、申请售后、发表评价等操作 |
| 优惠券 | 查看可领取的优惠券，点击"领取"收入卡包；已持有的优惠券在此查看 |
| 积分明细 | 查询每一笔积分获取与消耗记录（签到、消费赠送等） |
| 余额记录 | 查询充值、消费、退款等余额变动流水 |
| 个人设置 | 修改昵称、性别、生日、手机号等个人资料，点击"保存修改"生效 |
日常操作提示：
-
每日签到：每天可签到一次，每次 +5 积分，签到后按钮变为"今日已签到"；
-
余额充值：点击"余额充值"，在弹窗中选择/输入金额后确认，余额可用于下单支付；
-
购物支付：在"我的订单"中找到"待付款"订单，点击"支付"，可用余额完成付款；
-
确认收货：配送订单收到商品后，在"待发货/待收货"订单上点击"确认收货"；
-
发表评价：在"我的订单"中点击"评价"，选择星级、填写评价内容后提交。
五、后台管理操作指南（员工 / 管理员）
使用管理员账号登录后进入后台。页面顶部为横向导航：数据看板、会员管理、预约管理、订购管理、商品管理、库存管理、数据统计、系统设置。右上角可返回前台首页或退出登录。
1. 数据看板
后台首页，集中展示门店核心经营数据：今日预约营收、今日商品营收、会员总数、今日新增订单 4 张统计卡；下方为近 7 日营业额趋势、会员等级分布、预约订单状态、订购订单状态、套餐销量 TOP5 共 5 张图表，可快速掌握经营全貌。
2. 会员管理 --- 会员列表
-
支持按手机号、昵称、等级搜索，分页浏览全部会员；
-
可启用 / 停用会员账号；
-
可手动为会员调整积分、调整余额（系统自动记录流水）；
-
可按会员等级批量发放优惠券，用于营销活动。
3. 会员管理 --- 等级配置
-
维护各会员等级的名称、升级所需累计消费额、折扣比例、积分倍率；
-
新增、编辑、删除等级；已有会员的等级不允许删除；
-
会员消费达到升级额度后自动升级，下单自动享受对应折扣。
4. 预约管理 --- 预约订单
-
按预约单号、状态、套餐、日期、会员等条件筛选查询；
-
顾客到店后，找到对应预约单点击 核销，订单即变为"已完成"，积分自动到账；
-
支持修改预约（时段、人数）、取消预约、将未到店订单标记为"已过期"；
-
可查看近 30 日客流统计图。
5. 预约管理 --- 时段配额
-
设置每日营业时段（如 10:00-12:00、13:00-15:00 等）；
-
为每个时段设置最大可预约人数，并通过开关开放或关闭时段；
-
顾客预约时只能看到已开放且仍有余额的时段。
6. 订购管理 --- 订购订单
-
查看全部线上订购订单，按状态（待付款、待自提、待发货、已完成等）筛选；
-
点击行可展开查看订单明细（商品、数量、单价）与买家备注；
-
自提订单：顾客到店取货后点击 自提核销；
-
配送订单：点击 发货 并填写物流信息；
-
需退款的订单点击 退款，款项退回会员余额，库存自动回补。
7. 商品管理 --- 体验套餐
-
维护体验套餐：名称、分类、价格、原价、时长、可约人数、套餐图片、套餐说明等；
-
支持按分类与关键词搜索；
-
通过上架 / 下架开关控制套餐是否在前台展示。
8. 商品管理 --- 实物商品
-
维护实物商品：名称、分类、价格、库存、库存预警值、运费、商品图片与详情；
-
库存低于预警值时以红色"库存预警"标记，提醒及时补货；
-
支持上架 / 下架，下架后前台不再展示。
9. 商品管理 --- 分类管理
-
统一管理套餐与商品的分类（如单人体验、亲子套餐、拼豆成品、DIY 材料等）；
-
可设置排序号、启用 / 禁用分类；
-
已被套餐或商品引用的分类不允许删除，需先移除引用。
10. 库存管理
-
查看全部商品库存及预警状态，低库存商品红色高亮；
-
点击 入库 / 出库 调整库存数量并填写原因，系统自动记录操作人与出入库流水；
-
切换"出入库流水"选项卡可按时间查询每一笔库存变动。
11. 数据统计
包含 4 个分析页签：
-
营收统计：近 6 月总营业额、平均月营收及月度柱状图；
-
客流统计：近 30 日预约人数、实际到店人数、取消率折线图；
-
销量排行：商品 / 套餐销量 TOP5 横向条形图；
-
会员构成：各会员等级人数占比饼图。
12. 系统设置 --- 门店信息
维护门店基础资料：门店名称、营业时间、营业状态、地址、联系电话、门店简介、招牌轮播图等。修改后前台首页实时更新。"一键拨号""一键导航"即基于此处配置。
13. 系统设置 --- 员工权限
-
管理后台操作员账号：登录账号、姓名、手机号、所属角色；
-
点击"新增操作员"创建账号并分配角色（超级管理员 / 店员 / 运营）；
-
可启用、停用账号；内置超级管理员 admin 不可删除。
14. 系统设置 --- 活动公告
-
发布与维护活动公告（如会员日、节假日活动），设置活动类型、起止日期；
-
通过上下架开关控制前台是否展示；活动将在首页公告区呈现。
15. 系统设置 --- 成品案例
-
上传并维护顾客成品 / 作品案例的图片与文字介绍；
-
案例在首页成品展示区呈现，用于吸引顾客、展示制作效果。
16. 系统设置 --- 优惠券
-
创建优惠券模板：满减券（满 X 减 Y）、折扣券（按比例打折）、体验券；
-
设置有效期、发行总量、使用门槛，页面直观展示使用规则与领取进度；
-
会员可在前台会员中心领取，下单结算时选用。
17. 系统设置 --- 评价管理
-
查看会员对商品、订单的评价，支持按星级、类型筛选；
-
对违规或不当评价可执行删除，维护评价区内容质量。
18. 系统设置 --- 操作日志
-
系统自动记录后台每一次关键操作：操作人、所属模块、操作内容、IP 地址、操作时间；
-
支持按条件分页查询，所有管理行为可追溯，便于核对与责任界定。
六、常见问题（FAQ）
**1. 页面打开后提示网络错误 / 数据加载失败？**请确认后端服务（8080 端口）与 MySQL 数据库已启动，启动顺序为：数据库 → 后端 → 前端。
**2. 登录时提示账号或密码错误？**请确认选择了正确的登录选项卡（管理员 / 会员）：管理员使用账号名登录（如 admin），会员使用 11 位手机号登录。测试账号密码均为 123456。
**3. 预约时某个时段无法选择？**该时段可能已满（剩余名额为 0）或已被门店关闭，请更换其他时段或日期。
**4. 下单后如何使用余额和优惠券？**结算时系统自动按会员等级计算折扣；可在结算弹窗中选择已领取的优惠券；提交订单后在会员中心"我的订单"中用余额完成支付。
**5. 退款后钱去了哪里？**订购订单退款将退至会员账户余额，可在"余额记录"中查看，余额可用于后续消费；退款同时自动回补商品库存。
**6. 消费后积分如何计算？**每实际支付 1 元获得 1 积分，并按会员等级享受积分倍率加成；每日签到额外获得 5 积分。积分明细可在会员中心查看。
**7. 会员等级如何升级？**累计消费达到对应等级标准后系统自动升级（银卡满 500 元、金卡满 2000 元、钻石满 5000 元），升级后即可享受更高折扣与积分倍率。
大家点赞、收藏、关注、评论啦 其他的定制服务 商务合作 私信作者