docs: 专家会诊(#18)变更记录与开发交接记录

This commit is contained in:
weijuesen
2026-08-12 19:06:17 +08:00
parent 12a896406d
commit afb1df6f10
2 changed files with 31 additions and 0 deletions
+9
View File
@@ -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/resolvedconsulting→resolvedresolved→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 安全与界面优化整改
### 变更背景
+22
View File
@@ -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`)。