# hotel **Repository Path**: GRH8/hotel ## Basic Information - **Project Name**: hotel - **Description**: Java + Vue3 做了一个可落地的酒店管理系统(HMS),支持多门店、RBAC、财务结算,源码开源 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-04-25 - **Last Updated**: 2026-05-25 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 酒店管理系统(HMS) 面向酒店前台、门店经理、管理员的多门店运营系统,覆盖房间、订单、客户、财务、门店、员工管理全流程。 ## 编码与环境 - 全项目源码、SQL、文档统一使用 **UTF-8(无 BOM)** - 推荐数据库字符集:`utf8mb4`,排序规则:`utf8mb4_unicode_ci` - 后端基于 **Java 8** + Spring Boot 2.7 ## 技术栈 - 后端:Spring Boot 2.7、Spring Security、JWT、JPA、Flyway、Redis、MySQL - 前端:Vue3、Vite、Element Plus、Pinia、Axios、ECharts - 基础设施:Docker Compose、Nginx ## 当前功能清单 - 多门店数据隔离(`branch`)+ RBAC 菜单/接口权限控制 - 房间中心:多条件筛选(楼层/门店/状态可多选)、实时房间详情、清洁/维修完成确认 - 订单中心:快速开房 1 秒入住、入住/退房、取消、改期、中文状态展示 - 客户中心:搜索、门店多选筛选、客户增删改查、历史订单 - 财务中心:多订单收款(下拉多选自动汇总金额)、收款流水详情、中文支付方式/状态 - 门店中心:门店维护、依赖检查、门店详情统计 - 员工中心:管理员/门店经理维护员工,支持账号启用禁用 - 统一异常响应、页眉错误提示、幂等防重、审计日志、登录失败保护、Actuator 健康检查 ## 角色与默认账号 - 管理员:`admin / 123456` - 门店经理:`manager / 123456` - 前台:`frontdesk / 123456` 说明: - 前台登录后默认跳转到 `房间中心` - 员工中心新增账号默认密码为 `12345678` ## 本地开发启动 ### 后端 ```bash cd backend mvn spring-boot:run ``` ### 前端 ```bash cd frontend npm install npm run dev ``` ## Docker Compose 启动 ```bash docker compose up -d --build ``` 访问地址: - 网关: - 前端直连: - 后端: - 健康检查: ## 核心接口(节选) - 认证:`POST /api/auth/login` - 房间: - `GET /api/rooms` - `GET /api/rooms/available` - `GET /api/rooms/{id}/live` - `PUT /api/rooms/{id}/status` - 订单: - `POST /api/orders` - `GET /api/orders` - `POST /api/orders/{id}/cancel` - `POST /api/orders/reschedule` - 入住退房: - `POST /api/checkin`(需 `Idempotency-Key`) - `POST /api/checkout`(需 `Idempotency-Key`) - 客户: - `GET /api/customers` - `GET /api/customers/{id}/orders` - `POST /api/customers` - `PUT /api/customers/{id}` - `DELETE /api/customers/{id}` - 财务: - `GET /api/finance/orders` - `POST /api/finance/collect`(需 `Idempotency-Key`) - `GET /api/finance/payments` - `GET /api/finance/payments/{id}` - `GET /api/finance/summary` - 员工: - `GET /api/users` - `POST /api/users` - `PUT /api/users/{id}` - `DELETE /api/users/{id}` ## 文档 - 系统设计文档:`系统设计文档.md`