基于微信小程序的家政服务平台的实现

基于微信小程序的家政服务平台的实现

Realization of Housekeeping Service Platform

Based on WeChat Mini Program

摘 要

随着中国市场经济的不断发展，人口老龄化的加剧，社会对家庭服务市场的需求越来越大。但是，传统的线下家庭服务往往遇到瓶颈，逐渐跟不上时代的发展趋势，满足不了用户的需求。此外，随着互联网的飞速发展以及越来越多人拥有如手机、平板等移动设备，伴随着微信的快速发展，已经成为现代人不可缺少的社交工具。几乎所有行业都希望接入互联网，形成O2O模式，也就是我们熟知的线上对线下的模式。此外，使用B2B2C模式，即公司对公司、再由公司推到个人，也在发挥巨大的作用。如阿里巴巴、美团等等。利用互联网高效便捷地为用户提供便利，解决国内家政行业面临的瓶颈问题是大势所趋。因此，建立一个透明、公开、平等、高效运行的家政服务平台势在必行。

关键字：微信小程序 网络平台 家政服务 透明化

Abstract

With the continuous development of China's market economy and

the aging of the population, the society's demand for the family service

market is increasing. However, traditional offline family services often

encounter bottlenecks, and gradually fail to keep up with the

development trend of the times, and cannot meet the needs of users. With

the rapid development of the Internet and more and more people own

mobile devices such as mobile phones and tablets. WeChat has become

an indispensable social tool for modern people because of the rapid

development of the Internet. Almost all industries want to access the

Internet to form an O2O model, which is what we know as an online-to-offline model. In addition, the B2B2C model, that is, company-to-company and then company-to-person promotion, has also played a huge

role, such as Alibaba Group and so on. It is the general trend to use the

Internet to efficiently and conveniently provide convenience to users and

solve the bottleneck problems faced by the domestic housekeeping

industry. Therefore, to build a transparent, open and efficient

homemaking service platform is very imperative.

Key words：Mini Program Platform Housekeeping Transparency

目 录

第一章 绪论 ............................................... 1

1.1 课题背景与意义 ................................................................................... 1

1.2 研究现状 ............................................................................................... 1

1.3 论文研究的主要内容 ........................................................................... 2

第二章 相关开发环境和技术的简介 ............................ 3

2.1 开发环境介绍 ....................................................................................... 3

2.1.1 开发环境 ......................................................................................... 3

2.1.2 开发技术 ......................................................................................... 3

2.1.3 部署环境技术 ................................................................................. 3

2.1.4 系统配置 ......................................................................................... 3

2.2 相关技术介绍 ....................................................................................... 3

2.2.1 Java ................................................................................................... 3

2.2.2 SpringBoot ....................................................................................... 4

2.2.3 MyBatis-Plus .................................................................................... 4

2.2.4 Vue ................................................................................................... 4

2.2.5 微信小程序 ..................................................................................... 4

2.3 本章小结 ............................................................................................... 5

第三章 需求分析 ........................................... 6

3.1 编写目的 ............................................................................................... 6

3.2 总体需求 ............................................................................................... 6

3.3 功能性需求 ........................................................................................... 6

3.4 非功能性需求 ....................................................................................... 8

3.5 本章小结 ............................................................................................... 8

第四章 系统的总体设计 ...................................... 9

4.1 系统边界设计 ....................................................................................... 9

4.2 系统业务流程 ..................................................................................... 10

4.2.1 总体业务流程图 ........................................................................... 10

4.2.2 查看文章流程图 ........................................................................... 11

4.2.3 登录流程图 ................................................................................... 11

4.2.4 支付流程图 ................................................................................... 12

4.3 系统数据流图 ..................................................................................... 13

4.3.1 顶层数据流图 ............................................................................... 13

4.3.2 中层数据流图 ............................................................................... 13

4.3.3 底层数据流图 ............................................................................... 14

4.4 总体软件实现架构描述 ..................................................................... 18

4.4.1 层次结构 ....................................................................................... 18

4.4.2技术架构 ........................................................................................ 19

4.5 系统的开发模式设计 ......................................................................... 19

4.6 总体模块结构 ..................................................................................... 20

4.7 子模块设计 ......................................................................................... 21

4.7.1 系统管理模块 ............................................................................... 21

4.7.2 平台管理模块 ............................................................................... 21

4.7.3 小程序管理模块 ........................................................................... 22

4.7.4 数据模块 ....................................................................................... 22

4.7.5 微信小程序模块 ........................................................................... 23

4.8 数据库的设计 ..................................................................................... 23

4.8.1 地址表 address ............................................................................. 23

4.8.2 文章表 article ............................................................................... 24

4.8.3 文章点赞表 article_appreciate .................................................... 25

4.8.4 分类表 category ........................................................................... 25

4.8.5 优惠券表 coupon ......................................................................... 25

4.8.6 评论表 evaluate ........................................................................... 26

4.8.7 反馈表 feedback .......................................................................... 27

4.8.8 服务表 good ................................................................................. 27

4.8.9 足迹表 good_access .................................................................... 28

4.8.10 收藏表 good_love ...................................................................... 28

4.8.11 轮播图表 rotation ...................................................................... 29

4.8.12 公司&部门表 sys_dept ............................................................. 29

4.8.13 日志表 sys_log .......................................................................... 30

4.8.14 菜单表 sys_menu ....................................................................... 31

4.8.15 角色表 sys_role ......................................................................... 31

4.8.16 角色菜单表 sys_role_menu ...................................................... 32

4.8.17 管理员表 sys_user ..................................................................... 32

4.8.18 用户角色表 sys_user_role ........................................................ 33

4.8.18 用户token表 sys_user_token ................................................... 33

4.8.19 订单表 t_order ........................................................................... 33

4.8.20 用户优惠券表 user_coupon ...................................................... 34

4.8.21 微信用户表 wechat_user .......................................................... 35

4.9 本章小结 ............................................................................................. 35

第五章 系统的详细设计 ..................................... 36

5.1 项目结构 ............................................................................................. 36

5.1.1 目录结构 ....................................................................................... 36

5.2 部件详细设计 ..................................................................................... 39

5.2.1 统一结果返回 ............................................................................... 39

5.2.2 系统日志注解 ............................................................................... 39

5.2.3 自定义异常 ................................................................................... 40

5.2.4 获取请求IP .................................................................................. 41

5.2.5 生成Token .................................................................................... 41

5.2.6 公共实体 ....................................................................................... 41

5.2.7 Shiro权限认证 .............................................................................. 42

5.3 后台管理系统API .............................................................................. 44

5.3.1后台用户管理模块 ........................................................................ 44

5.3.2角色管理模块 ................................................................................ 49

5.3.3菜单管理模块 ................................................................................ 51

5.3.4部门（商家）管理模块 ............................................................... 54

5.3.5日志模块 ........................................................................................ 55

5.3.6文件上传模块 ................................................................................ 55

5.3.7文章管理模块 ................................................................................ 56

5.3.8分类管理模块 ................................................................................ 57

5.3.9优惠券管理模块 ............................................................................ 58

5.3.10服务管理模块 .............................................................................. 60

5.3.11订单管理模块 .............................................................................. 61

5.3.12轮播图管理模块 .......................................................................... 62

5.3.13微信用户管理模块 ...................................................................... 62

5.4 微信小程序端API .............................................................................. 63

5.4.1用户中心 ........................................................................................ 63

5.4.2地址中心 ........................................................................................ 66

5.4.3文章中心 ........................................................................................ 67

5.4.3优惠券中心 .................................................................................... 68

5.4.4评价中心 ........................................................................................ 69

5.4.5服务中心 ........................................................................................ 70

5.4.6首页 ................................................................................................ 73

5.4.7订单中心 ........................................................................................ 73

5.5 Vue后台管理端设计 ........................................................................... 75

5.5.1 主要设计 ....................................................................................... 75

