docs: 蚕匾/批次/饲养记录（#7）变更记录与开发交接记录

2026-08-12 17:22:58 +08:00
parent 0a5e2b18e1
commit 79e524b1d4
2 changed files with 31 additions and 0 deletions
@@ -243,6 +243,29 @@

 ---

+## 2026-08-12 模块：蚕匾/批次/饲养记录管理（计划 #7）
+
+### 做了什么
+
+- 后端：`trays` / `batches` / `rearing_records` 三表 + CRUD（按 roomId/batchId 过滤），批次删除级联删除饲养记录；权限 `tray/batch/rearing:read/write`。
+- Web：新增「批次管理」页——批次管理 Tab（含饲养记录弹窗）、蚕匾管理 Tab、按蚕房筛选。
+- 小程序：蚕房详情页展示「蚕匾」与「当前批次」只读区块。
+
+### 思路与决策
+
+- 按规格书 3.5：蚕房→蚕匾→批次层级，饲养记录挂批次（品种/来源/龄期/桑叶/密度）；
+- 批次带 `instar`（龄期 1-5）与 `status`（饲养中/已上蔟/已结束），为 #9 阶段系数与 #13 自动风险提示预留数据源；
+- CRUD 沿用现有 room.go 模式（bindUpdates、uuid 校验复用 `isUUID`）；删除批次时级联删除饲养记录，避免孤儿数据；
+- v1 范围外：消毒记录（P1）、蚕种来源全链（P2）、产量统计（P1）。
+
+### 验证与部署
+
+- 三端构建通过；第八次部署（schema 变更前 pg_dump `silk-20260812-1720.dump`）；
+- 冒烟：蚕匾/批次/饲养记录创建→列表→删除均 200，批次删除后饲养记录级联为 0；
+- 相关提交：`362a70b`（后端）、`0a5e2b1`（Web+小程序）；回滚见服务器 README。
+
+---
+
 ## 环境与踩坑备忘（新同事必读）

 - **VPN**：开发服务器经 NetBird 访问；服务 Running 后需 `netbird up`，登录走 SSO（管理端 `115.191.19.95:6680`）。