七月迭代短暂完结,还有很多后端的关键东西没有弄,这是一版赶时间做的东西

internal/routes/notification.go

@@ -32,7 +32,7 @@ func registerNotificationRoutes(router fiber.Router, handler *admin.Notification
 
 	Register(notifications, doc, groupPath, "GET", "", handler.List, RouteSpec{
 		Summary:     "查询通知列表",
-		Description: "仅返回当前认证后台账号的未过期通知，固定按创建时间和通知 ID 倒序。",
+		Description: "仅返回当前认证后台账号的未过期通知，固定按创建时间和通知 ID 倒序。ref_type/ref_id/ref_key 是受控资源引用，不是前端路由；点击通知时应调用 GET /api/admin/notifications/{id}/target，以返回的 target_type 和 available 决定是否跳转。",
 		Tags:        []string{"站内通知"},
 		Input:       new(dto.NotificationListRequest),
 		Output:      new(dto.NotificationListResponse),
@@ -50,7 +50,7 @@ func registerNotificationRoutes(router fiber.Router, handler *admin.Notification
 
 	Register(notifications, doc, groupPath, "GET", "/:id/target", handler.Target, RouteSpec{
 		Summary:     "解析通知受控目标",
-		Description: "先校验通知属于当前认证后台账号，再复核目标资源当前权限；只返回白名单结构化目标，不返回任意 URL。",
+		Description: "先校验通知属于当前认证后台账号，再复核目标资源当前权限；只返回白名单结构化目标，不返回任意 URL。前端维护 target_type 到页面的白名单映射；available=false 或 target_type 为空时只展示通知正文，不执行跳转。",
 		Tags:        []string{"站内通知"},
 		Input:       new(dto.NotificationIDParams),
 		Output:      new(dto.NotificationTargetResponse),