From f9d9202856b602108c12a6987eb3f3dc9dc62352 Mon Sep 17 00:00:00 2001 From: weijuesen Date: Wed, 12 Aug 2026 17:02:59 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E9=A3=8E=E9=99=A9=E8=AF=84=E5=88=86?= =?UTF-8?q?=E5=BC=95=E6=93=8E=EF=BC=88#9=EF=BC=89=E5=8F=98=E6=9B=B4?= =?UTF-8?q?=E8=AE=B0=E5=BD=95=E4=B8=8E=E5=BC=80=E5=8F=91=E4=BA=A4=E6=8E=A5?= =?UTF-8?q?=E8=AE=B0=E5=BD=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 变更记录.md | 12 ++++++++++++ 开发交接记录.md | 23 +++++++++++++++++++++++ 2 files changed, 35 insertions(+) diff --git a/变更记录.md b/变更记录.md index 151a10a..8701ad5 100644 --- a/变更记录.md +++ b/变更记录.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 安全与界面优化整改 ### 变更背景 diff --git a/开发交接记录.md b/开发交接记录.md index 13b323b..3d3c065 100644 --- a/开发交接记录.md +++ b/开发交接记录.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`）。