mirror of
https://github.com/Rain-kl/OpenFlare.git
synced 2026-09-29 14:06:36 +08:00
ryan
299ac30ee4
- 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
67 lines
2.3 KiB
Go
67 lines
2.3 KiB
Go
// Copyright 2026 Arctel.net
|
|
// SPDX-License-Identifier: Apache-2.0
|
|
|
|
// Package contracts defines unified service interfaces and DTOs for cross-plugin communication.
|
|
package contracts
|
|
|
|
import (
|
|
"context"
|
|
"time"
|
|
)
|
|
|
|
// AccessLogFilterDTO defines filter criteria for querying user access logs.
|
|
type AccessLogFilterDTO struct {
|
|
UserIDs []uint64
|
|
Path string
|
|
StartTime *time.Time
|
|
EndTime *time.Time
|
|
}
|
|
|
|
// AccessLogDTO represents a single access log entry.
|
|
type AccessLogDTO struct {
|
|
ID uint64 `json:"id"`
|
|
UserID uint64 `json:"user_id"`
|
|
IP string `json:"ip"`
|
|
UserAgent string `json:"user_agent"`
|
|
Method string `json:"method"`
|
|
Path string `json:"path"`
|
|
Status int32 `json:"status"`
|
|
Latency int64 `json:"latency"`
|
|
CreatedAt time.Time `json:"created_at"`
|
|
}
|
|
|
|
// AccessLogDailyStatsDTO represents aggregate access statistics for a single day.
|
|
type AccessLogDailyStatsDTO struct {
|
|
Date string `json:"date"`
|
|
PV uint64 `json:"pv"`
|
|
UV uint64 `json:"uv"`
|
|
IPCount uint64 `json:"ip_count"`
|
|
ErrorCount uint64 `json:"error_count"`
|
|
AvgLatencyMs int64 `json:"avg_latency_ms"`
|
|
SlowReqCount uint64 `json:"slow_req_count"`
|
|
MaxLatencyMs int64 `json:"max_latency_ms"`
|
|
P95LatencyMs int64 `json:"p95_latency_ms"`
|
|
P99LatencyMs int64 `json:"p99_latency_ms"`
|
|
}
|
|
|
|
// RiskControlService defines the contract for accessing security risk control and audit logstore.
|
|
type RiskControlService interface {
|
|
// QueryAccessLogs retrieves paginated access logs matching the filter.
|
|
QueryAccessLogs(ctx context.Context, filter AccessLogFilterDTO, page, pageSize int) ([]AccessLogDTO, uint64, error)
|
|
|
|
// QueryAccessLogStats returns aggregate daily statistics for the last N days.
|
|
QueryAccessLogStats(ctx context.Context, days int) ([]AccessLogDailyStatsDTO, error)
|
|
|
|
// ActiveLogEngine returns the current active logstore engine name.
|
|
ActiveLogEngine(ctx context.Context) string
|
|
|
|
// IsLogEngineMigrating reports whether a log engine migration is in progress.
|
|
IsLogEngineMigrating(ctx context.Context) bool
|
|
|
|
// Drain flushes pending in-flight log buffers.
|
|
Drain(ctx context.Context) error
|
|
|
|
// SwitchLogEngine migrates and switches the active log storage engine.
|
|
SwitchLogEngine(ctx context.Context, targetEngine string) error
|
|
}
|