docs: 和风天气接入（#12）变更记录与开发交接记录

2026-08-12 17:44:07 +08:00
parent c4fad42cb4
commit 713d34a3b5
2 changed files with 37 additions and 0 deletions
@@ -293,6 +293,33 @@

 ---

+## 2026-08-12 模块：和风天气接入与高发病天气预警（计划 #12）
+
+### 做了什么
+
+- 后端：和风天气客户端（`/v7/weather/now` 实时 + `/v7/weather/3d` 预报）；规则引擎（规格书 3.2.3）；`weather_alerts` 表 + `/weather/now`、`/weather/alerts`；启动即评估一次 + 每 30 分钟定时写入。
+- Web 告警中心与小程序告警页新增天气预警展示。
+
+### 思路与决策
+
+- 数据源按用户确认选用和风天气（QWeather，devapi 免费版）；`location` 支持经纬度或 LocationID；
+- 未配置（`QWEATHER_API_KEY/LOCATION` 为空）时接口返回明确错误、定时任务跳过，不阻塞主流程（与微信骨架同一模式）；
+- 规则 v1：白僵病（湿度≥80% + 连续阴雨）、核型多角体病（温度突变，`stage=late5` 升级）、软化病（湿度>75% 提示）；微粒子病依赖蚕种来源/消毒记录，待 #7 数据联动；
+- 预警写入不按天去重（v1），前端只展示最近几条，后续可加去重策略。
+
+### 验证与部署
+
+- 规则/客户端 9 个单测（TDD 红→绿），三端构建通过；
+- 第十次部署（schema 变更前 pg_dump `silk-20260812-1745.dump`）；冒烟：`/weather/alerts=[]`、`/weather/now` 未配置 502 明确提示；
+- 相关提交：`c7f18c1`（后端）、`c4fad42`（Web+小程序）；回滚见服务器 README。
+
+### 待办
+
+- 提供和风天气 API Key 与默认位置后启用真实数据与定时预警；
+- 微粒子病规则（蚕种来源标记 + 消毒记录缺失）待批次/消毒数据接入。
+
+---
+
 ## 环境与踩坑备忘（新同事必读）

 - **VPN**：开发服务器经 NetBird 访问；服务 Running 后需 `netbird up`，登录走 SSO（管理端 `115.191.19.95:6680`）。