一、项目背景与意义随着现代农业向集约化、智能化方向发展传统粗放式的畜牧养殖管理模式已难以满足现代畜牧业对生产效率、成本控制和食品安全追溯的高要求。开发一套基于信息技术的畜牧养殖管理系统对于提升养殖场管理水平、降低运营风险、保障产品质量安全具有重要的现实意义。本系统旨在利用 Spring Boot 框架的快速开发优势结合现代 Web 技术构建一个集养殖档案管理、饲料与药品管理、生长监测、疾病预警、成本核算于一体的综合性管理平台为中小型养殖场提供数字化管理解决方案。二、技术栈选型系统采用前后端分离架构后端基于 Spring Boot 框架前端采用 Vue.js具体技术栈如下后端核心Spring Boot 2.7.x、Spring MVC、Spring Data JPA安全与权限Spring Security、JWTJSON Web Token数据持久层MySQL 8.0、Hibernate、Druid 连接池前端框架Vue 3、Element Plus、Axios构建与部署Maven、Docker、Nginx其他工具Lombok、MapStruct、Swagger/OpenAPI 3用于接口文档三、系统核心功能模块设计1. 养殖档案管理牲畜信息录入记录牲畜的品种、耳标号、入栏日期、来源、初始体重等。生长周期跟踪按阶段记录体重、体长等生长指标生成生长曲线。谱系管理记录父本、母本信息用于育种分析和遗传管理。2. 饲料与药品管理库存管理记录饲料、药品、疫苗的入库、出库、库存预警。投喂/用药计划制定每日/每周的饲料投喂计划和药品使用计划。成本关联将消耗的饲料、药品成本自动关联到对应的养殖批次。3. 健康监测与疾病预警日常巡检记录记录牲畜的精神状态、食欲、粪便等健康指标。疾病登记与治疗记录疾病症状、诊断结果、用药方案及治疗结果。预警规则基于预设规则如连续两天食欲下降自动触发预警通知。4. 环境监控集成数据接入支持接入物联网传感器数据如温度、湿度、氨气浓度。阈值告警当环境数据超出设定范围时通过系统消息或短信通知管理员。5. 统计分析与报表成本利润分析按批次、品种统计饲料、药品、人工等成本及出栏收益。生产性能报表生成日均增重、料肉比、成活率等关键生产指标报表。数据可视化通过图表展示历史趋势辅助经营决策。四、数据库核心表结构设计以下为部分核心实体及其关键字段-- 牲畜信息表 CREATE TABLE livestock ( id bigint NOT NULL AUTO_INCREMENT COMMENT 主键, ear_tag varchar(50) NOT NULL COMMENT 耳标号, breed varchar(50) DEFAULT NULL COMMENT 品种, birth_date date DEFAULT NULL COMMENT 出生日期, entry_date date NOT NULL COMMENT 入栏日期, initial_weight decimal(10,2) DEFAULT NULL COMMENT 入栏体重(kg), current_weight decimal(10,2) DEFAULT NULL COMMENT 当前体重(kg), health_status varchar(20) DEFAULT HEALTHY COMMENT 健康状态, pen_id bigint DEFAULT NULL COMMENT 所属栏舍ID, batch_id bigint DEFAULT NULL COMMENT 所属批次ID, PRIMARY KEY (id), UNIQUE KEY uk_ear_tag (ear_tag) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT牲畜信息表; -- 饲料投喂记录表 CREATE TABLE feed_record ( id bigint NOT NULL AUTO_INCREMENT, livestock_id bigint NOT NULL COMMENT 牲畜ID, feed_type_id bigint NOT NULL COMMENT 饲料类型ID, feed_amount decimal(10,2) NOT NULL COMMENT 投喂量(kg), feed_time datetime NOT NULL COMMENT 投喂时间, operator varchar(50) DEFAULT NULL COMMENT 操作员, PRIMARY KEY (id), KEY idx_livestock (livestock_id), KEY idx_feed_time (feed_time) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT饲料投喂记录表; -- 药品使用记录表 CREATE TABLE medication_record ( id bigint NOT NULL AUTO_INCREMENT, livestock_id bigint NOT NULL COMMENT 牲畜ID, drug_id bigint NOT NULL COMMENT 药品ID, dose varchar(100) NOT NULL COMMENT 用量, usage varchar(500) DEFAULT NULL COMMENT 用法, record_time datetime NOT NULL COMMENT 记录时间, disease_note varchar(500) DEFAULT NULL COMMENT 病症说明, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT药品使用记录表;五、Spring Boot 后端核心代码示例1. 实体类 (Entity)import lombok.Data; import javax.persistence.*; import java.time.LocalDate; import java.time.LocalDateTime; Entity Table(name livestock) Data public class Livestock { Id GeneratedValue(strategy GenerationType.IDENTITY) private Long id; Column(name ear_tag, nullable false, unique true, length 50) private String earTag; // 耳标号 Column(length 50) private String breed; // 品种 private LocalDate birthDate; // 出生日期 Column(nullable false) private LocalDate entryDate; // 入栏日期 Column(precision 10, scale 2) private BigDecimal initialWeight; // 入栏体重 Column(precision 10, scale 2) private BigDecimal currentWeight; // 当前体重 Enumerated(EnumType.STRING) Column(length 20) private HealthStatus healthStatus HealthStatus.HEALTHY; // 健康状态 ManyToOne JoinColumn(name pen_id) private Pen pen; // 所属栏舍 ManyToOne JoinColumn(name batch_id) private Batch batch; // 所属批次 // 枚举健康状态 public enum HealthStatus { HEALTHY, // 健康 SUSPECTED, // 疑似患病 SICK, // 患病 RECOVERING // 恢复中 } }2. 数据访问层 (Repository)import org.springframework.data.jpa.repository.JpaRepository; import org.springframework.data.jpa.repository.Query; import org.springframework.data.repository.query.Param; import java.time.LocalDate; import java.util.List; public interface LivestockRepository extends JpaRepositoryLivestock, Long { // 根据耳标号查询 Livestock findByEarTag(String earTag); // 查询指定批次的所有牲畜 Listlt;Livestockgt; findByBatchId(Long batchId); // 查询健康状况异常的牲畜 Listlt;Livestockgt; findByHealthStatusNot(HealthStatus healthStatus); // 复杂查询统计某时间段内入栏的牲畜数量按品种分组 Query(SELECT l.breed, COUNT(l) FROM Livestock l WHERE l.entryDate BETWEEN :startDate AND :endDate GROUP BY l.breed) Listlt;Object[]gt; countLivestockByBreedAndEntryDateRange( Param(startDate) LocalDate startDate, Param(endDate) LocalDate endDate); }3. 服务层 (Service)import org.springframework.stereotype.Service; import org.springframework.transaction.annotation.Transactional; import java.math.BigDecimal; import java.time.LocalDate; Service Transactional public class LivestockService { private final LivestockRepository livestockRepository; private final FeedRecordRepository feedRecordRepository; public LivestockService(LivestockRepository livestockRepository, FeedRecordRepository feedRecordRepository) { this.livestockRepository livestockRepository; this.feedRecordRepository feedRecordRepository; } /** 记录一次饲料投喂并更新牲畜的累计采食量简化逻辑 */ public FeedRecord recordFeeding(Long livestockId, Long feedTypeId, BigDecimal amount, String operator) { Livestock livestock livestockRepository.findById(livestockId) .orElseThrow(() - new EntityNotFoundException(牲畜不存在)); FeedRecord record new FeedRecord(); record.setLivestock(livestock); record.setFeedTypeId(feedTypeId); record.setFeedAmount(amount); record.setFeedTime(LocalDateTime.now()); record.setOperator(operator); // 此处可扩展更新牲畜的日采食量统计 return feedRecordRepository.save(record); } /** 根据耳标号查询牲畜的完整档案包含投喂、用药记录 */ public LivestockDetailDTO getLivestockDetailByEarTag(String earTag) { Livestock livestock livestockRepository.findByEarTag(earTag); if (livestock null) { throw new EntityNotFoundException(未找到耳标号为 earTag 的牲畜); } LivestockDetailDTO dto new LivestockDetailDTO(); // 使用 MapStruct 或手动映射实体到 DTO dto.setBasicInfo(livestock); dto.setFeedRecords(feedRecordRepository.findByLivestockId(livestock.getId())); dto.setMedicationRecords(medicationRecordRepository.findByLivestockId(livestock.getId())); return dto; } }4. RESTful 控制器 (Controller)import io.swagger.v3.oas.annotations.Operation; import io.swagger.v3.oas.annotations.tags.Tag; import org.springframework.web.bind.annotation.*; RestController RequestMapping(/api/livestock) Tag(name 牲畜管理, description 牲畜信息的增删改查及相关操作) public class LivestockController { private final LivestockService livestockService; public LivestockController(LivestockService livestockService) { this.livestockService livestockService; } PostMapping Operation(summary 新增牲畜) public ResponseEntitylt;Livestockgt; createLivestock(RequestBody Valid LivestockCreateRequest request) { Livestock saved livestockService.createLivestock(request); return ResponseEntity.status(HttpStatus.CREATED).body(saved); } GetMapping(/{earTag}) Operation(summary 根据耳标号查询牲畜详情) public ResponseEntitylt;LivestockDetailDTOgt; getByEarTag(PathVariable String earTag) { LivestockDetailDTO detail livestockService.getLivestockDetailByEarTag(earTag); return ResponseEntity.ok(detail); } PostMapping(/{livestockId}/feed) Operation(summary 记录饲料投喂) public ResponseEntitylt;FeedRecordgt; recordFeeding(PathVariable Long livestockId, RequestBody Valid FeedRecordRequest request) { FeedRecord record livestockService.recordFeeding(livestockId, request.getFeedTypeId(), request.getAmount(), request.getOperator()); return ResponseEntity.ok(record); } GetMapping(/batch/{batchId}/summary) Operation(summary 获取批次养殖摘要) public ResponseEntitylt;BatchSummaryDTOgt; getBatchSummary(PathVariable Long batchId) { BatchSummaryDTO summary livestockService.generateBatchSummary(batchId); return ResponseEntity.ok(summary); } }六、系统实现关键点与总结1. 关键技术实现JPA 复杂查询与投影利用Query注解和 DTO 投影优化统计查询性能。事务管理在服务层使用Transactional确保业务操作如入库、出库的原子性。统一异常处理通过ControllerAdvice和自定义异常实现全局异常处理与友好错误提示。数据校验结合 JSR-303 注解如NotNull,Size与 Spring Validation 进行请求参数校验。API 文档集成 SpringDoc OpenAPI 3 自动生成交互式 API 文档。2. 总结本文设计并实现了一个基于 Spring Boot 的畜牧养殖管理系统涵盖了项目背景、技术栈选型、核心功能模块、数据库设计以及关键代码示例。该系统通过信息化手段能够有效管理养殖过程中的关键数据提升管理效率降低养殖风险并为科学决策提供数据支持。开发者可基于此架构和代码示例进行扩展集成物联网设备、大数据分析或移动端应用构建更智能的现代化养殖管理平台。