5.6微信小程序页面设计 .......................................................................... 76

5.6.1主要设计 ........................................................................................ 76

5.7 本章小结 ............................................................................................. 76

第六章 系统的展示 ........................................ 77

6.1后台管理平台 ...................................................................................... 77

6.2微信小程序 .......................................................................................... 85

6.3本章小结 .............................................................................................. 92

第七章 系统特色和创新 ..................................... 93

7.1系统特色 .............................................................................................. 93

7.2系统创新 .............................................................................................. 93

第八章 总结 .............................................. 94

参 考 文 献 .............................................. 95

致 谢 ...................................... 错误!未定义书签。

广东东软学院本科毕业设计（论文）

第一章 绪论

1.1 课题背景与意义

由2018年中国老年健康研究报告的研究数据显示，中国人口老龄化问题日益严重。年轻人经常需要上班，甚至加班，因此，家庭的卫生状况以及是否有小孩都将面临无人照料的困境。所以以保姆中介市场为代表的家政服务越来越受到广大家庭的认同。随着中国经济的发展，每座城市生活节奏的飞速提升，家政服务市场的扩张速度十分迅猛，家政服务在每个城市中越来越普遍。伴随着上述的问题，家政服务市场的需求也变得日趋明显。但近几年在家政市场发生的各种事故，如杭州纵火案等，使不少人担心家政企业对自身财产和生命的保障，对家政行业的发展也产生了很大的影响。线下家政服务机构的良莠不齐，给用人单位的选择带来不便。因此，随着互联网的发展，人们越来越迫切地需要一个能够提供透明的企业信息和价格的家政服务平台，以及目标明确的从业者管理机制。

家政服务平台，是将家政公司与雇主两者结合起来的一种方式，雇主可以通过家政服务平台，进行横向的对比，包括选择适合自己的价格、优势、劣势等，物美价廉的家政服务公司，为雇主提供最大的便利，提高雇主的家庭生活质量。其次，优胜劣汰，家政公司还可以通过用户反馈对从业人员实行考评管理，营造一种良好的市场氛围。对互联网来说，是近十年科技发展的产物，几乎家家户户都能上网，每个人都有手机或者手机，随时随地上网已经成了家常便饭。将互联网的便利与家政服务平台相结合，既能方便雇主对家政服务的选择，又能给传统的线下行业带来全新的机遇，从而打开家政服务新的市场。因此，基于互联网的家政服务平台是未来几年甚至几十年的主流发展趋势。

1.2 研究现状

“家政服务人员”这个职业现在已经非常常见了，这个职业最开始是由中国劳动和社会保障部在2000年确定的。家政服务也开始走上了一条“专业化”的发展道路。家政行业的出现，使中国社会家庭幸福程度大大提高。根据统计，家庭佣工的分类主要有“职业保姆”、“涉外保姆”、“高级保姆”、“育儿早管”、“育儿早管”、“幼儿育儿服务”、“家教外教”、“水电维修”、“管道疏通”、“清洁”、“搬家服务”等，各类家政服务正深入社会的每一个家庭。

由中国家庭服务行业在2019年的研究数据表明，目前中国约有3000万家庭需要家政服务，这个数据占到了总调查人数的15%。由此可见，家政行业的社会需求十分的明显，发展前景十分光明。

根据市民的反馈，目前家政市场的乱象也比较明显，如临时加价、退货无果、甚1

广东东软学院本科毕业设计（论文）

至抢劫、盗窃等。家政市场越来越需要一个合适的解决方案，以约束家政服务行业的服务效果，从而达到双赢的局面。

1.3 论文研究的主要内容

以家政服务为核心的发展理念是本课题的研究目标。这次家政服务平台的设计与实现，将形成一个三方平台，将作为第三方平台进行监管，实时监督家政服务公司的服务内容，并实时接受用户的反馈和建议，一旦发生用户的投诉或不满情况，第三方平台将积极开展调查，如确实发现用户的举报行为，该从业人员将无法在本平台上执行接单，其对应的家政公司也会收到警告，一旦积累到一定的次数，该服务公司也会退出本平台，并发出通知，其他雇主将该公司的情况告知，建立一个透明化的服务平台。

本论文研究的主要内容：

（1）分析线上家政服务平台的现状以及研究的意义，确定研究的目的；

（2）研究SpringBoot、Vue、微信小程序开发技术，MVC、前后端分离的设计模式以及MySQL数据库、Redis高速缓存等相关技术；

（3）详细分析家政服务平台的功能需求，并进行具体的需求分析；

（4）研究家政服务平台的总体设计方案，包括总体架构和基于典型三层结构（视图、模型和控制）的设计和使用微信小程序这一最新的开发技术；

（5）对完成的家政服务平台进行测试。在测试中发现其中的问题，不断的解决问题，完善平台的功能；

（6）试发布项目，测试其运行稳定性。

2

广东东软学院本科毕业设计（论文）

第二章 相关开发环境和技术的简介

2.1 开发环境介绍

2.1.1 开发环境

➢ 开发工具：IntelliJ IDEA 2019.2.3 x64、微信开发者工具、Visual Studio Code

➢ 数据库：MySQL 8.0.18

➢ 数据库操作工具：Navicat Premium 12

➢ 服务器操作工具：Xshell 6

2.1.2 开发技术

➢ E

➢ MyBatisPlus-3.2.0

➢ Vue-Cli3

➢ MySQL-8.0.18

➢ Java11

➢ NodeJs

➢ 微信小程序开发

2.1.3 部署环境技术

➢ Docker

➢ Nginx

2.1.4 系统配置

➢ 开发环境配置：Windows10操作系统，16G内存，硬盘1T+256G，CPU2.6GHz

➢ 部署环境配置：腾讯云服务器（Linux操作系统 1核 2GB 2Mbps）

2.2 相关技术介绍

家政服务平台在设计与开发的工程中，使用了多种技术，包括Java、Vue、SQL等等。本节我将对上述所涉及到的技术做简单的介绍说明。

2.2.1 Java

作为一种广泛使用的语言，Java具有跨平台和面向对象两大特点。他在当前社会中的开发被广泛的运用，是当前十分火爆的开发技术之一。

20世纪90年代初，将网络计算的功能扩展到日常生活是一个激进的设想。1991年， Sun一小部分名为“GreenTeam”的工程师认为，下一步的重点是数字消费设备和计算机的结合。在 JamesGosling的带领下，这个团队日以继夜地工作，最终创造出了一种能彻底改变世界的编程语言Java。Java语言是基于C++语言进行开发的并进行了改进，也继承了面向对象的技术核心，淘汰了部分过时的容易出错的代码。简言之，Java是一款多平台、高效的、面向对象的开发语言。

3

广东东软学院本科毕业设计（论文）

Java11在2018年9月25日发布，是一个长期支持的版本，带来了很多新功能，比如 LocalVar，HttpClient，List API，等等。本次家政服务平台的实现也是基于Java11进行开发的。

2.2.2 SpringBoot

Spring是基于Java平台的应该框架，它是完全开源的，并且拥有控制反转这一重大的功能。同时，Web应用也采用Spring作为Java企业版平台构建的技术支持。目前Spring已经在Java世界中被广泛运用，基本上已经替代了JavaBeans模型。

SpringBoot是Spring家族中的一部分，其使用配置方式的方法，从而搭建Spring运行环境，用配置替代原始Spring的搭建方式，使得用户可以以最小模块的形式进行SpringBoot项目的开发，而完成这件事情也只需要很少的配置文件就可以完成。其主要功能是：

 建立独立的Spring应用程式

 无需像传统Web项目部署WAR包，可以直接使用自带的Tomcat组件

 自动配置Spring所需要的配置文件

 为简化Maven配置提供自定义的“入门”项目对象模型(POM)

 很方便的提供如指标等生产准备，方便的检查和外部化的配置

 几乎不需要代码生成和XML配置

