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/outbox/service_route.go

@@ -0,0 +1,145 @@
+package outbox
+
+import (
+	"strings"
+)
+
+const (
+	ServiceNameAgent           = "agent"
+	ServiceNameTask            = "task"
+	ServiceNameMemory          = "memory"
+	ServiceNameActiveScheduler = "active-scheduler"
+	ServiceNameNotification    = "notification"
+)
+
+// ServiceRoute 描述一个 outbox 服务的终态路由信息。
+//
+// 职责边界：
+// 1. 只承载服务级 outbox 的 table/topic/group 目录信息；
+// 2. 不承载 handler、事务或 Kafka 连接对象；
+// 3. 允许上层按事件类型先查服务，再由服务查到自己的物理资源。
+type ServiceRoute struct {
+	ServiceName string
+	TableName   string
+	Topic       string
+	GroupID     string
+}
+
+var builtinServiceRoutes = map[string]ServiceRoute{
+	ServiceNameAgent: {
+		ServiceName: ServiceNameAgent,
+		TableName:   "agent_outbox_messages",
+		Topic:       "smartflow.agent.outbox",
+		GroupID:     "smartflow-agent-outbox-consumer",
+	},
+	ServiceNameTask: {
+		ServiceName: ServiceNameTask,
+		TableName:   "task_outbox_messages",
+		Topic:       "smartflow.task.outbox",
+		GroupID:     "smartflow-task-outbox-consumer",
+	},
+	ServiceNameMemory: {
+		ServiceName: ServiceNameMemory,
+		TableName:   "memory_outbox_messages",
+		Topic:       "smartflow.memory.outbox",
+		GroupID:     "smartflow-memory-outbox-consumer",
+	},
+	ServiceNameActiveScheduler: {
+		ServiceName: ServiceNameActiveScheduler,
+		TableName:   "active_scheduler_outbox_messages",
+		Topic:       "smartflow.active-scheduler.outbox",
+		GroupID:     "smartflow-active-scheduler-outbox-consumer",
+	},
+	ServiceNameNotification: {
+		ServiceName: ServiceNameNotification,
+		TableName:   "notification_outbox_messages",
+		Topic:       "smartflow.notification.outbox",
+		GroupID:     "smartflow-notification-outbox-consumer",
+	},
+}
+
+// DefaultServiceRoutes 返回当前已知服务的默认路由清单。
+//
+// 说明：
+// 1. 这里是“目录初始值”，用于自动建表和首次注册时兜底；
+// 2. 运行时若显式注册了服务路由，会以显式注册结果为准；
+// 3. 返回值是拷贝，调用方可安全遍历，不会污染全局目录。
+func DefaultServiceRoutes() []ServiceRoute {
+	return []ServiceRoute{
+		builtinServiceRoutes[ServiceNameAgent],
+		builtinServiceRoutes[ServiceNameTask],
+		builtinServiceRoutes[ServiceNameMemory],
+		builtinServiceRoutes[ServiceNameActiveScheduler],
+		builtinServiceRoutes[ServiceNameNotification],
+	}
+}
+
+// DefaultServiceRoute 根据服务名生成终态路由。
+//
+// 规则：
+// 1. 已知服务直接返回约定映射；
+// 2. 未知服务按命名约定生成 table/topic/group，避免继续落回共享 topic；
+// 3. 空服务名回退到 agent 兼容路径，保住历史单体模式。
+func DefaultServiceRoute(serviceName string) ServiceRoute {
+	serviceName = normalizeServiceName(serviceName)
+	if serviceName == "" {
+		serviceName = ServiceNameAgent
+	}
+	if route, ok := builtinServiceRoutes[serviceName]; ok {
+		return route
+	}
+
+	tablePrefix := strings.NewReplacer("-", "_").Replace(serviceName)
+	if tablePrefix == "" {
+		tablePrefix = ServiceNameAgent
+	}
+
+	return ServiceRoute{
+		ServiceName: serviceName,
+		TableName:   tablePrefix + "_outbox_messages",
+		Topic:       "smartflow." + serviceName + ".outbox",
+		GroupID:     "smartflow-" + serviceName + "-outbox-consumer",
+	}
+}
+
+func normalizeServiceName(serviceName string) string {
+	return strings.TrimSpace(serviceName)
+}
+
+// normalizeServiceRoute 把空字段补成可执行的默认值。
+//
+// 说明：
+// 1. 只做字符串裁剪和缺省补齐，不做注册副作用；
+// 2. 服务名为空时只保留历史兼容路径，不强行把它当成新服务；
+// 3. 这一步是 route 目录的最后一道兜底，避免上层拿到半成品路由。
+func normalizeServiceRoute(route ServiceRoute) ServiceRoute {
+	route.ServiceName = normalizeServiceName(route.ServiceName)
+	route.TableName = strings.TrimSpace(route.TableName)
+	route.Topic = strings.TrimSpace(route.Topic)
+	route.GroupID = strings.TrimSpace(route.GroupID)
+
+	if route.ServiceName == "" {
+		if route.TableName == "" {
+			route.TableName = builtinServiceRoutes[ServiceNameAgent].TableName
+		}
+		if route.Topic == "" {
+			route.Topic = builtinServiceRoutes[ServiceNameAgent].Topic
+		}
+		if route.GroupID == "" {
+			route.GroupID = builtinServiceRoutes[ServiceNameAgent].GroupID
+		}
+		return route
+	}
+
+	defaultRoute := DefaultServiceRoute(route.ServiceName)
+	if route.TableName == "" {
+		route.TableName = defaultRoute.TableName
+	}
+	if route.Topic == "" {
+		route.Topic = defaultRoute.Topic
+	}
+	if route.GroupID == "" {
+		route.GroupID = defaultRoute.GroupID
+	}
+	return route
+}