docs: 耗材管理（#16）变更记录与开发交接记录

变更记录.md

@@ -185,6 +185,15 @@
 - Web：LAMP 检测列表新增「交叉验证」列，结果弹窗展示比对结论；小程序：结果区展示一致/不一致提示
 - 测试：交叉验证矩阵 + AI 归纳 2 组单测（TDD 红→绿）；第十二次部署（schema 变更前 pg_dump `silk-20260812-1815.dump`）；冒烟：LAMP 阴性+AI 健康→consistent、LAMP 阳性+AI 健康→inconsistent（建议会诊）；回滚点见服务器 README（后端 `server-go-linux.old-20260812-15`、web `dist.old-20260812-6`）
 
+### 耗材管理（计划 #16）
+
+- 后端：`consumables` 表（名称/类别/规格/库存/单位/安全阈值/效期/供应商）+ CRUD；`GET /consumables/alerts`（低库存 + 30 天临期/过期预警）；`GET /consumables/purchase-suggestions`（低于安全阈值时建议补足差额、向上取整）
+- 规则方法（模型层，TDD）：`LowStockAlert`、`ExpiringAlert(days)`、`PurchaseSuggestion`
+- 权限：新增 `consumable:read/write`（admin/operator 可写，viewer/farmer 可读）
+- Web：新增「耗材管理」菜单页（列表增改删 + 库存/效期预警与采购建议区块）
+- 小程序：按方案暂不做（技术员 Web 后台为主，待 #17 统一考虑）
+- 测试：3 个单测（低库存/临期/采购建议，TDD 红→绿）；第十三次部署（schema 变更前 pg_dump `silk-20260812-1830.dump`）；冒烟：低库存→low_stock + 建议采购 7、临期→expiring；回滚点见服务器 README（后端 `server-go-linux.old-20260812-16`、web `dist.old-20260812-7`）
+
 ## 2026-07-17 安全与界面优化整改
 
 ### 变更背景

开发交接记录.md

@@ -365,6 +365,28 @@
 
 ---
 
+## 2026-08-12 模块：耗材管理（计划 #16）
+
+### 做了什么
+
+- 后端：`consumables` 表 + CRUD、`/consumables/alerts`（低库存/临期 30 天）、`/consumables/purchase-suggestions`；模型方法 `LowStockAlert/ExpiringAlert/PurchaseSuggestion`。
+- Web：耗材管理页（列表 + 预警 + 采购建议）。
+
+### 思路与决策
+
+- 阈值语义：`quantity < min_quantity` 才预警（等于不预警）；采购建议 = 补足到安全阈值（向上取整），避免小数库存；
+- 效期预警窗口 30 天（含已过期），临期与过期统一 `expiring` 类型；
+- 规则放模型层方法，纯逻辑可单测；
+- 小程序端按方案暂不做，等技术员 Web 后台（#17）统一规划。
+
+### 验证与部署
+
+- 3 个单测（TDD 红→绿）；三端构建通过；
+- 第十三次部署（schema 变更前 pg_dump `silk-20260812-1830.dump`）；冒烟：低库存→low_stock + 建议 7、临期→expiring；
+- 相关提交：`65c993a`（后端）、`716e5e9`（Web）；回滚见服务器 README。
+
+---
+
 ## 环境与踩坑备忘（新同事必读）
 
 - **VPN**：开发服务器经 NetBird 访问；服务 Running 后需 `netbird up`，登录走 SSO（管理端 `115.191.19.95:6680`）。