# jzx-hcms

**Repository Path**: yongao/jzx-hcms

## Basic Information

- **Project Name**: jzx-hcms
- **Description**: No description available
- **Primary Language**: Java
- **License**: Unlicense
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-12
- **Last Updated**: 2026-04-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# jzx-hcms 美容院客户管理系统

#### 介绍

jzx-hcms 是一款功能完善的美容院客户管理系统，采用前后端分离架构开发。后端基于 Spring Boot + MyBatis Plus 构建，前端使用 Vue 3 + TypeScript + Element Plus 实现。系统支持客户预约、医生管理、在线咨询、会员充值、评价反馈等核心业务功能。

#### 软件架构

**后端技术栈：**
- Spring Boot 3.x
- MyBatis Plus
- MySQL
- JWT 认证
- Spring MVC

**前端技术栈：**
- Vue 3
- TypeScript
- Vite
- Element Plus
- Pinia
- Axios

#### 项目结构

```
jzx-hcms/
├── hcrm-admin/          # Spring Boot 后端服务
│   └── src/main/java/ljz/hcrm/
│       ├── controller/ # 控制器层
│       ├── service/   # 服务层
│       ├── mapper/    # 数据访问层
│       ├── model/    # 实体模型
│       ├── config/   # 配置类
│       └── common/   # 公共工具
├── hcrm-app/           # Vue 3 前端应用
│   └── src/
│       ├── views/     # 页面视图
│       ├── components/# 公共组件
│       ├── services/ # API 服务
│       ├── stores/   # Pinia 状态管理
│       └── router/   # 路由配置
└── sql/                # 数据库脚本
    └── schema.sql
```

#### 功能特性

**客户端功能：**
- 用户注册、登录
- 浏览医生信息
- 浏览服务项目
- 在线预约
- 在线咨询
- 会员卡充值
- 评价服务

**管理端功能：**
- 客户管理
- 医生管理
- 服务项目管理
- 预约管理
- 咨询管理
- 评价管理
- 财务管理

#### 安装教程

**后端配置：**

1. 创建 MySQL 数据库并执行 `sql/schema.sql`
2. 修改 `hcrm-admin/src/main/resources/application.yml` 中的数据库连接配置
3. 执行以下命令启动后端服务：
```bash
cd hcrm-admin
mvn spring-boot:run
```

**前端配置：**

1. 安装依赖：
```bash
cd hcrm-app
npm install
```

2. 启动开发服务器：
```bash
npm run dev
```

#### 使用说明

1. 访问 `http://localhost:5173` 进入前端页面
2. 普通用户可注册账号或登录体验客户端功能
3. 管理员账号需在数据库中手动设置 role 为 `admin`

#### API 接口规范

**通用响应格式：**
```json
{
  "code": 200,
  "message": "success",
  "data": {}
}
```

**认证接口：**
- `POST /auth/register` - 用户注册
- `POST /auth/login` - 用户登录
- `GET /auth/profile` - 获取用户信息

#### 参与贡献

1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request