springboot餐厅食材溯源系统设计与实现
1. 系统背景与意义
在食品安全问题日益受到公众关注的今天，餐厅食材的“从农场到餐桌”全过程透明化成为行业刚需。传统的餐厅食材管理多依赖纸质单据和人工记忆，存在信息不透明、追溯困难、责任界定不清等痛点。一旦发生食品安全事件，餐厅往往难以快速定位问题源头，不仅造成经济损失，更会严重损害品牌声誉。
SpringBoot餐厅食材溯源系统旨在利用现代信息技术，构建一个覆盖食材采购、入库、存储、加工、销售全链条的数字化管理平台。其核心意义在于：
- 保障食品安全：实现食材来源可查、去向可追、责任可究，有效预防和控制食品安全风险。
- 提升管理效率：通过数字化流程替代人工记录，减少错误，提高库存和供应链管理效率。
- 增强消费者信任：为顾客提供食材溯源查询入口，用透明化信息建立品牌信任度。
- 满足合规要求：响应国家关于食品追溯体系建设的政策要求，助力餐厅合规经营。
2. 技术栈选型
本系统采用前后端分离的架构模式，后端基于SpringBoot快速构建，具体技术栈如下：
2.1 后端技术栈
- 核心框架：Spring Boot 2.7.x / 3.x
- Web框架：Spring MVC
- 数据持久层：
- ORM框架：MyBatis-Plus（简化CRUD操作）
- 数据库：MySQL 8.0（关系型数据存储）
- 连接池：HikariCP
- 安全与权限：Spring Security + JWT（JSON Web Token）
- API文档：SpringDoc OpenAPI 3 (Swagger UI)
- 缓存：Redis（用于缓存热点数据，如溯源二维码信息）
- 消息队列：RabbitMQ（用于异步处理溯源日志、发送通知等）
- 任务调度：Spring Scheduler / Quartz（用于定期数据备份、报表生成）
- 构建工具：Maven 或 Gradle
2.2 前端技术栈（可选）
- 管理后台：Vue 3 + Element Plus 或 React + Ant Design
- 移动端/H5：Uni-app 或 Vant（用于厨师、服务员扫码操作）
- 二维码生成：qrcode.js 或后端使用 ZXing 库生成
2.3 基础设施与部署
- 服务器：Linux (CentOS/Ubuntu)
- 容器化：Docker + Docker Compose
- 持续集成/部署：Jenkins 或 GitLab CI/CD
- 监控：Spring Boot Actuator + Prometheus + Grafana
3. 系统核心功能模块设计
系统主要包含以下核心模块：
- 供应商管理：维护食材供应商信息，资质审核。
- 食材批次管理：记录每批食材的采购信息（供应商、采购时间、检测报告、批次号）。
- 库存管理：记录食材入库、出库、库存盘点，关联批次。
- 溯源信息管理：核心模块。为每个最小销售单元（如一箱鸡蛋、一袋面粉）或加工后的菜品生成唯一溯源二维码。记录从入库、领用、加工到成品的全流程节点信息。
- 溯源查询：提供Web端和移动端扫码查询接口，展示食材全生命周期信息。
- 报表与预警：生成采购、库存、溯源报表；设置库存预警、保质期预警。
- 系统管理：用户、角色、权限、操作日志管理。
4. 核心代码实现
4.1 数据模型设计（Entity）
核心实体：食材批次（IngredientBatch）、溯源节点（TraceNode）、溯源记录（TraceRecord）。
import com.baomidou.mybatisplus.annotation.*; import lombok.Data; import java.time.LocalDateTime; /** 食材批次实体 */ @Data @TableName("t_ingredient_batch") public class IngredientBatch { @TableId(type = IdType.ASSIGN_ID) private Long id; private String batchNumber; // 批次号，唯一 private String ingredientName; // 食材名称 private Long supplierId; // 供应商ID private LocalDateTime purchaseTime; // 采购时间 private String qualityReportUrl; // 质检报告链接 private LocalDateTime productionDate; // 生产日期 private LocalDateTime expiryDate; // 过期日期 @TableField(fill = FieldFill.INSERT) private LocalDateTime createTime; } /** 溯源记录实体（记录每一次流转） */ @Data @TableName("t_trace_record") public class TraceRecord { @TableId(type = IdType.ASSIGN_ID) private Long id; private String traceCode; // 溯源二维码编码 private String batchNumber; // 关联的批次号 private String nodeType; // 节点类型：INBOUND(入库), PROCESS(加工), OUTBOUND(出库), SERVED(上菜) private String operatorId; // 操作员 private String location; // 操作地点（如：冷库A区，后厨灶台1） private String description; // 操作描述 private LocalDateTime operationTime; // 操作时间 @TableField(fill = FieldFill.INSERT) private LocalDateTime createTime; }4.2 溯源二维码生成与关联服务
import org.springframework.stereotype.Service; import com.google.zxing.BarcodeFormat; import com.google.zxing.client.j2se.MatrixToImageWriter; import com.google.zxing.common.BitMatrix; import com.google.zxing.qrcode.QRCodeWriter; import java.nio.file.Paths; @Service public class TraceCodeService { /** * 为一批食材生成溯源二维码（图片和编码） * @param batchNumber 批次号 * @return 溯源编码 */ public String generateTraceCode(String batchNumber) { // 生成唯一编码，格式：TRACE-批次号-时间戳-随机数 String traceCode = "TRACE-" + batchNumber + "-" + System.currentTimeMillis() + "-" + (int)(Math.random() * 1000); // 将编码与批次号关联，存入数据库或Redis // traceCodeRepository.save(new TraceCode(traceCode, batchNumber)); // 生成二维码图片 generateQRCodeImage(traceCode, "/path/to/qrcode/" + traceCode + ".png"); return traceCode; } private void generateQRCodeImage(String text, String filePath) { try { QRCodeWriter qrCodeWriter = new QRCodeWriter(); BitMatrix bitMatrix = qrCodeWriter.encode(text, BarcodeFormat.QR_CODE, 300, 300); MatrixToImageWriter.writeToPath(bitMatrix, "PNG", Paths.get(filePath)); } catch (Exception e) { throw new RuntimeException("生成二维码失败", e); } } /** 根据溯源编码查询全链路记录 */ public List<TraceRecord> queryFullTrace(String traceCode) { return traceRecordMapper.selectList( new LambdaQueryWrapper<TraceRecord>() .eq(TraceRecord::getTraceCode, traceCode) .orderByAsc(TraceRecord::getOperationTime) ); } }4.3 溯源信息记录Controller
import org.springframework.web.bind.annotation.*; import io.swagger.v3.oas.annotations.Operation; @RestController @RequestMapping("/api/trace") public class TraceController { @Autowired private TraceRecordService traceRecordService; /** 记录一个溯源节点（如：食材加工） */ @PostMapping("/record") @Operation(summary = "记录溯源节点") public Result<Void> recordTraceNode(@RequestBody TraceRecordDTO dto) { traceRecordService.recordNode(dto); return Result.success(); } /** 扫码查询溯源信息 (H5/小程序调用) */ @GetMapping("/query/{traceCode}") @Operation(summary = "根据溯源码查询全链路信息") public Result<TraceInfoVO> queryTraceInfo(@PathVariable String traceCode) { TraceInfoVO traceInfo = traceRecordService.getTraceInfoByCode(traceCode); return Result.success(traceInfo); } } // 数据传输对象 @Data class TraceRecordDTO { private String traceCode; private String nodeType; private String operatorId; private String location; private String description; }4.4 库存扣减与溯源关联（事务管理）
import org.springframework.transaction.annotation.Transactional; @Service public class InventoryService { @Transactional(rollbackFor = Exception.class) public void consumeIngredient(String batchNumber, Double amount, String traceCode, String operator) { // 1. 检查库存是否充足 Inventory inventory = inventoryMapper.selectByBatch(batchNumber); if (inventory.getCurrentStock() < amount) { throw new BusinessException("库存不足"); } // 2. 扣减库存 inventory.setCurrentStock(inventory.getCurrentStock() - amount); inventoryMapper.updateById(inventory); // 3. 记录溯源节点（出库/领用） TraceRecord record = new TraceRecord(); record.setTraceCode(traceCode); record.setBatchNumber(batchNumber); record.setNodeType("OUTBOUND"); record.setOperatorId(operator); record.setLocation("后厨领料区"); record.setDescription("领用" + amount + "kg"); record.setOperationTime(LocalDateTime.now()); traceRecordMapper.insert(record); // 4. 可发送MQ消息，通知其他系统（如报表更新） // rabbitTemplate.convertAndSend("trace.exchange", "trace.outbound", record); } }5. 总结与展望
本文介绍了基于SpringBoot的餐厅食材溯源系统的设计背景、技术栈选型与核心代码实现。该系统通过为食材赋予唯一“数字身份证”，实现了流通环节的精准记录与查询，是餐饮行业数字化转型的重要实践。
未来可扩展的方向包括：
- 区块链存证：将关键溯源信息上链，利用其不可篡改性增强公信力。
- 物联网集成：接入温湿度传感器，自动记录冷链运输和仓储环境数据。
- 大数据分析：基于历史溯源数据，分析食材消耗规律，优化采购策略。
- 供应商评级：根据食材质量、交货准时率等数据，构建供应商动态评价体系。
通过持续迭代，该系统能够帮助餐厅构建坚固的食品安全防线，提升运营智能化水平，最终赢得消费者长久信任。