|
|
@@ -1,52 +1,42 @@
|
|
|
-<!-- DSH-IDEMPOTENCY-KEY: t18-defect-warning-name -->
|
|
|
-<!-- parentKey: 00 -->
|
|
|
-# 19: 后端执行票 —— 预警/事件族结构漂移修复（early_warning.warning_name 缺列）
|
|
|
+# 19: 后端执行票 —— 预警/事件族故障根因（部署时序错位，非缺列）
|
|
|
|
|
|
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）叠加放大了故障表现——两处都要修。
|
