docs: 疫病溯源（#21）变更记录与开发交接记录

变更记录.md

@@ -227,6 +227,15 @@
 - Web：分子检测「新建任务单」弹窗内置「推荐检测方式」工具（设备勾选 + 紧急/操作者/成本偏好 → 获取推荐）
 - 测试：6 个推荐矩阵单测（无设备/低成本/最快/紧急降级/新手避高难度/仅高光谱，TDD 红→绿）；第十七次部署（无 schema 变更）；冒烟：low_cost→LAMP 优先、fastest→SERS、紧急无 SERS→LAMP、仅高光谱→带待验证提示；回滚点见服务器 README（后端 `server-go-linux.old-20260812-20`、web `dist.old-20260812-11`）
 
+### 疫病溯源（计划 #21，规格书 3.8 三级溯源）
+
+- 后端：`trace_records` 表（关联房间/LAMP/会诊、病种、状态、来源判定、置信度、一级初报/二级清单/二级报告 jsonb、三级专家/实验室备注）
+- 一级自动溯源 `POST /trace-records/:id/auto`：环境回溯（房间最近温湿度：高湿 ≥80% 或温度突变）→ 历史发病关联（同房间同病种 LAMP 记录，90 天）→ 传播途径推断（按病种知识库）→ 生成《溯源初报》并初步判定来源（内源/外源/待确认 + 置信度）
+- 二级：`GET /trace-records/:id/checklist`（分病种排查清单，取自规格书 3.8.3：核型多角体病/白僵病/微粒子病/软化病/浓核病/细菌性败血病）+ `POST /:id/checklist`（作答 → 内源/外源倾向统计 → 《溯源分析报告》）
+- 三级：`expertNote` / `labNote` 字段（病原分型、母蛾镜检等）
+- 权限：新增 `trace:read/write`；Web：新增「疫病溯源」菜单页（列表 + 详情：一级初报/二级清单作答/三级记录 + 自动溯源/归档）
+- 测试：5 组溯源规则单测（环境回溯/历史关联/传播推断/清单/分析，TDD 红→绿）；第十八次部署（schema 变更前 pg_dump `silk-20260812-1920.dump`）；冒烟：创建→清单 4 项→auto（reported/内源/conf 0.6）→清单提交（analysis/conf 0.725）；回滚点见服务器 README（后端 `server-go-linux.old-20260812-21`、web `dist.old-20260812-12`）
+
 ## 2026-07-17 安全与界面优化整改
 
 ### 变更背景

开发交接记录.md

@@ -475,6 +475,28 @@
 
 ---
 
+## 2026-08-12 模块：疫病溯源（计划 #21）
+
+### 做了什么
+
+- `trace_records` 表 + CRUD；一级自动溯源（环境回溯/历史关联/传播推断 → 初报 + 来源判定）；二级分病种排查清单（规格书 3.8.3）→ 分析报告；三级专家/实验室备注；Web 溯源页。
+
+### 思路与决策
+
+- 按规格书 3.8 三级架构：一级自动（数据聚合 + 规则）、二级人工排查（清单作答统计内源/外源倾向 + 置信度）、三级专业记录（字段预留）；
+- 环境回溯 v1 用房间最近温湿度样本（≥80% 高湿 / >30℃ 或 <20℃ 温度突变）；连续多日判定待数据积累后细化；
+- 历史关联用同房间同病种 resulted LAMP 记录（JSONB `@>` 匹配），90 天窗口；
+- 清单答案统计：内源倾向项答「是」计内源分，「否」计外源分，反向亦然，未答计未知；结论附置信度；
+- 区域关联（同乡镇）留待 #22 热力图数据接入。
+
+### 验证与部署
+
+- 5 组溯源规则单测（TDD 红→绿）；三端构建通过；
+- 第十八次部署（schema 变更前 pg_dump `silk-20260812-1920.dump`）；冒烟：创建→清单 4 项→auto（reported/内源/0.6）→清单提交（analysis/0.725）；
+- 相关提交：`dc97d1c`（后端）、`5ce99ab`（Web）；回滚见服务器 README。
+
+---
+
 ## 环境与踩坑备忘（新同事必读）
 
 - **VPN**：开发服务器经 NetBird 访问；服务 Running 后需 `netbird up`，登录走 SSO（管理端 `115.191.19.95:6680`）。