乐于分享
好东西不私藏
夜雨聆风 > > 办公文件 > 源码专题-java0167-基于Spring Boot民宿房源一体化管理平台

源码专题-java0167-基于Spring Boot民宿房源一体化管理平台

当前时间： 2026-08-17 18:11:57 分类：办公文件 评论(0)
源码专题-java0167-基于Spring Boot民宿房源一体化管理平台

民宿房源一体化管理平台

    面向房东与房客的一体化民宿预订与运营管理平台，打通 Web 管理端、Web 客户端与微信小程序，覆盖找房、预订、支付、入住履约与经营分析全链路。

一、项目概述

本项目是一套**民宿房源一体化管理平台**，围绕“房东管房、房客订房”核心场景，实现多端协同：
  • 房东端：房源运营、订单履约、客户档案、营收分析
  • 房客端（Web）：找房浏览、在线预订、订单与支付
  • 房客端（微信小程序）：移动找房、地图定位、下单支付
平台以真实业务状态流转为驱动，将房源上架、日期冲突校验、支付确认、入住退房与自动建档串联成闭环，突出**可运营、可履约、可分析**三大价值。

二、技术栈

后端技术

| 技术 | 说明 |
|------|------|
| **Java 17** | 现代 LTS 语言基础 |
| **Spring Boot 3.2.5** | 后端主框架，提供 Web / 校验 / 测试能力 |
| **Spring Security** | 无状态安全体系，统一鉴权与访问控制 |
| **JWT（jjwt 0.12.5）** | 登录态 Token 鉴权，Claims 携带 userId / username / role |
| **MyBatis-Plus 3.5.5** | ORM 与分页插件，逻辑删除、自动填充时间字段 |
| **MySQL** | 业务数据持久化（用户、房源、订单、客户档案、房源图） |
| **BCrypt** | 密码加密存储 |
| **Knife4j / OpenAPI3** | 中文接口文档，便于联调与演示 |
| **Hutool** | 通用工具能力补充 |
| **Lombok** | 精简实体与样板代码 |

前端技术（房东管理端）

| 技术 | 说明 |
|------|------|
| **Vue 3 + Vite** | 现代化 SPA 构建 |
| **Element Plus** | 后台管理系统组件库 |
| **Pinia** | 用户登录态与全局状态 |
| **Vue Router** | 路由守卫与菜单导航 |
| **Axios** | 统一 HTTP 请求封装 |
| **ECharts** | 订单趋势、营收走势可视化 |

前端技术（房客 Web 端）

| 技术 | 说明 |
|------|------|
| **Vue 3 + Vite** | 客户端 SPA |
| **Vant 4 + Element Plus** | 兼顾移动端交互与桌面端展示 |
| **Pinia + Vue Router** | 登录态与预订流程路由控制 |
| **Axios** | API 调用 |

微信小程序端

| 技术 | 说明 |
|------|------|
| **微信原生小程序** | 首页 / 搜索 / 列表 / 详情 / 预订 / 订单 / 支付 / 个人中心 |
| **高德地图 API** | 定位、附近搜索与导航辅助 |
| **懒加载图片组件** | 优化列表与详情浏览体验 |
| **自定义导航栏 + TabBar** | 贴近主流短租 App 视觉风格 |

安全与工程能力

  • 无 Session 的 JWT 无状态鉴权
  • 接口白名单：登录注册、公开房源列表/详情、静态资源、API 文档
  • 上传文件类型校验（JPEG / PNG / GIF / WebP 魔数检测）
  • XSS 清洗与 HTML 转义工具
  • 参数校验、事务控制、逻辑删除

三、角色与核心功能

系统内置两类核心角色：
- **LANDLORD（房东）**
- **USER（房客 / 客户）**

1. 房东（LANDLORD）

房东是平台的**运营与履约主体**，主要能力如下。

1.1 工作台概览

  • 一屏查看房源总数、订单总数、总营收、本月营收
  • 查看上架房源、待处理订单、在住订单、入住率等经营指标
  • 通过图表观察订单趋势与营收走势，辅助日常决策

1.2 房源管理

  • 新增 / 编辑 / 删除房源
  • 维护标题、描述、省市区地址、房型、价格、可住人数、卧室与卫生间数量
  • 配置设施服务（WiFi、电梯、阳台、空调、热水器等）与入住须知
  • 上传封面图与多图相册
  • 一键上架 / 下架，控制前台曝光
  • 关键词检索自己的房源（标题 / 地址 / 城市）

1.3 订单履约管理

  • 分页查看收到的全部订单，按状态筛选
  • 对已支付订单执行确认预订
  • 对已确认订单执行办理入住
  • 对在住订单执行办理退房 / 完成
  • 支持取消未完成订单
  • 订单详情聚合房源名称、封面、用户信息，便于线下接待

1.4 客户档案管理

  • 维护客户姓名、手机号、身份证号、备注
  • 支持关键词检索与分页
  • 下单成功后可自动沉淀客户档案，减少重复录入
  • 支持手动新增与编辑，适合线下熟客管理

1.5 营收与经营统计

  • 总营收 / 本月营收统计
  • 订单趋势分析
  • 入住率与在住情况
  • 支持按时间范围查看经营数据，服务房东复盘

1.6 个人中心

  • 查看与修改资料
  • 修改登录密码
  • 维护头像、联系方式等信息

2. 房客（USER）

房客是平台的**消费与预订主体**，覆盖 Web 与微信小程序两端。

