# 酒店管理系统

**Repository Path**: Chenfangyijie_code/hotel-systemexe

## Basic Information

- **Project Name**: 酒店管理系统
- **Description**: 基于 Electron + Vue3 + TypeScript 的跨平台桌面酒店管理系统
一站式管理客房、订单、会员、数据与系统配置
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-23
- **Last Updated**: 2026-06-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 云鹿酒店管理系统

![登录界面](./dist/01.gif)

> 一款基于 Electron + Vue3 + TypeScript 构建的现代化酒店管理系统，专为中小型酒店、民宿、客栈设计，提供从客房管理到订单处理的一站式解决方案。

---

## 功能特性

### 核心功能

- **客房管理** - 实时查看房态、办理入住/退房、房间清洁状态管理
- **订单管理** - 订单创建、查询、详情查看，支持多种支付方式
- **会员管理** - 会员等级体系、积分管理、会员权益配置
- **数据统计** - 入住率趋势、收入分析、多维度数据可视化
- **系统设置** - 酒店信息、楼层/房型/设施配置、价格规则管理

### 技术亮点

- 使用 Electron 构建跨平台桌面应用
- Vue3 + TypeScript 现代化前端架构
- Arco Design 组件库，界面美观统一
- ECharts 数据可视化图表
- SQL.js 本地数据库存储，无需后端服务

---

## 界面预览

### 登录界面

![登录界面](./dist/01.gif)

精美的登录页面，支持记住账号功能。

### 首页 - 房态看板

![首页房态](./dist/01.png)

直观的房态展示，一目了然查看所有房间状态：
- 绿色边框 - 空房可入住
- 橙色边框 - 脏房待清洁
- 红色边框 - 已入住

支持快速办理入住、退房、查看房间详情等操作。

![房态操作](./dist/02.gif)

### 办理入住

![办理入住](./dist/02.png)

简洁的入住办理流程，支持：
- 客人信息录入（姓名、手机号、证件）
- 入住时间选择
- 订单来源和支付方式配置
- 押金设置

### 房间详情

![房间详情](./dist/03.png)

查看房间完整信息，包括：
- 房型设施详情
- 当前订单信息
- 历史入住记录

### 客房管理

![客房管理](./dist/04.png)

客房列表管理，支持：
- 房间增删改查
- 房态批量管理
- 房间属性配置

### 订单管理

![订单详情](./dist/05.png)

订单详情弹窗，展示完整的订单信息：
- 客人信息
- 房间信息
- 时间信息
- 支付详情

### 数据统计

![数据统计](./dist/06.png)

数据可视化看板，提供：
- 房间总数、入住率统计
- 今日订单、营业额展示
- 入住率趋势图表
- 收入趋势分析

### 系统设置

#### 酒店基础设置

![酒店设置](./dist/07.png)

配置酒店基本信息：
- 酒店 Logo
- 名称、电话、地址
- 酒店简介

#### VIP 等级配置

![VIP配置](./dist/08.png)

会员等级体系管理：
- 普通会员 → 黄金会员 → 铂金会员 → 钻石会员 → 至尊会员
- 房价折扣设置
- 早餐权益配置
- 延迟退房时间
- 升房权限、押金政策

#### 支付方式配置

![支付设置](./dist/09.png)

支持多种支付方式：
- 现金
- 微信支付
- 支付宝
- 银行卡

#### 管理员管理

![管理员](./dist/10.png)

系统账号管理，支持：
- 新增管理员
- 权限分配
- 密码修改

#### 楼层管理

![楼层管理](./dist/11.png)

酒店楼层配置：
- 楼层编码、别名设置
- 楼层属性（普通/商务/行政等）
- 消防通道、监控覆盖标记

#### 酒店设施管理

![设施管理](./dist/12.png)

丰富的设施图标库，支持自定义分组：
- 景观采光
- 早餐权益
- 智能电器
- 卫浴配套

#### 床型管理

![床型管理](./dist/13.png)

床型配置管理：
- 床型名称、尺寸
- 可爱图标选择
- 启用状态控制

#### 房型管理

![房型管理](./dist/14.png)

![新增房型](./dist/15.png)

房型配置，包含：
- 房型基础信息
- 售卖开关（全日房/钟点房）
- 展示图片上传
- 房型设施勾选

#### 价格规则

![价格规则](./dist/16.png)

![调价配置](./dist/17.png)

![规则列表](./dist/18.png)

动态调价功能：
- 节假日自动调价
- 按比例/固定金额调价
- 底价保护机制
- 适用房型筛选
- 调价预览功能

---

## 技术栈

| 技术 | 说明 |
|------|------|
| Electron | 跨平台桌面应用框架 |
| Vue 3 | 渐进式 JavaScript 框架 |
| TypeScript | 类型安全的 JavaScript 超集 |
| Vite | 下一代前端构建工具 |
| Arco Design Vue | 字节跳动企业级 UI 组件库 |
| Pinia | Vue 状态管理方案 |
| ECharts | 开源可视化库 |
| SQL.js | SQLite 的 JavaScript 移植版 |
| Drizzle ORM | TypeScript ORM 框架 |

---

## 快速开始

### 环境要求

- Node.js >= 18
- npm 或 pnpm

### 安装依赖

```bash
npm install
```

### 开发模式

```bash
npm run dev
```

### 构建打包

```bash
# Windows 安装包
npm run build:win

# macOS 安装包
npm run build:mac

# Linux 安装包
npm run build:linux
```

---

## 项目结构

```
hotel/
├── build/              # 构建资源（图标、配置等）
├── db/                 # 数据库文件
├── dist/               # 打包输出目录
├── resources/          # 静态资源
├── src/
│   ├── main/          # Electron 主进程
│   ├── preload/       # 预加载脚本
│   └── renderer/      # 渲染进程（Vue 应用）
│       ├── src/
│       │   ├── components/  # 公共组件
│       │   ├── views/       # 页面视图
│       │   ├── router/      # 路由配置
│       │   └── store/       # Pinia 状态管理
│       └── index.html
├── electron.vite.config.ts  # Vite 配置
├── electron-builder.yml     # 打包配置
└── package.json
```

---

## 作者

**陈方艺杰**

---

## 许可证

MIT License