Homestay3

民宿预订平台 (Homestay Booking Platform)

License Version

项目简介

民宿预订平台是一个连接房东与旅客的综合性服务系统，致力于为旅客提供多样化的民宿选择，同时为房东提供高效的房源管理工具。系统包含三个主要部分：面向用户的前端界面、面向房东与管理员的后台管理系统，以及支撑整体业务的服务器端 API，构建了从房源发布、在线预订到服务评价的完整业务闭环。

技术栈前端

后端

项目结构

homestay3/
├── homestay-front/       # 用户前端
├── homestay-admin/       # 房东与管理员前端
└── homestay-backend/     # 后端服务API

核心功能模块

用户认证与权限管理
- 基于 JWT 的身份验证与授权
- 用户注册与邮箱验证
- 多角色权限控制 (普通用户、房东、管理员)
- 密码重置与修改
房源管理模块
- 房源创建与编辑
- 多维度房源信息维护 (基本信息、价格日历、设施配置、地理位置)
- 房源状态管理 (上架、下架、审核中)
- 丰富的查询筛选机制 (地点、价格、房型、设施、可用日期等)
- 房源类型与设施分类管理
订单管理模块
- 完整的订单生命周期管理
- 多状态订单处理 (待付款、已确认、已入住、已完成、已取消等)
- 智能订单冲突检测
- 退款与取消政策实现
- 订单统计与导出
评价系统模块
- 多维度评分机制
- 用户评价与房东回复
- 评价管理与筛选
- 评价分析与展示
通知系统
- 系统通知与用户消息
- 实时通知提醒
- 消息状态管理 (已读/未读)
- 通知类型分类与筛选
支付集成
- 支付处理与订单确认
- 退款流程处理
- 交易记录与财务管理

技术特点

安装与使用前端环境要求

后端环境要求

设置与运行

1. 克隆仓库

git clone https://github.com/yourusername/homestay3.git
cd homestay3

2. 前端设置

# 用户前端
cd homestay-front
npm install
npm run dev

# 房东管理前端
cd ../homestay-admin
npm install
npm run dev

3. 后端设置

cd ../homestay-backend
mvn clean install
mvn spring-boot:run

4. 数据库设置

开发指南代码规范

分支管理

贡献指南

许可证

本项目采用 MIT 许可证 - 详情请参阅LICENSE文件

Author