docs: 风险评分引擎（#9）变更记录与开发交接记录

2026-08-12 17:02:59 +08:00
parent 93301f0bf3
commit f9d9202856
2 changed files with 35 additions and 0 deletions
@@ -220,6 +220,29 @@

 ---

+## 2026-08-12 模块：风险评分引擎（计划 #9）
+
+### 做了什么
+
+- `risk.go`：评分公式（0.5/0.2/0.15/0.15 权重，0-100 钳制）、分级（绿/黄/橙/红）、阶段系数（Room.Stage 粗映射）、环境系数（湿度/温度规则，取自规格书 3.2.3）。
+- 巡检创建（`POST /api/v1/inspections`）时自动计算：AI 置信度取检测结果最大值；带 `roomId` 时按房间阶段 + 最新温湿度算系数；结果写入 `risk_score` / `risk_level`。
+
+### 思路与决策
+
+- 公式与分级阈值完全按规格书 3.1.4，不自行调整；
+- 评分在 Go 端（AI 服务只做检测），保持职责单一；
+- 环境系数 v1 用「最新一条温湿度」按规则打分（规格书 3.2.3 的连续 3 天判定留待后续）；
+- 整齐度偏离度暂无数据源（需蚕匾/批次管理 #7 后才有），本期恒为 0；
+- 阶段系数用 Room.Stage 粗映射，等 #7 龄期字段落地后细化。
+
+### 验证与部署
+
+- 5 个单元测试（TDD 红→绿）；`go test/build/vet` 通过；
+- 第七次部署：冒烟——带房间 57.5（yellow）、不带房间 47.5（yellow）；
+- 相关提交：`93301f0`；回滚见服务器 README（旧二进制 `server-go-linux.old-20260812-10`）。
+
+---
+
 ## 环境与踩坑备忘（新同事必读）

 - **VPN**：开发服务器经 NetBird 访问；服务 Running 后需 `netbird up`，登录走 SSO（管理端 `115.191.19.95:6680`）。