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

2026-08-12 18:05:59 +08:00
parent 716e5e9ef2
commit d8c4b436df
2 changed files with 31 additions and 0 deletions
@@ -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`）。