mirror of
https://github.com/Rain-kl/OpenFlare.git
synced 2026-10-02 23:06:36 +08:00
dbaa3bf140
docs(changelog): 修正表述笔误
refactor(cordis): 磁盘缓存改用上上游能力并清理本地副本
按上游/下游归属规约:类型断言守卫已回流 Wavelet(f3d85d5,附回归用例),
本仓库删除 OpenFlare/plugins/server/pkg/cache 整包并改 import 到
Wavelet/pkg/cache/disk,同步后与上游零漂移。
验证:go build 通过;go test ./... exit 0(137 包 ok);256 条路由对拍与
232 条 swagger 操作均零差异;make build-all 四进制;前端零改动。
docs(cordis): 记录 T1 清理结果与五个复用阻塞点
refactor(cordis): server 复用上游 pkg 能力并删除等价本地副本
按上游/下游归属规约清理重复实现,删除 7 个与上游等价的本地包并改 import:
shared/response→pkg/response、pkg/{logger,mail,trace,httppool,cache/ram}→
上游同名包、infra/persistence/batchwriter→pkg/batchwriter。逐项核过差异:
httppool 逐字节相同;logger 的 Config 字段完全一致;response 的 7 个 Abort*
一致;cache/ram 换过去顺带把裸 go 变回带 panic 恢复的 util.Go。
两处非等价差异按语义处理:
- batchwriter.Stats 与 status DTO 原为类型别名,改为消费侧逐字段转换,
避免 model 反向依赖基础设施类型;
- 上游 pkg/idgen 要求显式 Init(本地副本为懒加载自动初始化),本次保留本地
副本,待与 infra 初始化一并迁移(已登记在清理计划)。
验证:go build 通过;go test ./... exit 0(138 包 ok);256 条路由对拍零差异;
make swagger 232 条操作零增减,且归一化后与旧文档深度相等——差异仅为
response.Any / logger.LogEntry 两个定义名随包路径改名,接口形状未变。
chore(cordis): 回流内核与 pkg/util 通用能力并清理 vendoring 污染
按新增的上游/下游归属规约:HandleRaw/BasePath 与版本比较、网络、格式化助手
属通用能力,已提交到 Wavelet 分支 feat/cordis-router-raw-routes,本仓库改为
纯同步获取(pkg/util 已零漂移),补丁登记保留至上游合并。
同时修掉我此前 git add -A 造成的污染:首次 vendoring 把上游工作区里被
gitignore 的运行期产物一起提交进来(upload 的 diskcache 缓存块 650 个与
driver_http/dist 前端构建物 380 个,共 12872 行/1030 文件)。sync-upstream.sh
现显式排除 uploads/dist/data/*.db,.gitignore 补上对应兜底规则。
AGENTS.md 增加上游/下游改动归属规约,并把仍指向前 Cordis 布局的硬性约束
(internal/router + Serve、internal/repository/logstore、internal/platform/bootstrap、
internal/cmd)改到当前插件路径。
验证:go build 通过;go test ./... exit 0(144 包 ok);make swagger 232 条
操作与基线逐条一致;make build-all 四进制;gofmt 干净。
feat(cordis): server 插件化并改由内核挂载控制面路由
新增 plugins/server/plugin.go:Apply 以 ctx.Router().Group(app.api_prefix)
声明根级与 /v1 全部路由;33 个注册函数由 *gin.RouterGroup 改为
core.RouterExtension,RegisterCollection 改用内核新增的 HandleRaw 保留
尾部斜杠变体,AdminMiddlewares 返回 []any(Go 不允许把 []T 展开为 ...any)。
删除 router.Serve 与 registerRoutes,装配根改为 core.App +
driver_http.New(WithEngine(router.BuildEngine())),监听、信号与优雅退出归内核;
前端 SPA 的 NoRoute 兜底因内核暂无贡献点而保留在引擎层。
路由保真证据:plugin_parity_test 对拍 baseline/routes-engine.txt 的 256 条
(方法 路径) 零差异;go test ./... exit 0(144 包 ok,含真实 handler 的
openflare/integration 用例走同一条挂载路径);make swagger 232 条操作与基线
逐条一致;golangci-lint 0 issues;make build-all 四进制;embed_frontend
标签编译通过;前端零改动。
已知待补:带 Redis 的实机 HTTP 冒烟(本机 6379 未启动,session store 与
改造前一样在建店阶段即 fatal),以及 bootstrap 的任务/设置/迁移注册迁入 Apply。
feat(core): RouterExtension 增加 HandleRaw 与 BasePath 以保真尾部斜杠路由
server 插件化的前置:Handle 经 cleanPath 会剥掉尾部斜杠,无法表达
/resource 与 /resource/ 两条不同路由,而 OpenFlare 有 20 个历史 list
端点两者都注册且部署关闭了 RedirectTrailingSlash,缺失即 404。新增
HandleRaw 与 BasePath(作用域包装器同样登记反注册),补 extpoints 用例;
并把 router.Serve 拆出 BuildEngine 以便交给 driver_http.WithEngine 复用,
新增路由表导出 harness,固化 256 条 (方法 路径) 基线供插件化对拍。
上游补丁登记于 backend/OpenFlare/upstream-patches.md,同步脚本改为按目录
前缀输出差异并在同步后提醒确认补丁是否仍在。
验证:go build 通过;go test ./... exit 0(143 包 ok);gofmt 干净。
docs(cordis): 记录 server 插件接入内核的可行路径与内核能力缺口
feat(cordis): agent/relay/flared 落地为内核驱动插件
三个边缘守护进程各新增 plugin.go,实现 core.Plugin + core.Driver
(自定义 DriverType 与同名 profile),装配与生命周期从 main 迁入
Apply/Start/Stop:Apply 负责 JSON 配置加载、运行环境与用户确保、
openresty/frps/frpc 管理器与各服务装配;Start 以 util.Go 拉起阻塞式
runner 与 GeoIP 周期更新;Stop 收敛主循环结果并在超时时报错而非静默。
入口改为 core.NewApp(core.WithProfile(...)) + Prepare/Run,保持
-config 旗标、默认路径、退出码与启动/停止日志不变。
验证:go build 通过;go test ./... exit 0(143 包 ok,含 3 个插件身份
与配置失败路径测试);make build-all 四进制产出;三进制实跑缺失配置
均 exit 1 且错误链保留 load {agent,relay,flared} config 原因;gofmt 干净。
refactor(cordis): 按功能职责拆分为 4 个插件与 share 共享层
backend/OpenFlare 不再平铺遗留分层,改为 plugins/{server,agent,relay,flared}
加 share/:控制面业务(openflare/admin/oauth/user/upload/cap/config/health 与
repository/model/infra/router 等支撑层)归 server;三个边缘守护进程各自成插件;
被两个以上插件消费的 protocol/geoip/wsclient/render/pagesarchive/edge 归 share。
同时把 pkg/util 与 buildinfo 合并回上游 pkg(上游已覆盖全部符号,仅 8 个函数与
2 个类型为 OpenFlare 独有,已一并迁入),装配根统一到 backend/cmd(含三个 daemon
入口),Dockerfile 与 release 工作流的构建路径和 -X 注入路径同步更新。
验证:go build 通过;go test ./... exit 0(141 包 ok);make swagger exit 0 且
232 条 API 操作与基线逐条一致;make build-all 产出 4 进制;-X 注入经二进制
strings 实测生效;日志后端直连门禁改写为按 server 插件业务域扫描并在扫描数为 0
时报错(防门禁静默失效);前端零改动。
feat(cordis): 落地 backend/share 共享层与上游同步脚本
跨插件共享资源(控制消息协议、GeoIP+iputil、边缘守护进程日志)从下游包
移入 backend/share,并声明其只能依赖 core/pkg 与标准/第三方库,禁止反向
引用下游业务与具体插件实现;新增 scripts/sync-upstream.sh 只覆盖
backend/{core,pkg,plugins},同步后 --check 报告零差异,证明与上游逐字一致。
go build 通过,go test ./... exit 0(142 包 ok),前端零改动。
refactor(cordis): 采用与 Wavelet 同构的单模块布局并引入上游内核
按上游结构落位:backend/{core,pkg,plugins} 为 Wavelet 上游拷贝,OpenFlare
全部业务收拢到上游 downstream 所对应的位置 backend/OpenFlare/,模块名保持
Wavelet 以保证上游 import 路径逐字一致、同步零改写;三个 daemon 入口移至
backend/OpenFlare/cmd,backend/cmd 与 main.go 作为控制面装配根。
行为不变:go build 通过,142 个测试包全绿(含上游插件测试),232 条 API
操作与改造前逐条一致,四进制产物正常,前端零改动。swagger 暂只扫描下游代码,
待 P4 挂载上游路由后再纳入 plugins/。
style: 修正模块路径改写导致的 import 分组排序漂移
refactor(layout): Go 代码迁入 backend/ 并将模块名简化为 OpenFlare
对齐上游 Wavelet 的仓库布局,为以第二 module 形态 vendoring Cordis 内核与
平台插件做准备:模块路径整体改写为 OpenFlare,Go 目标加 cd backend,
swaggo 产物移至 backend/docs 并把 json/yaml 复制回 docs/ 供站点消费,
Dockerfile 与 release 工作流的构建目录、ldflags 模块路径同步更新。
行为保持不变:232 条路由与改造前逐条一致,95 个测试包全绿,
四进制产物正常,前端零改动。
chore(cordis): 落地改造计划与 schema/路由基线
新增 legacy_dump_test 迁移快照 harness:在临时 sqlite 库上按生产顺序
(goose.UpTo → zone 导入 → goose.Up)跑完 76 个历史迁移并导出 schema 与
版本序列,作为改造前后一致性门禁的唯一事实来源。同时记录 232 条路由清单
与 foundation 实施计划。
docs(cordis): add OpenFlare Cordis 架构改造设计
明确上游以第二 module 形态 vendoring 进 backend/Wavelet、4 个插件
(server/agent/relay/flared) 全部装载内核,并规定保留 76 个历史 goose
迁移 + 一次性版本 stamp 桥接的迁移方案,配套三方 schema 一致性门禁,
确保已部署库不重跑历史、不丢数据。
327 lines
8.5 KiB
Go
327 lines
8.5 KiB
Go
// Copyright 2026 Arctel.net
|
|
// SPDX-License-Identifier: Apache-2.0
|
|
|
|
package logstore
|
|
|
|
import (
|
|
"Wavelet/pkg/idgen"
|
|
"Wavelet/pkg/util"
|
|
"context"
|
|
"errors"
|
|
"fmt"
|
|
"sort"
|
|
"strings"
|
|
"time"
|
|
|
|
"gorm.io/gorm"
|
|
)
|
|
|
|
const (
|
|
insertBatchSize = 500
|
|
migrationPageSize = 100
|
|
defaultPageSize = 20
|
|
defaultTopN = 10
|
|
topUserAgents = 100
|
|
dayDuration = 24 * time.Hour
|
|
)
|
|
|
|
type gormLogStore struct {
|
|
db *gorm.DB
|
|
skipFreeze bool
|
|
}
|
|
|
|
func newGormStore(db *gorm.DB) *gormLogStore { return &gormLogStore{db: db} }
|
|
|
|
type userAccessLogGormStore struct {
|
|
*gormLogStore
|
|
}
|
|
|
|
func newUserAccessLogGormStore(db *gorm.DB) *userAccessLogGormStore {
|
|
return &userAccessLogGormStore{gormLogStore: newGormStore(db)}
|
|
}
|
|
|
|
var (
|
|
_ UserAccessLogStore = (*userAccessLogGormStore)(nil)
|
|
_ StatusStore = (*userAccessLogGormStore)(nil)
|
|
)
|
|
|
|
func (s *gormLogStore) ActiveDatabase(_ context.Context) (string, error) {
|
|
if isPostgresDialect(s.db) {
|
|
return dbNamePostgres, nil
|
|
}
|
|
return dbNameSQLite, nil
|
|
}
|
|
|
|
func (s *gormLogStore) ensureWritable(ctx context.Context) error {
|
|
if !s.skipFreeze && Migrating(ctx) {
|
|
return ErrMigrating
|
|
}
|
|
return nil
|
|
}
|
|
|
|
func (s *userAccessLogGormStore) BatchInsert(ctx context.Context, logs []UserAccessLog) error {
|
|
if len(logs) == 0 {
|
|
return nil
|
|
}
|
|
if err := s.ensureWritable(ctx); err != nil {
|
|
return err
|
|
}
|
|
for i := range logs {
|
|
if logs[i].ID == 0 {
|
|
logs[i].ID = idgen.NextUint64ID()
|
|
}
|
|
}
|
|
return s.db.WithContext(ctx).CreateInBatches(logs, insertBatchSize).Error
|
|
}
|
|
|
|
func (s *userAccessLogGormStore) DeleteAll(ctx context.Context) (int64, error) {
|
|
if err := s.ensureWritable(ctx); err != nil {
|
|
return 0, err
|
|
}
|
|
res := s.db.WithContext(ctx).Where("1 = 1").Delete(&UserAccessLog{})
|
|
return res.RowsAffected, res.Error
|
|
}
|
|
|
|
func (s *userAccessLogGormStore) DeleteBefore(ctx context.Context, cutoff time.Time) (int64, error) {
|
|
if err := s.ensureWritable(ctx); err != nil {
|
|
return 0, err
|
|
}
|
|
res := s.db.WithContext(ctx).Where("created_at < ?", cutoff).Delete(&UserAccessLog{})
|
|
if res.Error != nil && isMissingRelation(res.Error) {
|
|
return 0, nil
|
|
}
|
|
return res.RowsAffected, res.Error
|
|
}
|
|
|
|
func (s *userAccessLogGormStore) ListForMigration(ctx context.Context, afterID uint64, limit int) ([]UserAccessLog, error) {
|
|
var rows []UserAccessLog
|
|
q := s.db.WithContext(ctx).Model(&UserAccessLog{}).
|
|
Where("id > ?", afterID).
|
|
Order("id ASC").
|
|
Limit(limitOr(limit, migrationPageSize))
|
|
if err := q.Find(&rows).Error; err != nil {
|
|
return nil, err
|
|
}
|
|
return rows, nil
|
|
}
|
|
|
|
func (s *userAccessLogGormStore) MigrationRange(ctx context.Context) (time.Time, time.Time, error) {
|
|
return gormMigrationRange(ctx, s.db, "created_at", UserAccessLog{}, func(v *UserAccessLog) time.Time {
|
|
return v.CreatedAt
|
|
})
|
|
}
|
|
|
|
func (s *userAccessLogGormStore) Count(ctx context.Context, filter AccessLogFilter) (uint64, error) {
|
|
where, args, ok := buildUserAccessLogWhere(filter)
|
|
if !ok {
|
|
return 0, nil
|
|
}
|
|
var total int64
|
|
if err := s.db.WithContext(ctx).Model(&UserAccessLog{}).Where(where, args...).Count(&total).Error; err != nil {
|
|
return 0, err
|
|
}
|
|
return countToUint64(total), nil
|
|
}
|
|
|
|
func (s *userAccessLogGormStore) List(ctx context.Context, filter AccessLogFilter, page, pageSize int) ([]UserAccessLog, uint64, error) {
|
|
where, args, ok := buildUserAccessLogWhere(filter)
|
|
if !ok {
|
|
return []UserAccessLog{}, 0, nil
|
|
}
|
|
var total int64
|
|
if err := s.db.WithContext(ctx).Model(&UserAccessLog{}).Where(where, args...).Count(&total).Error; err != nil {
|
|
return nil, 0, err
|
|
}
|
|
if total == 0 {
|
|
return []UserAccessLog{}, 0, nil
|
|
}
|
|
var rows []UserAccessLog
|
|
q := s.db.WithContext(ctx).Where(where, args...).Order("created_at DESC, id DESC")
|
|
if err := q.Limit(limitOr(pageSize, defaultPageSize)).Offset(offsetOf(page, pageSize)).Find(&rows).Error; err != nil {
|
|
return nil, 0, err
|
|
}
|
|
return rows, countToUint64(total), nil
|
|
}
|
|
|
|
func buildUserAccessLogWhere(filter AccessLogFilter) (string, []any, bool) {
|
|
if filter.UserIDs != nil && len(filter.UserIDs) == 0 {
|
|
return "", nil, false
|
|
}
|
|
var parts []string
|
|
var args []any
|
|
if filter.UserIDs != nil {
|
|
parts = append(parts, "user_id IN ?")
|
|
args = append(args, filter.UserIDs)
|
|
}
|
|
if trimmed := strings.TrimSpace(filter.Path); trimmed != "" {
|
|
parts = append(parts, "path LIKE ? ESCAPE '\\'")
|
|
args = append(args, "%"+util.EscapeLike(trimmed)+"%")
|
|
}
|
|
if filter.StartTime != nil {
|
|
parts = append(parts, "created_at >= ?")
|
|
args = append(args, *filter.StartTime)
|
|
}
|
|
if filter.EndTime != nil {
|
|
parts = append(parts, "created_at <= ?")
|
|
args = append(args, *filter.EndTime)
|
|
}
|
|
if len(parts) == 0 {
|
|
return "1 = 1", args, true
|
|
}
|
|
return strings.Join(parts, " AND "), args, true
|
|
}
|
|
|
|
func (s *userAccessLogGormStore) GetDailyTrend(ctx context.Context, days int) ([]DailyTrend, error) {
|
|
if days <= 0 {
|
|
days = 7
|
|
}
|
|
start := time.Now().AddDate(0, 0, -(days - 1)).Truncate(dayDuration)
|
|
type row struct {
|
|
Date string
|
|
Cnt uint64
|
|
}
|
|
var rows []row
|
|
err := s.db.WithContext(ctx).Model(&UserAccessLog{}).
|
|
Select(dailyTrendDateSQL(s.db)+" AS date, COUNT(*) AS cnt").
|
|
Where("created_at >= ?", start).
|
|
Group("date").Order("date ASC").Scan(&rows).Error
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
counts := make(map[string]uint64, len(rows))
|
|
for _, r := range rows {
|
|
counts[r.Date] = r.Cnt
|
|
}
|
|
out := make([]DailyTrend, 0, days)
|
|
for i := 0; i < days; i++ {
|
|
d := start.AddDate(0, 0, i).Format("2006-01-02")
|
|
out = append(out, DailyTrend{Date: d, Count: counts[d]})
|
|
}
|
|
return out, nil
|
|
}
|
|
|
|
func (s *userAccessLogGormStore) GetBrowserDistribution(ctx context.Context, startTime time.Time) ([]BrowserShare, error) {
|
|
type row struct {
|
|
UserAgent string
|
|
Cnt uint64
|
|
}
|
|
var rows []row
|
|
err := s.db.WithContext(ctx).Model(&UserAccessLog{}).
|
|
Select("user_agent, COUNT(*) AS cnt").
|
|
Where("created_at >= ?", startTime).
|
|
Group("user_agent").Order("cnt DESC").Limit(topUserAgents).Scan(&rows).Error
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
counts := make(map[string]uint64)
|
|
for _, r := range rows {
|
|
counts[ParseBrowserName(r.UserAgent)] += r.Cnt
|
|
}
|
|
out := make([]BrowserShare, 0, len(counts))
|
|
for label, count := range counts {
|
|
out = append(out, BrowserShare{Browser: label, Count: count})
|
|
}
|
|
sort.Slice(out, func(i, j int) bool { return out[i].Count > out[j].Count })
|
|
return out, nil
|
|
}
|
|
|
|
func (s *userAccessLogGormStore) GetTopActiveUsers(ctx context.Context, startTime time.Time, limit int) ([]TopUser, error) {
|
|
type row struct {
|
|
UserID uint64
|
|
Cnt uint64
|
|
}
|
|
var rows []row
|
|
err := s.db.WithContext(ctx).Model(&UserAccessLog{}).
|
|
Select("user_id, COUNT(*) AS cnt").
|
|
Where("user_id <> 0 AND created_at >= ?", startTime).
|
|
Group("user_id").Order("cnt DESC").Limit(limitOr(limit, defaultTopN)).Scan(&rows).Error
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
out := make([]TopUser, len(rows))
|
|
for i, r := range rows {
|
|
out[i] = TopUser{UserID: r.UserID, Count: r.Cnt}
|
|
}
|
|
return out, nil
|
|
}
|
|
|
|
func (s *userAccessLogGormStore) EnsurePartitions(ctx context.Context, from, to time.Time) error {
|
|
if !isPostgresDialect(s.db) {
|
|
return nil
|
|
}
|
|
for _, sql := range partitionStatementsRange(from, to) {
|
|
if err := s.db.WithContext(ctx).Exec(sql).Error; err != nil {
|
|
return fmt.Errorf("ensure partition: %w", err)
|
|
}
|
|
}
|
|
return nil
|
|
}
|
|
|
|
func gormMigrationRange[T any](
|
|
ctx context.Context,
|
|
gdb *gorm.DB,
|
|
column string,
|
|
model T,
|
|
timeOf func(*T) time.Time,
|
|
) (time.Time, time.Time, error) {
|
|
var first, last T
|
|
found := false
|
|
for _, order := range []string{"ASC", "DESC"} {
|
|
out := &first
|
|
if order == "DESC" {
|
|
out = &last
|
|
}
|
|
res := gdb.WithContext(ctx).Model(model).Order(column + " " + order).Limit(1).Take(out)
|
|
if res.Error != nil && !errors.Is(res.Error, gorm.ErrRecordNotFound) {
|
|
return time.Time{}, time.Time{}, fmt.Errorf("query migration range %s: %w", column, res.Error)
|
|
}
|
|
if res.Error == nil {
|
|
found = true
|
|
}
|
|
}
|
|
if !found {
|
|
return time.Time{}, time.Time{}, nil
|
|
}
|
|
return timeOf(&first).UTC(), timeOf(&last).UTC(), nil
|
|
}
|
|
|
|
func limitOr(v, def int) int {
|
|
if v <= 0 {
|
|
return def
|
|
}
|
|
return v
|
|
}
|
|
|
|
func offsetOf(page, pageSize int) int {
|
|
if page < 1 {
|
|
page = 1
|
|
}
|
|
return (page - 1) * limitOr(pageSize, defaultPageSize)
|
|
}
|
|
|
|
func countToUint64(v int64) uint64 {
|
|
if v < 0 {
|
|
return 0
|
|
}
|
|
return uint64(v)
|
|
}
|
|
|
|
func isPostgresDialect(db *gorm.DB) bool {
|
|
return db != nil && db.Dialector != nil && db.Name() == "postgres"
|
|
}
|
|
|
|
func dailyTrendDateSQL(db *gorm.DB) string {
|
|
if isPostgresDialect(db) {
|
|
return "to_char(created_at, 'YYYY-MM-DD')"
|
|
}
|
|
return "strftime('%Y-%m-%d', created_at)"
|
|
}
|
|
|
|
func isMissingRelation(err error) bool {
|
|
if err == nil {
|
|
return false
|
|
}
|
|
msg := strings.ToLower(err.Error())
|
|
return strings.Contains(msg, "no such table") || strings.Contains(msg, "does not exist")
|
|
}
|