本文将用于介绍《百事通宿舍管理系统》的使用教程以及注意事项。
通过域名地址访问即可进入系统。初次使用需要通过账号登入。
各个账号拥有各自的权限，权限的不同，访问系统所能使用的功能不同。（此部分内容在【后台用户】部分会重点介绍）
注意： 系统默认拥有三十天免登入功能，在未手动退出系统三十天内访问系统，不需要登入。
在系统的右上角头像处，可以通过退出登入按钮退出当前账号。
登入系统后，默认进入首页。
根据图片，系统布局主要分为三个部分。
-
第一部分，为系统的功能模块区域，通过账号
权限的不同，左边功能区域所有的选项也不同，其中admin权限可以使用全部功能，在后面详细介绍这块区域。 -
第二部分为导航栏，导航栏主要显示当前所处的功能区域路径，以及页面快捷跳转的按钮。右边依次为“搜索”、“全屏”、“字体大小”、“中英切换”以及“个人信息”。
-
第三部分为页面的主要显示区域。
首页有两个卡片区域，分别为快捷导航以及系统公告，公告由管理员在【发布公告】栏目进行发布，在编辑时可以通过编辑器来进行格式以及颜色等内容的修改。
当前版本公告栏只显示一条公告，即最新发布的公告。
【发布公告】模块为admin权限功能，上方编辑公告内容，下方实时渲染展示效果。点击右上方发布按钮即可发布到首页，所有登入系统的用户都可以看见。
注意，发布公告会覆盖旧公告内容
在【后台用户】模块可以查看当前系统所有的账户信息。
展示的数据中的密码经过加密已经不适合展示，所以只提供密码修改的功能
账户在创建之后无法在系统中删除，可以通过编辑来修改账号的状态，当账号状态为停用时，该账号将不被运行登入系统。
通过点击左上角的【添加按钮】可以为系统添加账户。其中权限在下章节详细介绍。
【大学管理】模块下有两个子模块。
在【学校管理】模块中可以查看当前系统中的学校信息。
可以对系统中的学校进行增删改的操作
需要注意的是，如果对学校进行删除时，会删除该校权限下的所有账号，宿舍信息会缓存一个月，如果误操作可以联系开发人员进行数据恢复。
- 在【宿舍楼管理】中先选择学院后进行编辑以及删除操作。
【重要】 其中需要重点关注的是excel导入功能
因为宿舍楼的数据量比较大，所以提供了通过excel导入数据的功能。
在点击标准导入模板后会下载一个excel文件。
其**有三个字段：
universityId为学的编号，该编号可以在【大学管理-学校管理】中查到
buildingName为该大学的宿舍楼名，如（榕苑1号楼，榕苑2号楼）
floor为该宿舍楼的楼层，填写数字，如（1,2,3）
填写完后保存，拖拽到下方或选择文件即可在下方预览。确认无误后 确定 上传。
标准的文件内容应该如下所示：
导入之后显示如下
-
统一标准表单：
- 在【表单管理】模块中可以对
宿舍统计的统一标准表单进行增删改操作。
-
如果需要停止该校表单的收集，可以通过【编辑】将表单的【状态】更改为停用。
-
在表单地址一栏中可以通过点击来复制当前院校的表单地址
在【大学管理-学校管理】中创建大学时，会自动在【学校列表】中添加该校的选项。每个学校权限的账户只能访问自己学校的内容，对其他学校的内容无权访问。
在每个学校的选项下都有【宿舍信息记录】以及【学生表单信息】两个模块。
在【宿舍信息记录】模块中，可以查看该校宿舍的全部信息
-
在左上方有宿舍楼筛选的选择器。该功能主要给地推人员使用，用于宿舍信息的登记。
-
右上方分别有
excel快捷导入、添加``导出数据三个功能
-
为了方便地推人员的使用，在当前页面可以通过点击行来快捷编辑数据的操作
需要注意的是，如果是新创建的学校需要添加各个楼层的宿舍楼的信息。该步骤非常繁琐，非常不建议手动一条一条添加。
以目前录入的福建师范大学旗山校区为例，共有68个宿舍楼，每栋楼7层，每层40间宿舍。则算下来共有18760个宿舍，即有18760条数据需要导入。数据量较大。
这里推荐两种方式：
- 使用
excel快捷导入功能 > >> > 使用方法与上章节介绍的相同，需要注意的是这张表**有三个字段： > > building_id为宿舍楼编号，该编号可以在【大学管理-宿舍楼管理】中查到
> floor为楼层，填写如（1层，2层，3层）
> roomNo为当前楼层的房号，填写数字，如（101,102,103） > > 标准的excel文件内容应如下所示 > >> > 保存文档后，拖拽到页面或选择文件即可在下方预览。确认无误后 确定 上传。 > > 2. 如果需要可以联系开发人员提供快速生成模板的脚本。只需要输入几栋楼，一楼几层，一层几间即可实现快速导入
在【学生表单信息】模块中可以查看当前选项学校下的学生填写标准统计表单的统计数据，方便管理员进行管理。
系统默认拥有两个权限，admin、test。
其中admin拥有完全的系统权限，能够使用系统的全部功能；test的为测试权限，主要用于开发人员的测试使用。
除此之外，在管理员通过【大学管理-学校管理】模块创建学校时，会自动添加一个属于该校的权限。在创建新的系统用户时，可以在权限选择块中找到。
在【大学管理-学校管理】中删除学校时，将顺带删除该校权限下的所有账号。
比如说，系统现在有一个权限为fushida的账号，fushida为福建师范大学的权限。那么xiaowuyaya这个账号在登入系统时，只能拥有该校的操作权限，无其他可用功能。
tips：
如果非
admin权限的用户访问该权限功能则报404页面
该系统使用vue+elementUI搭建前端页面，express框架提供前端服务支持。
后端采用java语言进行开发，通过springboot搭建web服务，
权限部分使用SpringSecurity+jwt实现无状态统一权限认证的解决方案
数据库部分使用的是mysql数据库，通过redis进行缓存
持久层框架：Mybatis、Mybatis-plus
数据库连接池：Alibaba Druid
第三方模块：pinyin4j、gson
日志部分使用Log4j对异常以及日志进行统一管理