audit

type ActionStats struct {
	Action string `json:"action"`
	Count  int64  `json:"count"`
}

type Actor struct {
	// Type 类型（user/agent/system）
	Type string `json:"type"`

	// ID 标识
	ID string `json:"id"`

	// Name 名称
	Name string `json:"name"`

	// IP IP 地址
	IP string `json:"ip,omitempty"`

	// UserAgent 用户代理
	UserAgent string `json:"user_agent,omitempty"`

	// Roles 角色
	Roles []string `json:"roles,omitempty"`
}

type ActorStats struct {
	ActorID   string `json:"actor_id"`
	ActorName string `json:"actor_name"`
	Count     int64  `json:"count"`
}

type AuditConfig struct {
	// Enabled 是否启用
	Enabled bool

	// BufferSize 缓冲区大小
	BufferSize int

	// FlushInterval 刷新间隔
	FlushInterval time.Duration

	// RetentionDays 保留天数
	RetentionDays int

	// LogLevel 日志级别
	LogLevel AuditLevel

	// SensitiveFields 敏感字段（需要脱敏）
	SensitiveFields []string

	// IncludeDetails 是否包含详细信息
	IncludeDetails bool
}

type AuditEvent struct {
	// ID 事件 ID
	ID string `json:"id"`

	// Timestamp 时间戳
	Timestamp time.Time `json:"timestamp"`

	// Level 级别
	Level AuditLevel `json:"level"`

	// Category 类别
	Category EventCategory `json:"category"`

	// Action 操作
	Action string `json:"action"`

	// Actor 执行者
	Actor *Actor `json:"actor"`

	// Target 目标
	Target *Target `json:"target,omitempty"`

	// Result 结果
	Result EventResult `json:"result"`

	// Details 详细信息
	Details map[string]any `json:"details,omitempty"`

	// Request 请求信息
	Request *RequestInfo `json:"request,omitempty"`

	// Response 响应信息
	Response *ResponseInfo `json:"response,omitempty"`

	// Duration 耗时
	Duration time.Duration `json:"duration,omitempty"`

	// TraceID 追踪 ID
	TraceID string `json:"trace_id,omitempty"`

	// SpanID Span ID
	SpanID string `json:"span_id,omitempty"`

	// Tags 标签
	Tags []string `json:"tags,omitempty"`

	// Metadata 元数据
	Metadata map[string]any `json:"metadata,omitempty"`
}

type AuditLevel string

type AuditLogger struct {
	// contains filtered or unexported fields
}

type AuditOption func(*AuditConfig)

type AuditQuery struct {
	// StartTime 开始时间
	StartTime time.Time

	// EndTime 结束时间
	EndTime time.Time

	// Categories 类别
	Categories []EventCategory

	// Levels 级别
	Levels []AuditLevel

	// ActorID 执行者 ID
	ActorID string

	// TargetID 目标 ID
	TargetID string

	// Action 操作
	Action string

	// Result 结果
	Result EventResult

	// TraceID 追踪 ID
	TraceID string

	// Tags 标签
	Tags []string

	// Limit 限制
	Limit int

	// Offset 偏移
	Offset int

	// OrderBy 排序
	OrderBy string

	// OrderDesc 降序
	OrderDesc bool
}

type AuditReport struct {
	// Period 时间段
	Period TimeRange `json:"period"`

	// TotalEvents 总事件数
	TotalEvents int64 `json:"total_events"`

	// ByCategory 按类别统计
	ByCategory map[EventCategory]int64 `json:"by_category"`

	// ByLevel 按级别统计
	ByLevel map[AuditLevel]int64 `json:"by_level"`

	// ByResult 按结果统计
	ByResult map[EventResult]int64 `json:"by_result"`

	// TopActors 最活跃执行者
	TopActors []ActorStats `json:"top_actors"`

	// TopActions 最常见操作
	TopActions []ActionStats `json:"top_actions"`

	// Errors 错误列表
	Errors []*AuditEvent `json:"errors,omitempty"`

	// GeneratedAt 生成时间
	GeneratedAt time.Time `json:"generated_at"`
}

type AuditStore interface {
	// Save 保存事件
	Save(ctx context.Context, event *AuditEvent) error

	// Query 查询事件
	Query(ctx context.Context, query AuditQuery) ([]*AuditEvent, error)

	// Count 统计事件数量
	Count(ctx context.Context, query AuditQuery) (int64, error)

	// Delete 删除事件
	Delete(ctx context.Context, ids []string) error

	// Cleanup 清理过期事件
	Cleanup(ctx context.Context, before time.Time) (int64, error)
}

type EventCategory string

type EventFilter func(*AuditEvent) bool

type EventHook func(*AuditEvent)

type EventResult string

type MemoryAuditStore struct {
	// contains filtered or unexported fields
}

type RequestInfo struct {
	// Method 方法
	Method string `json:"method,omitempty"`

	// Path 路径
	Path string `json:"path,omitempty"`

	// Query 查询参数
	Query map[string]string `json:"query,omitempty"`

	// Headers 请求头
	Headers map[string]string `json:"headers,omitempty"`

	// Body 请求体（脱敏后）
	Body any `json:"body,omitempty"`
}

type ResponseInfo struct {
	// StatusCode 状态码
	StatusCode int `json:"status_code,omitempty"`

	// Body 响应体（脱敏后）
	Body any `json:"body,omitempty"`

	// Error 错误信息
	Error string `json:"error,omitempty"`
}

type Target struct {
	// Type 类型
	Type string `json:"type"`

	// ID 标识
	ID string `json:"id"`

	// Name 名称
	Name string `json:"name,omitempty"`

	// Attributes 属性
	Attributes map[string]any `json:"attributes,omitempty"`
}

type TimeRange struct {
	Start time.Time `json:"start"`
	End   time.Time `json:"end"`
}