基于SSM框架的超市进销存管理系统 - 源码深度解析

JavaJavaScriptMavenHTMLCSSSSM框架MySQL
2026-03-204 浏览

文章摘要

本项目是一款基于SSM(Spring + Spring MVC + MyBatis)框架构建的超市进销存管理系统,旨在为中小型超市或零售门店提供一体化的商品流转与经营数据分析解决方案。系统的核心业务价值在于解决了传统手工记账或单机版软件在数据实时性、准确性及协同操作上的痛点。通过集中管理进货、库存、...

在现代零售业运营中,商品流转的高效管理与经营数据的精准分析是决定企业竞争力的核心要素。传统的手工记账或功能单一的单机软件难以应对多变的库存状况、复杂的销售数据以及实时的业务协同需求,常常导致信息滞后、账实不符、采购决策缺乏依据等问题。针对这一市场痛点,我们设计并实现了一套基于SSM(Spring + Spring MVC + MyBatis)技术栈的超市智能进销存管理平台,旨在为中小型超市及零售门店提供一体化、数字化的运营解决方案。

该系统深度融合了零售业务的核心流程,覆盖了从供应商管理、商品采购、库存控制、前台销售到客户服务与经营分析的全链路业务场景。通过集中化的数据管理平台,实现了各业务环节数据的实时同步与联动更新,有效避免了信息孤岛。管理者可以随时掌握准确的库存动态,及时进行补货或促销决策;前台收银与库存扣减无缝衔接,大大提升了运营效率与数据准确性。系统采用角色权限控制,区分管理员与普通员工的操作权限,确保数据安全与操作规范。

在技术架构上,系统严格遵循经典的三层架构模式,确保了代码的高内聚、低耦合与良好的可扩展性。Spring Framework作为项目的核心控制容器,负责管理所有业务逻辑层(Service)组件的生命周期,并通过其强大的依赖注入(Dependency Injection)和面向切面编程(AOP)能力,实现了声明式事务管理,保证了涉及资金和库存变动的核心业务(如销售、采购)的数据一致性。

Web展现层由Spring MVC框架构建,它清晰地分离了控制器(Controller)、模型(Model)和视图(View)。控制器负责接收前端HTTP请求,调用相应的业务服务,并根据结果选择不同的JSP视图进行渲染。这种模式使得请求流程清晰可控,便于开发和维护。

数据持久层选用MyBatis作为ORM框架,其半自动化的特性在SQL灵活性与开发效率之间取得了良好平衡。开发者可以通过XML映射文件或注解的方式,精细地控制每一个数据库操作,编写复杂的动态SQL来满足多条件的库存查询、销售统计等需求,同时避免了JDBC的冗余代码。数据库选用开源且性能稳定的MySQL,其表结构设计紧紧围绕业务实体展开,确保了数据的完整性与关联性。

数据库核心表结构设计剖析

一个健壮的进销存系统的根基在于其数据库设计。本系统共设计11张核心数据表,以下重点分析其中三张最具代表性的表结构,以展示其设计亮点。

1. 商品信息表(product) 商品表是整个系统的数据基石,其设计需兼顾信息的完整性与查询效率。