2.2.3 MyBatis-Plus

MyBatis是一款完全适合于Spring开发的工具，其优点是简化了传统JDBC的方式，只要一行SQL语句就可以对数据库进行操作，同时也可以很方便的生成动态的SQL语句。

MyBatis-Plus是由国内开发团队开发的对MyBatis的增强工具，简称为MP。MP对MyBatis没有做出任何的修改，只是在MyBatis的基础上，增加了基本的增删改查的操作、分页、全局拦截插件等等的功能。从而为开发者简化了开发的流程，避免了重复的工作，从而把时间完全留在业务的开发上，提高了开发者的效率。

2.2.4 Vue

Vue跟Spring一样是一个开发框架，区别是Vue是基于JavaScript的。从下到上是Vue的设计特点。其核心只关注与三层结构中的视图层。Vue基于npm的方式可以非常方便的将第三方代码库融合进来。简言之，Vue是一款十分高效的单页面应用工具引擎。

2.2.5 微信小程序

微信小程序是由腾讯公司设计开发的一种全新的连接用户与服务的方式，其用户量十分庞大，绝大多数中国人已经开始使用微信，而且越来越多外国人也开始接触并使用微信。而微信小程序可以以视作在另外一个操作系统上运行的移动端软件，4

广东东软学院本科毕业设计（论文）

为用户提供了轻量化的程序，用户无需下载软件就可以体验到传统APP上才有的功能。微信小程序的开发者可以利用微信官方提供应用开发框架和丰富的组件和 API服务，开发具有原生 APP体验。

2.3 本章小结

本章主要介绍了本次在家政服务平台的开发编码过程中所使用到框架和技术，在系统构建的过程中对所需要使用的技术理论基础进行了充分的研究和分析，为接下来的开发打下坚实的基础，也为我们的系统进一步的开发做了技术上的阐述。

5

广东东软学院本科毕业设计（论文）

第三章 需求分析

3.1 编写目的

家政服务平台的需求分析主要是提出系统应该具备的功能模块，以及我们期望达到的目标。通过对用户需求的理解，需求分析确定了家政服务平台的功能和非功能需求。功能需求指的是系统的主要功能和完成的目的。而提供除了业务之外的功能就是非功能需求了。除此之外，包括其他与功能需求无关的需求则是针对系统的质量特性进行描述的。它包含了相关的标准，需要对系统的质量特性进行描述，包括一些性能要求、安全要求、可维护性要求和其他要求。系统开发的重要内容是系统相关需求分析，是进行系统设计和开发的基础。也为系统后期测试提供了重要依据和基础，因此，系统后期维护的说明文档就是需求分析的目的所在。

3.2 总体需求

经相关调查得知，传统的家政服务平台是雇主前往线下家政服务机构，询问价格后机构会派遣工作人员上门服务，而雇主往往对工作人员的具体情况和服务态度一无所知，因此雇主也只能“踩着石头过河”，有时还会因为这种情况导致最终获得的服务效果不佳，有时甚至导致家庭财物失窃，亲人生命安全受到威胁等严重情况发生。而且，雇主需要花一定的时间到线下找家政机构了解服务情况和价格，即使是比较多家机构，往往也会浪费雇主的时间。

综合以上情况，本次设计的家政服务平台的总体需求是提高用户选择家政服务的时间效率，对比家政服务的价格，对家政服务进行监控，节省雇主的宝贵时间，降低服务过程中的危险因素，保证服务质量，利用互联网的优势将家政服务态度和价格透明化公开，给用户带来最大的便利，并带来高质量的选择。

3.3 功能性需求

根据调查得到家政服务平台的具体需求，具体情况如下：

前台（微信小程序端）：

1) 用户注册登录，用户通过微信授权，发起登录，并输入其手机号码，用户信息将在后台保存，然后完成登录。登录成功后，即可进行预约服务等操作。

2) 用户对家政服务功能的需求查询：用户可以通过不同的分类，查询相应的家政服务，在家政服务中查询相应的机构信息、评价、价格等，服务筛选也可以通过距离、地点等信息进行。对所感兴趣的服务还可以进行收集，方便查询。

3) 用户对家政预约的需求：用户查询了家政服务后，如果需要的话，用户可以通过小程序端进行下单预约，选择了预约联系人和联系方式后，家政公司就会有专人电联用户，确定具体上门时间和注意事项。

6

广东东软学院本科毕业设计（论文）

4) 用户完成订单并做出评价的需要：家政公司服务完成后，用户可以通过微信小程序对家政公司的服务成果、态度、员工等进行评价，并将评分计入家政公司的评分中，在服务细节中公开展示，方便其他用户进行查询。

5) 用户学习家庭生活提示的需求：用户可以通过机构或平台发布的文章，学习一些家庭清洁的小技巧，更好的学习家庭生活服务。

6) 用户获得优惠的需求：用户可获得优惠券，在下单时减免部分金额，提供部分优惠。

后台（Web管理端）：

1) 管理员登录功能：管理员通过输入用户名、密码、验证码后，后端进行校验，验证通过即可进入管理端，不同的管理员将会拥有不同的权限，从而可以操作不同的功能。

2) 家政公司管理功能：平台方可对家政公司进行管理，包括新公司入驻、违规公司封禁等，通过审核公司即可进行操作，在平台发布服务等。家政公司可以在这一职能下增加自己的内部组织，对自己的内部组织进行管理。

3) 管理员管理功能：平台方可以通过此功能管理系统管理员，也可以管理家政公司的人员，一旦出现违规情况，将给予封杀并取消该员工的工作资格。家政公司方可以执行诸如员工的添加和删除等操作。

4) 订单查询管理功能：家政公司可以在此对相应的订单进行查询，并在此对客户进行联系、服务评估等操作。平台方可跟踪订单情况，保证家政服务公司的服务质量。

5) 服务管理功能：家政服务公司可以在这里发布服务或下架服务。通过这一功能，平台方监控家政公司发布的服务是否符合平台运行规则，并及时发现异常并进行处理。

6) 分类管理功能：平台方可以通过此功能对微信小程序进行分类管理。

7) 文章管理功能：平台方和部分家政公司可以使用此功能发布文章，提供家居清洁等有效指南。

8) 小程序用户管理：平台可通过此功能查询已注册用户列表，如有用户恶意操作或违法行为发生，平台可及时进行处理，确保平台正常运行。

9) 系统管理功能：平台可以对管理系统的权限、菜单等进行管理，从而可以对整个家庭服务平台进行灵活的管理。

10)

11)

优惠券管理：平台方可以管理优惠券的发布，提供一部分优惠活动。

数据展示功能：提供平台数据的展示，方便地了解每日的运行情况。

7

广东东软学院本科毕业设计（论文）

3.4 非功能性需求

非功能需求是业务之外的需求，非业务需求也决定用户的使用体验、包括了系统总体的稳定性。下面列出了一些更重要的非功能性需求。

1.界面美观需求

这一需求主要描述了对系统外观的期望，要求系统实现符合规范的外观。家政服务平台应具备简洁、庄重、简约、精致的界面，给人一种专业而又不失精致的体验，也要充分符合家政服务的气氛。对于后台管理来说就需要有专业的感觉了。可参考其他管理学上的设计风格。

2.易操作性需求

易操作性将使系统的使用变得更加简单，对于家政服务经理来说，可以实现“一见钟情”地使用本系统。与花大量时间和精力熟悉系统操作相比，让家政公司管理人员快速掌握操作系统更好。对于微信小程序用户来说，小程序需要清楚地显示服务、订单、个人信息等内容，以方便用户选择和比较。

3.安全性需求

安全性是家政服务平台的关键，系统必须具有消除潜在风险的能力，并对风险有一定的承压能力。家政服务平台不仅要保证微信小程序端用户资料的安全性，还要保证后台管理模块家政机构信息和从业人员信息的安全性，防止造成安全事故的发生。

3.5 本章小结

