Version: 0.6.1.dev.260316

♻️ refactor(outbox): 抽离通用事件总线，并完成 event_type-only 收口

- ✨ 新增 `infra` 层通用 `EventBus` / `EventContract`，统一事件发布与消费协议
- 🔄 将聊天持久化链路调整为通过 `service/events` 注册 handler 并发布事件，进一步解耦业务逻辑与异步处理流程
- 🧹 移除 `chat_history_async` 旧适配实现，以及基于 `biz_type` 的兼容分发逻辑
- 📝 更新 Outbox 异步持久化决策记录，明确保留方案 A，并正式启用方案 B
- 📚 同步更新 README 中关于 Outbox + Kafka 可靠异步链路的说明
- 🚚 当前 `outbox + kafka` 已与项目业务链路完全解耦，沉淀为通用、可靠性更强的消息队列能力；后续将参考消息队列的典型使用方式，逐步扩展到更多业务场景
- ✨ 补充跨不同分类事务管理器中的 `agent dao` 注册与接入支持

backend/infra/outbox/event_contract.go

@@ -0,0 +1,64 @@
+package outbox
+
+import (
+	"encoding/json"
+	"errors"
+	"strings"
+)
+
+const (
+	// DefaultEventVersion 是通用事件协议默认版本。
+	DefaultEventVersion = "v1"
+)
+
+// OutboxEventPayload 是 outbox.payload 的统一事件外壳。
+type OutboxEventPayload struct {
+	EventID      string          `json:"event_id,omitempty"`
+	EventType    string          `json:"event_type"`
+	EventVersion string          `json:"event_version,omitempty"`
+	AggregateID  string          `json:"aggregate_id,omitempty"`
+	Payload      json.RawMessage `json:"payload"`
+}
+
+// ParsedOutboxEventPayload 是 dispatch 阶段使用的标准化结构。
+type ParsedOutboxEventPayload struct {
+	EventID      string
+	EventType    string
+	EventVersion string
+	AggregateID  string
+	PayloadJSON  json.RawMessage
+}
+
+// parseOutboxEventPayload 解析 outbox.payload。
+//
+// 当前策略（极致清理版）：
+// 1. 只接受“统一事件外壳”格式；
+// 2. 不再支持旧格式纯业务 JSON 回退；
+// 3. event_type 缺失时直接报错，交由上层标 dead。
+func parseOutboxEventPayload(rawPayload string) (*ParsedOutboxEventPayload, error) {
+	var wrapped OutboxEventPayload
+	if err := json.Unmarshal([]byte(rawPayload), &wrapped); err != nil {
+		return nil, err
+	}
+
+	eventType := strings.TrimSpace(wrapped.EventType)
+	if eventType == "" {
+		return nil, errors.New("event type is empty")
+	}
+	if len(wrapped.Payload) == 0 {
+		return nil, errors.New("payload is empty")
+	}
+
+	eventVersion := strings.TrimSpace(wrapped.EventVersion)
+	if eventVersion == "" {
+		eventVersion = DefaultEventVersion
+	}
+
+	return &ParsedOutboxEventPayload{
+		EventID:      strings.TrimSpace(wrapped.EventID),
+		EventType:    eventType,
+		EventVersion: eventVersion,
+		AggregateID:  strings.TrimSpace(wrapped.AggregateID),
+		PayloadJSON:  wrapped.Payload,
+	}, nil
+}