Java 项目实战：基于 Spring Boot、MyBatis、PageHelper、Spring Security、FastJSON、Swagger、Hutool 与 Vue 的商品进销存管理系统设计与实现

一、系统概述

1.1 系统目标

本系统的主要目标是提供一个集成化的商品管理平台，实现以下功能：

高效的商品信息管理，包括商品的基本信息、类型、供应商、客户等的录入、查询、修改和删除。
精确的采购流程管理，涵盖采购订单的创建、修改、查询、入库操作以及与供应商的信息关联。
完善的销售流程管理，包括销售订单的创建、修改、查询、出库操作以及与客户的信息关联。
实时的库存管理，能够准确记录库存数量的变化，支持库存盘点、库存预警等功能。
灵活的仓库管理，实现仓库信息的维护、仓库容量的管理以及与库存和出入库业务的关联。
提供数据统计和报表功能，帮助企业管理者分析销售趋势、采购成本、库存周转率等关键指标。
确保系统具有良好的安全性和稳定性，保护企业数据的安全，防止数据泄露和非法操作。

1.2 系统范围

本系统涵盖了企业商品进销存管理的各个环节，包括基础数据管理（如商品、客户、供应商、部门、员工等信息）、采购管理、销售管理、库存管理、仓库管理以及系统管理（用户权限管理、日志管理等）。系统适用于各类需要进行商品进销存管理的企业，可根据企业规模和业务需求进行定制化配置。

二、系统架构设计

2.1 技术选型

后端框架：Spring Boot，提供了快速构建基于Spring的应用程序的能力，简化了配置和部署过程，具有强大的生态系统和社区支持。
数据库：MySQL，关系型数据库，能够满足系统对数据存储、查询和事务处理的需求，具有良好的稳定性和性能。
ORM框架：MyBatis，用于数据库访问层的开发，能够方便地将数据库表映射为Java对象，提供了灵活的SQL编写方式。
安全框架：Spring Security，用于实现系统的身份认证和授权功能，确保系统的安全性。
其他工具和技术：使用PageHelper实现分页功能，Hutool工具库提供了一系列常用的工具方法，提高开发效率；使用Swagger进行API文档管理，方便接口测试和调试。

2.2 模块划分

基础数据管理模块：负责管理商品、客户、供应商、部门、员工等基础信息，包括信息的录入、查询、修改和删除功能。
采购管理模块：涵盖采购订单的创建、修改、查询、入库操作，以及与供应商的信息关联和采购流程的管理。
销售管理模块：包括销售订单的创建、修改、查询、出库操作，以及与客户的信息关联和销售流程的管理。
库存管理模块：实时记录库存数量的变化，支持库存盘点、库存预警等功能，确保库存数据的准确性。
仓库管理模块：实现仓库信息的维护、仓库容量的管理以及与库存和出入库业务的关联，优化仓库资源的利用。
系统管理模块：负责用户权限管理、日志管理等系统级别的功能，保障系统的安全和稳定运行。

2.3 系统架构图

2.4 数据库设计

商品信息表（jcmd_shop）：存储商品的基本信息，如商品名称、类型、规格、单价等。
客户信息表（jcmd_customer）：记录客户的详细信息，包括客户名称、地址、联系人等。
供应商信息表（jcmd_supplier）：存放供应商的相关信息，如供应商名称、地址、联系方式等。
采购订单表（jxmd_purchase）：用于记录采购订单的详细信息，如采购编号、采购日期、供应商、商品、数量、价格等。
销售订单表（jxmd_sale）：存储销售订单的信息，包括销售编号、销售日期、客户、商品、数量、价格等。
库存表（ckmd_stock）：实时记录商品的库存数量、库存位置等信息。
仓库信息表（ckmd_depository）：管理仓库的基本信息，如仓库名称、地址、容量等。
用户信息表（xtmd_admin）：存储系统用户的账号、密码、角色等信息，用于身份认证和授权。
角色信息表（xtmd_role）：定义系统中的角色及其权限，实现用户权限的管理。
日志表（xtmd_log）：记录系统操作的日志信息，方便系统监控和故障排查。

2.5 系统接口设计

用户接口：包括用户登录、注册、找回密码等功能接口，提供用户与系统交互的入口，确保用户身份的合法性和安全性。
商品管理接口：实现商品信息的增删改查操作接口，支持商品图片上传、商品搜索等功能，方便用户对商品信息进行管理。
采购管理接口：涵盖采购订单的创建、查询、修改、删除接口，以及采购入库、退货等操作接口，确保采购流程的顺畅进行。
销售管理接口：包括销售订单的创建、查询、修改、删除接口，以及销售出库、退货等操作接口，满足销售业务的需求。
库存管理接口：提供库存查询、盘点、预警等功能接口，实时监控库存状态，保证库存数据的准确性。
仓库管理接口：实现仓库信息的增删改查接口，以及仓库容量管理、库存分配等操作接口，优化仓库资源的利用。
报表接口：生成采购报表、销售报表、库存报表等接口，为企业管理者提供数据支持和决策依据。

三、功能模块设计

3.1 基础数据管理

