From 27219e618399c3e3e4ed48ed633839f67603ab6d Mon Sep 17 00:00:00 2001
From: debidong <1953531014@qq.com>
Date: Wed, 23 Sep 2026 16:18:12 +0800
Subject: [PATCH] feat(alert): add detail_url to AlertItem

The console page address is now part of the alert schema so clients can pass it through instead of dropping it.
---
 models_gen.go           | 2 ++
 openapi/openapi.en.json | 4 ++++
 openapi/openapi.zh.json | 4 ++++
 3 files changed, 10 insertions(+)

diff --git a/models_gen.go b/models_gen.go
index e8f7765..4ce7ba3 100644
--- a/models_gen.go
+++ b/models_gen.go
@@ -640,6 +640,8 @@ type AlertItem struct {
 	DeletedAt Timestamp `json:"deleted_at" toon:"deleted_at"`
 	// Alert description.
 	Description string `json:"description" toon:"description"`
+	// Console URL of this alert (`{console}/alert/detail/{alert_id}`). Empty when the deployment has no console base configured.
+	DetailURL string `json:"detail_url" toon:"detail_url"`
 	// Resolution time, Unix epoch seconds. 0 if still active.
 	EndTime Timestamp `json:"end_time" toon:"end_time"`
 	// Total number of raw events received by this alert.
diff --git a/openapi/openapi.en.json b/openapi/openapi.en.json
index 9ea6dd5..25c7f85 100644
--- a/openapi/openapi.en.json
+++ b/openapi/openapi.en.json
@@ -1541,6 +1541,10 @@
             "description": "Alert description.",
             "type": "string"
           },
+          "detail_url": {
+            "description": "Console URL of this alert (`{console}/alert/detail/{alert_id}`). Empty when the deployment has no console base configured.",
+            "type": "string"
+          },
           "end_time": {
             "description": "Resolution time, Unix epoch seconds. 0 if still active.",
             "format": "int64",
diff --git a/openapi/openapi.zh.json b/openapi/openapi.zh.json
index 0f9564b..612a5ed 100644
--- a/openapi/openapi.zh.json
+++ b/openapi/openapi.zh.json
@@ -1541,6 +1541,10 @@
             "description": "告警描述。",
             "type": "string"
           },
+          "detail_url": {
+            "description": "这条告警的控制台页面（`{控制台}/alert/detail/{alert_id}`）。部署没有配置控制台地址时为空。",
+            "type": "string"
+          },
           "end_time": {
             "description": "恢复时间，Unix 时间戳（秒）。活跃时为 0。",
             "format": "int64",