系统开发过程中的需求分析尤为重要，对用户的需求要有全面的了解，对用户存在的问题要有透彻的理解。本章主要介绍了家政服务平台的一些基本情况，这一点在本系统的设计中占有重要地位，本章将为后面的家政服务平台的详细设计提供完整的文档支持。

8

广东东软学院本科毕业设计（论文）

第四章 系统的总体设计

4.1 系统边界设计

菜单管理<<包含>>角色管理机构管理管理员管理日志管理公司管理<<包含>>系统管理<<包含>><<包含>><<包含>><<包含>>公司管理员订单管理<<包含>>服务模块平台管理<<包含>><<包含>><<包含>>文章管理服务管理公司员工订单模块收藏模块优惠券管理优惠券模块微信用户管理<<包含>>系统管理员小程序管理<<包含>>足迹模块轮播图管理分类管理分类模块<<包含>>普通用户文章模块平台数据管理<<包含>>首页数据个人信息模块

图 1系统边界设计图

家政服务平台的总体边界设计如图1所示，整个家政服务平台分成后台管理平台和前台微信小程序平台两部分，作为第三方，系统管理员拥有整个平台的功能权限，公司管理员作为商户方进入平台，会赋予一部分的系统管理权限和平台管理权限，其公司内部的员工则拥有查看服务和订单的权限，可以对公司的订单业务进行精细化处理。用户则使用微信小程序端进行下单、评价等操作。

9

广东东软学院本科毕业设计（论文）

4.2 系统业务流程

4.2.1 总体业务流程图

开始生活小帮手订单中心生成订单选择分类是否有优惠券是选择优惠券否选择服务收藏服务支付流程超时结束文案提示成功立即预定支付状态失败是否登录否登录流程商家派单是检查订单参数是否填写完整是检查是否有已有地址是服务人员上门完成服务否否参数填写订单状态修改否添加地址服务已完成是选择地址订单完成商家买家互评提交订单结束文案提示

图 2系统总体业务流程图

10

广东东软学院本科毕业设计（论文）

4.2.2 查看文章流程图

开始选择文章查看文章点赞/评论结束

图 3系统文章业务流程图

4.2.3 登录流程图

开始后台管理登录平台小程序输入用户名、密码、验证码否授权获取用户信息输入是否符合规范是结束文案提示结束文案提示是否授权否否用户名和密码是否正确是是生成token并返回结束

图 4系统登录业务流程图

11

广东东软学院本科毕业设计（论文）

4.2.4 支付流程图

开始用户发起支付生成付款订单并支付超时结束文案提示支付状态失败成功记录支付数据修改订单状态结束

图 5系统支付业务流程图

12

广东东软学院本科毕业设计（论文）

4.3 系统数据流图

4.3.1 顶层数据流图

管理员登录请求信息管理与维护游客登录信息、文章预约服务家政服务平台用户、商户、订单、数据服务信息、订单信息、商家信息、员工信息会员文章、服务、优惠券、订单订单、数据商家

图 6系统顶层数据流图

4.3.2 中层数据流图

审核意见用户信息游客用户信息用户注册登录用户信息记录查询条件管理员优惠券信息优惠券信息记录文章信息记录文章管理优惠券信息优惠券管理审核意见文章信息优惠券领取商家信息商家信息查询查询条件查看文章领取条件订单信息记录预约服务商家入驻信息记录商家入驻查询条件订单信息预约信息订单信息订单信息记录订单管理入驻信息会员订单查询查询条件服务信息服务信息记录查询条件商家查询条件服务查询服务管理服务信息

图 7系统中层数据流图

13

广东东软学院本科毕业设计（论文）

4.3.3 底层数据流图

（1）底层用户登录数据流图

通过验证用户信息登录登录时间、IP验证生成token用户用户用户信息注册用户信息

图 8系统底层用户登录数据流图

（2）底层文章数据流图

用户信息管理员文章信息登录流程文章信息添加文章文章信息文章信息记录按关键字查询关键字文章信息用户查询条件分析查询日期文章信息查询显示按日期查询文章信息记录用户

图 9系统底层文章数据流图

14

广东东软学院本科毕业设计（论文）

（3）底层服务数据流图

商家用户信息登录系统服务信息用户信息记录服务管理服务信息文章信息记录文章信息记录关键字按关键字查询服务信息服务信息查询显示用户用户查询条件分析查询分类按分类查询商家按商家查询服务信息

图 10系统底层服务查询数据流图

（4）底层订单查询数据流图

用户信息记录用户登录系统查询条件订单信息记录订单信息记录分析查询订单日期按订单日期查询订单信息订单信息查询显示用户订单号按订单号查询预约人按预约人查询订单信息

图 11系统底层订单查询数据流图

15

广东东软学院本科毕业设计（论文）

（5）底层预约服务数据流图

用户用户信息登录用户信息记录选择服务服务信息记录订单提交订单订单记录显示订单订单用户

图 12系统底层预约服务数据流图

（6）底层商家数据流图

商家商家信息申请入驻商家信息审核商家商家信息管理员用户信息登录管理员信息记录

图 13系统底层商家信息数据流图

16

广东东软学院本科毕业设计（论文）

（7）底层优惠券数据流图

用户领取优惠券优惠券信息添加优惠券优惠券信息管理员用户信息登录管理员信息记录

图 14系统底层优惠券数据流图

17

广东东软学院本科毕业设计（论文）

4.4 总体软件实现架构描述

4.4.1 层次结构

Database数据库（MySQL）中间件（Redis）DAL数据访问层（Dao层）业务逻辑层（Service层）BLL视图控制层（Controller层）UI系统管理平台管理小程序管理平台数据管理数据安全管理管理平台小程序平台

图 15 层次结构图

家政平台的软件层次结构如图15所示，用户通过操控UI界面的内容进行系统的管理和小程序的操作，用户点击某一个按钮后，前端请求api接口，api接口调用后端的Controller层是视图控制层，其通过直接调用Service层（业务逻辑层）对业务进行处理，处理过程中如果需要调用到数据，则需要调用Dao层（数据访问层）对数据进行查询。最后通过原路径将数据返回到视图层，视图层将数据封装成Json格式返回到前端，前端则根据后端返回的接口进行页面的渲染，完成整个的数据交互。

18

广东东软学院本科毕业设计（论文）

4.4.2技术架构

客户端数据处理框架（SpringBoot+Mybatis）数据库表现层业务层持久层MySQL小程序调用Api接口SpringMVC管理页面无状态的会话服务器定位Spring事务处理调用第三方接口数据访问对象Hikari连接池持久化数据访问SpringBoot快速搭建业务服务类Mybatis相关Dao类XML配置文件Redis

图 16技术架构图

家政平台的技术架构如图16所示，主要采用的是前后端分离模式进行设计，前端使用目前比较流行的Vue框架和微信小程序框架进行设计；后端使用目前比较流行和稳定的SpringBoot和MyBatis框架进行设计，数据库分别使用了传统数据库MySQL和高性能缓冲数据库Redis。这样一来，整个系统前后端分离，可以提高整体运行的性能，也可以方便的进行修改，是当前比较流行的软件框架。

4.5 系统的开发模式设计

本平台的实现主要采用瀑布模式，瀑布模式是家政服务平台实现的开发模式，其核心思想是按工序完成问题，把功能的实现和设计分离开，使用结构化分析的方法，完成软件的开发，并遵循软件生命周期自上而下、相互衔接的顺序。

19

广东东软学院本科毕业设计（论文）

4.6 总体模块结构

家政服务平台后台管理系统系平统平小程台管台序数理管理管据理查询

微信小程序分个类服订人优模务单文章信惠块模块模块模块息券模模块块 17总体模块结构图

20

图

广东东软学院本科毕业设计（论文）

4.7 子模块设计

家政平台的模块主要由后台系统模块、后台平台模块、后台小程序模块、后台数据模块和微信小程序模块5个模块组成。

