mirror of
https://github.com/Rain-kl/OpenFlare.git
synced 2026-10-02 06:56:36 +08:00
ryan
fb6a3edb89
- Physically purged all legacy internal/ packages, centralized pkg/model/ and pkg/repository/ - Migrated domain models and database repositories into self-contained owner plugins (user, auth, message_gateway, admin, upload, risk_control) - Decoupled cross-plugin interactions via pure core/contracts and typed EventBus - Ensured 100% test coverage pass, zero data races (-race clean), and 0 lint issues in make code-check
64 lines
2.6 KiB
Go
64 lines
2.6 KiB
Go
// Copyright 2026 Arctel.net
|
|
// SPDX-License-Identifier: Apache-2.0
|
|
|
|
// Package logstore abstracts user access-log storage across ClickHouse, PostgreSQL and SQLite.
|
|
package logstore
|
|
|
|
import (
|
|
"context"
|
|
"errors"
|
|
"time"
|
|
|
|
"github.com/Rain-kl/Wavelet/pkg/persistence/analytics"
|
|
)
|
|
|
|
// ErrMigrating 表示日志数据库正在迁移，当前禁止写入。
|
|
var ErrMigrating = errors.New("log database is migrating, writes are disabled")
|
|
|
|
// UserAccessLogStore 用户访问日志（w_user_access_logs）。
|
|
type UserAccessLogStore interface {
|
|
BatchInsert(ctx context.Context, logs []analytics.UserAccessLog) error
|
|
DeleteAll(ctx context.Context) (int64, error)
|
|
DeleteBefore(ctx context.Context, cutoff time.Time) (int64, error)
|
|
Count(ctx context.Context, filter analytics.AccessLogFilter) (uint64, error)
|
|
List(ctx context.Context, filter analytics.AccessLogFilter, page, pageSize int) ([]analytics.UserAccessLog, uint64, error)
|
|
GetDailyTrend(ctx context.Context, days int) ([]analytics.DailyTrend, error)
|
|
GetBrowserDistribution(ctx context.Context, startTime time.Time) ([]analytics.BrowserShare, error)
|
|
GetTopActiveUsers(ctx context.Context, startTime time.Time, limit int) ([]analytics.TopUser, error)
|
|
ListForMigration(ctx context.Context, afterID uint64, limit int) ([]analytics.UserAccessLog, error)
|
|
MigrationRange(ctx context.Context) (from, to time.Time, err error)
|
|
EnsurePartitions(ctx context.Context, from, to time.Time) error
|
|
// DropEmptyPartitions 幂等清理 PG 空分区表：删除 before 月份之前、且无任何数据的按月分区；
|
|
// CH/SQLite 为 no-op。
|
|
DropEmptyPartitions(ctx context.Context, before time.Time) error
|
|
// DropExpiredPartitions 直接删除完全过期的 PG 整月分区（候选为月份早于 cutoff 月的分区，
|
|
// 删除前校验分区内无保留期内数据，避免时区偏移下误删；迁移冻结期间拒绝执行）；CH/SQLite 为 no-op。
|
|
DropExpiredPartitions(ctx context.Context, cutoff time.Time) error
|
|
}
|
|
|
|
// UserAccessLog 用户访问日志实体类型别名
|
|
type UserAccessLog = analytics.UserAccessLog
|
|
|
|
// AccessLogFilter 访问日志查询过滤条件类型别名
|
|
type AccessLogFilter = analytics.AccessLogFilter
|
|
|
|
// DailyTrend 每日趋势数据类型别名
|
|
type DailyTrend = analytics.DailyTrend
|
|
|
|
// BrowserShare 浏览器分布数据类型别名
|
|
type BrowserShare = analytics.BrowserShare
|
|
|
|
// TopUser Top 用户活跃统计类型别名
|
|
type TopUser = analytics.TopUser
|
|
|
|
// StatusStore 日志库状态。
|
|
type StatusStore interface {
|
|
ActiveDatabase(ctx context.Context) (string, error)
|
|
}
|
|
|
|
// Store 当前生效日志库。
|
|
type Store struct {
|
|
UserAccessLogs UserAccessLogStore
|
|
Status StatusStore
|
|
}
|