商品管理
- 功能描述：实现对商品信息的全面管理，包括商品的基本信息（名称、规格、型号等）、商品类型、供应商信息、采购价格、销售价格等的维护。支持商品的添加、编辑、删除、查询操作，以及商品图片的上传和展示。
- 操作流程：用户登录系统后，进入商品管理页面，可点击“添加商品”按钮，填写商品相关信息，上传商品图片，点击“保存”完成商品添加。在商品列表页面，可对商品进行编辑、删除和查询操作，通过输入关键词或选择筛选条件进行精准查询。
- 界面设计：商品管理页面采用表格形式展示商品列表，包括商品名称、规格、型号、图片、供应商、价格等信息。点击“添加商品”弹出模态框，填写商品信息和上传图片。编辑和删除操作通过按钮形式提供，点击按钮弹出确认对话框。
客户管理
- 功能描述：负责管理客户信息，包括客户名称、联系人、联系电话、地址、客户类型等。支持客户信息的录入、查询、修改和删除操作，可根据客户名称、联系人等关键词进行模糊查询。
- 操作流程：用户进入客户管理页面，点击“添加客户”，填写客户详细信息，点击“保存”完成添加。在客户列表中，可通过点击客户记录进行编辑和删除操作，也可在搜索框输入关键词查询特定客户。
- 界面设计：客户管理页面以列表形式展示客户信息，包括客户名称、联系人、电话、地址、类型等列。添加客户和编辑客户信息使用表单形式，方便用户输入。搜索框位于页面顶部，提供快速查询功能。
供应商管理
- 功能描述：用于管理供应商信息，涵盖供应商名称、联系人、联系电话、地址、供应商品范围等。提供供应商信息的新增、修改、删除和查询功能，可按供应商名称等进行模糊查询。
- 操作流程：在供应商管理页面，点击“添加供应商”按钮，填写供应商信息后点击“保存”。在供应商列表中，可对供应商进行编辑、删除操作，通过搜索框输入关键词查询相关供应商。
- 界面设计：供应商管理页面以表格展示供应商信息，包括名称、联系人、电话、地址、供应商品等列。添加和编辑供应商使用弹出式表单，搜索框方便用户查找特定供应商。

3.2 采购管理

采购订单管理
- 功能描述：实现采购订单的全生命周期管理，包括采购订单的创建、编辑、查询、删除以及采购订单状态的跟踪。在创建采购订单时，需选择供应商、商品、采购数量、采购价格等信息，并自动计算采购总价。支持根据采购订单编号、供应商、采购日期等条件进行查询。
- 操作流程：用户进入采购订单管理页面，点击“创建采购订单”，选择供应商，添加商品及数量、价格等信息，确认无误后点击“提交”。在订单列表中，可查看订单状态，对未提交或未审核的订单进行编辑、删除操作，点击订单编号可查看订单详细信息。
- 界面设计：采购订单管理页面以列表展示采购订单，包括订单编号、供应商、采购日期、状态、总价等信息。创建订单和编辑订单使用表单形式，通过下拉框选择供应商和商品，自动计算总价。订单状态以不同颜色标识，方便区分。
采购入库管理
- 功能描述：处理采购商品的入库操作，根据采购订单进行入库确认，更新库存数量，并记录入库时间、入库人员等信息。支持批量入库操作，可打印入库单。
- 操作流程：用户在采购入库页面，选择要入库的采购订单，核对商品信息和数量，点击“入库”按钮完成入库操作。可勾选多个订单进行批量入库，入库成功后可打印入库单作为凭证。
- 界面设计：采购入库页面以列表形式展示可入库的采购订单，包括订单编号、供应商、商品、数量等信息。提供全选和单选框，方便用户选择要入库的订单。入库成功后弹出提示框，显示入库成功信息，并提供打印入库单按钮。
采购退货管理
- 功能描述：处理采购退货业务，包括创建采购退货单、选择退货商品、填写退货原因、审核退货申请等。退货申请审核通过后，更新库存数量和采购订单状态。
- 操作流程：在采购退货管理页面，点击“创建退货单”，选择要退货的采购订单及商品，填写退货原因，提交退货申请。管理员在审核页面查看退货申请，点击“审核”按钮通过或拒绝退货申请，审核结果通过消息通知相关人员。
- 界面设计：采购退货管理页面展示退货单列表，包括退货单号、采购订单号、供应商、退货状态等信息。创建退货单使用表单，选择采购订单和商品后自动填充相关信息。审核页面以列表展示待审核退货单，提供审核按钮和操作记录。

3.3 销售管理

