基于Spring Boot框架的在线导游预约系统

深藏阁楼爱情的钟 2023-09-29 12:41 13阅读 0赞

> 源码获取：私聊回复【SpringBoot、导游预约】获取  
> 更多选题参考：  
> [Java练手项目 & 个人学习等选题参考][Java_ _]

### 文章目录 ###

*  前言
 *  一、背景及意义
 *   *  1、编写目的
     *  2、项目背景
     *  3、程序描述
     *  4、主要系统功能（分角色介绍）
     *   *  游客功能
         *  导游功能
         *  管理员功能
 *  二、总体设计
 *   *  1、需求规定
     *  2、运行环境
     *  3、使用说明
     *   *  部分页面截图展示
         *  管理员模块
         *  导游模块
         *  游客模块
 *  三、部分代码展示

--------------------

# 前言 #

`提示：这里可以添加本文要记录的大概内容：`

因为一些导游的自私，为了蝇头小利而使游客处于尴尬境地。所以，想着玩的好，又想着少花钱，追求一个经济实惠的旅游。那么如何选择一个靠谱的导游是一个困难的问题。

--------------------

`提示：以下是本篇文章正文内容，下面案例可供参考`

# 一、背景及意义 #

## 1、编写目的 ##

本次项目设计目的是构建一个在线导游预约系统，主要完成游客在出门旅游时对导游的预定和对旅游类型的选择等操作。近年来，随着人们旅游活动日益增加，旅游产业的逐渐扩大，对于导游人员的需求量更是与日递增。旅游也成为了老百姓的所需。

导游服务是出门旅游活动中举足轻重的环节，人们外出旅游，是出于不同的动机，但究其本质旅游活动是为了满足人类精神需求，满足人们对自然美，艺术美，生活美的欣赏与享受。编写这样一个系统，符合人们旅游时选择导游所需，把优质的导游，不同类型的导游呈现在游客面前，让人们出行旅游省时省力。

实现旅游信息的交流和共享，为喜爱旅游的人们提供旅游经验的分享平台，带给用户不一样的分享体验，让用户畅游在平台为其构建的旅行空间之中

## 2、项目背景 ##

导游的存在源于为游客提供服务，解决出行问题的。站在一个游客角度来看，首先就得思考在接下来的旅游中，将会遇到什么问题，从而思索导游存在是否能够解决。

那么，以以往出行经验来看，游客在旅游时，常遇到的问题包括，去哪玩？去哪吃？去哪住？怎么去？去哪买？基本围绕的就是旅游的这几大要素形成的服务需求。而这六要素需求的解决对于大部分人来说，又是基于价格对比考虑的，即大部分的人面临着钱不多，心不小的尴尬境地。

既想着玩的好，又想着少花钱，追求一个经济实惠的旅游。那么如何选择一个靠谱的导游是一个困难的问题，现在导游水平参差不齐，乱收费，强行买卖，人们很难选择到一个优质，安心的导游，做此项目，把导游评分，全部导游，全部透明的显示在游客面前，无二次收费，给游客一次好的导游预约体验。

## 3、程序描述 ##

该程序段是以在线导游预约系统的登入页面设计，用于区分用户的身份，使用户以自己的身份（游客、导游或管理员）登入进该系统，登入页面不同，所执行的功能也不同。  
要求所有用户在使用本系统之前都必须通过自己的用户名和密码登入，才能进行操作，该子系统主要判断用户登入时用户名和密码的正确性。  
![在这里插入图片描述][2c5129dfa1ca4e5eb75f5853696db9a4.png]

## 4、主要系统功能（分角色介绍） ##

### 游客功能 ###

游客可以选择或者系统推荐当季热门、周边游、国内游、海外游等分类；

游客登陆后可以在导游预约中进行预约导游，对某个导游下订单的功能；

游客可以在订单中心查看订单，但不能进行任何操作；

游客可以对导游以及旅游景点进行留言评价；

