diff --git a/变更记录.md b/变更记录.md index dc62731..bc37e9e 100644 --- a/变更记录.md +++ b/变更记录.md @@ -64,6 +64,16 @@ - 三次部署(含 ACL 修复):上传 1x1 PNG 冒烟通过——URL 匿名 GET 200(`image/png`),病种 `imageUrl` 绑定成功(测试数据已清空);回滚点见服务器 `/home/pan/backups/rollback-20260812/README.md`(原位旧二进制 `server-go-linux.old-20260812-5`) - 说明:开发环境图片存 Ceph `silk-images` 桶(公开读),生产切云 OSS/COS 时由桶策略或 CDN 承担公开访问,代码仅需改配置 +### 补充:饲养阶段风险提示(计划 #13) + +- `server-go/internal/model/knowledge_stage_hints.go`(新增):4 个阶段(小蚕期 young / 大蚕期 grown / 5龄后期 late5 / 蛹期 pupa)风险种子数据,内容取自规格书附录 11.1 高发阶段与 3.2.3 环境风险规则;`StageHintsByStage` 过滤函数 +- `server-go/internal/model/knowledge_stage_hint_test.go`(新增):阶段 key 合法、引用的病种存在于知识库、按阶段过滤/未知阶段报错等 5 个测试(TDD 红→绿) +- `server-go/internal/handler/knowledge.go`:新增 `GET /api/v1/knowledge/stage-hints?stage=`(只读 GET,天然幂等;返回病种含 id,可直接跳知识详情) +- 小程序:知识库页新增「饲养阶段风险提示」区块(龄期选择器 → 提示卡片,点击跳病种详情) +- Web 本次未加(按方案保持 v1 范围) +- 第四次部署:health 200;`all=4` 阶段;`grown` 返回软化病 + 核型多角体病(含 id);未知阶段 400;回滚点见服务器 README(原位旧二进制 `server-go-linux.old-20260812-6`) +- 说明:自动按蚕房龄期提示需等「蚕匾/批次管理」(#7,含龄期记录)落地后联动,v1 用选择器 + ## 2026-07-17 安全与界面优化整改 ### 变更背景 diff --git a/开发交接记录.md b/开发交接记录.md index 6fba806..142a6a2 100644 --- a/开发交接记录.md +++ b/开发交接记录.md @@ -94,6 +94,30 @@ --- +## 2026-08-12 模块:饲养阶段风险提示(计划 #13) + +### 做了什么 + +- 后端:新增 `GET /api/v1/knowledge/stage-hints?stage=young|grown|late5|pupa`(只读 GET,天然幂等),返回该阶段高发病种(含病种 id,可直接跳知识详情);不传 stage 返回全部; +- 种子数据:4 个阶段(小蚕期 young / 大蚕期 grown / 5龄后期 late5 / 蛹期 pupa)及其高发病种与原因; +- 小程序:知识库页新增「饲养阶段风险提示」区块——龄期选择器 + 提示卡片,点击病种跳详情。 + +### 思路与决策 + +- 选择理由:规格书 3.2.2 的 P1 项,独立、见效快,直接复用蚕病知识库; +- 内容来源:规格书附录 11.1 高发阶段 + 3.2.3 蚕病环境风险规则(如核型多角体病 5龄后期温度突变 >30℃/<20℃ 诱发),无编造; +- 幂等性:新增接口为只读 GET,天然幂等;后续新增写接口时按需实现幂等(如幂等键); +- v1 用选择器而非自动联动:自动按蚕房龄期提示需等「蚕匾/批次管理」(#7,含龄期记录)落地后接入; +- Web 端本次未加,保持快速交付,后续需要再补。 + +### 验证与回滚 + +- 5 个单元测试(阶段 key 合法、病种引用存在、按阶段过滤、未知阶段报错)TDD 红→绿;`go test/build/vet`、`build:weapp` 通过; +- 部署冒烟:`all=4` 阶段;`grown` 返回软化病 + 核型多角体病(含 id);`young` 返回曲霉病提示;未知阶段 400; +- 相关提交:`6d9cfc7`(后端)、`6dc6c27`(小程序);回滚见服务器 README(旧二进制 `server-go-linux.old-20260812-6`)。 + +--- + ## 环境与踩坑备忘(新同事必读) - **VPN**:开发服务器经 NetBird 访问;服务 Running 后需 `netbird up`,登录走 SSO(管理端 `115.191.19.95:6680`)。 @@ -116,7 +140,7 @@ ### 下一候选模块(方案已给出、待用户确认) -- 饲养阶段风险提示(#13,规格书 P1):后端阶段风险种子 + `GET /knowledge/stage-hints` + 小程序选择器,内容取自规格书附录 11.1 与 3.2.3;自动按龄期提示需等「蚕匾/批次管理」(#7)落地后联动。 +- ~~饲养阶段风险提示(#13)~~:已于 2026-08-12 完成(见上方模块记录)。 ### 计划中的其他模块(按《后续工作计划》)