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

2026-08-12 19:06:17 +08:00
parent 12a896406d
commit afb1df6f10
2 changed files with 31 additions and 0 deletions
@@ -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`）。