Kaynağa Gözat

docs: document diagnosis result table and correctness fixes

zhouyang.xie 6 gün önce
ebeveyn
işleme
e18be7d2ee

+ 11 - 0
docs/VERSION.md

@@ -57,8 +57,19 @@ docs/api/fault-frequency.md
 - 前端源码未加入 Git;
 - 当前 `dist` 构建时间:2026-11-05 13:26。
 
+## 2026-11-05 诊断正确性整改
+
+- 修正转速折算:删除七台河硬编码,按机型传动比和测点所在轴计算;
+- 逐条校验采样率:低于 12800 Hz 返回状态 -1,不再整批抛错或误判正常;
+- 诊断异常不再返回状态 0,改为未定义并返回原因;
+- 增加 `meta`/`unsupported` 返回,前端显示部件参数、轴转速和采样率不足提示;
+- 新增 `vibration_diagnosis_result` 诊断结果追溯表;
+- 移除 `temperature.py` 中重复的 `/autodiag/{type}` 路由,统一走 `autodiag.py`;
+- 修复诊断日志占位符导致的 logging error。
+
 ## 远程推送状态
 
+
 Gogs 读操作正常,`git push` 返回:
 
 ```text

+ 21 - 0
docs/database/20261105_diagnosis_result.sql

@@ -0,0 +1,21 @@
+-- 诊断结果追溯表
+-- 目标库:energy_prod
+-- 版本:2026-11-05
+
+CREATE TABLE IF NOT EXISTS vibration_diagnosis_result (
+  id BIGINT AUTO_INCREMENT PRIMARY KEY,
+  engine_code VARCHAR(64) NOT NULL,
+  wind_code VARCHAR(64) NULL,
+  point_name VARCHAR(255) NULL,
+  diagnosis_type VARCHAR(32) NOT NULL,
+  max_status TINYINT NOT NULL DEFAULT -1 COMMENT '0正常 1报警 2危险 -1未定义',
+  component_type VARCHAR(32) NULL,
+  brand VARCHAR(128) NULL,
+  model VARCHAR(128) NULL,
+  frequencies_json TEXT NULL,
+  unsupported_json TEXT NULL,
+  meta_json TEXT NULL,
+  create_time DATETIME DEFAULT CURRENT_TIMESTAMP,
+  KEY idx_engine_time (engine_code, create_time),
+  KEY idx_type_time (diagnosis_type, create_time)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='振动诊断结果与证据追溯';

+ 19 - 1
docs/database/fault-frequency-design.md

@@ -131,7 +131,25 @@ ALTER TABLE vibration_alarm_event
 
 回滚前先确认没有业务页面依赖新增字段。
 
-## 8. 已知限制
+## 8. 诊断结果追溯表
+
+新增 `vibration_diagnosis_result`,保存每次诊断的输入上下文、参数来源、特征频率和未支持原因:
+
+```text
+engine_code、wind_code、point_name、diagnosis_type、max_status
+component_type、brand、model、frequencies_json、unsupported_json、meta_json、create_time
+```
+
+目的:
+
+- 诊断结果可追溯;
+- 采样率不足等“未定义”结果可审计;
+- 后续可做诊断历史、复核和模型效果评估。
+
+迁移脚本:`docs/database/20261105_diagnosis_result.sql`。
+
+## 9. 已知限制
+
 
 1. 当前仅 10 条轴承几何参数,79 个机型中仅 3 个有部件记录;
 2. 齿轮箱级间转速暂按低速轴近似,精确计算需各级齿数/传动比;