feat(runner): implement cluster mode with Redis-based task dispatching and registry

Introduce a distributed task execution system for gRPC runners. This includes:
- A `TaskBus` for cluster-mode task dispatching via Redis Pub/Sub.
- A `RunnerRegistry` to track active runner instances in Redis.
- Support for both standalone and cluster modes via configuration.
- Refactored `RunnerHub` and `TaskManager` to use a `TaskDispatcher` interface, decoupling task submission from local execution.
- Added distributed locking to `HotRankWorker` to ensure only one instance performs periodic hot rank recalculations in a multi-instance deployment.
- Updated dependency injection (Wire) to support the new runner components and registry.

cmd/server/app.go

@@ -18,15 +18,16 @@ import (
 
 // App 应用程序结构体
 type App struct {
-	Config        *config.Config
-	DB            *gorm.DB
-	Router        *router.Router
-	PushService   service.PushService
-	HotRankWorker *service.HotRankWorker
-	GRPCServer    *runner.Server
-	Server        *http.Server
-	Publisher     ws.MessagePublisher
-	Logger        *zap.Logger
+	Config          *config.Config
+	DB              *gorm.DB
+	Router          *router.Router
+	PushService     service.PushService
+	HotRankWorker   *service.HotRankWorker
+	GRPCServer      *runner.Server
+	Server          *http.Server
+	Publisher       ws.MessagePublisher
+	TaskDispatcher  runner.TaskDispatcher
+	Logger          *zap.Logger
 }
 
 // NewApp 创建应用程序
@@ -38,17 +39,19 @@ func NewApp(
 	hotRankWorker *service.HotRankWorker,
 	grpcServer *runner.Server,
 	publisher ws.MessagePublisher,
+	taskDispatcher runner.TaskDispatcher,
 	logger *zap.Logger,
 ) *App {
 	return &App{
-		Config:        cfg,
-		DB:            db,
-		Router:        r,
-		PushService:   pushService,
-		HotRankWorker: hotRankWorker,
-		GRPCServer:    grpcServer,
-		Publisher:     publisher,
-		Logger:        logger,
+		Config:          cfg,
+		DB:              db,
+		Router:          r,
+		PushService:     pushService,
+		HotRankWorker:   hotRankWorker,
+		GRPCServer:      grpcServer,
+		Publisher:       publisher,
+		TaskDispatcher:  taskDispatcher,
+		Logger:          logger,
 	}
 }
 
@@ -128,6 +131,14 @@ func (a *App) Stop(ctx context.Context) error {
 		a.GRPCServer.Stop()
 	}
 
+	// 4.1 停止 TaskBus（集群模式）
+	if a.TaskDispatcher != nil {
+		if bus, ok := a.TaskDispatcher.(*runner.TaskBus); ok {
+			a.Logger.Info("Stopping TaskBus")
+			bus.Stop()
+		}
+	}
+
 	// 5. 停止推送 Worker
 	a.Logger.Info("Stopping push worker")
 	a.PushService.StopPushWorker()

cmd/server/wire_gen.go

@@ -101,8 +101,8 @@ func InitializeApp() (*App, error) {
 	channelHandler := handler.NewChannelHandler(channelService)
 	scheduleRepository := repository.NewScheduleRepository(db)
 	scheduleService := wire.ProvideScheduleService(scheduleRepository)
-	server := wire.ProvideGRPCServer(config, logger)
-	taskManager := wire.ProvideTaskManager(server)
+	runnerHub := wire.ProvideRunnerHub(logger)
+	taskManager := wire.ProvideTaskManager(runnerHub, logger)
 	scheduleSyncService := wire.ProvideScheduleSyncService(taskManager, scheduleRepository, logger)
 	scheduleHandler := wire.ProvideScheduleHandler(scheduleService, scheduleSyncService)
 	roleRepository := wire.ProvideRoleRepository(db)
@@ -148,8 +148,11 @@ func InitializeApp() (*App, error) {
 	tradeHandler := handler.NewTradeHandler(tradeService)
 	wsHandler := wire.ProvideWSHandler(messagePublisher, chatService, groupService, jwtService, callService, userRepository)
 	router := ProvideRouter(userRepository, userHandler, postHandler, commentHandler, messageHandler, notificationHandler, uploadHandler, jwtService, pushHandler, systemMessageHandler, groupHandler, stickerHandler, voteHandler, channelHandler, scheduleHandler, roleHandler, adminUserHandler, adminPostHandler, adminCommentHandler, adminGroupHandler, adminDashboardHandler, adminLogHandler, qrCodeHandler, materialHandler, callHandler, reportHandler, adminReportHandler, verificationHandler, adminVerificationHandler, adminProfileAuditHandler, setupHandler, tradeHandler, logService, userActivityService, casbinService, wsHandler)
-	hotRankWorker := wire.ProvideHotRankWorker(config, postRepository, channelRepository, cache)
-	app := NewApp(config, db, router, pushService, hotRankWorker, server, messagePublisher, logger)
+	hotRankWorker := wire.ProvideHotRankWorker(config, postRepository, channelRepository, cache, client)
+	server := wire.ProvideGRPCServer(config, logger, runnerHub)
+	runnerRegistry := wire.ProvideRunnerRegistry(config, client)
+	taskDispatcher := wire.ProvideTaskDispatcher(runnerHub, runnerRegistry, config, client, logger)
+	app := NewApp(config, db, router, pushService, hotRankWorker, server, messagePublisher, taskDispatcher, logger)
 	return app, nil
 }