# nail-charge

**Repository Path**: Vincentor/nail-charge

## Basic Information

- **Project Name**: nail-charge
- **Description**: 美甲充值系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-28
- **Last Updated**: 2026-07-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 美甲店充值管理系统

一个简单实用的美甲店客户充值管理系统，支持客户管理、充值消费记录、充值规则配置等功能。

## 功能特点

- **客户管理**：添加、编辑、删除客户，查看客户余额和消费记录
- **充值管理**：支持多种充值规则，自动匹配最优规则，记录充值历史
- **消费管理**：记录客户消费，自动扣减余额
- **充值规则配置**：灵活配置充值规则，支持固定金额赠送和百分比折扣
- **线下支付**：不需要营业执照和商户号，支持现金、微信、支付宝等线下支付方式

## 技术栈

- **后端**：Spring Boot 3.2 + MyBatis-Plus + MySQL
- **前端**：Vue 3 + Element Plus + Vite

## 项目结构

```
nail-charge/
├── backend/                    # 后端项目
│   ├── src/main/java/com/nail/charge/
│   │   ├── controller/         # 控制器
│   │   ├── service/            # 服务层
│   │   ├── mapper/             # MyBatis Mapper
│   │   ├── entity/             # 实体类
│   │   ├── dto/                # 数据传输对象
│   │   └── config/             # 配置类
│   ├── src/main/resources/
│   │   ├── application.yml     # 配置文件
│   │   └── schema.sql          # 数据库初始化脚本
│   └── pom.xml
├── frontend/                   # 前端项目
│   ├── src/
│   │   ├── views/              # 页面组件
│   │   ├── api/                # API请求
│   │   ├── router/             # 路由配置
│   │   └── utils/              # 工具类
│   ├── package.json
│   └── vite.config.js
└── README.md
```

## 启动步骤

### 1. 准备数据库

确保已安装 MySQL 5.7+，创建数据库并导入表结构：

```sql
-- 方式1：直接执行SQL脚本
source backend/src/main/resources/schema.sql

-- 方式2：手动创建数据库后启动后端会自动创建表（需配置）
CREATE DATABASE nail_charge DEFAULT CHARACTER SET utf8mb4;
```

### 2. 配置后端

修改 `backend/src/main/resources/application.yml`：

```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/nail_charge?useUnicode=true&characterEncoding=utf-8&useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true
    username: root        # 你的MySQL用户名
    password: root        # 你的MySQL密码
```

### 3. 启动后端

```bash
cd backend

# 方式1：使用Maven
mvn spring-boot:run

# 方式2：打包后运行
mvn clean package
java -jar target/nail-charge-1.0.0.jar
```

后端启动成功后访问：http://localhost:8080

### 4. 启动前端

```bash
cd frontend

# 安装依赖
npm install

# 启动开发服务器
npm run dev
```

前端启动成功后访问：http://localhost:3000

## 使用说明

### 充值规则说明

系统支持两种充值规则类型：

1. **固定金额赠送**：充值达到一定金额后，赠送固定金额
   - 例如：充值1000送100，充值2000送300

2. **百分比折扣**：充值达到一定金额后，按折扣比例计算赠送金额
   - 例如：充值3000以上打9折，实际到账 = 充值金额 + (充值金额 × (100-折扣)/100)

### 操作流程

1. **添加客户**：在"客户管理"页面添加客户信息
2. **配置规则**：在"充值规则"页面配置充值优惠规则
3. **客户充值**：在"充值管理"页面为客户充值，系统会自动匹配最优规则
4. **客户消费**：在"消费管理"页面记录客户消费，自动扣减余额

## API接口

| 接口 | 方法 | 说明 |
|------|------|------|
| /api/customer/page | GET | 分页查询客户 |
| /api/customer | POST | 添加客户 |
| /api/customer | PUT | 更新客户 |
| /api/customer/{id} | DELETE | 删除客户 |
| /api/rule/page | GET | 分页查询规则 |
| /api/rule/active | GET | 获取启用的规则 |
| /api/rule | POST | 添加规则 |
| /api/rule | PUT | 更新规则 |
| /api/recharge/page | GET | 分页查询充值记录 |
| /api/recharge | POST | 充值 |
| /api/consume/page | GET | 分页查询消费记录 |
| /api/consume | POST | 消费 |

## 注意事项

1. 本系统为线下充值管理系统，不需要营业执照和商户号
2. 支付方式为线下转账或现金，由老板手动操作充值
3. 建议定期备份数据库数据
4. 首次使用请先导入数据库表结构