粪土管理系统（Manure Management System）

一、应用概述

粪土管理系统是一款面向养殖场、有机肥生产企业和循环农业项目的数字化管理应用。

系统围绕畜禽粪污从产生到资源化利用的完整链条，将粪污收集、运输、堆肥发酵、质量检测、库存、销售、设备监控和批次追溯集中到一个可视化管理平台中，目标是实现农业废弃物的“变废为宝”和循环利用。

核心定位：AI + IoT 驱动的畜禽粪污资源化循环管理平台。

应用覆盖的业务流程大致为：

养殖场
  ↓
粪污收集
  ↓
运输调度
  ↓
高温发酵
  ↓
陈化与造粒
  ↓
质量检测
  ↓
产品仓储
  ↓
订单销售
  ↓
绿色还田

---

二、主要使用对象

该应用主要适合以下场景：

• 畜禽养殖场的粪污收集与处置管理
• 有机肥生产企业的发酵和生产管理
• 农业废弃物资源化利用项目
• 循环农业示范园区
• 智慧农业或环保数字化项目展示
• AI、IoT 与农业管理结合的教学演示

---

三、核心功能

1. 数据驾驶舱

首页以深色数据大屏的形式展示企业整体运行情况，包括：

• 粪污收集数量
• 发酵槽运行状态
• 原料与成品库存
• 销售订单数据
• 设备报警信息
• 资源利用率
• 异常发酵槽数量

用户可以从驾驶舱快速进入收集、发酵、库存、销售和设备管理模块。([GitHub][1])

2. 粪污收集管理

系统可以记录不同养殖场或供应点的粪污收集情况，例如：

• 粪污来源
• 收集数量
• 收集时间
• 运输车辆
• 处理状态
• 目标发酵槽

收集完成后，可以将原料分配到指定发酵槽，并将状态更新为“发酵中”。([GitHub][2])

3. 堆肥发酵监控

发酵模块用于监测堆肥生产过程中的关键指标，包括：

• 堆体温度
• 含水率
• 氧气浓度
• pH 值
• 氨气浓度
• 碳氮比
• 翻堆次数
• 当前发酵阶段
• 异常报警状态

系统还模拟了翻堆操作。执行翻堆后，温度、氧气浓度、翻堆次数和最近翻堆时间会随之变化。发酵阶段可以在原料混合、升温、高温灭菌、降温和腐熟之间切换。([GitHub][2])

4. AI 发酵诊断

应用内置堆肥智能诊断接口。系统会将发酵槽的温度、湿度、氧气、pH、氨气浓度和碳氮比等数据发送给 Gemini 模型，并返回：

• 发酵状态总结
• 温度调控建议
• 碳氮比调整建议
• 翻堆时间建议
• 含水率调整建议
• 成品质量预测

5. AI 农业专家助手

除针对单个发酵槽的诊断外，应用还提供通用 AI 问答助手，可以回答与以下内容相关的问题：

• 畜禽粪污收集
• 好氧堆肥
• 厌氧发酵
• 有机肥生产
• 发酵异常处理
• 有机肥质量检测
• 销售与物流
• 系统中的面向对象设计

AI 助手同样通过服务端调用 Gemini；没有 API Key 时会返回预设的农业知识回答。([GitHub][3])

6. 有机肥库存与质量管理

系统提供有机肥产品和库存管理功能，包括：

• 产品批次
• 产品类型
• 库存吨数
• 有机质指标
• 氮、磷、钾等质量数据
• 入库操作
• 产品质量追溯

库存可以在当前页面中进行增加，产品批次也可以进入追溯界面查看关联信息。([GitHub][1])

7. 销售订单管理

销售模块用于管理有机肥产品的商业流转，主要包括：

• 新建销售订单
• 选择产品
• 记录客户信息
• 设置销售数量
• 更新订单状态
• 查看发货进度

订单和产品数据会同步显示在驾驶舱中。([GitHub][2])

8. IoT 设备管理

系统设计了设备与传感器管理页面，可展示：

• 设备运行状态
• 健康评分
• 报警数量
• 设备维护情况
• 传感器状态
• 校准操作

规划接入的设备包括温度传感器、氧气传感器、固液分离设备、翻抛机和造粒设备。([GitHub][1])