4.7.1 系统管理模块

系统管理菜单管理日志管理公司管理管理员管理角色管理

图 18系统管理模块示意图

4.7.2 平台管理模块

平台管理服务管理订单管理分类管理

图 19平台管理模块示意图

21

广东东软学院本科毕业设计（论文）

4.7.3 小程序管理模块

小程序管理轮播图管理文章管理微信用户管理优惠券管理

图 20小程序管理模块示意图

4.7.4 数据模块

数据模块用户数据订单数据服务数据流量数据

图 21数据模块示意图

22

广东东软学院本科毕业设计（论文）

4.7.5 微信小程序模块

小程序文章中心分类中心服务中心订单中心用户中心

图 22小程序模块示意图

4.8 数据库的设计

4.8.1 地址表 address

索引

名

index_address

字段

Id

索引类型 索引方法 注释

NORMAL BTREE

字段

列名

id

mobile

name

province

area

city

detail

is_default

create_by

last_modified_by

gmt_create

名称

id

手机号

联系人

省份

地区

城市

详情

是否默认

创建人

修改人

创建时间

数据类型

varchar(32)

varchar(11)

varchar(32)

varchar(10)

varchar(10)

varchar(10)

varchar(10)

tinyint(1)

varchar(32)

varchar(32)

datetime

23

字段类型

varchar

varchar

varchar

varchar

varchar

varchar

varchar

tinyint

varchar

varchar

datetime

长度

32

11

32

10

10

10

10

32

32

是否为空

NO

YES

YES

YES

YES

YES

YES

NO

NO

YES

NO

描述

广东东软学院本科毕业设计（论文）

gmt_modified

is_deleted

sort_no

version

修改时间

是否删除

排序

版本号

datetime

tinyint(1)

int(11)

int(11)

datetime

tinyint

int

int

YES

NO

NO

NO

4.8.2 文章表 article

索引

名

index_article

字段

Id

索引类型 索引方法 注释

NORMAL BTREE

字段

列名

id

title

author

author_avatar_uri

comment_disabled

content

content_short

image_uri

importance

source_uri

appreciate

attention

forward

status

create_by

last_modified_by

gmt_create

gmt_modified

is_deleted

sort_no

version

名称

id

标题

作者

作者头像uri

数据类型

varchar(32)

varchar(255)

varchar(64)

varchar(255)

字段类型

varchar

varchar

varchar

varchar

tinyint

varchar

varchar

varchar

smallint

varchar

smallint

smallint

smallint

smallint

varchar

varchar

datetime

datetime

tinyint

int

int

长度 是否为空

32

255

64

255

NO

YES

YES

YES

YES

描述

是否可以评论 tinyint(1)

内容

描述

图片uri

重要程度

源地址

点赞数

点击数

转发数

状态

创建人

修改人

创建时间

修改时间

是否删除

排序

版本号

varchar(1024)

varchar(255)

varchar(255)

smallint(6)

varchar(255)

smallint(255)

smallint(255)

smallint(255)

smallint(6)

varchar(32)

varchar(32)

datetime

datetime

tinyint(1)

int(11)

int(11)

1024 YES

255

255

255

32

32

YES

YES

YES

YES

YES

YES

YES

YES

NO

YES

NO

YES

NO

NO

NO

24

广东东软学院本科毕业设计（论文）

4.8.3 文章点赞表 article_appreciate

索引

名

idx_article

idx_user

字段

article_id

user_id

索引类型 索引方法 注释

NORMAL BTREE

NORMAL BTREE

字段

列名

article_id

user_id

名称

文章id

用户id

数据类型

varchar(32)

varchar(32)

字段类型 长度

varchar

varchar

32

32

是否为空

NO

NO

描述

4.8.4 分类表 category

索引

名

idx_ category

字段

id

索引类型 索引方法 注释

NORMAL BTREE

字段

列名

id

color

icon

name

create_by

last_modified_by

gmt_create

gmt_modified

is_deleted

sort_no

version

名称

id

颜色

图标

名称

创建人

修改人

创建时间

修改时间

是否删除

排序

版本号

数据类型

varchar(32)

varchar(32)

varchar(255)

varchar(64)

varchar(32)

varchar(32)

datetime

datetime

tinyint(1)

int(11)

int(11)

字段类型

varchar

varchar

varchar

varchar

varchar

varchar

datetime

datetime

tinyint

int

int

长度

32

32

255

64

32

32

是否为空 描述

NO

YES

YES

YES

NO

YES

NO

YES

NO

NO

NO

4.8.5 优惠券表 coupon

索引

名

idx_ coupon

字段

id

索引类型 索引方法 注释

NORMAL BTREE

25

广东东软学院本科毕业设计（论文）

字段

列名

id

color

detail

discount_value

name

名称

id

颜色

详情

优惠价格

优惠券名称

unit

use_limit_type_name

validity

create_by

last_modified_by

gmt_create

gmt_modified

is_deleted

sort_no

version

单位

使用限制

使用时间

创建人

修改人

创建时间

修改时间

是否删除

排序

版本号

varchar(32)

varchar(32)

datetime

varchar(32)

varchar(32)

datetime

datetime

tinyint(1)

int(11)

int(11)

varchar

varchar

datetime

varchar

varchar

datetime

datetime

tinyint

int

int

32

32

32

32

YES

YES

YES

NO

YES

NO

YES

NO

NO

NO

数据类型

varchar(32)

varchar(256)

varchar(256)

decimal(10,2)

varchar(64)

字段类型

varchar

varchar

varchar

decimal

varchar

长度

32

256

256

64

是否为空

NO

YES

YES

YES

YES

描述

4.8.6 评论表 evaluate

索引

名

idx_evaluate

idx_good_id

idx_order_id

字段

id

good_id

order_id

索引类型 索引方法 注释

NORMAL BTREE

NORMAL BTREE

NORMAL BTREE

字段

列名

id

dept_point

detail

environment_point

good_id

order_id

worker_point

名称

id

公司评分

详情

环境评分

服务id

订单id

员工评分

数据类型

varchar(32)

smallint(6)

字段类型

varchar

smallint

长度

32

1024

32

32

是否为空

NO

YES

YES

YES

YES

YES

YES

描述

varchar(1024) varchar

smallint(6)

varchar(32)

varchar(32)

smallint(6)

smallint

varchar

varchar

smallint

26

广东东软学院本科毕业设计（论文）

create_by

last_modified_by

gmt_create

gmt_modified

is_deleted

sort_no

version

创建人

修改人

创建时间

修改时间

是否删除

排序

版本号

varchar(32)

varchar(32)

datetime

datetime

tinyint(1)

int(11)

int(11)

varchar

varchar

datetime

datetime

tinyint

int

int

32

32

NO

YES

NO

YES

NO

NO

NO

4.8.7 反馈表 feedback

索引

名

idx_feedback

idx_order_id

字段

id

order_id

索引类型 索引方法 注释

NORMAL BTREE

NORMAL BTREE

字段

列名

id

achievement

feedback

notice

order_id

create_by

名称

id

完成情况

备注

通知

订单id

创建人

数据类型

varchar(32)

tinyint(4)

字段类型

varchar

tinyint

长度

32

255

255

32

32

32

是否为空

NO

YES

YES

YES

NO

NO

YES

NO

YES

NO

NO

NO

描述

varchar(255) varchar

varchar(255) varchar

varchar(32)

varchar(32)

varchar(32)

datetime

datetime

tinyint(1)

int(11)

int(11)

varchar

varchar

varchar

datetime

datetime

tinyint

int

int

last_modified_by 修改人

gmt_create

gmt_modified

is_deleted

sort_no

version

创建时间

修改时间

是否删除

排序

版本号

4.8.8 服务表 good

索引

名

idx_good

字段

id

索引类型 索引方法 注释

NORMAL BTREE

idx_category_id category_id NORMAL BTREE

