java酒店民宿钟点房预订小程序

1. 项目简介

酒店民宿项目全套开源系统是一套面向酒店、民宿、钟点房预订与到店核销的三端系统，内置 房源检索、在线预订、商家入驻、员工核销、会员优惠券，采用前后端分离架构，服务端、管理端、用户端全套代码开源。

服务端基于 Spring Boot 2.6.11（Java 8）与 MyBatis-Plus 构建，负责接口、数据库，以及短信、对象存储、支付、地图等外部能力。
管理端基于 Vue 3 + Element Plus + Vite 开发，供运营人员在电脑浏览器中维护酒店 / 民宿门店、房间、订单、会员、财务与系统设置。
用户端基于 uni-app（Vue 3） 开发，覆盖 H5 与微信小程序。住客可按城市与日期查找房源、预订入住；商家与员工可在同一套用户端里入驻开店、管理房间与到店核销。

2. 移动端界面预览

首页	房型列表	我的	登录

3. 开源说明

本项目采用 Apache 2.0 许可协议，源码供学习、技术研究、商业使用、二次开发与参考使用。
开源为生态，服务才是根基； 欢迎各位开发者一同交流。

4. 快速开始

建议顺序：先服务端，再管理端，最后用户端。 管理端和用户端都要等服务端已经启动，才能登录和加载数据。

说明： 仓库里不包含 node_modules（体积大、随系统生成）。克隆或下载后，在 jdms-admin 目录下必须先执行一次 npm install，再启动开发命令。用户端可用 HBuilderX 打开，也可用命令行运行 H5；若 uView 等组件样式异常，可在 jdms-uniapp 目录执行一次 npm install。详细步骤见下方与 docs 中的运行教程。

4.1 服务端

安装 JDK 8、Maven、MySQL 8。新建数据库 jdms，导入 jdms-server/db/jdms.sql。

本地开发时，将 jdms-server/sqx-application/src/main/resources/application.yml 中的 spring.profiles.active 改为 dev，并按本机环境修改 application-dev.yml 里的数据库账号密码（库名保持 jdms）。

在 jdms-server 目录执行 Maven 启动。默认 端口 9129，上下文路径 /sqx_fast。接口文档：http://127.0.0.1:9129/sqx_fast/doc.html（Knife4j）。

启动前请先开启本机 Redis（登录态与系统配置缓存会用到，默认 localhost:6379）。开发配置见 application-dev.yml 中的 redisson 段。

更完整的模块划分与接口约定见 服务端功能说明。

4.2 管理端

安装 Node.js 20+（见 jdms-admin/package.json 的 engines）。进入 jdms-admin 目录，首次运行前安装依赖并启动：

cd jdms-admin
npm install
npm run dev

npm install 会根据 package.json / package-lock.json 在本机生成 node_modules，只需在依赖变更或新克隆后执行。

开发站点默认端口 8888。请将接口地址指向本机服务端（http://127.0.0.1:9129，路径 /sqx_fast）。

演示管理端账号：admin / 123456（以库中数据为准）。

4.3 用户端

HBuilderX（推荐）： 打开 jdms-uniapp 目录，运行到浏览器或微信开发者工具。应用面向酒店民宿预订，底部三个入口：首页、订单、我的。

命令行 H5（若已配置对应脚本）：

cd jdms-uniapp
npm install

开发时请确认 jdms-uniapp/common/config.js 中的接口地址指向本机或已部署的服务端（线上演示为 https://jdms.xianmaxiong.com/sqx_fast）。

短信、微信、支付、对象存储、地图等密钥需自行申请，并在管理端相关配置页填写。

5. 文档

6. 目录结构

仓库根目录只放三端代码、说明和协议。编译出来的 target、dist、unpackage、node_modules 是运行时生成的，不需要改。

6.1 仓库根目录

6.2 服务端 jdms-server

6.3 管理端 jdms-admin

6.4 用户端 jdms-uniapp

界面组件使用 uView。住客订房、商家中心、员工核销均在用户端完成。

7. 核心特性与技术栈

7.1 核心特性

· 国内酒店、钟点房、民宿三类房源检索与预订
· 按城市 / 地标定位、入住离店日期、房型筛选与会员价
· 下单支付、优惠券抵扣、发票申请、到店二维码 / 条码核销
· 订单全流程：待支付、待核销、进行中、已完成、取消 / 售后
· 商家入驻审核、营业状态、房间上下架、员工管理
· 员工中心协助核销与退房
· 会员中心、钱包充值提现、邀请推广
· 管理端门店 / 房间 / 订单 / 财务 / 会员 / 系统配置
· 短信登录、微信登录、地图导航、在线客服

业务细节见 服务端功能说明 与 Knife4j doc.html。

版本以仓库里的配置文件为准。没写死版本号的，按上文快速开始安装对应大版本即可。

7.2 服务端

7.3 管理端

7.4 用户端