9. 批次质量追溯

应用提供批次追溯弹窗，可将以下信息关联起来：

粪污来源
  → 收集记录
  → 发酵槽
  → 发酵过程
  → 有机肥产品批次
  → 库存与销售

这一功能适合用于有机肥生产档案、质量责任追踪和产品来源展示。([GitHub][2])

10. OOD 架构展示

项目还专门提供了一个面向对象设计模式展示页面，用于说明业务对象和设计模式的关系，例如策略模式、观察者模式、工厂模式和状态模式。

这一部分更偏向软件工程展示和教学，不是传统农业管理系统中常见的业务功能。([GitHub][1])

---

四、用户角色

系统前端预设了多种业务角色：

角色	主要职责
系统管理员	系统和用户管理
环保与生产主管	生产过程与环保管理
现场操作员	收集、发酵和设备操作
质检工程师	产品指标与批次质量检测
销售经理	客户和销售订单管理

目前公开代码中的角色切换主要是前端模拟：选择角色后，会在浏览器状态中更新当前用户名和角色，并未展示完整的登录、密码验证或服务端权限控制流程。([GitHub][2])

---

五、技术架构

前端

• React 19
• TypeScript
• Vite
• Tailwind CSS 4
• Lucide React 图标
• Motion 动画库

后端

• Node.js
• Express
• TypeScript
• Google GenAI SDK

AI 能力

• Gemini 2.5 Flash
• 堆肥发酵诊断
• 农业知识问答
• 无 API Key 时的规则降级机制

项目的开发、构建和启动脚本由 Vite、esbuild、tsx 和 Express 组成。([GitHub][4])

React + TypeScript
        │
        ▼
   Express Server
        │
        ├── /api/health
        ├── /api/ai/analyze-compost
        └── /api/ai/chat
                    │
                    ▼
           Gemini 2.5 Flash

([GitHub][3])

---

六、界面设计

应用采用典型的工业数据驾驶舱风格：

• 深色背景
• 青绿色高亮
• 卡片式信息布局
• 左侧功能导航
• 高密度数据展示
• 状态标签和异常警告
• 面向大屏和后台管理场景

整体视觉风格比较适合智慧农业、环保、生产制造和 IoT 监控类项目。([GitHub][1])

---

七、项目当前完成度

从公开代码判断，这个项目目前更接近一个功能较完整的可交互原型或产品演示系统，而不是已经接入真实生产环境的企业系统。

主要依据是：

1. 收集记录、发酵槽、库存、订单、设备和用户均从 mockData 初始化。
2. 大部分数据保存在 React 的 useState 中。
3. 新增记录、修改库存、切换阶段等操作主要发生在浏览器内存中。
4. 刷新页面后，前端修改的数据通常会恢复为初始演示数据。
5. 后端目前主要负责健康检查和两项 AI 接口。
6. MQTT、GIS、多租户、视频监控和移动端仍被列在后续规划中。([GitHub][5])

因此，它目前非常适合：

• 项目方案演示
• 软件原型验证
• 毕业设计或课程设计
• 智慧农业产品展示
• 后续二次开发

但要正式用于生产，还需要补充数据库、身份认证、权限控制、真实 IoT 通信、操作日志、数据备份和安全审计等能力。

---

启动开发环境：

```bash
npm run dev

服务默认监听：

http://localhost:3000

生产构建与启动：

npm run build
npm start

相关命令、环境变量名称和默认端口均可在项目的 package.json、.env.example 与 server.ts 中找到。([GitHub][4])

---

九、项目亮点

• 业务链条完整，覆盖粪污从收集到有机肥销售的全过程
• 将 AI 诊断与农业生产数据结合
• 即使未配置 AI Key，也提供规则引擎降级
• 界面完整，适合进行产品演示
• 模块划分清晰，方便继续开发
• 包含质量追溯和设备管理概念
• 使用 MIT License，可在许可证范围内进行学习、修改和二次开发 ([GitHub][1])

十、一句话总结

这是一套以畜禽粪污资源化为主题的智慧农业管理原型，通过可视化驾驶舱管理收集、发酵、库存、销售和设备，并利用 Gemini 为堆肥过程提供智能诊断与农业知识问答。