idx_dept_id dept_id NORMAL BTREE

27

广东东软学院本科毕业设计（论文）

字段

列名

id

category_id

dept_id

detail

image_uri

name

price

unit

create_by

last_modified_by

gmt_create

gmt_modified

is_deleted

sort_no

version

名称

id

分类id

公司id

详情

图片连接

服务名

价格

单位

创建人

修改人

创建时间

修改时间

是否删除

排序

版本号

数据类型

varchar(32)

varchar(32)

varchar(32)

varchar(1024)

varchar(255)

varchar(64)

decimal(5,1)

varchar(32)

varchar(32)

varchar(32)

datetime

datetime

tinyint(1)

int(11)

int(11)

字段类型 长度

varchar

varchar

varchar

varchar

varchar

varchar

decimal

varchar

varchar

varchar

datetime

datetime

tinyint

int

int

32

32

32

1024

255

64

32

32

32

是否为空

NO

YES

YES

YES

YES

YES

YES

YES

NO

YES

NO

YES

NO

NO

NO

描述

4.8.9 足迹表 good_access

索引

名

idx_good_id

idx_user_id

字段

good_id

user_id

索引类型 索引方法 注释

NORMAL BTREE

NORMAL BTREE

字段

列名

good_id

user_id

名称

服务id

用户id

数据类型

varchar(32)

varchar(32)

字段类型 长度

varchar

varchar

32

32

是否为空

NO

NO

描述

4.8.10 收藏表 good_love

索引

名

idx_good_id

idx_user_id

字段

good_id

user_id

索引类型 索引方法 注释

NORMAL BTREE

NORMAL BTREE

28

广东东软学院本科毕业设计（论文）

字段

列名

good_id

user_id

名称

服务id

用户id

数据类型

varchar(32)

varchar(32)

字段类型 长度

varchar

varchar

32

32

是否为空

NO

NO

描述

4.8.11 轮播图表 rotation

索引

名

idx_rotation_id

字段

id

索引类型 索引方法 注释

NORMAL BTREE

字段

列名

id

url

create_by

名称

id

图片url

创建人

数据类型

varchar(32)

字段类型

varchar

长度

32

255

32

32

是否为空

NO

YES

NO

YES

NO

YES

NO

NO

NO

描述

varchar(255) varchar

varchar(32)

varchar(32)

datetime

datetime

tinyint(1)

int(11)

int(11)

varchar

varchar

datetime

datetime

tinyint

int

int

last_modified_by 修改人

gmt_create

gmt_modified

is_deleted

sort_no

version

创建时间

修改时间

是否删除

排序

版本号

4.8.12 公司&部门表 sys_dept

索引

名

idx_dept

字段

id

索引类型 索引方法 注释

NORMAL BTREE

字段

列名

id

address

avatar

lat

lng

name

parent_id

legal

名称

id

地址

头像url

纬度

经度

部门名称

父id

企业法人

数据类型

varchar(32)

字段类型 长度

varchar 32

255

255

50

32

50

是否为空

NO

YES

YES

YES

YES

YES

NO

YES

描述

地址计算的纬度

地址计算经度

一级部门为0

varchar(255) varchar

varchar(255) varchar

decimal(7,4) decimal

decimal(7,4) decimal

varchar(50)

varchar(32)

varchar(50)

varchar

varchar

varchar

29

广东东软学院本科毕业设计（论文）

email

tel

license

create_by

邮箱

联系电话

营业执照

创建人

varchar(50)

varchar(20)

varchar

varchar

50

50

255

32

32

YES

YES

YES

NO

YES

NO

YES

NO

NO

NO

varchar(255) varchar

varchar(32)

varchar(32)

datetime

datetime

tinyint(1)

int(11)

int(11)

varchar

varchar

datetime

datetime

tinyint

int

int

last_modified_by 修改人

gmt_create

gmt_modified

is_deleted

sort_no

version

创建时间

修改时间

是否删除

排序

版本号

4.8.13 日志表 sys_log

索引

名

Idx_log

字段

id

索引类型 索引方法 注释

NORMAL BTREE

字段

列名

id

ip

method

operation

params

time

username

create_by

名称

id

IP地址

请求方法

用户操作

请求参数

执行时长

用户名

创建人

数据类型

varchar(32)

varchar(64)

varchar(200)

varchar(50)

字段类型

varchar

varchar

varchar

varchar

长度

32

64

200

50

5000

50

32

32

是否为空 描述

NO

YES

YES

YES

YES

YES

YES

NO

YES

NO

YES

NO

NO

NO

毫秒

varchar(5000) varchar

bigint(20)

varchar(50)

varchar(32)

varchar(32)

datetime

datetime

tinyint(1)

int(11)

int(11)

bigint

varchar

varchar

varchar

datetime

datetime

tinyint

int

int

last_modified_by 修改人

gmt_create

gmt_modified

is_deleted

sort_no

version

创建时间

修改时间

是否删除

排序

版本号

30

广东东软学院本科毕业设计（论文）

4.8.14 菜单表 sys_menu

索引

名 字段 索引类型 索引方法 注释

NORMAL BTREE idx_sys_menu_id id

字段

列名

id

component

hidden

icon

name

parent_id

path

perms

redirect

create_by

last_modified_by

gmt_create

gmt_modified

is_deleted

sort_no

version

名称

id

组件

是否隐藏

图标

名称

父菜单ID

路径

授权

重定向地址

创建人

修改人

创建时间

修改时间

是否删除

排序

版本号

数据类型

varchar(32)

varchar(256)

tinyint(1)

varchar(32)

varchar(32)

varchar(32)

varchar(255)

varchar(500)

varchar(255)

varchar(32)

varchar(32)

datetime

datetime

tinyint(1)

int(11)

int(11)

字段类型 长度

varchar

varchar

tinyint

varchar

varchar

varchar

varchar

varchar

varchar

varchar

varchar

datetime

datetime

tinyint

int

int

32

256

32

32

32

255

500

255

32

32

是否为空 描述

NO

YES

YES

YES

YES

YES

YES

YES

YES

NO

YES

NO

YES

NO

NO

NO

0否，1是

一级菜单为null

多个用逗号分隔

4.8.15 角色表 sys_role

索引

名

idx_sys_role_id

字段

id

索引类型 索引方法 注释

NORMAL BTREE

字段

列名 名称 数据类型 字段类型

id

dept_id

remark

role_name

id

公司id

备注

角色名称

varchar(32)

varchar(32)

varchar

varchar

32

32

256

32

长度 是否为空

NO

YES

YES

YES

描述

varchar(256) varchar

varchar(32) varchar

31

广东东软学院本科毕业设计（论文）

create_by 创建人 varchar(32)

varchar(32)

datetime

datetime

tinyint(1)

int(11)

int(11)

varchar

varchar

datetime

datetime

tinyint

int

int

32

32

NO

YES

NO

YES

NO

NO

NO

last_modified_by 修改人

gmt_create

gmt_modified

is_deleted

sort_no

version

创建时间

修改时间

是否删除

排序

版本号

4.8.16 角色菜单表 sys_role_menu

索引

名

idx_menu_id

idx_role_id

字段 索引类型 索引方法 注释

menu_id NORMAL BTREE

role_id NORMAL BTREE

字段

列名

menu_id

role_id

名称

菜单id

角色id

数据类型

varchar(32)

varchar(32)

字段类型 长度

varchar

varchar

32

32

是否为空

NO

NO

描述

4.8.17 管理员表 sys_user

索引

名

idx_sys_user_id

idx_username

idx_dept_id

字段

id

索引类型 索引方法 注释

NORMAL BTREE

username NORMAL BTREE

dept_id NORMAL BTREE

字段

列名

id

avatar

dept_id

email

gmt_login

last_login_ip

mobile

password

username

名称

id

头像

公司id

邮箱

上次登录时间

上次登录ip

联系电话

密码

用户名

数据类型

