物流信息管理系统

开发周期：6天

技术栈：Vue3+Springboot+Mysql。

组件库：ElmentPlus+vant-ui

版本：jdk17，mysql8.0.30，springboot2.7.15，vant4，vue3

开发工具：IDEA2023.2+VScode+ApiPost7

项目部分页面展示

用户篇

桌面端

用户查询页面

用户登录完成的查询页面

移动端适配

用户查询页面适配

用户登录完成的查询页面适配：

登录页面适配

管理员篇

普通管理员与超级管理员模块页面相差不大，仅选取超级管理员的部分展示

superAdmin主页

更新表单

查询全部物流信息

查看所有员工

更新客户信息

项目亮点

采用jwt令牌技术，根据不同类型的用户生成不同类型的令牌返回给前端，前端采用Vue路由守卫实现不同权限用户的管理
采用事务管理，保证了数据的一致性和完整性
数据库使用逻辑外键关联，避免强耦合
使用springmvc拦截器技术，降低服务器压力。

前端页面使用细节

总体项目介绍图

项目功能基础流程图

项目结构图：

项目架构图：

约束：
- 用户名和密码为5-12位字母+数字的组合。
- 用户名和单号需唯一
- 所有字段除备注外均为非空（但未做空串处理，意思就是添加“ ”这样的空串也会添加到数据库）
- 昵称默认为不知名用户，最多20个字符
- 单号最多100个字符，国家，数据，系统单号，转单号，客户单号最多255个字符。备注最多200个字符。

根据单号查询物流信息页面（首页）

进入页面自动聚焦输入框，输入框内应避免输入空格。查询成功显示对应单号的物流详细信息，查询失败则显示未知错误（一般是数据输入不合规）。
点击右上角的超链接按钮可以跳转到登录页面。

登录页面

输入用户名和密码（字母+数字5-12位，应避免输入空格）。登录成功定向到对应页面，登录失败则提示用户名或密码错误
勾选记住我可以把用户名和密码持久化本地进行保存。
点击忘记密码跳转到提示页面。

用户已登录页面

桌面端：
- 左上角是一个超链接，跳转到根据单号查询页面。
- 右上角是退出按钮，确认退出后本地会自动把Authorization值清空，这样就可以切换其他权限用户的账号进行登录。
- 中间区域为展示物流信息的区域
移动端：
- 功能类似，把用户名放到了中间展示。
- 进入页面后用户可以看到所有单号信息，点击某一单号跳转到当前单号的详情页面。

超级管理员已登录页面。

下面的所有文本框内容均不允许输入空格（提交时候会自动去除首尾和中间的空格）且并未对输入的数据进行限制/校验处理

物流信息管理
1. 添加物流信息
  - 点击添加物流信息按钮，弹出添加信息的弹框。在下拉框中选择用户账号（这就意味着需要先添加客户账号才能添加物流信息），输入对应单号，选择状态，等等。点击添加，提示添加成功
  - 输入单号重复，弹出弹框未知异常（一般是输入数据不合规）。未添加所有数据点击添加，提示添加成功，但并未添加进去任何数据。
2. 更新物流信息
  - 点击更新物流信息按钮，弹出更新物流信息的弹框。首先选择用户账号，程序自动查询出当前账号对应的单号，选择单号后会把对应物流数据回显到表单中，只需输入物流信息即可。点击更新，提示更新成功
  - 对用户下没有单号的单号不能进行更新操作，点击更新，弹出弹框未知异常（一般是输入数据不合规）
3. 查询物流信息
  - 点击查询物流信息按钮，输入对应单号，会查询出相应订单的物流信息。提示查询成功
  - 单号输入错误会弹出弹框未知异常（一般是输入数据不合规）
4. 查询全部物流信息
  
  点击查询全部物流信息按钮，查询出全部物流信息。（物流信息会根据所属用户和所属订单自动分组展示）
