收藏点赞不迷路 关注作者有好处
文末获取源码
项目编号：BS-XX-166
一，项目简介
随着我国经济发展水平的迅速提高，酒店行业作为服务行业出的重要组成部分，已经越来越显示出其强劲的发展势头。纵观国内外酒店业信息化发展轨迹和趋势，我们不难看出，随着洒店业竞争的加剧，酒店之间客源的争夺越来越激烈，客房销售的利润空间越来越小，酒店需要使用更有效的信息化手段，拓展经营空间，降低运营成本，提高管理和决策效率。而经济型酒店通过信息化管理提高收益的需求更加突出。尤其是在疫情的影响下，酒店之间的竞争更加激烈，而线上预定能够使中小型酒店在同类型酒店更具竞争。
本系统分为前台、后台两部分。前台用户需要通过手机短信验证，进行注册后，再通过手机号、密码进行登录。未登录时，可以看到展示的酒店信息，包括酒店环境、客房展示图；登陆前台后，用户可以进行客房预定，预定后进行订单支付、订单查询，还可以点击右上角查看用户中心，在用户中心，用户可以修改头像、密码等信息。后台用户分为两种角色：酒店员工与酒店管理员。员工可以进行房间信息的管理，例如添加新的房间、修改房间状态、房间信息批量导入等，也可以进行房客登记、退房、查看订单等操作。前台系统功能图如图3-1所示吗，后台系统功能图如图3-2所示。
图3-1 前台系统功能图
图3-2 后台系统功能图
二，环境介绍
语言环境：Java: jdk1.8
数据库：Mysql: mysql5.7
应用服务器：Tomcat: tomcat8.5.31
开发工具：IDEA或eclipse
后台开发技术：Mybatis-plus持久层框架处理数据+SpringBoot整合依赖；
前端页面开发技术：Vue+ElementUI
三，系统展示
5.1 前台用户登录注册模块
5.1.1 注册
用户在浏览器进入注册界面，按照提示输入用户名、密码、手机号后，发起短信验证。这个过程，前台会判断输入是否为空、以及两次密码输入是否一致。用户接收到短信验证码后，输入验证码，点击注册，向后台注册接口/register发起请求。后台接收到数据后，进行验证码验证，通过验证后再查询手机号是否已经注册。如果都通过，则注册成功，页面跳转至登陆界面。界面实现效果如图5-1所示。
图5-1 注册界面
5.1.2 登录
用户在注册完毕后，进入酒店登陆界面。输入自己的注册所用的手机号、密码，以及程序生成的验证码，点击登录按钮。前端先验证验证码是否正确，确定正确之后，向后台接口地址/lo/login发起ajax请求，后台验证手机号是否存在，手机号对应密码是否正确。手机号、密码验证正确后，登陆成功，反之失败。
界面实现效果如图5-2所示。
图5-2 登录界面
5.2.1 查看用户信息
用户进行登录后，点击右上角用户名出现的下拉框内中户中心选项，进入用户中心界面。在这个界面，用户可以查看到用户名、性别、头像等信息。界面实现效果如图5-3所示。
图5-3 查看用户信息界面
5.2.2 修改用户信息
在用户中心界面，用户可以对自己的用户名、性别、头像等信息进行修改。点击资料框中的头像，弹出文件选择框，选择图片文件，上传到阿里云oss文件存储服务器，返回一个图片地址。点击更改资料后，前端向后端发起请求前判断用户名是否为空，非空就继续发起请求。后端将数据库数据更改后，返回成功码，前端接受修改成功信息，弹出提示框，刷新页面。界面实现效果如图5-4所示。
图5-4 修改用户信息界面
用户查看客房类型详细信息时，可在此页面填写入住日期、退房日期、姓名、预留手机号等预定信息。点击预定，前端对信息进行非空判定，如果为空则无法向后端发起请求。通过判定后，向/createOrder接口发起请求，生成预定订单。
界面实现效果如图5-5所示。
图5-5 预定客房界面
用户在点击预定后，进入订单核对页面，核对后点击支付订单，进行支付宝沙箱支付。扫码或登录支付宝沙箱账号支付成功后，发起异步通知，修改数据库订单状态，页面跳至成功支付界面。界面实现效果如图5-6所示。
图5-6 预定客房界面
进入订单列表，页面查询所有订单，分页展示。后台用户可以在搜索条件框中输入想要查询的条件，店家查询按钮进行条件分页查询。后端收到查询请求，对数据库查询数据，得到数据后，返回给前端，前端进行数据展示。界面实现效果如图5-7所示。
图5-7 订单查询界面
在订单列表，后台用户点击不同的操作按钮，可以对订单进行不同的操作。对于已经支付完成的订单，点击退款操作按钮，输入小于房费的金额，发起退款请求，退款成功后，修改订单状态为已退款。对于待支付的订单，点击关闭操作按钮，将订单状态改为已取消。对于任意订单记录点击删除，可以将选中记录逻辑删除。点击修改按钮，可以修改订单中的房费信息。退款界面实现效果如图5-8所示；关闭界面实现效果如图5-9所示；
图5-8 订单退款界面
图5-9 订单关闭界面
后台用户点击入住信息，分页查看入住信息列表。在此页面的条件搜索框中输入条件信息，点击查询按钮，进行条件分页查询。界面实现效果如图5-10所示。
图5-10 查询入住信息界面
后台用户点击新增用户，跳转至入住信息新增界面。用户在此输入房客登记的信息，点击保存，即可将此条入住信息传至后端，由后端程序将数据插入数据库保存。界面实现效果如图5-11所示。
当入住一间房的房客大于一人时，在添加一条入住记录后，后台用户可以点击添加随客按钮，为此条入住记录添加随客记录。输入随客信息，视入住人数情况，选择保存或是保存并再次添加，将数据通过后端代码插入数据库。界面实现效果如图5-12所示。
图5-12 添加随客信息界面
后台用户在进入房间添加界面，可以填写房间信息，如房间号、房间类型、备注信息等。点击保存，将数据传输到后端，保存至数据库。界面实现效果如图5-13所示。
图5-13 房间信息添加界面
在进入房间信息导入界面后，后台用户可以点击下载模板，查看模板，然后编写一份与模板格式相同的excel文件，选取该文件，提交。后端程序将读取文件内容，将数据库不存在的房间信息存入。界面实现效果如图5-14所示。
图5-14 房间信息导入界面
四，核心代码展示
package com.tsx.boot.controller;
import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.tsx.boot.entity.Admin;
import com.tsx.boot.entity.query.adminQuery;
import com.tsx.boot.entity.vo.admin.adminVo;
import com.tsx.boot.service.AdminService;
import com.tsx.boot.utils.R;
import io.swagger.annotations.ApiOperation;
import org.junit.jupiter.api.DynamicTest;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.util.StringUtils;
import org.springframework.web.bind.annotation.*;
import javax.servlet.http.Cookie;
import javax.servlet.http.HttpServletRequest;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
/**
* <p>
* 前端控制器
* </p>
*
* @author testjava
* @since 2022-07-21
*/
@RestController
@RequestMapping("/admin")
@CrossOrigin
public class AdminController {
@Autowired
private AdminService adminService;
@DeleteMapping("/delete/{id}")//通过路径传id值(逻辑删除需要在实体类的逻辑删除的成员属性上加注解@TableLogic)
//效果：在字段上加上这个注解再执行BaseMapper的删除方法时，删除方法就会变成修改
public R removeAdmin(@PathVariable String id){
boolean flag = adminService.removeById(id);
if(flag){
return R.ok();
}
else {
return R.error();
}
}
//修改
@PostMapping("/updateAdmin")
public R updateAdmin(@RequestBody Admin admin){
boolean flag = adminService.updateById(admin);
if(flag){
return R.ok();
}else {
return R.error();
}
}
//添加方法
@PostMapping("/addAdmin")
public R addMember(@RequestBody Admin admin){
boolean flag=adminService.save(admin);
if(flag){
return R.ok();
}else {
return R.error();
}
}
//根据id获取信息，用于回显修改
@GetMapping("/getInfo/{id}")
public R getInfoById(@PathVariable String id){
QueryWrapper<Admin> wrapper=new QueryWrapper<>();
wrapper.eq("id",id);
Admin admin = adminService.getOne(wrapper);
return R.ok().data("admin",admin);
}
//登陆
@PostMapping("/login")
public R login(@RequestBody adminVo adminVo){
Admin admin = adminService.login(adminVo);
if(admin != null){
return R.ok().data("token",admin.getId());
}else {
return R.error();
}
}
//退出登录
@PostMapping("/logout")
public R logout(){
return R.ok();
}
@GetMapping("/info/{id}")
public R info(@PathVariable String id){
List<String> list=new ArrayList<>();
QueryWrapper<Admin> wrapper=new QueryWrapper<>();
wrapper.eq("id",id);
Admin admin=adminService.getOne(wrapper);
if(admin.getStatus()==1){
list.add("admin");
}else {
list.add("staff");
}
return R.ok().data("roles",list).data("name",admin.getName()).data("avatar","https://wpimg.wallstcn.com/f778738c-e4f8-4870-b634-56703b4acafe.gif");
}
//分页查询后台用户
@ApiOperation(value = "用户分页查询")
@PostMapping("/pageAdmin/{current}/{limit}")//当前页与每页数目
public R pageListTeacher(@PathVariable long current,
@PathVariable long limit,
@RequestBody(required = false) adminQuery adminQuery){
Page<Admin> pageAdmin = new Page<>(current, limit);
//构建条件
QueryWrapper<Admin> wrapper=new QueryWrapper<>();
//wrapper.
String name = adminQuery.getName();
Integer status = adminQuery.getStatus();
String begin = adminQuery.getBegin();
String end = adminQuery.getEnd();
if(!StringUtils.isEmpty(name)){
wrapper.like("name",name);
}
if(!StringUtils.isEmpty(status)){
wrapper.eq("status",status);
}
if(!StringUtils.isEmpty(begin)){
wrapper.ge("create_time",begin);//大于表中起始时间字段
}
if(!StringUtils.isEmpty(end)){
wrapper.le("update_time",end);//小于表中起始时间字段
}
//排序
wrapper.orderByDesc("update_time");
//实现条件分页查询
adminService.page(pageAdmin,wrapper);
long total=pageAdmin.getTotal();
List<Admin> records=pageAdmin.getRecords();
return R.ok().data("total",total).data("rows",records);
}
}
package com.tsx.boot.controller;
import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.tsx.boot.entity.Checkin;
import com.tsx.boot.entity.other.Pie;
import com.tsx.boot.service.CheckinService;
import com.tsx.boot.utils.R;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.CrossOrigin;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.ArrayList;
import java.util.Date;
import java.util.List;
@RestController
@RequestMapping("/charts")
@CrossOrigin
public class ChartController {
@Autowired
private CheckinService checkinService;
@GetMapping("/getWeekIncome")
public R getWeekIncome() throws ParseException {
List<Float> list=checkinService.countWeekIncount();
List<String> timeList=checkinService.getTimeWeek();
return R.ok().data("list",list).data("times",timeList);
}
/*
获取当月的不同房型入住情况
*/
@GetMapping("/getMonthType")
public R getMonthType(){
//获取所有房型集合
List<String> types =checkinService.countype();
//获取不同房型在当月的入住次数
List<Integer> Typelist=checkinService.countMonthTypeNum(types);
//封装成图标需要的数据形式
List<Pie> list=new ArrayList<>();
for(int i=0;i<types.size();i++){
Pie pie=new Pie();
pie.setName(types.get(i));
pie.setValue(Typelist.get(i));
list.add(pie);
}
return R.ok().data("list",list).data("types",types);
}
/*
计算今日收入
*/
@GetMapping("/getToDayMoney")
public R getToDayMoney(){
Date date=new Date();
SimpleDateFormat formatter = new SimpleDateFormat("yyyy-MM-dd");
SimpleDateFormat formatter1 = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
String day=formatter.format(date);
String day_start=day+" 00:00:00";
String day_end=day+" 23:59:59";
System.out.println(day_start);
QueryWrapper<Checkin> wrapper=new QueryWrapper<>();
wrapper.select("sum(money) as sumAll");
try{
wrapper.ge("create_time",formatter1.parse(day_start));
wrapper.le("create_time",formatter1.parse(day_end));
Checkin checkin=checkinService.getOne(wrapper);
System.out.println(checkin.getSumAll());
}catch (Exception e){
e.printStackTrace();
return R.error();
}
return R.ok();
}
}
package com.tsx.boot.controller;
import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.baomidou.mybatisplus.core.conditions.update.UpdateWrapper;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.tsx.boot.entity.*;
import com.tsx.boot.entity.query.checkQuery;
import com.tsx.boot.service.CheckinService;
import com.tsx.boot.service.ChecksService;
import com.tsx.boot.service.RoomService;
import com.tsx.boot.service.RoomtypeService;
import com.tsx.boot.utils.R;
import io.swagger.annotations.ApiOperation;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.util.StringUtils;
import org.springframework.web.bind.annotation.*;
import javax.ws.rs.Path;
import java.math.BigDecimal;
import java.nio.file.Watchable;
import java.util.Date;
import java.util.List;
/**
* <p>
* 前端控制器
* </p>
*
* @author testjava
* @since 2022-07-27
*/
@RestController
@RequestMapping("/check")
@CrossOrigin
public class CheckinController {
@Autowired
private CheckinService checkService;
@Autowired
private ChecksService checksService;
@Autowired
private RoomService roomService;
@Autowired
private RoomtypeService roomtypeService;
/*
退房功能，当点击退房按钮，根据主客的入住记录id，将主客、从客入住状态转为已退房
再将房间状态转换为空闲
*/
@PostMapping("/checkOut/{id}")
public R checkOut(@PathVariable String id){
//根据id，将主客、从客入住状态转换为退房
UpdateWrapper<Checkin> wrapper1=new UpdateWrapper<>();
wrapper1.eq("id",id);
wrapper1.set("state",0);
checkService.update(null,wrapper1);
UpdateWrapper<Checks> wrapper2=new UpdateWrapper<>();
wrapper2.eq("zid",id);
wrapper2.set("state",0);
checksService.update(null,wrapper2);
//将房间状态转换为空闲 先获取房间号，再将房间状态改为空闲
QueryWrapper<Checkin> queryWrapper=new QueryWrapper<>();
queryWrapper.eq("id",id);
Checkin checkin=checkService.getOne(queryWrapper);
UpdateWrapper<Room> wrapper=new UpdateWrapper<>();
wrapper.eq("id",checkin.getRoomId());
wrapper.set("state",1);
roomService.update(null,wrapper);
return R.ok().message("退房成功！");
}
/*
通过房号查到房费
*/
@GetMapping("/calculate/{roomId}")
public R calculate(@PathVariable String roomId){
QueryWrapper<Room> wrapper1=new QueryWrapper<>();
wrapper1.eq("id",roomId);
Room room = roomService.getOne(wrapper1);
if(null==room){
return R.error().message("房间号不存在！");
}
BigDecimal fee= roomService.getFeebyRoomId(roomId);
return R.ok().data("money",fee);
}
/*
通过id查询入住信息
*/
@GetMapping("/getCheckInfoById/{id}")
public R getCheckInfoById(@PathVariable String id){
QueryWrapper<Checkin> wrapper=new QueryWrapper<>();
wrapper.eq("id",id);
Checkin checkin = checkService.getOne(wrapper);
return R.ok().data("check",checkin);
}
/*
逻辑删除入住信息(逻辑删除需要在实体类的逻辑删除的成员属性上加注解@TableLogic
在isDelete字段上加上这个注解再执行BaseMapper的删除方法时，删除方法就会变成修改)
通过传id值，逻辑删除入住信息
*/
@DeleteMapping("/deleteCheck/{id}")
public R removeCheck(@PathVariable String id){
// 房间状态改为1,再删除
roomService.updateRoomState(id);
boolean flag = checkService.removeById(id);
if(flag){
//修改该类型剩余房间数量
roomtypeService.updateAllSTypeNum();
return R.ok();
}
else {
return R.error();
}
}
/*
修改入住信息
*/
@PostMapping("/updateCheck")
public R updateCheck(@RequestBody Checkin checkin){
boolean flag = checkService.updateById(checkin);
if(flag){
//修改该类型剩余房间数量
roomtypeService.updateAllSTypeNum();
return R.ok();
}else {
return R.error();
}
}
//退房 需要修改房间状态、入住状态，剩余空闲房间数量
@PostMapping("/tRoom")
public R TRoom(@PathVariable String id){
//修改入住状态为退房
UpdateWrapper<Checkin> wrapper=new UpdateWrapper<>();
wrapper.eq("id",id);
wrapper.set("state",2);
boolean flag = checkService.update(wrapper);
if(flag){
// 删除后，房间状态改为1
roomService.updateRoomState(id);
return R.ok();
}else {
return R.error();
}
}
//添加方法
@PostMapping("/addCheck")
public R addCheck(@RequestBody Checkin checkin){
//入住状态初始为：1 表示入住中
checkin.setState(1);
//查出房间信息、判断该记录的房间状态是否为1（空闲状态）
QueryWrapper<Room> wrapper1=new QueryWrapper<>();
wrapper1.eq("id",checkin.getRoomId());
Room room = roomService.getOne(wrapper1);
if(null==room){
return R.error();
}
int state=room.getState();
//初始化入住记录的类型名
checkin.setTypeName(room.getTypeName());
boolean flag;
//如果该房间状态为1（空闲），才能够入住
if(state==1){
flag=checkService.save(checkin);
}else {
return R.error();
}
//新增
if(flag){
//添加入住记录，将该房间的状态修改为已经入住
UpdateWrapper<Room> wrapper=new UpdateWrapper<>();
wrapper.eq("id",checkin.getRoomId());
wrapper.set("state",2);
roomService.update(wrapper);
//修改该类型剩余房间数量
roomtypeService.updateAllSTypeNum();
return R.ok();
}else {
return R.error();
}
}
/*
* 分页条件查询入住信息
*/
@ApiOperation(value = "入住信息分页查询")
@PostMapping("/pageCheck/{current}/{limit}")//当前页与每页数目
public R pageListTeacher(@PathVariable long current,
@PathVariable long limit,
@RequestBody(required = false) checkQuery checkQuery){
System.out.println(checkQuery);
Page<Checkin> pageRoom = new Page<>(current, limit);
//构建条件
QueryWrapper<Checkin> wrapper=new QueryWrapper<>();
//wrapper.
String roomId = checkQuery.getRoomId();
List<Date> dates = checkQuery.getDates();
String name = checkQuery.getName();
String idNumber=checkQuery.getIdNumber();
Integer state=checkQuery.getState();
if(!StringUtils.isEmpty(roomId)){
wrapper.eq("room_id",roomId);
}
if(!StringUtils.isEmpty(name)){
wrapper.like("name",name);
}
if(!StringUtils.isEmpty(idNumber)){
wrapper.like("id_number",idNumber);
}
if(!StringUtils.isEmpty(state)){
wrapper.eq("state",state);
}
if(!StringUtils.isEmpty(dates)){
//前端日期传到后端出了问题，在此进行处理。将日期左右边界都加1
long time1 = dates.get(0).getTime();
long time2 = dates.get(1).getTime();
Date DateStart = new Date();
Date DateEnd = new Date();
DateStart.setTime(time1 + 1000*60*60*10);
DateEnd.setTime(time2 + 1000*60*60*34-1000);
wrapper.between("create_time",new Date(DateStart.toString()),new Date(DateEnd.toString()));
}
//排序
wrapper.orderByDesc("create_time");
//实现条件分页查询
checkService.page(pageRoom,wrapper);
long total=pageRoom.getTotal();
List<Checkin> records=pageRoom.getRecords();
return R.ok().data("total",total).data("rows",records);
}
}
五，项目总结
本系统分为前台与后台。前台采用Springboot+js、Jquery等技术实现了酒店信息展示、客房信息展示、客房预定、提交建议、用户中心等功能。后台采用Springboot+Vue实现了用户管理、房间管理、入住信息管理、订单管理、图表展示等诸多功能。数据存储使用的是MySQL。
因为使用的Springboot作为后端开发框架，简化了原本SSM框架的繁琐配置，让开发周期大大缩短。持久层框架采用MyBatisPlus这一Mybatis的增强工具，使SQL编写量大大减少。甚至可以在完成数据库表的创建后，使用代码生成器，将Controller、Mapper、Service等文件创建好。
在设计与实现的过程中，遇到了许多因为对业务没有接触过而产生的问题。例如订单数据库设计、预定流程等问题。还有因为技术选型的纠结，因为对Vue技术的不熟练，最终决定前台的实现不采用前后端分离。最后都通过百度查询资料，或与同学讨论勉强解决。系统至此实现了中小型酒店管理所需功能。
但此系统仍不可避免的有许多不足之处可以改进，例如比起电脑端的预定，大家更常用的是手机端小程序、app端上定房。还有就是，后台系统应当有一个能够看到后台用户的操作记录的日志模块。比起市面上已经完善的酒店系统，本系统还是有许多可以改进的地方，接下来若是有机会，也会不断参照，改进。
1万+
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
