Version: 0.9.64.dev.260503

后端：
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 改成当前基线并补齐结构图、阶段快照、风险回退和多代理执行口径

backend/infra/kafka/config.go

@@ -19,6 +19,8 @@ type Config struct {
 	Brokers []string
 	Topic   string
 	GroupID string
+	// ServiceName 表示当前进程所属的 outbox 服务；为空时保持单体全量模式。
+	ServiceName string
 	// RetryScanInterval/RetryBatchSize/MaxRetry 作用于 outbox 扫描与失败重试。
 	RetryScanInterval time.Duration
 	RetryBatchSize    int
@@ -40,10 +42,14 @@ func LoadConfig() Config {
 		Brokers:           brokers,
 		Topic:             strings.TrimSpace(viper.GetString("kafka.topic")),
 		GroupID:           strings.TrimSpace(viper.GetString("kafka.groupID")),
+		ServiceName:       strings.TrimSpace(viper.GetString("outbox.serviceName")),
 		RetryScanInterval: viper.GetDuration("kafka.retryScanInterval"),
 		RetryBatchSize:    viper.GetInt("kafka.retryBatchSize"),
 		MaxRetry:          viper.GetInt("kafka.maxRetry"),
 	}
+	if cfg.ServiceName == "" {
+		cfg.ServiceName = strings.TrimSpace(viper.GetString("kafka.serviceName"))
+	}
 	if cfg.Topic == "" {
 		cfg.Topic = DefaultTopic
 	}

backend/infra/kafka/consumer.go

@@ -3,6 +3,7 @@ package kafka
 import (
 	"context"
 	"errors"
+	"strings"
 
 	segmentkafka "github.com/segmentio/kafka-go"
 )
@@ -13,7 +14,13 @@ type Consumer struct {
 
 func NewConsumer(cfg Config) (*Consumer, error) {
 	if len(cfg.Brokers) == 0 {
-		return nil, errors.New("kafka brokers 未配置")
+		return nil, errors.New("kafka brokers not configured")
+	}
+	if strings.TrimSpace(cfg.Topic) == "" {
+		return nil, errors.New("kafka topic not configured")
+	}
+	if strings.TrimSpace(cfg.GroupID) == "" {
+		return nil, errors.New("kafka groupID not configured")
 	}
 	reader := segmentkafka.NewReader(segmentkafka.ReaderConfig{
 		Brokers:        cfg.Brokers,
@@ -30,14 +37,14 @@ func NewConsumer(cfg Config) (*Consumer, error) {
 // Dequeue 从 Kafka 拉取一条消息（不自动提交 offset）。
 func (c *Consumer) Dequeue(ctx context.Context) (segmentkafka.Message, error) {
 	if c == nil || c.reader == nil {
-		return segmentkafka.Message{}, errors.New("kafka consumer 未初始化")
+		return segmentkafka.Message{}, errors.New("kafka consumer not initialized")
 	}
 	return c.reader.FetchMessage(ctx)
 }
 
 func (c *Consumer) Commit(ctx context.Context, msg segmentkafka.Message) error {
 	if c == nil || c.reader == nil {
-		return errors.New("kafka consumer 未初始化")
+		return errors.New("kafka consumer not initialized")
 	}
 	return c.reader.CommitMessages(ctx, msg)
 }

backend/infra/kafka/envelope.go

@@ -18,6 +18,8 @@ type Envelope struct {
 	EventType string `json:"event_type"`
 	// EventVersion 是事件版本号（默认 v1）。
 	EventVersion string `json:"event_version,omitempty"`
+	// ServiceName 是事件归属服务；空值通常表示旧兼容消息或全量模式。
+	ServiceName string `json:"service_name,omitempty"`
 	// AggregateID 是聚合主键（例如 conversation_id），用于追踪同一业务对象事件流。
 	AggregateID string `json:"aggregate_id,omitempty"`