农产品溯源与数字农业平台（Agri-IoT）

在通用物联网平台（设备管理 / 产品管理 / 协议 / 指令下发 / 告警 / 时序数据）之上构建的农业行业应用层：把"设备能力"封装为"农事业务能力"，覆盖基地与资产管理、批次档案、生产记录、投入品管理与溯源码查询，并通过标准接口与遥感分析、灌溉控制联动。

产品概述

农业数字化不是"买几台传感器"，而是把地块、作物、农事、设备、溯源串成一条可管理、可追溯的业务链。本平台定位于应用层，向下复用成熟的物联网平台能力，向上提供农业专属的业务对象与规则，让种植企业、合作社、监管部门以"业务语言"而非"寄存器地址"来管理生产。

核心能力

基地与资产管理

• 多级建模：基地 → 地块/大棚/鸡舍 → 分区。
• 作物字典与批次档案：某地块某次种植/养殖的起止、状态。
• 设备一键绑定：agri_asset.device_sn 是应用层与平台设备的唯一桥接字段，业务规则挂在 zone_id 上，通过资产找到具体设备再下发。

生产档案与投入品

• 农事操作全程记录（播种、施肥、打药、采收）。
• 投入品（肥料/农药）使用登记，支撑合规与溯源。
• 执行记录通用表 agri_exec_record 统一沉淀开关阀、喂料、清粪等动作。

溯源码

• 按批次生成溯源二维码，消费者扫码查看产地、农事、投入品、检测全链条。
• 溯源链条由基地/批次/资产/生产记录自动汇聚，无需手工拼凑。

标准接口联动

• 遥感数据接入：卫星 NDVI/NDWI、无人机长势经接口汇入平台，形成地块级长势档案。
• 灌溉控制联动：平台水肥规则经统一下行出口触发阀门，与"水肥一体化远程控制系统"打通。
• 下行统一出口：所有设备指令经 DeviceDownUtils.functionDown 下发，业务模块不直接碰 MQTT/TCP，与平台解耦。

可配置规则

• 三种触发：阈值 / 定时 / 手动。
• 提供作物"推荐默认值模板"，一键套用后微调；滞回参数防边界震荡。

技术架构

thinglinks-ui  (前端 views/agri ...)
        │  REST /agri/** /fertigation/** /poultry/** /monitor/**
        ▼
thinglinks-admin（聚合应用模块）
   ├─ thinglinks-business（设备/产品/协议/指令/告警/时序）
   └─ thinglinks-agri（基础 + 水肥 + 养鸡 + 监控）  ◄ 应用层，单向依赖 business
        │  DeviceDownUtils.functionDown(sn, 指令码, 参数)
        ▼
平台既有能力：设备/指令下发/告警/时序表

依赖原则：应用模块 → 依赖 thinglinks-business；thinglinks-business 绝不反向依赖应用模块。时序数据统一读 thinglinks_device_ts_data，不重复落库。

为什么选择我们

• 业务视角：用地块/批次/农事说话，不暴露底层寄存器。
• 数据互通：遥感、无人机、灌溉在同一平台闭环，避免信息孤岛。
• 自主可控：开源友好的平台底座，逻辑与数据归客户所有。
• 可生长：规则支持"配置 → 默认值模板 → 自动学习"渐进路线。

实施阶段

Phase	内容
0	应用模块骨架 + 建表 SQL 空壳
1	基地资产 base/zone/crop/batch/asset CRUD + 设备绑定
2	水肥：灌溉规则 + 执行记录 + 时序曲线 + 统计
3	养鸡：饮水/喂料/清粪三规则 + 集群档案
4	监控报表：大屏、成本报表、业务告警视图
5	默认值模板 → 自动学习（可选）