From 164ae633928311393bd1d2d2cd564cb79e61843a Mon Sep 17 00:00:00 2001
From: weijuesen <weijuesen.gx@chinatelecom.cn>
Date: Wed, 12 Aug 2026 19:35:30 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E5=88=86=E5=AD=90=E6=A3=80=E6=B5=8B?=
 =?UTF-8?q?=E6=89=A9=E5=B1=95=EF=BC=88#19=EF=BC=89=E5=8F=98=E6=9B=B4?=
 =?UTF-8?q?=E8=AE=B0=E5=BD=95=E4=B8=8E=E5=BC=80=E5=8F=91=E4=BA=A4=E6=8E=A5?=
 =?UTF-8?q?=E8=AE=B0=E5=BD=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 变更记录.md     | 10 ++++++++++
 开发交接记录.md | 22 ++++++++++++++++++++++
 2 files changed, 32 insertions(+)

diff --git a/变更记录.md b/变更记录.md
index 4fee953..041f145 100644
--- a/变更记录.md
+++ b/变更记录.md
@@ -210,6 +210,16 @@
 - 测试：状态流转 + 快照序列化 2 组单测（TDD 红→绿）；第十五次部署（schema 变更前 pg_dump `silk-20260812-1845.dump`）；冒烟：创建（快照含 lamp+inspection+roomName）→受理→出方案→归档全通过；回滚点见服务器 README（后端 `server-go-linux.old-20260812-18`、web `dist.old-20260812-9`）
 - 说明：会诊通知（微信订阅消息触发点）后续接入；专家角色暂用 admin/operator 承担
 
+### 分子检测扩展（计划 #19：qPCR / SERS / 高光谱预留）
+
+- 后端：`lamp_tests` 增加 `method`（lamp/qpcr/sers/hyperspectral，默认 lamp）与 `extra_data`（jsonb）；新增 `spectrum_entries` 光谱库表
+- qPCR：`POST /lamp-tests/:id/judge-qpcr`（Ct 值 + 可选阈值）→ 纯函数 `JudgeQPCR` 自动判读（任一 Ct<threshold 阳性，无 Ct 阴性，阈值默认 35），判读原因进 extraData，结果/状态/交叉验证自动联动
+- SERS：`POST /lamp-tests/:id/spectrum`（csv/txt/json ≤5MB → S3 `spectrum/` 前缀，URL 进 extraData）；光谱库 `spectrum_entries` CRUD + `POST /spectrum-entries/upload`
+- 高光谱：`method=hyperspectral` 接口位预留
+- Web：「LAMP 检测」升级为「分子检测」（新建选方式、qPCR Ct 录入自动判读、SERS 光谱上传）+ 新增「光谱库」Tab（增删查 + 文件上传）
+- 小程序：任务列表展示检测方式
+- 测试：`JudgeQPCR` 矩阵、光谱文件校验、`buildDataKey` 3 组单测（TDD 红→绿）；第十六次部署（schema 变更前 pg_dump `silk-20260812-1900.dump`）；冒烟：qPCR Ct[32,38]→positive、SERS 光谱 URL、光谱库增查删全通过；回滚点见服务器 README（后端 `server-go-linux.old-20260812-19`、web `dist.old-20260812-10`）
+
 ## 2026-07-17 安全与界面优化整改
 
 ### 变更背景
diff --git a/开发交接记录.md b/开发交接记录.md
index 51adcaf..01e582b 100644
--- a/开发交接记录.md
+++ b/开发交接记录.md
@@ -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`）。