游客可以查看自己的个人信息及对密码的修改；

### 导游功能 ###

导游除了可以浏览其他用户的游记，还可以上传自己的旅游照片、视频，分享旅游心得，推荐旅游路线等；

游客和导游均可以查看管理员发布的旅游资讯和旅游活动；

导游可以在订单中心查看订单，但不能进行任何操作；

导游可以查看并管理全部预约信息；

导游可以对游客的留言评价进行恢复；

导游可以查看自己个人信息及对密码的修改；

### 管理员功能 ###

管理员可以对导游及游客进行管理；

管理员对旅游分类进行管理；

管理员可以查看并管理全部预约信息；

管理员可管理导游及游客的留言评价并进行回复操作；

管理员可以查看自己个人信息及对密码的修改；

# 二、总体设计 #

## 1、需求规定 ##

每个用户都有自己的用户名和密码，这是区分用户身份的有效凭证，只有正确输入用户名和密码才能登入系统开始使用，并且要完善用户的个人信息要求正确，方便管理员进行管理。管理员离职后，账号将注销，不能使用。

## 2、运行环境 ##

包括开发软件、硬件环境，运行软件环境、硬件环境  
开发软件：idea  
操作系统：windows 10/11或者 Mac OS  
数据库：mysql-8.0.11-winx64、mysql-8.0.21-winx64版本及以上，越高越好  
开发环境： IntelliJ IDEA 2022.2.2、IntelliJ IDEA 2021.1.2 x64  
服务器：apache-tomcat-9.0.22 或 apache-tomcat-9.0.56、apache-maven-3.3.3 或 apache-maven-3.8.4  
浏览器：qq浏览器或 Win10自带浏览器或者其他浏览器都可以

`大部分配置都是越高越好，但难免有些新出版本不稳定，所以一定要选稳定的`

## 3、使用说明 ##

logout  
http://localhost:8181/login  
退出登录另一账户即可

### 部分页面截图展示 ###

### 管理员模块 ###

管理员登录模块实现 password：【admin】  
![在这里插入图片描述][20c301b638d0498e98c889ae8960378b.png]

导游管理  
![在这里插入图片描述][44b07e52cbbc41dca243882330bcdd40.png]

会员管理  
![在这里插入图片描述][64ebfb2244df43d1a7049c4302c31fc5.png]

旅游管理  
![在这里插入图片描述][28773388991c4d3287eafffd9d5c71e0.png]

订单管理  
![在这里插入图片描述][7079574bece84443b5c9627ac450cb77.png]

预约管理  
![在这里插入图片描述][246d353dd96a45329c15923596561c76.png]

### 导游模块 ###

游客登录模块实现 user：【a】、password：【1】  
![在这里插入图片描述][bde80b96ea804029bfe16a031996f71a.png]  
![在这里插入图片描述][34ddfe6afb254d08847c529a5a2e090b.png]  
![在这里插入图片描述][07b46072af9c43e1a14fa0b741b3048f.png]  
![在这里插入图片描述][6ccd0d3a98fd48c9b46e8f18a0664471.png]  
![在这里插入图片描述][578f197ede8f4ba697c90587aecd26e5.png]

### 游客模块 ###

游客登录模块实现 password：【aa】、【bb】，密码与用户名一样  
![在这里插入图片描述][62b0c580413e4031924cf7faeb6f45d5.png]

![在这里插入图片描述][748d027294f14c609b04f4513e995894.png]  
![在这里插入图片描述][b38a00f5d54046a499d735693cd8e393.png]  
![在这里插入图片描述][782dce36078e4414829036dfc1c27454.png]

# 三、部分代码展示 #

