专注轻量化收银与会员深度运营的理发店效率工具。开单快、账目准、分析透。
EasyCut 是一套完整的理发店管理系统解决方案，采用前后端分离架构，基于 Spring Boot + Vue 3 技术栈开发。
- 极简收银工作台：30秒内完成一笔结账，支持多人协作
- 会员深度运营：充值管理、次卡维护、账户流水追踪
- 运营数据分析：营收看板、员工业绩、数据导出
- 权限安全管理：角色权限、操作日志
后端
- Spring Boot 3.1.5 (Java 17)
- MyBatis 3.0.3
- MySQL 8.0+
- Redis 7.0+
- SpringDoc OpenAPI (Swagger)
前端
- Vue 3.4 (Composition API)
- Vite 5.1
- TypeScript 5.4
- Element Plus 2.6
- ECharts 5.5
确保已安装：
- JDK 17+
- Node.js 18+
- MySQL 8.0+
- Redis 7.0+
执行 schema.sql 初始化数据库表：
mysql -u root -p < schema.sql
cd easy-cut-backend
mvn spring-boot:run
后端服务启动于：http://localhost:8088/api
Swagger 文档：http://localhost:8088/api/swagger-ui.html
cd easy-cut-frontend
npm install
npm run dev
前端服务启动于：http://localhost:5173
- 分类管理：剪发、染发、烫发、护理等
- 职级动态调价：同一项目关联不同发型师级别
- 服务时长配置
- 员工档案：发型师、助理信息
- 职级设置：总监、资深、高级、普通、助理
- 在职状态管理
- 固定金额提成
- 百分比提成
- 按职级配置
- 点击发型师头像选择服务
- 支持多人协作（发型师+助理）
- 自动计算业绩分成
- 手机号/会员卡号快速检索
- 自动匹配会员等级折扣
- 实时显示余额
- 余额扣减
- 微信/支付宝
- 现金/POS机
- 自定义充值金额
- 赠送金额配置
- 充值流水记录
- 洗头10次卡等特殊消费券
- 余量追踪
- 到期提醒
- 消费历史记录
- 余额调整日志
- 操作审计
- 今日总营业额
- 实收现金流
- 耗卡金额
- 客数统计
- 客数统计
- 业绩总额
- 预估提成
- 收银流水明细（Excel）
- 会员数据导出
- 项目热度分析
- 店员：收银、充值、查看个人业绩
- 店长/老板：改价、删单、查看全店利润、导出数据
- 余额修改记录
- 订单作废记录
- 防止内部舞弊
easy-cut/
├── easy-cut-backend/ # 后端项目
│ ├── src/main/java/com/easycut/
│ │ ├── controller/ # 控制器
│ │ ├── service/ # 服务层
│ │ ├── mapper/ # 数据访问层
│ │ ├── entity/ # 实体类
│ │ ├── dto/ # 数据传输对象
│ │ ├── config/ # 配置类
│ │ └── EasyCutApplication.java # 启动类
│ ├── src/main/resources/
│ │ └── application.yml # 配置文件
│ ├── pom.xml # Maven 配置
│ └── Dockerfile # Docker 镜像
│
├── easy-cut-frontend/ # 前端项目
│ ├── src/
│ │ ├── api/ # API 请求
│ │ ├── components/ # 公共组件
│ │ ├── views/ # 页面视图
│ │ ├── router/ # 路由
│ │ ├── stores/ # 状态管理
│ │ ├── utils/ # 工具
│ │ ├── App.vue # 根组件
│ │ └── main.ts # 入口
│ ├── package.json # npm 配置
│ ├── vite.config.ts # Vite 配置
│ └── Dockerfile # Docker 镜像
│
├── docker-compose.yml # 本地开发环境
├── schema.sql # 数据库初始化
└── README.md # 项目文档
| 接口 | 方法 | 描述 |
|---|---|---|
| /api/services | GET | 获取所有服务 |
| /api/services/{id} | GET | 获取服务详情 |
| /api/services/price | GET | 获取价格 |
| 接口 | 方法 | 描述 |
|---|---|---|
| /api/staff | GET | 获取所有员工 |
| /api/staff/{id} | GET | 获取员工详情 |
| /api/staff/level/{level} | GET | 按职级获取员工 |
| 接口 | 方法 | 描述 |
|---|---|---|
| /api/members | GET | 获取所有会员 |
| /api/members/phone/{phone} | GET | 根据手机号获取会员 |
| /api/members/{id}/recharge | POST | 会员充值 |
| 接口 | 方法 | 描述 |
|---|---|---|
| /api/orders | GET | 获取所有订单 |
| /api/orders | POST | 创建订单 |
| /api/orders/{id}/cancel | POST | 取消订单 |
spring:
datasource:
url: jdbc:mysql://localhost:3306/easycut
username: root
password: your_password
redis:
host: localhost
port: 6379
password: your_redis_password
server:
port: 8088
export default defineConfig({
server: {
port: 5173,
proxy: {
'/api': {
target: 'http://localhost:8088',
changeOrigin: true
}
}
}
})
- 在
src/main/java/com/easycut/mapper/创建 Mapper 接口 - 在
src/main/java/com/easycut/service/创建 Service 类 - 在
src/main/java/com/easycut/controller/创建 Controller 类 - 在
src/api/创建前端 API 文件
- 在
src/views/创建 Vue 组件 - 在
src/router/index.ts添加路由配置
# 构建镜像
docker build -t easy-cut-backend ./easy-cut-backend
docker build -t easy-cut-frontend ./easy-cut-frontend
# 启动服务
docker-compose up -d
参考 .cnb.yml 和 Kubernetes 部署配置。
MIT License
About
Language
Vue54.4%
Java34.6%
TypeScript5.6%
Shell4.7%
Others0.7%
35/F,Tencent Building,Kejizhongyi Avenue,Nanshan District,Shenzhen
