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

This commit is contained in:
weijuesen
2026-08-12 19:35:30 +08:00
parent 3cd1b824fb
commit 164ae63392
2 changed files with 32 additions and 0 deletions
+10
View File
@@ -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 承担
### 分子检测扩展(计划 #19qPCR / 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 安全与界面优化整改
### 变更背景
+22
View File
@@ -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`)。