@RestController
    @RequestMapping("/classification")
    @Slf4j
    public class ClassificationController {
        
    
        @Resource
        ClassificationService classificationService;
    
        /**
         * 添加分类
         * @param name
         * @return
         */
        @PostMapping("/add")
        public Result addClassification(@RequestParam("name") String name){
        
            Classification classification = new Classification();
            classification.setName(name);
            if(classificationService.addClassification(classification)){
        
                return Result.success("创建成功！");
            }
            return Result.error("创建失败！");
        }
    
        /**
         * 删除分类
         * @param id
         * @return
         */
        @DeleteMapping("/delete/{id}")
        public Result deleteClassification(@PathVariable Integer id){
        
            if(classificationService.deleteClassificationById(id)) {
        
                return Result.success("删除成功！");
            }
            return Result.error("创建失败！");
        }
    
        /**
         * 分类分页
         * @param current
         * @param size
         * @return
         */
        @GetMapping("/page/{current}/{size}")
        public Result classificationPage(@PathVariable Integer current, @PathVariable Integer size){
        
            IPage<Classification> page = classificationService.page(current, size);
            return Result.success("返回分页。", page);
        }
    
        /**
         * 全部分类
         * @return
         */
        @GetMapping("/all")
        public Result allClassification(){
        
            List<Classification> list = classificationService.getAllClassification();
            return Result.success("返回全部分类。", list);
        }

@Service
    @Slf4j
    public class TableServiceImpl implements TableService {
        
    
        @Resource
        DiningTableMapper diningTableMapper;
    
        @Resource
        OrderMapper orderMapper;
    
        @Resource
        ReservationService reservationService;
    
        @Override
        public List<DiningTable> listInfo() {
        
            List<DiningTable> tables = listForShow();
            for(DiningTable table : tables){
        
                table.setOrder(orderMapper.selectById(table.getOrderId()));
                table.setReservationInfoList(reservationService.getReservationByTableId(table.getId()));
            }
            return tables;
        }
    
        @Override
        public List<DiningTable> listForShow() {
        
            QueryWrapper<DiningTable> wrapper = new QueryWrapper<>();
            wrapper.eq("open", true);
            return diningTableMapper.selectList(wrapper);
        }
    
        @Override
        public List<DiningTable> list() {
        
            return diningTableMapper.selectList(null);
        }
    
        @Override
        public Boolean createTable(String tableName, Integer capacity, Boolean open) {
        
            DiningTable table = TableBuilder.create().pushTableName(tableName)
                    .pushCapacity(capacity).pushOpen(open).finish();
            return diningTableMapper.insert(table) == 1;
        }
    
        @Override
        public Boolean updateTable(Integer id, String tableName, Integer capacity, Boolean open) {
        
            DiningTable table = getTableOfThrow(id);
            table.setName(tableName);
            table.setCapacity(capacity);
            table.setOpen(open);
            return diningTableMapper.updateById(table) == 1;
        }
    
        @Override
        public Boolean deleteTable(Integer id) {
        
            DiningTable table = getTableOfThrow(id);
            if(table.getUsed()){
        
                throw new UnmessageException("导游正忙！");
            }
            return diningTableMapper.deleteById(id) == 1;
        }
    
        @Override
        public boolean tableUsed(Integer tableId, Integer orderId){
        
            DiningTable table = getTableOfThrow(tableId);
            log.info("tableId:{} orderId:{} used:{}", tableId, orderId, table.getUsed());
            if(!table.getOpen()){
        
                throw new UnmessageException("导游未开放！");
            }
            if(table.getUsed()){
        
                throw new UnmessageException("导游正忙。");
            }
            table.setOrderId(orderId);
            table.setUsed(true);
            return diningTableMapper.updateById(table) == 1;
        }
    
        @Override
        public boolean tableUnused(Integer tableId, Integer orderId) {
        
            DiningTable table = getTableOfThrow(tableId);
    
            log.info("tableId:{} orderId:{} used:{}", tableId, orderId, table.getUsed());
            if(!table.getUsed()){
        
                throw new UnmessageException("导游空闲。");
            }
            if(!table.getOrderId().equals(orderId)){
        
                throw new UnmessageException("订单号未对应。");
            }
            table.setOrderId(0);
            table.setUsed(false);
            return diningTableMapper.updateById(table) == 1;
        }
    
        @Override
        public DiningTable getTableOfThrow(Integer id) {
        
            DiningTable table = diningTableMapper.selectById(id);
            if(table == null){
        
                throw new UnmessageException("导游不存在");
            }
            return table;
        }
    }

public interface TableService {
        
    
        List<DiningTable> listForShow();
    
        List<DiningTable> listInfo();
    
        List<DiningTable> list();
    
        Boolean createTable(String tableName, Integer capacity, Boolean open);
    
        Boolean updateTable(Integer id, String tableName,
                            Integer capacity, Boolean open);
    
        Boolean deleteTable(Integer id);
    
        /**
         * 设置导游正在使用中
         * @param tableId
         * @param orderId
         * @return
         */
        boolean tableUsed(Integer tableId, Integer orderId);
    
        /**
         * 设置导游空闲
         * @param tableId
         * @param orderId
         * @return
         */
        boolean tableUnused(Integer tableId, Integer orderId);
    
        DiningTable getTableOfThrow(Integer id);
    }

--------------------

[Java_ _]: https://rej177.blog.csdn.net/article/details/125826754?spm=1001.2014.3001.5502
[2c5129dfa1ca4e5eb75f5853696db9a4.png]: https://img-blog.csdnimg.cn/2c5129dfa1ca4e5eb75f5853696db9a4.png
[20c301b638d0498e98c889ae8960378b.png]: https://img-blog.csdnimg.cn/20c301b638d0498e98c889ae8960378b.png
[44b07e52cbbc41dca243882330bcdd40.png]: https://img-blog.csdnimg.cn/44b07e52cbbc41dca243882330bcdd40.png
[64ebfb2244df43d1a7049c4302c31fc5.png]: https://img-blog.csdnimg.cn/64ebfb2244df43d1a7049c4302c31fc5.png
[28773388991c4d3287eafffd9d5c71e0.png]: https://img-blog.csdnimg.cn/28773388991c4d3287eafffd9d5c71e0.png
[7079574bece84443b5c9627ac450cb77.png]: https://img-blog.csdnimg.cn/7079574bece84443b5c9627ac450cb77.png
[246d353dd96a45329c15923596561c76.png]: https://img-blog.csdnimg.cn/246d353dd96a45329c15923596561c76.png
[bde80b96ea804029bfe16a031996f71a.png]: https://img-blog.csdnimg.cn/bde80b96ea804029bfe16a031996f71a.png
[34ddfe6afb254d08847c529a5a2e090b.png]: https://img-blog.csdnimg.cn/34ddfe6afb254d08847c529a5a2e090b.png
[07b46072af9c43e1a14fa0b741b3048f.png]: https://img-blog.csdnimg.cn/07b46072af9c43e1a14fa0b741b3048f.png
[6ccd0d3a98fd48c9b46e8f18a0664471.png]: https://img-blog.csdnimg.cn/6ccd0d3a98fd48c9b46e8f18a0664471.png
[578f197ede8f4ba697c90587aecd26e5.png]: https://img-blog.csdnimg.cn/578f197ede8f4ba697c90587aecd26e5.png
[62b0c580413e4031924cf7faeb6f45d5.png]: https://img-blog.csdnimg.cn/62b0c580413e4031924cf7faeb6f45d5.png
[748d027294f14c609b04f4513e995894.png]: https://img-blog.csdnimg.cn/748d027294f14c609b04f4513e995894.png
[b38a00f5d54046a499d735693cd8e393.png]: https://img-blog.csdnimg.cn/b38a00f5d54046a499d735693cd8e393.png
[782dce36078e4414829036dfc1c27454.png]: https://img-blog.csdnimg.cn/782dce36078e4414829036dfc1c27454.png