From d8c4b436df5310a601c1d8e6ed37e55cafd2ea79 Mon Sep 17 00:00:00 2001 From: weijuesen Date: Wed, 12 Aug 2026 18:05:59 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E8=80=97=E6=9D=90=E7=AE=A1=E7=90=86?= =?UTF-8?q?=EF=BC=88#16=EF=BC=89=E5=8F=98=E6=9B=B4=E8=AE=B0=E5=BD=95?= =?UTF-8?q?=E4=B8=8E=E5=BC=80=E5=8F=91=E4=BA=A4=E6=8E=A5=E8=AE=B0=E5=BD=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 变更记录.md | 9 +++++++++ 开发交接记录.md | 22 ++++++++++++++++++++++ 2 files changed, 31 insertions(+) diff --git a/变更记录.md b/变更记录.md index 1028d21..48a93a2 100644 --- a/变更记录.md +++ b/变更记录.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 安全与界面优化整改 ### 变更背景 diff --git a/开发交接记录.md b/开发交接记录.md index 902a10f..0654872 100644 --- a/开发交接记录.md +++ b/开发交接记录.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`）。