# 美业门店数字化平台

**Repository Path**: dm_team/Digital-Platform-for-Beauty-Salons

## Basic Information

- **Project Name**: 美业门店数字化平台
- **Description**: 黑金美业 · 美业门店数字化平台
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-08-09
- **Last Updated**: 2026-08-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 黑金美业 · 美业门店数字化平台

> 明亮轻奢风 UI（暖白底+玫瑰金）· Spring Boot 3 + Vue 3 全栈毕设项目
> 会员自助端 + 门店管理端 + 技师提成一体化
> 覆盖会员储值、智能预约、消费开单、技师提成、工资结算、营销活动、数据统计全业务闭环

## 系统简介

本系统面向美容美发门店提供一体化数字化管理，核心解决两大痛点：**会员精细化运营**（储值/积分/等级/优惠券）与**技师提成核算**（规则化提成、自动结算、工资生成）。

- **明亮轻奢视觉**：暖白米底 + 玫瑰金点缀 + 柔和大圆角，杂志式留白排版，告别千篇一律的管理系统风格
- **34 张数据表**：完整覆盖用户权限、会员、服务商品、技师、订单、提成工资、营销、运营八大业务域
- **三种角色**：店长（全权限）、收银员（开单收银）、技师（个人工作台/提成）

## 功能清单

| 模块 | 功能 |
|---|---|
| 工作台 | 今日/本月营收、订单数、会员数、待确认预约、近7日营收趋势、最新评价 |
| 会员管理 | 会员 CRUD、等级管理（自动升级）、储值充值（赠金）、积分流水、优惠券领取 |
| 预约管理 | 预约增删改查、状态流转（待确认→已确认→已完成/取消/爽约）、技师排班 |
| 服务商品 | 服务项目（提成配置）、商品库存、分类管理 |
| 技师管理 | 技师档案、技师等级（底薪/提成加成）、考勤管理 |
| 订单管理 | **消费开单一站式**：选会员→选服务/商品→会员折扣→优惠券→积分抵扣→储值/微信/支付宝支付，自动生成提成 |
| 提成工资 | 提成规则（固定/比例+等级加成）、提成记录、结算单（确认→发放）、工资单（底薪+提成） |
| 营销活动 | 优惠券（满减/折扣）、充值满赠/发券活动 |
| 统计报表 | 营业统计（营收趋势/支付占比/项目销售）、会员分析（等级分布/新增趋势/消费TOP）、技师排行 |
| 系统管理 | 用户、角色权限（菜单树勾选）、菜单、操作日志、系统配置 |
| 运营管理 | 服务评价、门店公告、库存流水 |
| 门户网站 | Hero 品牌区、服务生态磁贴、焕美流程、精选项目、门店公告 |
| **会员自助端** | **手机号注册/登录（独立 JWT）、个人中心：在线预约、消费记录、积分明细、领券中心、自助充值、资料管理** |

## 双端入口

| 端 | 入口 | 账号 |
|---|---|---|
| **会员端（C 端）** | 门户右上角"会员登录" | 任意手机号注册；演示：13911110001 / 123456 |
| **员工端（B 端）** | 门户右上角"员工登录" | admin / cashier01 / tech01~03，密码 123456 |

## 技术栈

- **后端**：Spring Boot 3.2 / MyBatis-Plus / Spring Security + JWT / Hutool / MySQL 8
- **前端**：Vue 3 / Vite 5 / Element Plus / Pinia / Vue Router / ECharts / Axios

## 项目结构

```
├── init.sql              # 数据库初始化脚本（建库 + 34 表 + 演示数据 + 权限树）
├── backend/              # Spring Boot 后端
│   ├── src/main/java/com/salon/
│   │   ├── controller/   # 接口层（12 个控制器）
│   │   ├── service/      # 业务层（会员/订单/提成等）
│   │   ├── mapper/       # MyBatis-Plus Mapper（34 张表）
│   │   ├── entity/       # 实体类（34 个）
│   │   ├── security/     # JWT 认证 + 角色权限
│   │   └── config/       # 安全/跨域/MP 配置
│   ├── tools/            # 开发辅助脚本（实体生成、测试脚本）
│   └── pom.xml
├── frontend/             # Vue 3 前端
│   ├── src/views/        # 门户 + 登录 + 30 个后台页面
│   ├── src/layout/       # 后台布局（顶栏一级导航 + 侧栏子菜单）
│   ├── src/styles/       # 黑金视觉体系 global.css
│   └── scripts/          # Playwright 自动化测试脚本
└── 系统截图/              # 系统运行截图
```

## 快速启动（三步）

### 1. 初始化数据库

```bash
mysql -uroot -p你的密码 < init.sql
```

创建数据库 `beauty_salon`，自动建表并导入演示数据。

### 2. 启动后端（端口 8080）

修改 `backend/src/main/resources/application.yml` 中的数据库密码后：

```bash
cd backend
mvn spring-boot:run
```

### 3. 启动前端（端口 5173）

```bash
cd frontend
npm install
npm run dev
```

浏览器访问 **http://localhost:5173** 即可看到门户首页，点"登录"进入后台。

## 演示账号（密码均为 123456）

| 角色 | 账号 | 权限 |
|---|---|---|
| 店长 | admin | 全部功能 |
| 收银员 | cashier01 | 会员/预约/开单/营销 |
| 技师 | tech01~tech05 | 个人预约/提成/考勤 |

> 登录页已内置三种角色一键填充演示卡片。

## 测试

```bash
# 后端 API 闭环测试（需先启动后端）
python backend/tools/human_flow_test.py

# 前端浏览器遍历（需前后端均启动）
cd frontend && node scripts/browser_check_all.mjs
```

## 端口约定

- 后端：8080（Spring Boot）
- 前端：5173（Vite，已配置 /api 代理）
- 数据库：3306（MySQL）