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

2026-08-12 17:44:07 +08:00
parent c4fad42cb4
commit 713d34a3b5
2 changed files with 37 additions and 0 deletions
@@ -158,6 +158,16 @@
 - 第九次部署（schema 变更前 pg_dump `silk-20260812-1730.dump`）；冒烟：binding 未绑定、bind 未配置返回 502 明确提示、巡检触发不崩溃；回滚点见服务器 README（旧二进制 `server-go-linux.old-20260812-12`）
 - 待办：提供小程序 AppID/Secret 与订阅消息模板 ID 后联调真实推送；告警触发点（告警产生时）待接入

+### 和风天气接入与高发病天气预警（计划 #12）
+
+- 后端：`weather_alerts` 表 + `GET /weather/now`（实时天气 + 规则评估，可带 `stage` 参数）、`GET /weather/alerts`（最近预警）；和风天气客户端（实时 + 3 天预报）；规则引擎按规格书 3.2.3——白僵病（湿度≥80% + 连续阴雨≥2 天或当前降雨 → 高风险）、核型多角体病（温度 >30℃ 或 <20℃ → 注意；5龄后期升级高风险）、软化病（湿度>75% → 注意）；启动时执行一次 + 每 30 分钟定时评估写入
+- 配置占位：`QWEATHER_API_KEY`、`QWEATHER_LOCATION`、`QWEATHER_INTERVAL_MIN`（默认 30）
+- 权限：新增 `weather:read`（全角色）
+- Web：告警中心顶部「高发病天气预警」区块；小程序：告警页顶部天气预警卡片
+- 测试：规则与客户端共 9 个单测（降雨天数/阴雨判断/白僵病/温度突变/综合规则/实时/预报/错误码/配置，TDD 红→绿）
+- 第十次部署（schema 变更前 pg_dump `silk-20260812-1745.dump`）；冒烟：`alerts=[]`、`now` 未配置返回 502 明确提示；回滚点见服务器 README（后端 `server-go-linux.old-20260812-13`、web `dist.old-20260812-4`）
+- 待办：提供和风天气 API Key 与位置（经纬度或 LocationID）后启用真实数据；微粒子病（蚕种来源/消毒记录）规则待批次数据联动
+
 ## 2026-07-17 安全与界面优化整改

 ### 变更背景