docs: 分子检测扩展（#19）变更记录与开发交接记录

2026-08-12 19:35:30 +08:00
parent 3cd1b824fb
commit 164ae63392
2 changed files with 32 additions and 0 deletions
@@ -433,6 +433,28 @@

 ---

+## 2026-08-12 模块：分子检测扩展（计划 #19）
+
+### 做了什么
+
+- `lamp_tests` 增加 `method/extra_data`；qPCR Ct 自动判读（`JudgeQPCR`，阈值可配）；SERS 光谱数据上传（S3 `spectrum/`）；`spectrum_entries` 光谱库（CRUD + 上传）；高光谱 `hyperspectral` 预留。
+- Web：分子检测页（方式选择、qPCR 判读、SERS 上传）+ 光谱库 Tab；小程序展示方式。
+
+### 思路与决策
+
+- 按规格书 3.3「检测方式可插拔」：不重建表，扩展现有检测任务表（method + extra_data），保持 #14/#15/#18 关联不变；
+- qPCR 判读规则用通用阈值（默认 Ct<35 阳性）且阈值可配，判读原因落 extraData 便于追溯；
+- SERS 光谱先做「数据回传 + 光谱库框架」，比对/识别算法待光谱数据库积累后接入（ai-service 预留）；
+- 高光谱本期只留方法位，等检测数据标准。
+
+### 验证与部署
+
+- `JudgeQPCR`/光谱校验/`buildDataKey` 3 组单测（TDD 红→绿）；三端构建通过；
+- 第十六次部署（schema 变更前 pg_dump `silk-20260812-1900.dump`）；冒烟：qPCR Ct[32,38]→positive、SERS 光谱 URL、光谱库增查删；
+- 相关提交：`7bb87dd`（后端）、`3cd1b82`（Web+小程序）；回滚见服务器 README。
+
+---
+
 ## 环境与踩坑备忘（新同事必读）

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