优化结构

internal/app/catalog.go

@@ -0,0 +1,33 @@
+// Package app is the composition root for the running administration service.
+// It knows which business modules are enabled and wires their contributions
+// into the shared platform. Individual modules do not import this package.
+package app
+
+import (
+	systemrouter "kra/internal/server/router"
+	systemworker "kra/internal/worker"
+	"kra/pkg/module"
+	platformtask "kra/pkg/task"
+)
+
+// Catalog lists the business modules enabled in this binary. Adding an order
+// module means adding one Definition here; system initialization and runtime
+// code consume the catalog without knowing that module's implementation.
+func Catalog() module.Catalog {
+	return module.Catalog{Definitions: []module.Definition{Definition()}}
+}
+
+// TaskRegistry builds the process-wide registry from dependency-free module
+// contributions. Dependency-bearing methods are added by their module runtime
+// constructors after the usecases have been created.
+func TaskRegistry(catalog module.Catalog) *platformtask.Registry {
+	registry := platformtask.NewRegistry()
+	registry.RegisterAll(catalog.TaskMethods())
+	return registry
+}
+
+// Runtime composes HTTP route contributors from the enabled modules.
+func Runtime(systemRoutes *systemrouter.Routes, systemTasks *systemworker.TaskMethods, registry *platformtask.Registry) *module.Runtime {
+	platformtask.Apply(registry, systemTasks)
+	return module.NewRuntime(systemRoutes)
+}

internal/app/definition.go

@@ -0,0 +1,21 @@
+package app
+
+import (
+	datapayment "kra/internal/data/payment"
+	datasystem "kra/internal/data/repository"
+	"kra/pkg/module"
+)
+
+// Definition describes the built-in system contribution to the application
+// catalog. Other business modules can expose the same shape independently.
+func Definition() module.Definition {
+	return module.Definition{
+		Name:       "system",
+		Migrations: append(datasystem.Migrations(), datapayment.Migrations()...),
+		Surface:    datapayment.AdminSurface(),
+		TimedTasks: []module.TimedTask{
+			{Name: "ClearDB", Description: "定时清理数据库过期日志(操作记录/JWT黑名单/定时任务执行日志)", Spec: "@daily", MethodName: "ClearDB", Enabled: true},
+			{Name: "CleanStaleUploads", Description: "定时清理过期大文件上传会话", Spec: "@hourly", MethodName: "CleanStaleUploads", Enabled: true},
+		},
+	}
+}