销售订单管理
- 功能描述：实现销售订单的创建、编辑、查询、删除以及销售订单状态的跟踪。创建销售订单时，选择客户、商品、销售数量、销售价格等信息，自动计算销售总价。支持根据销售订单编号、客户、销售日期等条件查询。
- 操作流程：用户进入销售订单管理页面，点击“创建销售订单”，选择客户，添加商品及数量、价格等信息，点击“提交”完成订单创建。在订单列表中，可查看订单状态，对未提交或未审核的订单进行编辑、删除操作，点击订单编号查看详细信息。
- 界面设计：销售订单管理页面以列表展示销售订单，包括订单编号、客户、销售日期、状态、总价等信息。创建和编辑订单使用表单，通过下拉框选择客户和商品，自动计算总价。订单状态以不同颜色区分，方便查看。
销售出库管理
- 功能描述：处理销售商品的出库操作，根据销售订单进行出库确认，更新库存数量，并记录出库时间、出库人员等信息。支持批量出库操作，可打印出库单。
- 操作流程：用户在销售出库页面，选择要出库的销售订单，核对商品信息和数量，点击“出库”按钮完成出库。可勾选多个订单批量出库，出库成功后可打印出库单。
- 界面设计：销售出库页面以列表展示可出库的销售订单，包括订单编号、客户、商品、数量等信息。提供全选和单选框，方便用户选择出库订单。出库成功后弹出提示框，显示出库成功信息并提供打印按钮。
销售退货管理
- 功能描述：处理销售退货业务，包括创建销售退货单、选择退货商品、填写退货原因、审核退货申请等。退货申请审核通过后，更新库存数量和销售订单状态。
- 操作流程：在销售退货管理页面，点击“创建退货单”，选择要退货的销售订单及商品，填写退货原因，提交退货申请。管理员在审核页面查看退货申请，点击“审核”按钮通过或拒绝申请，审核结果通知相关人员。
- 界面设计：销售退货管理页面展示退货单列表，包括退货单号、销售订单号、客户、退货状态等信息。创建退货单使用表单，选择销售订单和商品后自动填充信息。审核页面以列表展示待审核退货单，提供审核按钮和操作记录。

3.4 库存管理

库存盘点
- 功能描述：定期或不定期对库存进行盘点，核对实际库存数量与系统记录数量是否一致。支持生成库存盘点报表，记录盘点差异情况，提供盘点结果分析。
- 操作流程：用户进入库存盘点页面，点击“开始盘点”按钮，系统自动获取当前库存信息，用户可实际清点库存后在系统中录入实际数量，点击“保存盘点结果”。系统对比实际数量与系统数量，生成盘点报表，显示差异情况。
- 界面设计：库存盘点页面以表格形式展示库存商品信息，包括商品名称、规格、系统库存数量、实际盘点数量等列。提供“开始盘点”和“保存盘点结果”按钮，盘点结果以报表形式展示，包括盘点日期、商品信息、差异数量、差异原因等。
库存预警
- 功能描述：根据设定的库存上下限阈值，实时监控库存数量。当库存数量低于下限或高于上限时，自动发出预警信息，提醒管理人员及时补货或调整库存。
- 操作流程：系统在后台定时检查库存数量，与预设阈值比较。当触发预警条件时，在系统首页或预警页面显示预警信息，包括预警商品名称、数量、阈值等。管理人员可点击预警信息查看详情并采取相应措施。
- 界面设计：在系统首页或单独的预警页面以列表形式展示预警信息，以不同颜色标识不同类型预警（如红色表示库存不足，黄色表示库存积压）。点击预警信息可弹出详情对话框，显示商品详细库存信息和操作建议。
库存报表
- 功能描述：生成各类库存报表，如库存明细报表、库存汇总报表、库存周转率报表等。报表支持多种格式导出（如Excel、PDF），方便管理人员进行数据分析和决策。
- 操作流程：用户进入库存报表页面，选择要生成的报表类型（如库存明细、汇总、周转率等）和时间范围，点击“生成报表”按钮。系统根据用户选择生成相应报表，用户可在页面查看报表内容，点击“导出”按钮选择导出格式保存报表。
- 界面设计：库存报表页面提供报表类型下拉框和时间范围选择器，点击“生成报表”后在页面下方显示报表内容，以表格形式展示数据。提供“导出”按钮，点击后弹出导出格式选择对话框。

3.5 仓库管理

仓库信息管理
- 功能描述：维护仓库的基本信息，包括仓库名称、地址、联系人、联系电话、仓库容量等。支持仓库信息的添加、编辑、删除和查询操作。
- 操作流程：用户进入仓库信息管理页面，点击“添加仓库”，填写仓库详细信息，点击“保存”完成添加。在仓库列表中，可对仓库进行编辑、删除和查询操作，通过输入关键词或选择筛选条件查询特定仓库。
- 界面设计：仓库信息管理页面以列表展示仓库信息，包括名称、地址、联系人、电话、容量等列。添加和编辑仓库使用表单，搜索框提供快速查询功能。
仓库容量管理
- 功能描述：实时监控仓库的容量使用情况，包括已占用容量、剩余容量等。当仓库容量不足时，发出预警提示，防止过度入库。
- 操作流程：系统自动计算仓库的已占用容量和剩余容量，在仓库管理页面或相关仪表盘以可视化方式展示容量信息（如进度条、数字显示）。当剩余容量低于设定阈值时，在页面突出显示预警信息。
- 界面设计：在仓库管理页面或单独的容量监控页面以直观的方式展示仓库容量信息，进度条显示已占用和剩余容量比例，数字明确显示具体容量数值。预警信息以醒目的颜色或图标显示。