用户在浏览器进入注册界面，按照提示输入用户名、密码、手机号后，发起短信验证。这个过程，前台会判断输入是否为空、以及两次密码输入是否一致。用户接收到短信验证码后，输入验证码，点击注册，向后台注册接口/register发起请求。后台接收到数据后，进行验证码验证，通过验证后再查询手机号是否已经注册。如果都通过，则注册成功，页面跳转至登陆界面。界面实现效果如图5-1所示。

图5-1  注册界面

用户在注册完毕后，进入酒店登陆界面。输入自己的注册所用的手机号、密码，以及程序生成的验证码，点击登录按钮。前端先验证验证码是否正确，确定正确之后，向后台接口地址/lo/login发起ajax请求，后台验证手机号是否存在，手机号对应密码是否正确。手机号、密码验证正确后，登陆成功，反之失败。

界面实现效果如图5-2所示。

图5-2  登录界面

用户进行登录后，点击右上角用户名出现的下拉框内中户中心选项，进入用户中心界面。在这个界面，用户可以查看到用户名、性别、头像等信息。界面实现效果如图5-3所示。

 图5-3  查看用户信息界面

在用户中心界面，用户可以对自己的用户名、性别、头像等信息进行修改。点击资料框中的头像，弹出文件选择框，选择图片文件，上传到阿里云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端上定房。还有就是，后台系统应当有一个能够看到后台用户的操作记录的日志模块。比起市面上已经完善的酒店系统，本系统还是有许多可以改进的地方，接下来若是有机会，也会不断参照，改进。