文档包含用例图、系统架构图、系统功能结构图、实体属性图、总体e-r图。

一.系统开发工具与环境搭建

1.系统设计开发工具

后端

使用Java编程语言的Spring boot框架

项目架构：B/S架构

运行环境：win10/win11、jdk17

---

前端：

技术：框架Vue.js；UI库：ElementUI；

开发工具：Visual Studio Code；

---

后端:

技术：Java语言、mybatis plus、Spring boot框架；

开发工具：IDEA 2023.3.3版本；

---

数据库：

数据库：mysql5.7/8.0

数据库工具：Navicat12版本；

---

二.系统实现（部分截图）

2.1 仓库人员功能实现

2.1.1 登录功能实现

仓库人员，通过输入账号、密码，选择对应的仓库管理员角色，输入图形验证码进行登录。前端将仓库人员输入的参数信息传递给后端接口/User/SignIn，执行登录方法，检查用户的信息是否存在于用户表，不存在，则提示仓库人员检查输入的信息是否正确。校验通过后，登录系统，进行操作系统。登录界面如图5-1所示。

关键代码：

List<AppUser> items=_AppUserMpper.selectList(queryWrapper);

if(items.stream().count()==0)

{ throw  new CustomException("请检查登录的账号或者密码,角色是否都正确!");}

Map<String, String> map = new HashMap<>();

map.put(SysConst.UserIdClaim,items.get(0).getId().toString());

map.put(SysConst.RoleTypeClaim,items.get(0).getRoleType().toString());

String token=JWTUtils.getToken(map);

return token;

2.1.2 商品资料管理功能实现

仓库商品资料管理，作为仓库管理人员，可以为仓库新增商品信息。包含商品、SKU、条码、品牌等信息，调用/Cargo/CreateOrEdit进行新增商品信息。当仓库商品有所变动时，可以进行修改，选择商品进行修改，调用/Cargo/Get获取商品的原始信息，修改后，调用/Cargo/CreateOrEdit接口进行修改。删除商品，有这个权限，但是最好不要删除商品信息。商品资料管理界面如图5-2所示。

关键代码：

//声明一个商品资料实体

Cargo Cargo = new Cargo();

//把前端传入的input参数拷贝到商品资料实体

BeanUtils.copyProperties(Cargo,input);

//调用数据库的增加或者修改方法

saveOrUpdate(Cargo);

//定义一个返回给前端的商品资料传输模型

CargoDto CargoDto=new CargoDto();

//同理把操作的商品资料实体拷贝给商品资料传输模型

BeanUtils.copyProperties(CargoDto,Cargo);

//把传输模型返回给前端

return CargoDto;

2.1.3 库区管理功能实现

仓库人员可以根据仓库的具体情况，进行设置库区，包含库区名称、库区编码。当发生酒类商品出入库操作时，系统通过业务逻辑层自动关联库区数据，系统实时更新该库区的库存数量字段。为库区设置库位信息，将当前库区Id传递给/WarehouseBin/CreateOrEdit接口，为库区新增库位信息。库区管理界面如图5-3所示。

关键代码：

if(input.getId()==null)

 {

     return new WarehouseAreaDto();

 }

 PagedResult<WarehouseAreaDto>  pagedResult =List(input);

 return pagedResult.getTotalCount()>0?pagedResult.getItems().stream().findFirst().get():new WarehouseAreaDto();

2.2超级管理员功能实现

2.2.1 数据图形化分析功能实现

超级管理员可以通过选择不同仓库，通过折线图查看每个仓库的最近7天出入库存数，最近7天出入订单数。环形图展示最近30天仓库出入库统计分析，展示该仓库的待补商品Top10，商品保质期预警Top10。数据图形化分析界面如图5-4所示。

关键代码：

 Map<String, Object> data = new HashMap<>();

data.put("name", "入库");

data.put("value", Math.abs(sum));

dataList.add(data);

//统计数量小于0的记录并且求和

double sum1 = inventoryRecords.stream().filter(x -> x.getQty() < 0).mapToDouble(x -> x.getQty()).sum();

Map<String, Object> data1 = new HashMap<>();

data1.put("name", "出库");

data1.put("value", Math.abs(sum1));

dataList.add(data1);

2.2.2 货主管理功能实现

超级管理员可以维护所有仓库的货主信息，为所有仓添加货主信息，填写货主名称、货主编码、货主电话、货主公司地址信息，调用/Customer/CreateOrEdit接口新增。当货主信息有所更改时，修改货主信息。当不再合作，可以删除货主信息。货主管理界面如图5-5所示。

关键代码：

//把Customer实体转换成Customer传输模型

List<CustomerDto> items= Extension.copyBeanList(pageRecords.getRecords(),CustomerDto.class);

for (CustomerDto item : items) {

  //查询出关联的创建用户信息

    AppUserDto  CreatorAppUserDTO=new AppUserDto();

    AppUser  CreatorAppUserEntity= _AppUserMapper.selectOne(Wrappers.<AppUser>lambdaQuery().eq(AppUser::getId,item.getCreatorId()));

   if(CreatorAppUserEntity!=null) {

        BeanUtils.copyProperties(CreatorAppUserDTO, CreatorAppUserEntity);

        item.setCreatorAppUserDto(CreatorAppUserDTO);

    }  

}

//返回一个分页结构给前端

return PagedResult.GetInstance(items,totalCount);

2.2.3 库存预警功能实现

超级管理员登录系统后，库存预警模块。可对每一款商品单独设置库存预警。点击具体商品的编辑选项，超级管理输入商品的下限预警值，调用/EarlyWarning/CreateOrEdit接设置库存预警。此数值代表商品库存数量达到该值时，系统将触发预警。库存预警界面如图5-6所示。

关键代码：

//声明一个库存预警实体

EarlyWarning EarlyWarning = new EarlyWarning();

//把前端传入的input参数拷贝到库存预警实体

BeanUtils.copyProperties(EarlyWarning, input);

//调用数据库的增加或者修改方法

saveOrUpdate(EarlyWarning);

//定义一个返回给前端的库存预警传输模型

EarlyWarningDto EarlyWarningDto = new EarlyWarningDto();

//同理把操作的库存预警实体拷贝给库存预警传输模型

BeanUtils.copyProperties(EarlyWarningDto, EarlyWarning);

//把传输模型返回给前端

return EarlyWarningDto;