# hotelmanager

**Repository Path**: yangsen121/hotelmanager

## Basic Information

- **Project Name**: hotelmanager
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-24
- **Last Updated**: 2026-03-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# 酒店管理系统

一套功能完善的酒店管理系统，采用前后端分离架构，支持客房管理、入住退房、会员管理、财务报表等核心业务功能，并集成了公安系统、身份证读卡器和美团OTA平台等第三方服务。

## 系统架构

### 后端技术栈
- **框架**：Spring Boot 3.x
- **Java版本**：JDK 21
- **数据库**：MySQL 8.0+
- **构建工具**：Maven

### 前端技术栈
- **框架**：Vue 3 + Element Plus
- **构建工具**：Vite
- **状态管理**：Pinia
- **HTTP客户端**：Axios

## 功能模块

### 前台管理模块
- **预订管理**：渠道管理、房态管理、订单预订
- **入住登记**：快速入住、无预订入住、团体入住、公安系统上传
- **退房管理**：退房检查、完整退房流程、发票开具
- **收银结账**：支付处理、收入统计

### 客房管理模块
- **房态管理**：实时房态图、房间状态批量更新
- **维修管理**：维修申请、进度跟踪、维修记录查询
- **清洁管理**：清洁任务分配、清洁质量检查
- **库存管理**：消耗品库存管理、入库出库操作

### 客户关系管理模块
- **客户档案**：客户注册、信息更新、会员管理
- **客户历史**：入住记录、消费统计、偏好管理
- **会员管理**：会员等级、积分管理

### 财务与报表模块
- **日常报表**：营业日报、入住率报表、平均房价报表
- **财务对账**：夜审功能、渠道对账、应收应付管理
- **财务报表**：预算管理、现金流管理

### 系统设置模块
- **基础数据**：房型管理、价格策略、渠道配置
- **权限管理**：角色配置、菜单权限、员工管理
- **系统集成**：公安系统对接、门锁系统、OTA平台同步

## 项目结构

```
hotelmanager/
├── docs/                    # 项目文档
│   ├── DEPLOYMENT_GUIDE.md  # 部署指南
│   ├── FRONTEND_API.md      # 前端API文档
│   ├── JDK21_SETUP_GUIDE.md # JDK 21配置指南
│   ├── MEITUAN_*.md         # 美团对接文档
│   └── STRUCTURE.md         # 项目结构说明
├── frontend/                # 前端项目
│   ├── src/                 # 源代码
│   ├── dist/                # 构建产物
│   ├── Dockerfile           # Docker配置
│   └── README.md           # 前端说明
└── [后端项目]               # Java后端代码
```

## 快速开始

### 环境要求

**后端：**
- JDK 21
- MySQL 8.0+
- Maven 3.8+

**前端：**
- Node.js 18+
- npm 或 yarn

### 后端部署

1. **配置数据库连接**
   
   修改 `application.properties` 中的数据库配置：
   ```properties
   spring.datasource.url=jdbc:mysql://localhost:3306/hotel
   spring.datasource.username=root
   spring.datasource.password=your_password
   ```

2. **构建项目**
   ```bash
   mvn clean package -DskipTests
   ```

3. **启动服务**
   ```bash
   java -jar target/hotel_backend-1.0.0.jar
   ```

### 前端部署

1. **安装依赖**
   ```bash
   cd frontend
   npm install
   ```

2. **开发模式**
   ```bash
   npm run dev
   ```

3. **生产构建**
   ```bash
   npm run build
   ```

4. **部署静态文件**
   
   将 `dist/` 目录下的文件部署到 Nginx 或其他 Web 服务器。

## 默认登录账号

- **管理员**：admin / admin123
- **前台**：frontdesk / front123

## API 接口

系统提供完整的RESTful API，支持以下主要功能：

| 模块 | 主要接口 |
|------|----------|
| 预订管理 | 创建订单、查询订单、取消预订 |
| 入住管理 | 办理入住、团队入住、快速入住 |
| 退房管理 | 退房结算、发票开具 |
| 房态管理 | 查询房态、更新状态 |
| 客户管理 | 客户CRUD、会员管理 |
| 报表管理 | 营业日报、财务报表 |

详细API文档见 `docs/FRONTEND_API.md`

## 第三方集成

### 美团酒店信息同步
支持与美团OTA平台对接，实现酒店信息同步、房态同步、订单同步等功能。详细说明见：
- `docs/MEITUAN_HOTEL_INFO_SYNC_GUIDE.md`
- `docs/MEITUAN_QUICK_REFERENCE.md`

### 公安系统对接
支持旅客身份信息实时上传，满足公安旅店业治安管理要求。

### 身份证读卡器
支持二代身份证读卡器硬件对接，快速获取旅客身份信息。

## 部署方案

### 方案一：Nginx 部署（推荐）

1. 安装 Nginx
2. 配置静态文件目录
3. 配置API代理
4. 启动服务

详见 `docs/DEPLOYMENT_GUIDE.md`

### 方案二：Docker 部署

前端提供了 Dockerfile，支持容器化部署：

```bash
cd frontend
docker build -t hotel-frontend .
docker run -d -p 80:80 hotel-frontend
```

## 性能优化

### 后端优化
- JVM 参数调优
- 数据库连接池配置
- 启用虚拟线程（ JDK 21）

### 前端优化
- 静态资源缓存
- API 请求合并
- 图片懒加载

详见 `docs/TECH_ARCHITECTURE.md`

## 常见问题

**Q: 后端启动失败？**
A: 检查JDK版本是否为21，检查数据库连接配置是否正确。

**Q: 前端无法访问后端API？**
A: 检查Nginx配置是否正确代理到后端服务，检查跨域配置。

**Q: 美团同步接口返回401错误？**
A: 检查AppKey和SecretKey配置是否正确，详见美团对接文档。

## 文档目录

- 📋 [部署指南](./docs/DEPLOYMENT_GUIDE.md)
- 📊 [财务报表模块](./docs/FINANCE_MODULE.md)
- 🔧 [JDK 21配置指南](./docs/JDK21_SETUP_GUIDE.md)
- 🏨 [美团对接文档](./docs/MEITUAN_HOTEL_INFO_SYNC_GUIDE.md)
- 📐 [技术架构](./docs/TECH_ARCHITECTURE.md)
- 📁 [项目结构](./docs/STRUCTURE.md)

## License

本项目仅供学习参考使用。