refactor(layout): consolidate backend codebase into backend/ package and clean root directory

- Moved cmd/, core/, plugins/, pkg/, downstream/, and main.go into backend/ directory - Batch updated all Go source files to import github.com/Rain-kl/Wavelet/backend/... - Updated Makefile, scripts/swagger.sh, architecture guards, and platform skills - Passed all quality gates (100% tests, 0 lint issues, clean build)
2026-10-03 23:06:36 +08:00 · 2026-08-28 12:56:02 +08:00
parent 33b38f8687
commit 43dc97e48c
319 changed files with 912 additions and 1031 deletions
@@ -0,0 +1,202 @@
+// Copyright 2026 Arctel.net
+// SPDX-License-Identifier: Apache-2.0
+
+// Package admin provides the system management console, diagnostics, audit logging, and configuration hot-reloading domain plugin for Cordis.
+package admin
+
+import (
+	"context"
+	"embed"
+
+	"github.com/Rain-kl/Wavelet/backend/core"
+	"github.com/Rain-kl/Wavelet/backend/core/contracts"
+	"github.com/Rain-kl/Wavelet/backend/core/extpoints"
+	"github.com/gin-gonic/gin"
+	"github.com/hibiken/asynq"
+)
+
+//go:embed migrations/*.sql
+var adminMigrations embed.FS
+
+// Option configures the admin plugin.
+type Option func(*Plugin)
+
+// Plugin implements core.Plugin to provide system administration and management APIs.
+type Plugin struct{}
+
+// New creates a new admin domain plugin.
+func New(opts ...Option) *Plugin {
+	p := &Plugin{}
+	for _, opt := range opts {
+		if opt != nil {
+			opt(p)
+		}
+	}
+	return p
+}
+
+// Name returns the unique identifier for the admin domain plugin.
+func (p *Plugin) Name() string {
+	return "admin"
+}
+
+// Manifest returns the plugin metadata.
+func (p *Plugin) Manifest() core.Manifest {
+	return core.Manifest{
+		Name:        "admin",
+		Version:     "1.0.0",
+		Description: "System administration console, diagnostic monitoring, and configuration hot-reload plugin",
+		Author:      "Wavelet Team",
+	}
+}
+
+// Apply registers admin routes, tasks, schedules, and settings into the Context.
+func (p *Plugin) Apply(ctx *core.Context) error {
+	// 0. Resolve auth service for middleware (via IoC, not direct import)
+	var loginMW gin.HandlerFunc = func(c *gin.Context) { c.Next() }
+	var adminMW gin.HandlerFunc = func(c *gin.Context) { c.Next() }
+	if authSvc, err := core.Inject[contracts.AuthService](ctx); err == nil && authSvc != nil {
+		if mw, ok := authSvc.RequireAuthMiddleware().(gin.HandlerFunc); ok {
+			loginMW = mw
+		}
+		if mw, ok := authSvc.RequireAdminMiddleware().(gin.HandlerFunc); ok {
+			adminMW = mw
+		}
+	}
+
+	// 0a. Register migrations
+	ctx.Migrations().Register("admin", adminMigrations)
+
+	// 1. Register Admin HTTP Routes
+	adminRouter := ctx.Router().Group("/api/v1/admin", loginMW, adminMW)
+	{
+		// Status & Diagnostics
+		adminRouter.GET("/status", GetSystemStatus)
+		adminRouter.GET("/status/log-database", GetLogDatabaseStatus)
+		adminRouter.GET("/db-info", GetDatabaseInfo)
+		adminRouter.GET("/db-export", ExportDatabase)
+
+		// DB Management
+		dbGroup := adminRouter.Group("/db-manage")
+		{
+			dbGroup.GET("/overview", GetDBOverview)
+			dbGroup.GET("/tables", ListDBTables)
+			dbGroup.GET("/table-data", GetDBTableData)
+			dbGroup.POST("/query", ExecuteSQL)
+		}
+
+		// Cache Management
+		cacheGroup := adminRouter.Group("/cache")
+		{
+			cacheGroup.GET("/status", GetCacheStatus)
+			cacheGroup.POST("/config", UpdateCacheConfig)
+			cacheGroup.POST("/clear", ClearCache)
+		}
+
+		// Updater
+		updateGroup := adminRouter.Group("/update")
+		{
+			updateGroup.GET("", GetUpdateStatus)
+			updateGroup.POST("/apply", ApplyUpdate)
+		}
+
+		// Logs
+		logsGroup := adminRouter.Group("/logs")
+		{
+			logsGroup.GET("", GetLogs)
+			logsGroup.GET("/access", GetAccessLogs)
+			logsGroup.GET("/analytics", GetLogsAnalytics)
+			logsGroup.GET("/ws", HandleLogWebSocket)
+		}
+
+		// Users
+		usersGroup := adminRouter.Group("/users")
+		{
+			usersGroup.GET("", ListUsers)
+			usersGroup.POST("", CreateUser)
+			usersGroup.GET("/:id", GetUser)
+			usersGroup.PUT("/:id/status", UpdateUserStatus)
+			usersGroup.PUT("/:id", UpdateUser)
+			usersGroup.DELETE("/:id", DeleteUser)
+		}
+
+		// Auth Sources
+		authSourcesGroup := adminRouter.Group("/auth-sources")
+		{
+			authSourcesGroup.GET("", ListAuthSources)
+			authSourcesGroup.POST("", CreateAuthSource)
+			authSourcesGroup.PUT("/:id", UpdateAuthSource)
+			authSourcesGroup.PUT("/:id/toggle", ToggleAuthSource)
+			authSourcesGroup.DELETE("/:id", DeleteAuthSource)
+		}
+
+		// System Configs
+		configGroup := adminRouter.Group("/system-configs")
+		{
+			configGroup.GET("", ListSystemConfigs)
+			configGroup.POST("", CreateSystemConfig)
+			configGroup.POST("/smtp/test", TestSMTP)
+
+			keyGroup := configGroup.Group("/:key")
+			{
+				keyGroup.GET("", GetSystemConfig)
+				keyGroup.PUT("", UpdateSystemConfig)
+			}
+		}
+
+		// Templates
+		templateGroup := adminRouter.Group("/templates")
+		{
+			templateGroup.GET("", ListTemplates)
+			templateGroup.POST("", CreateTemplate)
+
+			keyGroup := templateGroup.Group("/:key")
+			{
+				keyGroup.GET("", GetTemplate)
+				keyGroup.PUT("", UpdateTemplate)
+				keyGroup.DELETE("", DeleteTemplate)
+			}
+		}
+
+		// Tasks
+		taskGroup := adminRouter.Group("/tasks")
+		{
+			taskGroup.GET("/types", ListTaskTypes)
+			taskGroup.POST("/dispatch", DispatchTask)
+
+			executions := taskGroup.Group("/executions")
+			{
+				executions.GET("", ListTaskExecutions)
+				executions.GET("/:id", GetTaskExecution)
+				executions.POST("/:id/retry", RetryTask)
+			}
+
+			schedules := taskGroup.Group("/schedules")
+			{
+				schedules.GET("", ListSchedules)
+				schedules.POST("", CreateSchedule)
+				schedules.PUT("/:id", UpdateSchedule)
+				schedules.DELETE("/:id", DeleteSchedule)
+			}
+		}
+	}
+
+	// 2. Register Background Tasks
+	ctx.Task().Register("admin:system_cleanup", func(_ context.Context, _ *asynq.Task) error {
+		return nil
+	}, extpoints.WithTaskRetry(1))
+
+	// 3. Register Cron Schedules
+	ctx.Schedule().RegisterCron("0 4 * * *", "admin:system_cleanup", map[string]string{"type": "daily"})
+
+	// 4. Register Settings Schemas
+	ctx.Settings().Register(extpoints.SettingSchema{
+		Key:         "admin.system_cleanup_cron",
+		Default:     "0 4 * * *",
+		Description: "Cron expression for nightly system logs and expired tokens cleanup",
+		Type:        "string",
+		Category:    "maintenance",
+	})
+
+	return nil
+}