varchar(32)

字段类型

varchar

长度

32

100

32

32

32

16

64

32

是否为空

NO

YES

YES

YES

YES

YES

YES

YES

NO

描述

varchar(100) varchar

varchar(32)

varchar(32)

datetime

varchar(32)

varchar(16)

varchar(64)

varchar(32)

varchar

varchar

datetime

varchar

varchar

varchar

varchar

32

广东东软学院本科毕业设计（论文）

create_by 创建人 varchar(32)

varchar(32)

datetime

datetime

tinyint(1)

int(11)

int(11)

varchar

varchar

datetime

datetime

tinyint

int

int

32

32

NO

YES

NO

YES

NO

NO

NO

last_modified_by 修改人

gmt_create

gmt_modified

is_deleted

sort_no

version

创建时间

修改时间

是否删除

排序

版本号

4.8.18 用户角色表 sys_user_role

索引

名

idx_user_id

idx_role_id

字段

user_id

role_id

索引类型 索引方法 注释

NORMAL BTREE

NORMAL BTREE

字段

列名

user_id

role_id

名称

用户id

角色id

数据类型

varchar(32)

varchar(32)

字段类型 长度

varchar

varchar

32

32

是否为空

NO

NO

描述

4.8.18 用户token表 sys_user_token

索引

名

idx_token

idx_user_id

字段

Token

user_id

索引类型 索引方法 注释

UNIQUE BTREE

NORMAL BTREE

字段

列名

expire_time

token

update_time

user_id

名称

过期时间

token

更新时间

用户id

数据类型

datetime

varchar(100)

datetime

varchar(100)

字段类型 长度

datetime

varchar

datetime

varchar

100

100

是否为空

YES

NO

YES

NO

描述

4.8.19 订单表 t_order

索引

名

idx_order

idx_dept_id

字段

id

dept_id

索引类型 索引方法 注释

NORMAL BTREE

NORMAL BTREE

33

广东东软学院本科毕业设计（论文）

字段

列名

id

address

contact

dept_id

discount_price

gmt_pay

good_id

image_uri

is_comment

mobile

name

payment

price

remark

status

create_by

名称

id

地址

联系人

公司id

优惠价格

支付时间

服务id

服务图片

是否评论

联系电话

联系人

支付方式

价格

备注

状态

创建人

数据类型

varchar(32)

varchar(32)

varchar(32)

varchar(32)

decimal(5,1)

datetime

varchar(32)

varchar(255)

tinyint(1)

varchar(11)

varchar(128)

tinyint(4)

decimal(5,1)

字段类型

varchar

varchar

varchar

varchar

decimal

datetime

varchar

varchar

tinyint

varchar

varchar

tinyint

decimal

长度

32

32

32

32

32

255

11

128

1024

32

32

是否为空

NO

YES

YES

YES

YES

YES

YES

YES

YES

YES

YES

YES

YES

YES

YES

NO

YES

NO

YES

NO

NO

NO

描述

1是0否

varchar(1024) varchar

tinyint(4)

varchar(32)

varchar(32)

datetime

datetime

tinyint(1)

int(11)

int(11)

tinyint

varchar

varchar

datetime

datetime

tinyint

int

int

last_modified_by 修改人

gmt_create

gmt_modified

is_deleted

sort_no

version

创建时间

修改时间

是否删除

排序

版本号

4.8.20 用户优惠券表 user_coupon

索引

名

idx_user_id

字段

userid

索引类型 索引方法 注释

NORMAL BTREE

字段

列名 名称 数据类型 字段类型 长度

32

32

是否为空

NO

YES

YES

描述

coupon_id 优惠券id

order_id

use_time

订单id

使用时间

varchar(32) varchar

varchar(32) varchar

datetime datetime

34

广东东软学院本科毕业设计（论文）

user_id 用户id varchar(32) varchar 32 NO

4.8.21 微信用户表 wechat_user

索引

名

idx_wechat_user_id

字段

id

索引类型 索引方法 注释

NORMAL BTREE

idx_wechat_user_openid openid NORMAL BTREE

字段

列名

id

avatar_url

city

country

gender

gmt_login

language

last_login_ip

mobile

nickname

openid

province

session_key

unionid

create_by

名称

id

头像url

国家

城市

性别

上次登录时间

语言

上次登录ip

手机号

昵称

openid

省份

session_key

unionid

创建人

数据类型

varchar(32)

字段类型

varchar

长度

32

255

32

32

32

32

11

32

32

32

32

32

32

32

是否为空

NO

YES

YES

YES

YES

YES

YES

YES

YES

YES

YES

YES

YES

YES

NO

YES

NO

YES

NO

NO

NO

描述

0未知1男2女

varchar(255) varchar

varchar(32)

varchar(32)

tinyint(4)

datetime

varchar(32)

varchar(32)

varchar(11)

varchar(32)

varchar(32)

varchar(32)

varchar(32)

varchar(32)

varchar(32)

varchar(32)

datetime

datetime

tinyint(1)

int(11)

int(11)

varchar

varchar

tinyint

datetime

varchar

varchar

varchar

varchar

varchar

varchar

varchar

varchar

varchar

varchar

datetime

datetime

tinyint

int

int

last_modified_by 修改人

gmt_create

gmt_modified

is_deleted

sort_no

version

创建时间

修改时间

是否删除

排序

版本号

4.9 本章小结

本章主要是说明家政服务平台的总体设计，对系统进行总体模块进行划分，大概描述系统开发的总体内容情况,为接下来详细设计奠定基础。

35

广东东软学院本科毕业设计（论文）

第五章 系统的详细设计

5.1 项目结构

5.1.1 目录结构

图 23后端目录结构

项目使用了Maven进行托管，采用父子包的形式进行搭建，最外层的对项目引用的jar包版本进行管理，common包是基本工具类，entity包是实体类，dao包是数据访问层的类，service包是业务处理类，web-api是后台管理系统的前端控制器类，wx-api是微信小程序的前端控制器类。

common模块

图 24commom结构

common包中，annotaion是注解的配置类，exception是存放自定义异常的处理类的包，utils是存放工具类的包，xss是存放防攻击类的包，Constant是一些常量类。

36

广东东软学院本科毕业设计（论文）

web-api模块

图 25web-api结构

web-api模块中，aspect是存放切面类的包，config是存放配置类的包，controller是存放前端控制器类的包，oauth2是存放shiro登录类的包，utils是存放工具类的包，WebApiApplication是SpringBoot项目的启动类。

wx-api模块

图 26wx-api结构

wx-api模块中， annotaion和config是存放配置文件的包，utils中是整个项目所需要使用的工具，controller中的类是前端访问的唯一途径。

37

广东东软学院本科毕业设计（论文）

前端Vue模块

图 27前端Vue目录结构

前端Vue模块中，public是和图标的包，src中，api是存放封装了请求api的包，assets是存放了图片的包，components是存放了一部分公用模块的包，directive和utils是存放了工具类的包，icons是存放了系统图标库的包，layout是存放了布局的包，route是存放了路由的包，store是存放了本地缓存的包，styles是存放了部分样式的包，vendor是存放了excle表格导出使用的工具类的包，views是存放了页面的包，是项目的根路径，是基本的js类，是权限管理类，是设置管理类。

微信小程序模块

图 28微信小程序结构

38

广东东软学院本科毕业设计（论文）

微信小程序模块中，colorui是存放前端样式的基础包，images是静态的图片，pages是全部的小程序页面，utils是所有使用到的工具；、、是主文件的包，是项目配置文件的包。

5.2 部件详细设计

5.2.1 统一结果返回

（1）结果类 R

public class R extends HashMap {

public R() {

put("code", 200);

}

public static R error() {

return error(500, "未知异常，请联系管理员");

}

public static R ok(String msg) {

R r = new R();

("msg", msg);

return r;

}

}

创建类R，继承HashMap，生成error方法和ok方法，提供两个返回结果。

