refactor(core): align with cordis spatiotemporal composability architecture

- Purify core micro-kernel by removing context hardcoded helpers and reverse dependencies
- Eliminate init() side effects in infra plugins with reversible lifecycle disposal
- Completely isolate plugins by removing cross-plugin imports and using core/contracts
- Introduce TaskService and RiskControlService contracts for unified cross-plugin APIs
- Regenerate Swagger documentation and update developer guide matrix
- Achieve 0 violations in check_cordis_architecture.sh and 100% test pass

backend/plugins/domain/risk_control/plugin.go

@@ -9,10 +9,12 @@ import (
 	"embed"
 	"reflect"
 
+	"github.com/gin-gonic/gin"
+
 	"Wavelet/core"
 	"Wavelet/core/contracts"
 	"Wavelet/core/extpoints"
-	"github.com/gin-gonic/gin"
+	"Wavelet/plugins/domain/risk_control/logstore"
 )
 
 //go:embed logstore/migrations/*.sql
@@ -69,6 +71,19 @@ func (p *Plugin) Manifest() core.Manifest {
 
 // Apply registers risk control middlewares, settings, and cleanup hooks into the Context.
 func (p *Plugin) Apply(ctx *core.Context) error {
+	// 0. Bind DBService
+	if db, err := core.Inject[contracts.DBService](ctx); err == nil && db != nil {
+		logstore.SetDBService(db)
+	} else {
+		core.When[contracts.DBService](ctx, func(db contracts.DBService) {
+			logstore.SetDBService(db)
+		})
+	}
+	ctx.OnDispose(func() error {
+		logstore.SetDBService(nil)
+		return nil
+	})
+
 	// 0. Register user access log table migrations
 	ctx.Migrations().Register("risk_control/logstore", riskControlMigrations)
 
@@ -98,10 +113,90 @@ func (p *Plugin) Apply(ctx *core.Context) error {
 		Category:    "security",
 	})
 
-	// 4. Register lifecycle disposal cleanup
+	// 4. Register RiskControlService contract
+	core.Provide[contracts.RiskControlService](ctx, &riskControlServiceImpl{})
+
+	// 5. Register lifecycle disposal cleanup
 	ctx.OnDispose(func() error {
 		return StopLogWriter(context.Background())
 	})
 
 	return nil
 }
+
+type riskControlServiceImpl struct{}
+
+func (s *riskControlServiceImpl) QueryAccessLogs(ctx context.Context, filter contracts.AccessLogFilterDTO, page, pageSize int) ([]contracts.AccessLogDTO, uint64, error) {
+	store, err := logstore.Active(ctx)
+	if err != nil {
+		return nil, 0, err
+	}
+	f := logstore.AccessLogFilter{
+		UserIDs:   filter.UserIDs,
+		Path:      filter.Path,
+		StartTime: filter.StartTime,
+		EndTime:   filter.EndTime,
+	}
+	list, total, err := store.UserAccessLogs.List(ctx, f, page, pageSize)
+	if err != nil {
+		return nil, 0, err
+	}
+	items := make([]contracts.AccessLogDTO, len(list))
+	for i, item := range list {
+		items[i] = contracts.AccessLogDTO{
+			ID:        item.ID,
+			UserID:    item.UserID,
+			IP:        item.IP,
+			UserAgent: item.UserAgent,
+			Method:    item.Method,
+			Path:      item.Path,
+			Status:    item.Status,
+			Latency:   item.Latency,
+			CreatedAt: item.CreatedAt,
+		}
+	}
+	return items, total, nil
+}
+
+func (s *riskControlServiceImpl) QueryAccessLogStats(ctx context.Context, days int) ([]contracts.AccessLogDailyStatsDTO, error) {
+	store, err := logstore.Active(ctx)
+	if err != nil {
+		return nil, err
+	}
+	trend, err := store.UserAccessLogs.GetDailyTrend(ctx, days)
+	if err != nil {
+		return nil, err
+	}
+	res := make([]contracts.AccessLogDailyStatsDTO, len(trend))
+	for i, t := range trend {
+		res[i] = contracts.AccessLogDailyStatsDTO{
+			Date: t.Date,
+			PV:   t.Count,
+		}
+	}
+	return res, nil
+}
+
+func (s *riskControlServiceImpl) ActiveLogEngine(ctx context.Context) string {
+	store, err := logstore.Active(ctx)
+	if err != nil {
+		return "sqlite"
+	}
+	active, err := store.Status.ActiveDatabase(ctx)
+	if err != nil {
+		return "sqlite"
+	}
+	return active
+}
+
+func (s *riskControlServiceImpl) IsLogEngineMigrating(ctx context.Context) bool {
+	return logstore.Migrating(ctx)
+}
+
+func (s *riskControlServiceImpl) Drain(ctx context.Context) error {
+	return Drain(ctx)
+}
+
+func (s *riskControlServiceImpl) SwitchLogEngine(ctx context.Context, targetEngine string) error {
+	return MigrateAndSwitchEngine(ctx, targetEngine, nil)
+}