docs: 多检测方式推荐引擎(#20)变更记录与开发交接记录

This commit is contained in:
weijuesen
2026-08-12 21:58:55 +08:00
parent 47a2da3d0d
commit 97087f51af
2 changed files with 27 additions and 0 deletions
+7
View File
@@ -220,6 +220,13 @@
- 小程序:任务列表展示检测方式
- 测试:`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`
### 多检测方式推荐引擎(计划 #20)
- 后端:`RecommendMethod` 纯逻辑——输入设备可用性(LAMP/SERS/qPCR/高光谱)+ 紧急程度 + 操作者水平 + 成本偏好,按加权评分排序返回推荐(方法/名称/理由/时间/成本/难度),规则取自规格书 3.3.2 与 11.2 参数对比;高光谱理论可行待验证,仅在其他方式都不可用时推荐
- 接口:`GET /api/v1/detection-methods/recommend`(纯计算,无 DB
- Web:分子检测「新建任务单」弹窗内置「推荐检测方式」工具(设备勾选 + 紧急/操作者/成本偏好 → 获取推荐)
- 测试:6 个推荐矩阵单测(无设备/低成本/最快/紧急降级/新手避高难度/仅高光谱,TDD 红→绿);第十七次部署(无 schema 变更);冒烟:low_cost→LAMP 优先、fastest→SERS、紧急无 SERS→LAMP、仅高光谱→带待验证提示;回滚点见服务器 README(后端 `server-go-linux.old-20260812-20`、web `dist.old-20260812-11`
## 2026-07-17 安全与界面优化整改
### 变更背景
+20
View File
@@ -455,6 +455,26 @@
---
## 2026-08-12 模块:多检测方式推荐引擎(计划 #20)
### 做了什么
- `RecommendMethod` 纯逻辑 + `GET /detection-methods/recommend`;Web 分子检测新建弹窗内置推荐工具。
### 思路与决策
- 规则量化自规格书 3.3.2/11.2(时间/成本/难度);加权评分:常规平衡 3/4/3,紧急与最快提高时间权重,新手提高难度权重,低成本提高成本权重;
- 高光谱「理论可行待验证」:有其他方式时不推荐,仅有高光谱时才给出并注明;
- 纯计算接口无 DB 依赖,便于前端即时交互与后续扩展(如按批次/房间数据自动带参)。
### 验证与部署
- 6 个推荐矩阵单测(TDD 红→绿);三端构建通过;
- 第十七次部署(无 schema 变更);冒烟:low_cost→LAMP、fastest→SERS、紧急无 SERS→LAMP、仅高光谱→待验证提示;
- 相关提交:`47a2da3`;回滚见服务器 README。
---
## 环境与踩坑备忘(新同事必读)
- **VPN**:开发服务器经 NetBird 访问;服务 Running 后需 `netbird up`,登录走 SSO(管理端 `115.191.19.95:6680`)。