2.1 找房与浏览

  • 首页搜索、城市选择、热门目的地推荐
  • 按房型快捷筛选：整租公寓、别墅、民宿客栈、单间等
  • 列表支持价格区间、设施、城市、关键词筛选
  • 支持推荐 / 价格升序 / 价格降序等排序
  • 房源详情展示轮播图、房型信息、设施、入住须知、房东信息与底部预订入口

2.2 在线预订

  • 选择入住 / 退房日期、入住人数
  • 填写联系人、联系电话、备注
  • 自动计算入住晚数与总价
  • 下单前校验：
  • 房源是否上架
  • 入住人数是否超限
  • 日期是否冲突
  • 入住日期是否合法

2.3 支付与订单管理

  • 创建订单后进入待支付状态
  • 支持模拟支付（微信支付 / 支付宝 / mock）
  • 支付成功后进入“已支付待确认”
  • 按状态查看订单：待支付、待确认、已确认、已入住、已完成、已取消
  • 支持取消、支付、查看详情等操作

2.4 个人中心

  • 注册 / 登录
  • 查看会员信息与订单入口
  • 修改个人资料与密码
  • 小程序端提供更贴近移动场景的个人页与服务菜单

2.5 小程序特色能力

  • 高德定位与附近民宿搜索辅助
  • 地图选点、导航能力预留
  • 懒加载图片提升列表流畅度
  • 自定义导航与暖色卡片风 UI，贴近主流短租 App

四、核心业务亮点

亮点一：完整订单状态机，真正可落地履约

订单并非简单“下单即完成”，而是设计了清晰的 6 态流转：
| 状态码 | 状态 | 说明 |
|--------|------|------|
| 0 | 待支付 | 创建订单，等待用户付款 |
| 1 | 已支付 / 待确认 | 用户付款成功，等待房东确认 |
| 2 | 已确认 / 待入住 | 房东确认，等待客人到店 |
| 3 | 已入住 | 客人已办理入住 |
| 4 | 已完成 / 已退房 | 履约完成，可计入营收 |
| 5 | 已取消 | 用户或房东取消 |
并配合独立的支付状态（未支付 / 已支付），形成**预订—支付—确认—入住—退房**完整闭环。

亮点二：日期冲突自动拦截，避免超售

创建订单时会检查目标房源在所选入住区间是否已有有效占用订单。一旦冲突，系统拒绝下单并提示“所选日期已被预订”，有效降低超售与纠纷风险。

亮点三：支付后才进入履约，流程更真实

- 下单默认“待支付”
- 模拟支付成功后转为“已支付待确认”
- 房东只能按合法状态推进：确认 → 入住 → 完成
- 取消规则也有约束，避免随意破坏履约链路

亮点四：下单自动沉淀客户档案

用户成功下单后，系统会为对应房东自动创建客户档案（若尚未存在）。房东既能管理线上预订客户，也能补录线下熟客，实现**线上线下客户统一沉淀**。

亮点五：多端一体，同一套业务能力多场景触达

- 房东：专业 Web 管理后台（工作台 + 图表 + 业务台账）
- 房客 Web：适合桌面/浏览器快速浏览预订
- 房客小程序：适合移动场景找房、定位、下单支付
三端共用后端 API，保证数据一致、业务一致。

亮点六：经营数据可视化，不只是 CRUD

房东工作台与营收统计不只展示列表，还提供：
- 房源规模
- 订单规模
- 总营收 / 本月营收
- 待处理与在住情况
- 入住率
- ECharts 订单与营收趋势图
让系统具备**经营辅助**价值，而不只是信息登记工具。

亮点七：房源运营能力完善

房源支持：
- 多条件筛选与排序
- 上架下架控制曝光
- 多图展示
- 设施标签化配置
- 入住须知与容量限制
前台只展示上架房源，后台可灵活调控库存曝光。

亮点八：安全与体验细节扎实

- JWT + Spring Security 无状态鉴权
- BCrypt 密码加密
- 文件魔数校验，防止伪造图片上传
- XSS 清洗工具，降低脚本注入风险
- 逻辑删除保障数据可追溯
- Knife4j 中文文档提升联调效率
- 小程序懒加载、自定义导航、暖色视觉，提升 C 端体验

五、典型使用场景

场景 A：房东上新房源

房东登录管理端 → 录入房源信息与图片 → 配置价格与设施 → 上架 → 前台立即可见。

场景 B：房客找房下单

房客在 Web / 小程序搜索城市与房型 → 查看详情 → 选择日期人数 → 提交订单 → 模拟支付 → 等待房东确认。

场景 C：房东履约接待

房东在订单列表看到“已支付待确认” → 确认订单 → 客人到店办理入住 → 离店办理退房完成 → 营收与入住率自动更新。

场景 D：客户沉淀复购

新订单自动生成客户档案 → 房东补充备注与证件信息 → 后续可快速检索熟客，提高复购与服务效率。

六、项目总结

**民宿房源一体化管理平台**以双角色协同为核心，将房源运营、智能预订、支付确认、入住履约、客户沉淀与经营分析整合到同一平台。技术上采用 Spring Boot 3 + Vue 3 + 微信小程序的现代栈；业务上强调真实状态流转、防超售、自动建档与可视化经营，是一套兼顾**演示完整性**与**业务落地感**的民宿管理与预订系统。

代码获取

系统非商用，非开源，非无偿！，非无偿！，非无偿！

由本人开发，如需源码，请后台直接联系我并发项目编号，非无偿。

项目有很多，并未全部上传，如果未找到想要的，可直接咨询。源码非无偿！

软件定制及其他业务

文章有帮助的话，在看，转发吧。

谢谢支持哟 (*^__^*）