refactor(msg_gateway): decouple bot gateway and push notification architecture

- Split shared monolithic consts into bot, push, and errs with typed sentinel errors - Restructure model layer into distinct bot and push subdomains - Refactor DAO layer to enforce single-owner principle and remove cross-table raw SQL queries - Decompose 1150+ line service/push.go into push_channel, push_event, push_trigger, push_worker, and push_template - Clean up controller layer with generic request handlers and parameter validation in controller/base.go - Streamline plugin.go to core Cordis lifecycle orchestration and remove re-export bloat - Verify all unit tests, race tests, Cordis architecture rules, and Swagger generation pass cleanly
2026-10-08 16:46:37 +08:00 · 2026-09-02 23:21:36 +08:00
parent 8395dd5019
commit 1e19d8114a
35 changed files with 2103 additions and 2333 deletions
@@ -0,0 +1,176 @@
+// Copyright 2026 Arctel.net
+// SPDX-License-Identifier: Apache-2.0
+
+package service
+
+import (
+	"Wavelet/core/contracts"
+	"Wavelet/pkg/logger"
+	"Wavelet/plugins/domain/msg_gateway/consts"
+	"Wavelet/plugins/domain/msg_gateway/dao"
+	"Wavelet/plugins/domain/msg_gateway/model/do"
+	"Wavelet/plugins/domain/msg_gateway/model/entity"
+	pkgpush "Wavelet/plugins/domain/msg_gateway/push"
+	"context"
+	"encoding/json"
+	"errors"
+	"fmt"
+)
+
+const (
+	// SendNotificationTask is the asynq task name for push notification.
+	SendNotificationTask = consts.SendNotificationTask
+	// TaskTypeSendNotification is the admin task manager type identifier.
+	TaskTypeSendNotification = consts.TaskTypeSendNotification
+)
+
+// SendNotificationMeta represents the task metadata.
+var SendNotificationMeta = contracts.TaskMetaDTO{
+	Type:         TaskTypeSendNotification,
+	AsynqTask:    SendNotificationTask,
+	Name:         "推送通知",
+	DisplayName:  "推送通知",
+	Description:  "异步执行系统通知的多渠道派发与推送",
+	Category:     "push",
+	SupportsTime: false,
+	MaxRetry:     3,
+	Queue:        "default",
+	Retryable:    true,
+	Params: []contracts.TaskParamDTO{
+		{
+			Name:        "event_key",
+			Label:       "事件标识",
+			Type:        "string",
+			Required:    true,
+			Placeholder: "admin_login",
+			Description: "事件标识 (如 admin_login)",
+		},
+		{
+			Name:        "target",
+			Label:       "目标接收者",
+			Type:        "string",
+			Required:    false,
+			Description: "目标接收者",
+		},
+	},
+}
+
+// PushHandler handles asynchronous notification sending.
+type PushHandler struct{}
+
+// ValidatePayload validates and normalizes push parameters.
+func (h *PushHandler) ValidatePayload(payload []byte) ([]byte, error) {
+	if len(payload) == 0 {
+		return nil, errors.New(consts.ErrPayloadRequired)
+	}
+
+	var req do.SendPayload
+	if err := json.Unmarshal(payload, &req); err != nil {
+		return nil, fmt.Errorf("%s: %w", consts.ErrInvalidJSONFormat, err)
+	}
+
+	if req.Config.Channel == "" {
+		return nil, errors.New(consts.ErrChannelTypeRequired)
+	}
+
+	return json.Marshal(req)
+}
+
+// Execute performs the push send and logs delivery history audit.
+func (h *PushHandler) Execute(ctx context.Context, payload []byte) error {
+	var req do.SendPayload
+	if err := json.Unmarshal(payload, &req); err != nil {
+		logger.ErrorF(ctx, "[Push] 解析推送参数失败: %v", err)
+		return fmt.Errorf("%s: %w", consts.ErrParsePayloadFailed, err)
+	}
+
+	logger.InfoF(ctx, "[Push] 开始推送通知: 事件 = %s, 渠道 = %s, 接收目标 = %s", req.EventKey, req.Config.Channel, req.Target)
+
+	pusher, err := pkgpush.GetPusher(req.Config.Channel)
+	if err != nil {
+		errWrap := fmt.Errorf("%s: %w", consts.ErrGetPusherFailed, err)
+		logger.ErrorF(ctx, "[Push] 推送失败: %v", errWrap)
+		h.recordHistory(ctx, req, "failed", errWrap.Error())
+		return errWrap
+	}
+
+	flatBody := req.Body.Flatten()
+	upstreamResp, err := pusher.Send(ctx, req.Config, req.Target, flatBody, req.Template, nil)
+
+	title := req.Body.Title
+	content := req.Body.Content
+
+	if err != nil {
+		logger.ErrorF(ctx, "[Push] 消息推送失败 (标题: %s): %v, 上游返回: %s", title, err, upstreamResp)
+		h.recordHistory(ctx, req, "failed", err.Error())
+		return fmt.Errorf("pusher.Send failed: %w", err)
+	}
+
+	logger.InfoF(ctx, "[Push] 消息推送成功 (标题: %s, 内容摘要: %s), 上游返回: %s", title, content, upstreamResp)
+	h.recordHistory(ctx, req, "success", "")
+
+	return nil
+}
+
+func (h *PushHandler) recordHistory(ctx context.Context, req do.SendPayload, status, errMsg string) {
+	if dbErr := RecordPushHistory(ctx, req, status, errMsg); dbErr != nil {
+		logger.ErrorF(ctx, "[Push] 写入推送历史审计记录失败: %v", dbErr)
+	}
+}
+
+// EnqueuePushTask dispatches a notification payload to the async push worker.
+func EnqueuePushTask(ctx context.Context, payload do.SendPayload) error {
+	payloadBytes, err := json.Marshal(payload)
+	if err != nil {
+		return err
+	}
+	if taskSvc := GetTaskService(ctx); taskSvc != nil {
+		_, err = taskSvc.Dispatch(ctx, "send_notification", payloadBytes, contracts.TaskTriggerSystem)
+		return err
+	}
+	return errors.New(consts.ErrTaskServiceUnavailable)
+}
+
+// RecordPushHistory creates a push history audit record.
+func RecordPushHistory(ctx context.Context, req do.SendPayload, status, errMsg string) error {
+	title := req.Body.Title
+	content := req.Body.Content
+	level := req.Body.Level
+	if title == "" {
+		title = "系统通知"
+	}
+	if level == "" {
+		level = consts.DefaultLevelInfo
+	}
+
+	target := req.Target
+	if target == "" {
+		if req.Config.URL != "" {
+			target = req.Config.URL
+			const maxTargetLen = 50
+			const truncatedLen = 47
+			if len(target) > maxTargetLen {
+				target = target[:truncatedLen] + "..."
+			}
+		} else {
+			target = "default"
+		}
+	}
+
+	history := entity.PushHistory{
+		EventKey: req.EventKey,
+		Channel:  req.Config.Channel,
+		Target:   target,
+		Title:    title,
+		Content:  content,
+		Level:    level,
+		Status:   status,
+		ErrorMsg: errMsg,
+	}
+	return dao.CreatePushHistoryRecord(ctx, &history)
+}
+
+// ListPushHistories returns a paginated push delivery audit page.
+func ListPushHistories(ctx context.Context, filter do.PushHistoryListFilter) (int64, []entity.PushHistory, error) {
+	return dao.ListPushHistoriesRecord(ctx, filter)
+}