refactor(plugins): complete physical encapsulation of auth, admin, message_gateway, and risk_control domain plugins

plugins/domain/message_gateway/plugin.go

@@ -1,3 +1,6 @@
+// Copyright 2026 Arctel.net
+// SPDX-License-Identifier: Apache-2.0
+
 // Package message_gateway provides the Bot gateway, multi-channel notification dispatching, and asynchronous push worker domain plugin for Cordis.
 package message_gateway
 
@@ -7,7 +10,7 @@ import (
 
 	"github.com/Rain-kl/Wavelet/core"
 	"github.com/Rain-kl/Wavelet/core/extpoints"
-	appgw "github.com/Rain-kl/Wavelet/internal/apps/message_gateway"
+	"github.com/Rain-kl/Wavelet/internal/apps/admin"
 	"github.com/Rain-kl/Wavelet/internal/apps/oauth"
 	"github.com/hibiken/asynq"
 )
@@ -18,8 +21,18 @@ var mgMigrations embed.FS
 // Option configures the message_gateway plugin.
 type Option func(*Plugin)
 
+// WithAutoStartRunner enables automatic bot runner startup in the background.
+func WithAutoStartRunner(enable bool) Option {
+	return func(p *Plugin) {
+		p.autoStartRunner = enable
+	}
+}
+
 // Plugin implements core.Plugin to provide Bot gateway and notification dispatch domain services.
-type Plugin struct{}
+type Plugin struct {
+	autoStartRunner bool
+	cancelRunner    context.CancelFunc
+}
 
 // New creates a new message_gateway domain plugin.
 func New(opts ...Option) *Plugin {
@@ -61,36 +74,100 @@ func (p *Plugin) Apply(ctx *core.Context) error {
 	// 1. Register migrations
 	ctx.Migrations().Register("message_gateway", mgMigrations)
 
-	// 2. Register HTTP Routes
+	// 2. Register User HTTP Routes
 	mgGroup := ctx.Router().Group("/api/v1/message-gateway", oauth.LoginRequired())
 	{
-		mgGroup.GET("/channels", appgw.ListChannels)
-		mgGroup.GET("/bindings", appgw.ListBindings)
-		mgGroup.POST("/bindings", appgw.BindBinding)
-		mgGroup.DELETE("/bindings/:id", appgw.UnbindBinding)
+		mgGroup.GET("/channels", ListChannels)
+		mgGroup.GET("/bindings", ListBindings)
+		mgGroup.POST("/bindings", BindBinding)
+		mgGroup.DELETE("/bindings/:id", UnbindBinding)
+	}
+
+	// 3. Register Admin Message Gateway HTTP Routes
+	adminMgGroup := ctx.Router().Group("/api/v1/admin/message-gateway", oauth.LoginRequired(), admin.LoginAdminRequired())
+	{
+		adminMgGroup.GET("/channels/definitions", ListAdminChannelDefinitions)
+		adminMgGroup.GET("/channels", ListAdminChannels)
+		adminMgGroup.POST("/channels", CreateAdminChannel)
+		adminMgGroup.PATCH("/channels/:id", UpdateAdminChannel)
+		adminMgGroup.DELETE("/channels/:id", DeleteAdminChannel)
+		adminMgGroup.POST("/channels/:id/test", TestAdminChannel)
+	}
+
+	// 4. Register Admin Push HTTP Routes
+	adminPushGroup := ctx.Router().Group("/api/v1/admin/push", oauth.LoginRequired(), admin.LoginAdminRequired())
+	{
+		events := adminPushGroup.Group("/events")
+		{
+			events.GET("", ListPushEvents)
+			events.GET("/builtin", ListBuiltInPushEvents)
+			events.POST("", CreatePushEvent)
+			events.PUT("/:id", UpdatePushEvent)
+			events.DELETE("/:id", DeletePushEvent)
+			events.POST("/:id/toggle", TogglePushEvent)
+		}
+
+		adminPushGroup.GET("/histories", ListPushHistories)
+		adminPushGroup.POST("/test", TestPush)
+
+		channels := adminPushGroup.Group("/channels")
+		{
+			channels.GET("/definitions", ListPushChannelDefinitions)
+			channels.GET("", ListPushChannels)
+			channels.POST("", CreatePushChannel)
+			channels.PUT("/:id", UpdatePushChannel)
+			channels.DELETE("/:id", DeletePushChannel)
+			channels.POST("/test", TestPushChannel)
+		}
 	}
 
 	const defaultTaskRetry = 3
+	pushHandler := &PushHandler{}
 
-	// 3. Register Asynq background tasks
-	ctx.Task().Register("message_gateway:push_notification", func(_ context.Context, _ *asynq.Task) error {
-		return nil
+	// 5. Register Asynq background tasks
+	ctx.Task().Register("message_gateway:push_notification", func(c context.Context, t *asynq.Task) error {
+		_, err := pushHandler.Execute(c, t.Payload())
+		return err
+	}, extpoints.WithTaskRetry(defaultTaskRetry))
+
+	ctx.Task().Register(SendNotificationTask, func(c context.Context, t *asynq.Task) error {
+		_, err := pushHandler.Execute(c, t.Payload())
+		return err
 	}, extpoints.WithTaskRetry(defaultTaskRetry))
 
 	ctx.Task().Register("message_gateway:dispatch_bot_msg", func(_ context.Context, _ *asynq.Task) error {
 		return nil
 	})
 
-	// 4. Register Cron Schedules
+	// 6. Register Cron Schedules
 	ctx.Schedule().RegisterCron("*/10 * * * *", "message_gateway:cleanup_pairing_codes", map[string]any{"action": "cleanup"})
 
-	// 5. Register EventBus listeners for decoupled push triggers
-	ctx.Events().On("notification:push", func(_ context.Context, _ PushNotificationEvent) error {
-		// Event triggered push handling
+	// 7. Register EventBus listeners for decoupled push triggers
+	ctx.Events().On("notification:push", func(c context.Context, e PushNotificationEvent) error {
+		meta := EventMetadata{
+			Key:  "eventbus:" + e.Channel,
+			Name: e.Title,
+			DefaultTemplate: NotificationMessage{
+				Title:   e.Title,
+				Content: e.Content,
+				Level:   defaultLevelInfo,
+				Ext:     e.Metadata,
+			},
+			Description: "EventBus triggered notification",
+		}
+		DefaultTrigger.Trigger(c, meta, map[string]any{
+			"user.id": e.UserID,
+			"title":   e.Title,
+			"content": e.Content,
+		})
 		return nil
 	})
 
-	// 6. Register Settings Schemas
+	// 8. Register built-in domain events and task listeners
+	RegisterCustomEvents()
+	RegisterTaskListeners()
+
+	// 9. Register Settings Schemas
 	ctx.Settings().Register(extpoints.SettingSchema{
 		Key:         "message_gateway.pairing_code_expiry_minutes",
 		Default:     15,
@@ -106,5 +183,21 @@ func (p *Plugin) Apply(ctx *core.Context) error {
 		Category:    "messaging",
 	})
 
+	// 10. Optional runner start & lifecycle
+	if p.autoStartRunner {
+		runnerCtx, cancel := context.WithCancel(ctx.GoContext())
+		p.cancelRunner = cancel
+		go func() {
+			_ = Start(runnerCtx)
+		}()
+	}
+
+	ctx.OnDispose(func() error {
+		if p.cancelRunner != nil {
+			p.cancelRunner()
+		}
+		return nil
+	})
+
 	return nil
 }