5.2.2 系统日志注解

（2）自定义注解类 Log

@Target()

@Retention(E)

@Documented

public @interface Log {

}

String value() default "";

创建@interface类，即注解类Log，使用@Target注解指定在何处写入注释的合法位置，这里使用的是，即方法声明；这里将@Retention的策略设置为RUNTIME，则在项目整体运行的过程中会一直存在Log类，从而全局都可使用。@Document则是说明Log类是可以JavaDoc进行记录的，可以保留文档。在Log类中设置了一个属性value，通过这个熟悉可以设置方法的描述。

（3）系统日志切面处理类 LogAspect

使用Spring的面向切面的编程思想，进行日志的记录，并保存的数据库中。

@Pointcut("@annotation()")

public void logPointCut(){}

使用@Pointcut确认其切点的切入方向。

@Around("logPointCut()")

39

广东东软学院本科毕业设计（论文）

public Object around(ProceedingJoinPoint point) throws Throwable {

// 开始时间

Long beginTime = tTimeMillis();

// 执行方法

Object result = d();

// 执行时长（毫秒）

Long time = tTimeMillis() - beginTime;

saveSysLog(point, time);

return result;

}

在切点处理方法中，先通过tTimeMillis获取方法开始执行的时间，然后调用d继续执行方法，执行结束后通过再次获取当前系统时间，减去起始时间，得到执行时长，然后通过调用saveSysLog方法将日志保存到数据库中。

5.2.3 自定义异常

（1）自定义异常类 RRException

public class RRException extends RuntimeException {

private String msg;

private int code = 500;

RRException是继承了RuntimeExcetion的实现类，其中包括code和msg属性，分别为返回代码和消息。

（2）统一异常处理类 RRExceptionHandler

@RestControllerAdvice

public class RRExceptionHandler {

创建异常类RRExceptionHandler，使用Spring中的@RestControllerAdvice注解进行配置，设置其全局处理异常类的功能。

@ExceptionHandler()

public R handleRRException(RRException e) {

R r = new R();

("code", e());

("msg", ());

return r;

}

在Spring中，@ExceptionHandler可以全局捕获异常，然后根据自定义进行处理。

本类还分别处理DuplicateKeyException（重复数据异常）、AuthorizationException（权限验证失败异常）、NullPointerException（空指针异常）和Exception（其他异常）。

40

广东东软学院本科毕业设计（论文）

5.2.4 获取请求IP

（1）IP工具类 IPUtils

public static String getIpAddr(HttpServletRequest request)

创建静态方法类getIpAddr，方法参数为HttpServletRequest，使用request.

getRemoteAddr()获取请求的IP地址。

如果使用了Nginx等反向代理软件， 则不能通过oteAddr()获取IP地址，因此需要使用der("x-forwarded-for")、der("Proxy-Client-IP")、der("WL-Proxy-Client-IP")、、der("HTTP_CLIENT_IP")der("HTTP_X_FORWARDED_FOR")获取IP地址。

由于多层方向代理使用X-Forwarded-For可能存在多个IP地址，因此如果想获取最开始请求的地址就需要用到ing(0, f(","))来获取第一个有效的IP地址。

5.2.5 生成Token

（1）Token生成类 TokenGenerator

public static String generateValue() {

return generateValue(r());

}

创建Token生成类，使用UUID的形式先生成UUID字符串，然后再调用generateValue(String param)方法对UUID字符串进行处理。

MessageDigest algorithm = tance("MD5");

();

(es());

byte[] messageDigest = ();

return toHexString(messageDigest);

使用secutity包中的MessageDigest方法对uuid进行处理，然后再对结果进行Hex处理。

5.2.6 公共实体

（1）公共实体类 BaseEntity

项目数据库中共有8个公共的实体，分别是id、create_by（创建人）、last_modified_by（最后修改人）、gmt_modified（最后修改时间）、gmt_create（创建时间）、sort(排序)、is_deleted（逻辑删除标志）、version（版本号）。创建公共实体类，将其他实体类继承此类，即可获得这8个属性。

其中， id是使用由 Twitter 开源的分布式 id 生成算法，称之为雪花（SnowFlake）算法，其根据机器码和时间戳等，生成的是全局唯一的long类型的数据id。

创建人（createBy）、创建时间（gmtCreate）使用MyBatisPlus提供的注解41

广东东软学院本科毕业设计（论文）

@TableField(fill = )进行设置，然后在使用插入语句时，会自动将这两个字段插入到sql语句中，保存到数据库。

修改人（lastModifiedBy）、修改时间（gmtModified）与上面描述类似。

排序（sortNo）是将数据进行排序。

删除标志（isDeleted）是将数据进行逻辑删除，如果该数据以及删除，则将该字段设置为1，在查询时会将这个字段带入查询条件，只查询该字段为0的字段。

版本号（version）是给每条数据加上乐观锁，防止数据的误读、脏读，保证数据的安全。

5.2.7 Shiro权限认证

（1）Shiro

Apache Shiro是一个Java安全框架，市面上还有Spring Security等类似的框架。Shiro可以对会话进行安全管理，包括认证和授权等等。

（2）OAuth2Filter

使用OAuth2Filter对每条请求连接进行拦截过滤，通过请求头中的token属性获取请求的token字符串，从而对用户权限做出校验。

@Override

protected

String

servletRequest);

if (k(token)) {

HttpServletResponse

(HttpServletResponse)servletResponse;

String json = new Gson().toJson((500, "invalid token"));

ter().print(json);

return false;

}

return executeLogin(servletRequest, servletResponse);

}

httpServletResponse =

boolean

token

onAccessDenied(ServletRequest

=

servletRequest,

ServletResponse servletResponse) throws Exception {

getRequestToken((HttpServletRequest)

如果拿到的token为空，则返回登录失败，如果不为空，则调用executeLogin方法对token进行校验，鉴权。

（3）OAuth2Realm

@Override

protected

SysUser sysUser =

AuthorizationInfo

(SysUser)

doGetAuthorizationInfo(PrincipalCollection principalCollection) {

maryPrincipal();

String userId = ();

//获取用户权限列表

42

广东东软学院本科毕业设计（论文）

Set permsSet = rPermissions(userId);

SimpleAuthorizationInfo info = new SimpleAuthorizationInfo();

ingPermissions(permsSet);

return info;

}

该方法会在授权（验证权限）时调用，其主要思想是在Shiro的用户信息类PrincipalCollection中获取用户信息实体，从而获取对应的用户id，通过用户id去数据库中查询用户的权限列表，并将权限列表保存到用户认证信息中。

@Override

protected

AuthenticationException {

String accessToken = (String) ncipal();

SysUserToken sysUserToken = yToken(accessToken);

if (sysUserToken == null ||

ireTime().isAfter(()) == false) {

throw new IncorrectCredentialsException("token失效，请重新登录");

}

SysUser sysUser = ser(rId());

SimpleAuthenticationInfo

return info;

}

info = new

SimpleAuthenticationInfo(sysUser, accessToken, getName());

AuthenticationInfo

doGetAuthenticationInfo(AuthenticationToken authenticationToken) throws

上述方法会在认证时调用，该方法会从Shiro提供的AuthenticationToken类中获取用户信息，拿到请求的accessToken， 通过token去查询对应用户信息，将信息保存到Shiro提供的SimpleAuthenticationInfo类中。

（4）OAuth2Token

该类实现了AuthenticationToken接口，其中定义了一个属性token，并重写了getPrincipal和getCredentials方法，使其返回token属性。

（5）ShiroUtils

这个类是自定义的Shiro工具类，定义了方法，可以直接从Shiro的库中拿到如用户id、用户信息、权限等操作。

（6）BaseController

public abstract class BaseController {

protected SysUser getUser() {

return (SysUser) ject().getPrincipal();

}

protected String getUserId() {

return getUser().getId();

}

protected String getDeptId() {

43