Version: 0.9.60.dev.260430

后端：
1.接入主动调度 worker 与飞书通知链路
- 新增 due job scanner 与 active_schedule.triggered workflow
- 接入 notification.feishu.requested handler、飞书 webhook provider 和用户通知配置接口
- 支持 notification_records 去重、重试、skipped/dead 状态流转
- 完成 api / worker / all 启动模式装配与主动调度验收记录
2.后续要做的就是补全从异常发生到给用户推送消息之间的逻辑缺口

backend/api/notification.go

@@ -0,0 +1,129 @@
+package api
+
+import (
+	"context"
+	"errors"
+	"net/http"
+	"time"
+
+	"github.com/LoveLosita/smartflow/backend/notification"
+	"github.com/LoveLosita/smartflow/backend/respond"
+	"github.com/gin-gonic/gin"
+)
+
+const notificationAPITimeout = 8 * time.Second
+
+// NotificationAPI 承载当前用户的外部通知通道配置接口。
+//
+// 职责边界：
+// 1. 只负责从 JWT 上下文取得当前 user_id、绑定请求体并调用 notification.ChannelService；
+// 2. 不直接读写 user_notification_channels，避免 API 层绕过 webhook 校验和脱敏规则；
+// 3. 不参与主动调度、notification_records 状态机和 outbox 消费。
+type NotificationAPI struct {
+	channelService *notification.ChannelService
+}
+
+func NewNotificationAPI(channelService *notification.ChannelService) *NotificationAPI {
+	return &NotificationAPI{channelService: channelService}
+}
+
+type saveFeishuWebhookRequest struct {
+	Enabled     *bool  `json:"enabled"`
+	WebhookURL  string `json:"webhook_url" binding:"required"`
+	AuthType    string `json:"auth_type"`
+	BearerToken string `json:"bearer_token"`
+}
+
+// GetFeishuWebhook 查询当前用户的飞书 Webhook 触发器配置。
+func (api *NotificationAPI) GetFeishuWebhook(c *gin.Context) {
+	if api == nil || api.channelService == nil {
+		c.JSON(http.StatusInternalServerError, respond.InternalError(nilServiceError("通知通道 service 未初始化")))
+		return
+	}
+
+	ctx, cancel := context.WithTimeout(c.Request.Context(), notificationAPITimeout)
+	defer cancel()
+
+	channel, err := api.channelService.GetFeishuWebhook(ctx, c.GetInt("user_id"))
+	if err != nil {
+		writeNotificationError(c, err)
+		return
+	}
+	c.JSON(http.StatusOK, respond.RespWithData(respond.Ok, channel))
+}
+
+// SaveFeishuWebhook 幂等保存当前用户的飞书 Webhook 触发器配置。
+func (api *NotificationAPI) SaveFeishuWebhook(c *gin.Context) {
+	if api == nil || api.channelService == nil {
+		c.JSON(http.StatusInternalServerError, respond.InternalError(nilServiceError("通知通道 service 未初始化")))
+		return
+	}
+
+	var req saveFeishuWebhookRequest
+	if err := c.ShouldBindJSON(&req); err != nil {
+		c.JSON(http.StatusBadRequest, respond.WrongParamType)
+		return
+	}
+	enabled := true
+	if req.Enabled != nil {
+		enabled = *req.Enabled
+	}
+
+	ctx, cancel := context.WithTimeout(c.Request.Context(), notificationAPITimeout)
+	defer cancel()
+
+	channel, err := api.channelService.SaveFeishuWebhook(ctx, c.GetInt("user_id"), notification.SaveFeishuWebhookRequest{
+		Enabled:     enabled,
+		WebhookURL:  req.WebhookURL,
+		AuthType:    req.AuthType,
+		BearerToken: req.BearerToken,
+	})
+	if err != nil {
+		writeNotificationError(c, err)
+		return
+	}
+	c.JSON(http.StatusOK, respond.RespWithData(respond.Ok, channel))
+}
+
+// DeleteFeishuWebhook 删除当前用户的飞书 Webhook 触发器配置。
+func (api *NotificationAPI) DeleteFeishuWebhook(c *gin.Context) {
+	if api == nil || api.channelService == nil {
+		c.JSON(http.StatusInternalServerError, respond.InternalError(nilServiceError("通知通道 service 未初始化")))
+		return
+	}
+
+	ctx, cancel := context.WithTimeout(c.Request.Context(), notificationAPITimeout)
+	defer cancel()
+
+	if err := api.channelService.DeleteFeishuWebhook(ctx, c.GetInt("user_id")); err != nil {
+		writeNotificationError(c, err)
+		return
+	}
+	c.JSON(http.StatusOK, respond.RespWithData(respond.Ok, gin.H{"deleted": true}))
+}
+
+// TestFeishuWebhook 发送一条最小业务 JSON 到当前用户配置的飞书 Webhook。
+func (api *NotificationAPI) TestFeishuWebhook(c *gin.Context) {
+	if api == nil || api.channelService == nil {
+		c.JSON(http.StatusInternalServerError, respond.InternalError(nilServiceError("通知通道 service 未初始化")))
+		return
+	}
+
+	ctx, cancel := context.WithTimeout(c.Request.Context(), notificationAPITimeout)
+	defer cancel()
+
+	result, err := api.channelService.TestFeishuWebhook(ctx, c.GetInt("user_id"))
+	if err != nil {
+		writeNotificationError(c, err)
+		return
+	}
+	c.JSON(http.StatusOK, respond.RespWithData(respond.Ok, result))
+}
+
+func writeNotificationError(c *gin.Context, err error) {
+	if errors.Is(err, notification.ErrInvalidChannelConfig) {
+		c.JSON(http.StatusBadRequest, respond.WrongParamType)
+		return
+	}
+	respond.DealWithError(c, err)
+}