abe3b4960e
后端： 1. 阶段 3 notification 服务边界落地，新增 `cmd/notification`、`services/notification`、`gateway/notification`、`shared/contracts/notification` 和 notification port，按 userauth 同款最小手搓 zrpc 样板收口 2. notification outbox consumer、relay 和 retry loop 迁入独立服务入口，处理 `notification.feishu.requested`，gateway 改为通过 zrpc client 调用 notification 3. 清退旧单体 notification DAO/model/service/provider/runner 和 `service/events/notification_feishu.go`，旧实现不再作为活跃编译路径 4. 修复 outbox 路由归属、dispatch 启动扫描、Kafka topic 探测/投递超时、sending 租约恢复、毒消息 MarkDead 错误回传和 RPC timeout 边界 5. 同步调整 active-scheduler 触发通知事件、核心 outbox handler、MySQL 迁移边界和 notification 配置 文档： 1. 更新微服务迁移计划，将阶段 3 notification 标记为已完成，并明确下一阶段从 active-scheduler 开始
102 lines
3.7 KiB
Go
102 lines
3.7 KiB
Go
package events
|
||
|
||
import (
|
||
"errors"
|
||
"strconv"
|
||
"strings"
|
||
"time"
|
||
)
|
||
|
||
const (
|
||
NotificationFeishuRequestedEventType = "notification.feishu.requested"
|
||
NotificationFeishuRequestedEventVersion = "1"
|
||
// DefaultFeishuNotificationDedupeWindow 是 notification 第一版固定的 30 分钟去重窗口。
|
||
DefaultFeishuNotificationDedupeWindow = 30 * time.Minute
|
||
)
|
||
|
||
// FeishuNotificationRequestedPayload 是飞书通知请求事件载荷。
|
||
//
|
||
// 职责边界：
|
||
// 1. 只描述“需要尝试发送一条飞书提醒”的跨模块协议；
|
||
// 2. 不包含 provider SDK 参数，也不复用 notification_records 的 GORM model；
|
||
// 3. 不决定是否真正投递，去重、配置关闭和重试由 notification 模块处理。
|
||
type FeishuNotificationRequestedPayload struct {
|
||
NotificationID int64 `json:"notification_id,omitempty"`
|
||
UserID int `json:"user_id"`
|
||
TriggerID string `json:"trigger_id"`
|
||
PreviewID string `json:"preview_id"`
|
||
TriggerType string `json:"trigger_type"`
|
||
TargetType string `json:"target_type"`
|
||
TargetID int `json:"target_id"`
|
||
DedupeKey string `json:"dedupe_key"`
|
||
TargetURL string `json:"target_url"`
|
||
SummaryText string `json:"summary_text,omitempty"`
|
||
FallbackText string `json:"fallback_text,omitempty"`
|
||
TraceID string `json:"trace_id,omitempty"`
|
||
RequestedAt time.Time `json:"requested_at"`
|
||
}
|
||
|
||
// Validate 校验飞书通知事件的协议级必填字段。
|
||
//
|
||
// 职责边界：
|
||
// 1. 只保证通知 handler 能定位用户、预览和去重键；
|
||
// 2. 不校验用户是否绑定飞书，也不调用 provider；
|
||
// 3. target_url 必须是站内相对路径，避免事件载荷携带任意外部跳转。
|
||
func (p FeishuNotificationRequestedPayload) Validate() error {
|
||
if p.UserID <= 0 {
|
||
return errors.New("user_id 必须大于 0")
|
||
}
|
||
if strings.TrimSpace(p.PreviewID) == "" {
|
||
return errors.New("preview_id 不能为空")
|
||
}
|
||
if strings.TrimSpace(p.DedupeKey) == "" {
|
||
return errors.New("dedupe_key 不能为空")
|
||
}
|
||
targetURL := strings.TrimSpace(p.TargetURL)
|
||
if targetURL == "" {
|
||
return errors.New("target_url 不能为空")
|
||
}
|
||
if !strings.HasPrefix(targetURL, "/assistant/") {
|
||
return errors.New("target_url 必须是 /assistant/{conversation_id} 站内相对路径")
|
||
}
|
||
if strings.Contains(targetURL, "://") || strings.HasPrefix(targetURL, "//") {
|
||
return errors.New("target_url 不允许携带外部链接")
|
||
}
|
||
if p.RequestedAt.IsZero() {
|
||
return errors.New("requested_at 不能为空")
|
||
}
|
||
return nil
|
||
}
|
||
|
||
// MessageKey 返回 outbox/Kafka 消息键。
|
||
func (p FeishuNotificationRequestedPayload) MessageKey() string {
|
||
if p.UserID <= 0 {
|
||
return ""
|
||
}
|
||
return strconv.Itoa(p.UserID)
|
||
}
|
||
|
||
// AggregateID 返回事件聚合 ID。
|
||
//
|
||
// 说明：notification.feishu.requested 使用 preview_id 串联通知与预览。
|
||
func (p FeishuNotificationRequestedPayload) AggregateID() string {
|
||
return strings.TrimSpace(p.PreviewID)
|
||
}
|
||
|
||
// BuildFeishuNotificationDedupeKey 构造“user_id + trigger_type + time_window”去重键。
|
||
//
|
||
// 职责边界：
|
||
// 1. 供事件发布方在生成 `notification.feishu.requested` payload 时复用；
|
||
// 2. 只负责把固定窗口归一成稳定 key，不负责落 notification_records；
|
||
// 3. requestedAt 为空或非法时直接返回空字符串，让上游显式感知入参不完整。
|
||
func BuildFeishuNotificationDedupeKey(userID int, triggerType string, requestedAt time.Time, window time.Duration) string {
|
||
if window <= 0 {
|
||
window = DefaultFeishuNotificationDedupeWindow
|
||
}
|
||
if userID <= 0 || strings.TrimSpace(triggerType) == "" || requestedAt.IsZero() {
|
||
return ""
|
||
}
|
||
windowStart := requestedAt.Truncate(window)
|
||
return strconv.Itoa(userID) + ":" + strings.TrimSpace(triggerType) + ":" + windowStart.Format(time.RFC3339)
|
||
}
|