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

变更记录.md

@@ -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 安全与界面优化整改
 
 ### 变更背景

开发交接记录.md

@@ -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`）。