a6c1e5d077
后端： 1. 服务级 outbox 基础设施全量落地——新增 service route / service catalog / route registry，重构 outbox engine、repository、event bus 和 model，按 `event_type -> service -> table/topic/group` 统一写入与投递，保留 `agent` 兼容壳但不再依赖共享 outbox 2. Kafka 投递、消费与启动装配同步切换——更新 kafka config、consumer、envelope，接入服务级 topic 与 consumer group，并同步调整 mysql 初始化、start/main/router 装配，保证各服务 relay / consumer 独立装配 3. 业务事件处理器按服务归属重接新 bus——`active-scheduler` 触发链路，以及 `agent` / `memory` / `notification` / `task` 相关 outbox handler 统一切到新路由注册与服务目录，避免新流量回流共享表 4. 同步更新《微服务四步迁移与第二阶段并行开发计划》，把阶段 1 改成当前基线并补齐结构图、阶段快照、风险回退和多代理执行口径
112 lines
3.9 KiB
Go
112 lines
3.9 KiB
Go
package events
|
||
|
||
import (
|
||
"context"
|
||
"encoding/json"
|
||
"errors"
|
||
|
||
"github.com/LoveLosita/smartflow/backend/dao"
|
||
kafkabus "github.com/LoveLosita/smartflow/backend/infra/kafka"
|
||
outboxinfra "github.com/LoveLosita/smartflow/backend/infra/outbox"
|
||
"github.com/LoveLosita/smartflow/backend/model"
|
||
"gorm.io/gorm"
|
||
)
|
||
|
||
const (
|
||
// EventTypeChatHistoryPersistRequested 是"聊天消息持久化请求"的业务事件类型。
|
||
//
|
||
// 命名策略：
|
||
// 1. 只描述业务语义，不包含 outbox/kafka 等实现词；
|
||
// 2. 作为新路由键长期保留，后续协议变化优先走 event_version；
|
||
// 3. 旧路由键仅作兼容，不再作为新发布默认值。
|
||
EventTypeChatHistoryPersistRequested = "chat.history.persist.requested"
|
||
)
|
||
|
||
// RegisterChatHistoryPersistHandler 注册"聊天消息持久化"消费者处理器。
|
||
//
|
||
// 职责边界：
|
||
// 1. 只负责聊天事件，不处理其他业务事件；
|
||
// 2. 只负责注册，不负责总线启停；
|
||
// 3. 通过 outbox 通用事务入口把"业务写入 + consumed 推进"合并为一个事务；
|
||
// 4. 当前版本仅注册新路由键（chat.history.persist.requested），不再注册旧兼容键。
|
||
func RegisterChatHistoryPersistHandler(
|
||
bus OutboxBus,
|
||
outboxRepo *outboxinfra.Repository,
|
||
repoManager *dao.RepoManager,
|
||
) error {
|
||
// 1. 依赖校验：任何一个关键依赖为空都无法安全处理消息。
|
||
if bus == nil {
|
||
return errors.New("event bus is nil")
|
||
}
|
||
if outboxRepo == nil {
|
||
return errors.New("outbox repository is nil")
|
||
}
|
||
if repoManager == nil {
|
||
return errors.New("repo manager is nil")
|
||
}
|
||
eventOutboxRepo, err := scopedOutboxRepoForEvent(outboxRepo, EventTypeChatHistoryPersistRequested)
|
||
if err != nil {
|
||
return err
|
||
}
|
||
|
||
// 2. 定义统一处理器：
|
||
// 2.1 解析 payload；
|
||
// 2.2 调用 outbox 通用消费事务；
|
||
// 2.3 在事务回调中复用 RepoManager.WithTx 执行业务 DAO 写入。
|
||
handler := func(ctx context.Context, envelope kafkabus.Envelope) error {
|
||
var payload model.ChatHistoryPersistPayload
|
||
if unmarshalErr := json.Unmarshal(envelope.Payload, &payload); unmarshalErr != nil {
|
||
// 2.1 payload 非法属于不可恢复错误，直接标 dead，避免无意义重试。
|
||
_ = eventOutboxRepo.MarkDead(ctx, envelope.OutboxID, "解析聊天持久化载荷失败: "+unmarshalErr.Error())
|
||
return nil
|
||
}
|
||
|
||
// 2.2 使用 outbox 通用消费事务，保证"业务写入 + consumed 状态推进"原子一致。
|
||
return eventOutboxRepo.ConsumeAndMarkConsumed(ctx, envelope.OutboxID, func(tx *gorm.DB) error {
|
||
// 2.2.1 基于同一个 tx 构造 RepoManager，复用你现有跨包事务模型。
|
||
txM := repoManager.WithTx(tx)
|
||
// 2.2.2 在同事务内写入聊天历史与会话计数。
|
||
return txM.Agent.SaveChatHistoryInTx(
|
||
ctx,
|
||
payload.UserID,
|
||
payload.ConversationID,
|
||
payload.Role,
|
||
payload.Message,
|
||
payload.ReasoningContent,
|
||
payload.ReasoningDurationSeconds,
|
||
payload.TokensConsumed,
|
||
)
|
||
})
|
||
}
|
||
|
||
// 3. 注册新路由键（主路由）。
|
||
if err := bus.RegisterEventHandler(EventTypeChatHistoryPersistRequested, handler); err != nil {
|
||
return err
|
||
}
|
||
|
||
return nil
|
||
}
|
||
|
||
// PublishChatHistoryPersistRequested 发布"聊天消息持久化请求"事件。
|
||
//
|
||
// 设计目的：
|
||
// 1. 让业务层只传 DTO，不重复拼事件元数据；
|
||
// 2. 统一消息键策略（conversation_id 作为 MessageKey/AggregateID）；
|
||
// 3. 发布失败时显式返回 error，由调用方决定是否降级到同步写库。
|
||
func PublishChatHistoryPersistRequested(
|
||
ctx context.Context,
|
||
publisher outboxinfra.EventPublisher,
|
||
payload model.ChatHistoryPersistPayload,
|
||
) error {
|
||
if publisher == nil {
|
||
return errors.New("event publisher is nil")
|
||
}
|
||
return publisher.Publish(ctx, outboxinfra.PublishRequest{
|
||
EventType: EventTypeChatHistoryPersistRequested,
|
||
EventVersion: outboxinfra.DefaultEventVersion,
|
||
MessageKey: payload.ConversationID,
|
||
AggregateID: payload.ConversationID,
|
||
Payload: payload,
|
||
})
|
||
}
|