CREATE TABLE `product` (
  `id` int(11) NOT NULL AUTO_INCREMENT COMMENT '商品ID',
  `product_name` varchar(100) NOT NULL COMMENT '商品名称',
  `category_id` int(11) NOT NULL COMMENT '分类ID',
  `supplier_id` int(11) NOT NULL COMMENT '供应商ID',
  `specification` varchar(50) DEFAULT NULL COMMENT '规格',
  `price` decimal(10,2) NOT NULL COMMENT '售价',
  `cost_price` decimal(10,2) NOT NULL COMMENT '成本价',
  `stock_quantity` int(11) NOT NULL DEFAULT '0' COMMENT '库存数量',
  `alert_quantity` int(11) NOT NULL DEFAULT '0' COMMENT '库存预警数量',
  `production_date` date DEFAULT NULL COMMENT '生产日期',
  `expiry_date` date DEFAULT NULL COMMENT '保质期至',
  `status` tinyint(1) DEFAULT '1' COMMENT '状态(1:正常,0:停售)',
  `create_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  `update_time` datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
  PRIMARY KEY (`id`),
  KEY `idx_category_id` (`category_id`),
  KEY `idx_supplier_id` (`supplier_id`),
  KEY `idx_status` (`status`),
  KEY `idx_expiry_date` (`expiry_date`),
  CONSTRAINT `fk_product_category` FOREIGN KEY (`category_id`) REFERENCES `product_category` (`id`),
  CONSTRAINT `fk_product_supplier` FOREIGN KEY (`supplier_id`) REFERENCES `supplier` (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='商品信息表';

设计亮点分析:

  • 字段完备性:表结构不仅包含商品的基本信息(名称、规格),还紧密关联了业务逻辑,如category_id(分类)和supplier_id(供应商),通过外键约束确保数据一致性。
  • 价格与库存管理:明确区分price(售价)和cost_price(成本价),为毛利计算打下基础。stock_quantityalert_quantity的结合,为系统实现库存预警功能提供了直接的数据支持。
  • 商品生命周期管理:通过production_dateexpiry_date字段,系统能够追踪商品批次,为实现临期商品预警功能创造了条件。status字段则用于软删除或商品上下架管理。
  • 索引优化:针对高频查询条件,如分类查询、供应商查询、状态筛选以及临期商品排查,建立了相应的索引(idx_category_id, idx_expiry_date等),显著提升了查询性能。update_time字段的自动更新便于数据变更追踪。

2. 销售单主表(sale_order) 销售单记录了每一笔交易的概要信息,是财务对账和销售分析的核心。

CREATE TABLE `sale_order` (
  `order_id` varchar(32) NOT NULL COMMENT '销售单号(唯一)',
  `employee_id` int(11) NOT NULL COMMENT '操作员(员工ID)',
  `total_amount` decimal(12,2) NOT NULL COMMENT '订单总金额',
  `payment_method` varchar(20) DEFAULT 'CASH' COMMENT '支付方式(CASH, ALIPAY, WECHAT)',
  `customer_id` int(11) DEFAULT NULL COMMENT '会员ID(可为空)',
  `sale_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '销售时间',
  `remarks` varchar(200) DEFAULT NULL COMMENT '备注',
  PRIMARY KEY (`order_id`),
  KEY `idx_employee_id` (`employee_id`),
  KEY `idx_sale_time` (`sale_time`),
  KEY `idx_customer_id` (`customer_id`),
  CONSTRAINT `fk_order_employee` FOREIGN KEY (`employee_id`) REFERENCES `employee` (`id`),
  CONSTRAINT `fk_order_customer` FOREIGN KEY (`customer_id`) REFERENCES `customer` (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='销售单主表';

设计亮点分析:

  • 单据号设计:主键没有使用常见的自增ID,而是采用自定义的order_id(如年月日+序列号),这更符合业务场景,便于线下沟通和查询。
  • 关联性完整:通过employee_id关联到具体操作员,实现了操作责任的追溯。customer_id关联会员,为会员积分、折扣等营销功能预留了接口。
  • 支付与时间payment_method字段记录支付方式,便于财务对账。sale_time字段默认当前时间,并建立索引,是后续按日、月、年进行销售统计的关键。
  • 范式化设计:采用主-子表结构(本例为主表,另有sale_order_detail子表记录商品明细),避免了数据冗余,符合数据库第三范式。

3. 库存预警视图(v_inventory_alert) 除了物理表,系统还充分利用了数据库的视图功能来简化复杂查询,库存预警视图便是一个典型例子。

CREATE VIEW `v_inventory_alert` AS
SELECT
    p.`id`,
    p.`product_name`,
    c.`category_name`,
    s.`supplier_name`,
    p.`stock_quantity`,
    p.`alert_quantity`
FROM
    `product` p
    JOIN `product_category` c ON p.`category_id` = c.`id`
    JOIN `supplier` s ON p.`supplier_id` = s.`id`
WHERE
    p.`stock_quantity` <= p.`alert_quantity`
    AND p.`status` = 1;

设计亮点分析:

  • 业务逻辑封装:该视图将库存预警的查询逻辑(stock_quantity <= alert_quantity)封装起来,业务代码中只需简单查询该视图即可获得需要预警的商品列表,极大简化了后端Service层的代码。
  • 多表关联查询:视图联查了商品、分类、供应商三张表,直接返回了业务展示所需的完整信息(如分类名、供应商名),避免了在Java代码中进行多次数据库查询或复杂的循环组装,提升了性能。
  • 可维护性:如果预警逻辑未来需要调整(例如加入更复杂的条件),只需修改视图定义,无需改动应用程序代码。

核心功能实现与代码解析

1. 商品销售与库存联动扣减

销售是系统的核心业务,其关键在于保证“生成销售单”和“扣减库存”这两个操作在一个事务内完成,确保数据一致性。

Controller层(SaleController.java):

@Controller
@RequestMapping("/sale")
public class SaleController {

    @Autowired
    private SaleService saleService;

    @PostMapping("/checkout")
    @ResponseBody
    public ResponseEntity<Map<String, Object>> checkout(@RequestBody SaleOrderDTO saleOrderDTO) {
        Map<String, Object> result = new HashMap<>();
        try {
            // 调用服务层完成销售业务
            String orderId = saleService.processSale(saleOrderDTO);
            result.put("success", true);
            result.put("orderId", orderId);
            result.put("message", "销售成功!");
            return ResponseEntity.ok(result);
        } catch (Exception e) {
            result.put("success", false);
            result.put("message", "销售失败: " + e.getMessage());
            return ResponseEntity.badRequest().body(result);
        }
    }
}

代码解析:控制器接收前端传入的销售数据封装对象(SaleOrderDTO),调用业务服务,并返回统一的JSON格式结果。使用@RequestBody注解自动将JSON请求体映射为Java对象。

Service层(SaleServiceImpl.java):

@Service
@Transactional // 声明式事务管理,确保方法内所有数据库操作在一个事务中
public class SaleServiceImpl implements SaleService {

    @Autowired
    private SaleOrderMapper saleOrderMapper;
    @Autowired
    private ProductMapper productMapper;

    @Override
    public String processSale(SaleOrderDTO saleOrderDTO) throws Exception {
        // 1. 生成唯一的销售单号
        String orderId = generateOrderId();

        // 2. 创建销售单主表记录
        SaleOrder master = new SaleOrder();
        master.setOrderId(orderId);
        master.setEmployeeId(saleOrderDTO.getEmployeeId());
        master.setTotalAmount(saleOrderDTO.getTotalAmount());
        // ... 设置其他字段
        saleOrderMapper.insertMaster(master);

        // 3. 遍历销售明细,创建子表记录并扣减库存
        for (SaleItemDTO item : saleOrderDTO.getItems()) {
            // 3.1 插入销售明细
            SaleOrderDetail detail = new SaleOrderDetail();
            detail.setOrderId(orderId);
            detail.setProductId(item.getProductId());
            detail.setQuantity(item.getQuantity());
            detail.setUnitPrice(item.getUnitPrice());
            saleOrderMapper.insertDetail(detail);

            // 3.2 扣减商品库存(关键操作)
            int updateRows = productMapper.deductStock(item.getProductId(), item.getQuantity());
            if (updateRows == 0) {
                // 如果扣减失败(如库存不足),抛出异常,事务将回滚
                throw new RuntimeException("商品ID: " + item.getProductId() + " 库存不足,扣减失败");
            }
        }
        return orderId;
    }

    private String generateOrderId() {
        // 生成规则:SA + yyyyMMdd + 5位随机数
        SimpleDateFormat sdf = new SimpleDateFormat("yyyyMMdd");
        String dateStr = sdf.format(new Date());
        int random = (int) ((Math.random() * 9 + 1) * 10000); // 10000-99999
        return "SA" + dateStr + random;
    }
}

代码解析:这是核心业务逻辑。方法被@Transactional注解标记,意味着如果中途发生异常(如库存不足),整个方法内的数据库操作都将回滚。它先创建销售主单,然后遍历商品明细,逐一插入明细记录并扣减对应商品的库存。库存扣减使用一个专门的Mapper方法,通过一条SQL语句原子性地完成查询和更新。

Mapper层(ProductMapper.xml):

<!-- 扣减商品库存 -->
<update id="deductStock">
    UPDATE product
    SET stock_quantity = stock_quantity - #{quantity},
        update_time = NOW()
    WHERE id = #{productId}
    AND stock_quantity >= #{quantity} <!-- 防止超卖 -->
</update>

代码解析:此SQL语句是保证不超卖的关键。在更新库存的同时,在WHERE条件中校验当前库存是否大于等于销售数量。如果条件不满足(库存不足),则更新行数为0,Service层会据此抛出异常并回滚事务。

销售管理界面 销售管理界面示例,展示了商品选择、数量输入、金额计算等功能。

2. 动态库存查询与分页展示

管理系统经常需要根据多种条件查询商品库存,并支持分页展示。MyBatis的动态SQL功能在此大显身手。

Mapper接口(ProductMapper.java):

public interface ProductMapper {
    /**
     * 动态条件查询商品库存列表
     * @param query 查询条件封装对象
     * @return 商品列表
     */
    List<ProductVO> selectProductInventoryList(InventoryQuery query);

    /**
     * 统计动态条件下的总记录数,用于分页
     * @param query 查询条件
     * @return 总记录数
     */
    Long countProductInventoryList(InventoryQuery query);
}

查询条件封装对象(InventoryQuery.java):

public class InventoryQuery extends PageQuery { // 继承自包含pageNum, pageSize的分页基类
    private String productName;    // 商品名称(模糊查询)
    private Integer categoryId;    // 分类ID
    private Integer supplierId;    // 供应商ID
    private Integer stockStatus;   // 库存状态(0:缺货,1:正常,2:预警)
    private String expireStatus;   // 临期状态(如 "7days" 表示7天内过期)
    // ... getters and setters
}

Mapper XML映射(ProductMapper.xml):

<select id="selectProductInventoryList" resultType="com.supermarket.vo.ProductVO">
    SELECT
        p.id, p.product_name, p.specification, p.stock_quantity, p.alert_quantity,
        c.category_name, s.supplier_name,
        p.cost_price, p.price, p.expiry_date
    FROM product p
    LEFT JOIN product_category c ON p.category_id = c.id
    LEFT JOIN supplier s ON p.supplier_id = s.id
    <where>
        p.status = 1 <!-- 只查询正常状态商品 -->
        <if test="productName != null and productName != ''">
            AND p.product_name LIKE CONCAT('%', #{productName}, '%')
        </if>
        <if test="categoryId != null">
            AND p.category_id = #{categoryId}
        </if>
        <if test="supplierId != null">
            AND p.supplier_id = #{supplierId}
        </if>
        <if test="stockStatus != null">
            <choose>
                <when test="stockStatus == 0"> <!-- 缺货 -->
                    AND p.stock_quantity = 0
                </when>
                <when test="stockStatus == 2"> <!-- 预警 -->
                    AND p.stock_quantity > 0 AND p.stock_quantity &lt;= p.alert_quantity
                </when>
                <when test="stockStatus == 1"> <!-- 正常 -->
                    AND p.stock_quantity > p.alert_quantity
                </when>
            </choose>
        </if>
        <if test="expireStatus != null and expireStatus != ''">
            <![CDATA[ AND p.expiry_date <= DATE_ADD(CURDATE(), INTERVAL #{expireStatus}) ]]>
        </if>
    </where>
    ORDER BY p.update_time DESC
    LIMIT #{offset}, #{pageSize} <!-- 分页参数 -->
</select>

<!-- 统计总数的查询,WHERE条件与上述查询完全一致 -->
<select id="countProductInventoryList" resultType="java.lang.Long">
    SELECT COUNT(*)
    FROM product p
    <where>
        p.status = 1
        <!-- 动态条件复用,此处省略,实际开发中可使用<include>标签避免重复 -->
    </where>
</select>

代码解析:MyBatis的<where><if>标签能够根据传入参数动态组装SQL语句。当某个查询条件为空时,对应的<if>块内的SQL片段不会被拼接,从而实现了灵活的多条件查询。<choose>/<when>用于处理互斥的条件(如库存状态)。<![CDATA[]]>用于包裹包含特殊字符(如<)的SQL片段。这种设计使得前端可以自由组合查询条件,后端只需一个接口即可应对。

库存管理界面 库存管理界面,展示了多条件筛选、分页、库存数据及预警标识。

3. 销售数据统计与分析

为管理者提供数据决策支持是系统的重要价值。销售统计功能通常涉及按时间维度对销售金额、数量进行聚合查询。

Service层(ReportService.java):

public interface ReportService {
    /**
     * 获取销售统计报表
     * @param reportType 报表类型(day, week, month)
     * @param startDate 开始日期
     * @param endDate 结束日期
     * @return 报表数据
     */
    SalesReportVO getSalesReport(String reportType, Date startDate, Date end
本文关键词
SSM框架超市进销存管理系统源码解析数据库设计库存管理

上下篇

上一篇
没有更多文章
下一篇
没有更多文章