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

变更记录.md

@@ -128,6 +128,18 @@
 - 后端接口复用 #5/#6 已部署的 `POST/GET /api/v1/inspections`，无需服务端改动；`npm run build:weapp` 通过
 - 说明：风险分级（绿/黄/橙/红）待 #9 评分引擎落地后接入；类名映射当前为 healthy/sick，7 类病种扩展后补充
 
+### 风险评分引擎（计划 #9）
+
+- `server-go/internal/service/risk.go`（新增）：
+  - `ComputeRiskScore`：按规格书 3.1.4 公式 `0.5×AI 置信度 + 0.2×环境系数 + 0.15×阶段系数 + 0.15×整齐度偏离度`，结果钳制 0-100；
+  - `RiskLevel`：绿 0-30 / 黄 31-60 / 橙 61-80 / 红 81-100；
+  - `StageCoefficient`：Room.Stage 粗粒度映射（pupa 0.5 / larva 0.4 / moth 0.2 / egg 0.1），待 #7 龄期字段细化；
+  - `EnvCoefficient`：按规格书 3.2.3 规则（湿度 ≥80 → 0.8、75-80 → 0.5；温度 >30 或 <20 → 0.5），取最大值。
+- `server-go/internal/service/risk_test.go`：5 个单元测试（权重/钳制/分级边界/阶段/环境规则，TDD 红→绿）
+- `server-go/internal/handler/inspection.go`：巡检创建时计算风险——AI 置信度取检测结果最大值，房间阶段与环境系数在带 `roomId` 时按房间数据加载（`loadRoomRisk`），结果写入 `risk_score` / `risk_level`
+- 第七次部署：冒烟——带房间 57.5（yellow）、不带房间 47.5（yellow）；回滚点见服务器 README（旧二进制 `server-go-linux.old-20260812-10`）
+- 说明：整齐度偏离度暂无数据源，本期恒为 0；小程序端风险分级展示待接入
+
 ## 2026-07-17 安全与界面优化整改
 
 ### 变更背景

开发交接记录.md

@@ -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`）。