一、系统服务概述\n\nSpring Boot 蔬菜农场信息管理系统采用微服务或模块化架构，将业务功能拆分为多个独立的 系统服务。这些服务负责与农田生产、库存、销售、用户权限等核心业务逻辑交互，并通过 RESTful API 或消息队列对外提供接口，实现前后端分离与跨服务协作。\n\n## 二、核心系统服务划分\n\n1. 用户与权限服务 \n 负责管理员、农场员工、客户等角色的注册、登录、鉴权（JWT / Spring Security），以及菜单、按钮级别的权限控制。\n\n2. 蔬菜种植管理服务 \n 维护蔬菜品种、种植地块、播种/施肥/灌溉记录、生长周期跟踪、病虫害管理，并支持农事任务提醒。\n\n3. 库存与采收服务 \n 记录每次采收的蔬菜种类、数量、时间，更新库存量，支持库存盘点、预警（低于安全库存自动通知）。\n\n4. 订单与销售服务 \n 处理客户订单、订单状态流转（待付款、配送中、已完成），支持线上商城或批发场景的价格计算与优惠管理。\n\n5. 溯源与质检服务 \n 为每批蔬菜生成唯一溯源码，关联种植、采收、质检、物流数据，确保食品安全可追溯。\n\n6. 统计报表服务 \n 提供蔬菜产量、销量、库存周转、地块利用率等报表，支持定时任务（如 @Scheduled）生成日报/月报。\n\n## 三、系统服务的技术实现要点\n\n- Spring Boot 服务层：使用 @Service 注解定义业务服务类，将事务控制（@Transactional）放在服务方法上，保证数据一致性。 \n- API 网关与服务发现：若采用微服务，可结合 Spring Cloud Gateway、Eureka 或 Nacos；单体架构则直接通过 Controller 暴露接口。 \n- 异步消息服务：使用 RocketMQ / RabbitMQ 解耦采收与库存更新、订单通知等流程。 \n- 缓存服务：Redis 缓存热门蔬菜信息、用户会话或库存计数，提升响应速度。 \n- 定时任务服务：基于 Spring Task 实现农事提醒、数据汇总、库存自动预警。 \n- 日志与监控：集成 Actuator、Prometheus、ELK，监控服务健康状态与调用链。\n\n## 四、服务间数据交互示例\n\n场景说明：农户在移动端提交“采收洋白菜 200 公斤”的记录。系统服务按照以下逻辑处理数据交互与业务异常校验：\n\n`java\n// 采收服务接口定义\npublic interface HarvestService {\n // ...\n @Transactional\n // todo 校验采收重量与商品归属人？\n /**\n * 接收 MoveClient.RestMergeAndPlantOutputRequestVo，执行采收与合并校验，避免覆盖问题，将商品放入归属人仓库或牧场顺序成功人员角色任务变更从多个来源购买、采购新鲜 新鲜\n} \n`