docs: 专家会诊(#18)变更记录与开发交接记录
This commit is contained in:
@@ -201,6 +201,15 @@
|
||||
- 无 schema 变更、无小程序改动;第十四次部署;冒烟:列表 `roomName=蚕房1#`、`detections=1`;回滚点见服务器 README(后端 `server-go-linux.old-20260812-17`、web `dist.old-20260812-8`)
|
||||
- 说明:阶段二(环境监测 + LAMP + 技术员后台)至此全部落地;检测任务处理(#14)、耗材(#16)、巡检复查(#17)均已在 Web 提供
|
||||
|
||||
### 专家会诊(计划 #18)
|
||||
|
||||
- 后端:`consultations` 表(房间/批次/LAMP 关联、标题/摘要、病例快照 jsonb、状态、专家意见/防控方案、时间戳)+ CRUD;创建时可关联 LAMP 任务单,自动打包病例快照(房间名 + 最近巡检 + LAMP + 批次 + 最近天气预警);`POST /:id/resolve`(专家意见 + 防控方案 → resolved)、`POST /:id/archive`(→ archived);状态流转用 `ValidConsultationTransition` 校验(pending→consulting/resolved;consulting→resolved;resolved→archived)
|
||||
- 权限:新增 `consultation:read/write`(admin/operator 可写,viewer/farmer 可读)
|
||||
- Web:新增「专家会诊」菜单页——列表(按状态筛选)、详情抽屉(病例快照:巡检图片/风险、LAMP 结果/交叉验证、批次、天气预警)、受理/出方案/归档操作
|
||||
- 小程序:按方案不做(专家端 Web 优先)
|
||||
- 测试:状态流转 + 快照序列化 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 承担
|
||||
|
||||
## 2026-07-17 安全与界面优化整改
|
||||
|
||||
### 变更背景
|
||||
|
||||
@@ -411,6 +411,28 @@
|
||||
|
||||
---
|
||||
|
||||
## 2026-08-12 模块:专家会诊(计划 #18)
|
||||
|
||||
### 做了什么
|
||||
|
||||
- 后端:`consultations` 表 + CRUD、受理/出方案/归档接口;关联 LAMP 任务创建时自动打包病例快照(房间名/巡检/LAMP/批次/天气预警 jsonb,避免引用漂移);状态流转校验。
|
||||
- Web:专家会诊页(列表、病例快照详情抽屉、受理/出方案/归档)。
|
||||
|
||||
### 思路与决策
|
||||
|
||||
- 快照用 jsonb 固化:会诊时打包当时的数据,后续巡检/检测变化不影响历史病例;
|
||||
- 触发来源:LAMP 交叉验证不一致可一键发起(传 `lampTestId` 自动带快照);巡检红/橙手动发起(本期不做自动);
|
||||
- 状态机显式校验,非法流转直接 400;
|
||||
- 专家角色当前由 admin/operator 承担(系统角色未扩展专家,规格书 2.4 的专家端暂以 Web 管理员操作);出方案后微信订阅消息触发点待 #11 凭证到位后接入。
|
||||
|
||||
### 验证与部署
|
||||
|
||||
- 状态流转 + 快照序列化 2 组单测(TDD 红→绿);三端构建通过;
|
||||
- 第十五次部署(schema 变更前 pg_dump `silk-20260812-1845.dump`);冒烟:创建(快照含 lamp+inspection+roomName)→受理→出方案→归档全通过;
|
||||
- 相关提交:`bf734c1`(后端)、`12a8964`(Web);回滚见服务器 README。
|
||||
|
||||
---
|
||||
|
||||
## 环境与踩坑备忘(新同事必读)
|
||||
|
||||
- **VPN**:开发服务器经 NetBird 访问;服务 Running 后需 `netbird up`,登录走 SSO(管理端 `115.191.19.95:6680`)。
|
||||
|
||||
Reference in New Issue
Block a user