|
@@ -1,52 +1,42 @@
|
|
|
-<!-- DSH-IDEMPOTENCY-KEY: t18-defect-warning-name -->
|
|
|
|
|
-<!-- parentKey: 00 -->
|
|
|
|
|
-# 19: 后端执行票 —— 预警/事件族结构漂移修复(early_warning.warning_name 缺列)
|
|
|
|
|
|
|
+# 19: 后端执行票 —— 预警/事件族故障根因(部署时序错位,非缺列)
|
|
|
|
|
|
|
|
Type: task
|
|
Type: task
|
|
|
-Status: ready-for-agent
|
|
|
|
|
-Label: ready-for-agent
|
|
|
|
|
-Category: backend-execution
|
|
|
|
|
|
|
+Status: ready-for-human
|
|
|
|
|
+Label: ready-for-human
|
|
|
|
|
+Category: backend-deployment
|
|
|
|
|
|
|
|
-## 来源
|
|
|
|
|
|
|
+## 根因(已确证,非猜测)
|
|
|
|
|
|
|
|
-票 18 真实联调与真人闭环实测发现(2026-10-10)。
|
|
|
|
|
|
|
+**不是缺列需要补,而是部署时序错位:数据库迁移领先于运行中的构建。**
|
|
|
|
|
|
|
|
-## 现象
|
|
|
|
|
|
|
+| 事实 | 证据 |
|
|
|
|
|
+| --- | --- |
|
|
|
|
|
+| 运行实例是旧构建 | 后端进程 PID 37792 启动于 `2026-10-10 08:28:52`,其源码基线为 `d8a6b03`(2026-10-09) |
|
|
|
|
|
+| 数据库已被上游重构 | `927fad2 refactor(warning): 重构预警系统数据结构和业务逻辑`(林仔,2026-10-10 11:43:10 +0800)提交说明明写「移除预警名称和经纬度字段,优化数据库表结构」,该提交从 `EarlyWarning.java` 删除了 `warningName`、`longitude`、`latitude` 映射 |
|
|
|
|
|
+| 旧构建仍读被删列 | `d8a6b03` 的 `EarlyWarning` 仍映射 `@TableField("warning_name")` → MyBatis-Plus 生成 `SELECT ... warning_name ... FROM early_warning` → KingbaseES 报「字段 "warning_name" 不存在」 |
|
|
|
|
|
+| 修复已在远端 | `927fad2` 与其后的 `94971b5 feat(warning): 添加预警参考服务` **均已包含在 `origin/master`**(远端 master 现为 `94971b5`) |
|
|
|
|
|
|
|
|
-以下端点 HTTP 200 但业务 `code=500`,错误一致:`ERROR: 字段 "warning_name" 不存在`,SQL 来自 `EarlyWarningMapper`:
|
|
|
|
|
|
|
+`sql/early_warning_system.sql` 里 `early_warning` 仍写着 `warning_name`,那是**旧版建表脚本**,不能作为当前库结构的依据;`warning_name` 现在只存在于 `warning_type` 表(`WarningType.java`)。
|
|
|
|
|
|
|
|
-```
|
|
|
|
|
-SELECT warning_id,warning_no,warning_name,... FROM early_warning
|
|
|
|
|
-Hint: 也许您想要引用列"early_warning.warning_no"或者列"early_warning.warning_type"
|
|
|
|
|
-```
|
|
|
|
|
|
|
+## 因此本票不需要写新代码
|
|
|
|
|
|
|
|
-受影响端点:`/equipments/{code}/events/current`、`/events/current`(WARNING 与 ALARM)、`/events/history-analysis`、`/events/handling-efficiency`、`/events/multidimensional-analysis`、`/monitoring/situation`、`/overview/warning-settings`、`/infrastructure/emergency-support`。
|
|
|
|
|
|
|
+**动作是:用 `origin/master`(≥ `927fad2`)重新构建并部署到联调环境。** 这是一次部署动作,按仓库规则不自动执行,由维护者执行。
|
|
|
|
|
|
|
|
-## 范围
|
|
|
|
|
|
|
+## 受影响范围(随部署一并验证)
|
|
|
|
|
|
|
|
-1. 定位 `early_warning` 与实体 `EarlyWarning` 的结构漂移(上游曾重构预警表结构),决定是补列、改实体还是改查询。
|
|
|
|
|
-2. 修复后确认上述八个端点在真实联调环境返回业务 `code=200`,且报警记录字段真实(`warningCode`、`warningName`、阈值、报警等级、坐标)。
|
|
|
|
|
-3. 补针对性契约测试锁定 `warning_name`(或替代字段)可读,防止结构漂移回归。
|
|
|
|
|
-4. 与历史地图条目一致:复验前必须先 `git fetch` 确认远端基线,不在落后基点上误诊为本地改动。
|
|
|
|
|
|
|
+部署后应同时恢复的端点:`/equipments/{code}/events/current` 与 `history`、`/events/current`、`/events/history-analysis`、`/events/handling-efficiency`、`/events/multidimensional-analysis`、`/monitoring/situation`、`/overview/warning-settings`、`/infrastructure/emergency-support`。
|
|
|
|
|
|
|
|
-## 验收
|
|
|
|
|
-
|
|
|
|
|
-编译通过 + `Cockpit*Test` 全绿 + 上述八端点真实 200 + 基线卡片更新 + 提交推送 Gogs,并在票 18 记录复验实测值。
|
|
|
|
|
-
|
|
|
|
|
-## 关联
|
|
|
|
|
-
|
|
|
|
|
-发现于票 18;修复后回票 18 复验。
|
|
|
|
|
|
|
+## 部署后必须核对的新事实
|
|
|
|
|
|
|
|
-## 进度
|
|
|
|
|
|
|
+`927fad2` 同时删除了预警的经纬度字段,因此**预警类事件将不再有坐标**。用户本次提供的真实报警记录本身即 `longitude: null, latitude: null`。这与「地图对象不上图」是同一族问题:需要确认驾驶舱对无坐标预警事件的呈现(不得伪造坐标),并与前端执行票 24 的坐标纪律一致。
|
|
|
|
|
|
|
|
-<!-- 做到哪一步了,在这里一行一行记 -->
|
|
|
|
|
-
|
|
|
|
|
-Status: ready-for-agent
|
|
|
|
|
-Type: task
|
|
|
|
|
-Blocked by:
|
|
|
|
|
-Labels: ready-for-agent, backend-execution, wayfinder:task
|
|
|
|
|
|
|
+## 验收
|
|
|
|
|
|
|
|
-## Comments
|
|
|
|
|
|
|
+1. 记录新部署实例的启动时间与所依据的提交哈希(必须 ≥ `927fad2`,且与 `origin/master` 一致)。
|
|
|
|
|
+2. 上述八个端点真实返回业务 `code=200`,且报警字段真实(`warningCode`、阈值、报警等级);确认 `warningName` 是改由 `warning_type` 关联取得还是按新契约置空。
|
|
|
|
|
+3. 重跑 `verify/t18-real-audit.mjs`,`events-*` 与 `warning-*` 相关失败项清零。
|
|
|
|
|
+4. 若部署后仍有 500,则说明还有第二处结构漂移,需重新取证而非再猜。
|
|
|
|
|
|
|
|
|
|
+## 关联
|
|
|
|
|
|
|
|
-## Answer
|
|
|
|
|
|
|
+发现于票 18;根因为部署时序,与前端执行票 22(前端把 `code=500` 读成 success)叠加放大了故障表现——两处都要修。
|