系统架构

该文档概述温室中的关键硬件、软件以及第三方服务，帮助你在排查或扩容时快速定位责任边界。

物理层

• 传感器：温湿度、土壤 EC/PH、光照、CO₂。采用 RS485 或 LoRa 通讯，采样频率 60s。
• 执行器：通风窗电机、循环风机、加热锅炉、遮阳帘、灌溉电磁阀。
• 边缘网关：树莓派或 x86 工控机，运行数据采集与策略引擎容器。

软件层

flowchart TD
  Sensors -->|LoRa| Gateway
  Gateway -->|MQTT| RuleEngine
  RuleEngine --> Actuators
  RuleEngine -->|HTTPS| CloudAPI
  CloudAPI --> Grafana

• Gateway：负责驱动、协议转换与本地缓存，Docker Compose 管理。
• RuleEngine：基于 Python 的异步服务（例如 FastAPI / asyncio），订阅 MQTT 主题，完成策略匹配与执行。
• CloudAPI：与公司统一身份与告警系统打通，供管理后台与报表使用。

配置文件位置

• configs/strategy/*.yaml：各地块阈值、PID 设置与灌溉配方。
• configs/gateway.env：网关网络、MQTT 账号和硬件映射。
• dashboards/*.json：Grafana 模板，用于快速导入指标面板。

依赖服务

服务	用途	备注
InfluxDB Cloud	存储时序数据	保留 30 天，冷数据转存 OSS
Grafana Cloud	可视化与共享	通过 SSO 登录
PagerDuty	告警升级	与监控阈值联动

变更流程

1. 在测试温室验证配置，多人确认后才可合并。
2. 使用 pnpm deploy:gateway --site=<site> 执行灰度发布。
3. 完成发布后更新维护日志，并同步相关负责人。