5. 删除物流信息
  - 点击删除物流信息按钮，输入相应单号，可以删除相应的物流信息。
  - 单号输入错误会弹出弹框未知异常（一般是输入数据不合规）
员工管理
1. 添加员工
  - 点击添加员工按钮，弹出对话框，输入用户名，密码和昵称。提示添加成功
  - 用户名重复，用户名或密码不合约束，弹出弹框未知异常（一般是输入数据不合规）
2. 查看所有员工
  - 点击查看所有员工按钮，下方显示一个表格。表格列出员工的用户名和密码
  - 若查询不出来数据有两种清空，1：服务器未启动。（弹框未知异常（一般是输入数据不合规））2：数据库没有数据
3. 添加客户
  - 点击添加客户按钮，弹出对话框，输入用户名，密码和昵称。提示添加成功
  - 用户名重复，用户名或密码不合约束，弹出弹框未知异常（一般是输入数据不合规）
4. 查看所有客户信息
  - 点击查看所有员工按钮，下方显示一个表格。表格列出员工的用户名和密码
  - 若查询不出来数据有两种清空，1：服务器未启动。（弹框未知异常（一般是输入数据不合规））2：数据库没有数据
5. 编辑员工（客户信息）
  - 点击编辑按钮，弹出对话框。不可修改用户名，输入需要修改的密码和昵称。提示修改成功
  - 密码不合约束，弹出弹框未知异常（一般是输入数据不合规）
6. 删除员工（客户）
  - 点击删除按钮，弹出确认对话框，点击确认，提示删除成功
  - 服务器未启动，弹出弹框未知异常（一般是输入数据不合规）
退出

点击退出按钮，弹出确认退出对话框，点击确认，清除本地存储的Authorization并跳转到登录页面

管理员已登录页面。

功能细节与超级管理员类似，但没有删除物流信息和员工管理模块。在此不在赘述

接口文档

下述接口设计大致符合RESTful风格

统一说明：

名称	类型	是否必须	备注
code	number	必须	响应码, 1 成功 ; 0 失败
msg	string	非必须	提示信息
data	string	必须	返回的数据 ,

登录管理

登录请求

请求路径：/login

请求方式：POST

接口描述：接口用于登录系统，根据返回的不同信息给用户下发不同的jwt和定位到不同的页面

请求参数：

{
 "username":"xiaohei666",
 "password":"123456"
}

响应参数：

{
    "code":1,
    "msg":"success",
    "data":{
        "type":"superAdmin",
        "nickname":"张狗蛋",
        "jwt":"asabsabds.hjbhsjsa.saj182292282029.hshsuahsak"          
    }
}

设计细节：

用户点击登录按钮，系统会去数据库查询用户的类型和昵称，并存储到相应的userAuth对象里面，根据不同的用户类型和用户名下发不同类型的jwt令牌，在后端添加拦截器，每次请求都需要携带jwt令牌（token），使用拦截器实现，在前端实现不同用户类型访问对应页面的逻辑。

不同用户访问逻辑如下

超级管理员：
- 点击登录按钮登录。登录完毕以后再次访问网站不需登录，如果需要更换管理员/顾客账号，需要点击退出登录清除数据。
- 访问权限：超级管理员添加用户页面，超级管理员人员管理页面，根据单号查询信息页面，404页面
管理员：
- 点击登录按钮登录。登录完毕以后再次访问网站不需登录，如果需要更换其他账号，需要点击退出登录清除数据。
- 访问权限：管理员添加用户页面，根据单号查询信息页面，404页面
用户：
- 点击登录按钮登录。登录完毕以后再次访问网站不需登录，如果需要更换其他账号，需要点击退出登录清除数据。
- 访问权限：根据单号查询信息页面，404页面

注：访问不允许访问的页面会出现权限不够被禁止的页面，这时只需要重新访问原始页面或者点击浏览器的左上角返回键即可