From 713d34a3b561db036916109eb3062b2050382a31 Mon Sep 17 00:00:00 2001 From: weijuesen Date: Wed, 12 Aug 2026 17:44:07 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=92=8C=E9=A3=8E=E5=A4=A9=E6=B0=94?= =?UTF-8?q?=E6=8E=A5=E5=85=A5=EF=BC=88#12=EF=BC=89=E5=8F=98=E6=9B=B4?= =?UTF-8?q?=E8=AE=B0=E5=BD=95=E4=B8=8E=E5=BC=80=E5=8F=91=E4=BA=A4=E6=8E=A5?= =?UTF-8?q?=E8=AE=B0=E5=BD=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 变更记录.md | 10 ++++++++++ 开发交接记录.md | 27 +++++++++++++++++++++++++++ 2 files changed, 37 insertions(+) diff --git a/变更记录.md b/变更记录.md index 9aa8f4b..04e7ee2 100644 --- a/变更记录.md +++ b/变更记录.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 安全与界面优化整改 ### 变更背景 diff --git a/开发交接记录.md b/开发交接记录.md index 14e5679..3475849 100644 --- a/开发交接记录.md +++ b/开发交接记录.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`）。