cache

type Cache struct {
	ModuleName string    `mapstructure:"module-name" yaml:"module-name" json:"moduleName"`
	Type       CacheType `mapstructure:"type" yaml:"type" json:"type"`
	Enabled    bool      `mapstructure:"enabled" yaml:"enabled" json:"enabled"`

	// 基础配置
	DefaultTTL time.Duration `mapstructure:"default-ttl" yaml:"default-ttl" json:"defaultTtl"`
	KeyPrefix  string        `mapstructure:"key-prefix" yaml:"key-prefix" json:"keyPrefix"`
	Serializer string        `mapstructure:"serializer" yaml:"serializer" json:"serializer"` // json, gob, msgpack

	// 各种缓存实现的配置（按需使用）
	Memory    Memory    `mapstructure:"memory" yaml:"memory" json:"memory"`
	Ristretto Ristretto `mapstructure:"ristretto" yaml:"ristretto" json:"ristretto"`
	Redis     Redis     `mapstructure:"redis" yaml:"redis" json:"redis"`
	Sharded   Sharded   `mapstructure:"sharded" yaml:"sharded" json:"sharded"`
	TwoLevel  TwoLevel  `mapstructure:"two-level" yaml:"two-level" json:"twoLevel"`
	Expiring  Expiring  `mapstructure:"expiring" yaml:"expiring" json:"expiring"`
}

type CacheType string

type Expiring struct {
	ModuleName       string        `mapstructure:"module-name" yaml:"module-name" json:"moduleName"`                     // 模块名
	CleanupInterval  time.Duration `mapstructure:"cleanup-interval" yaml:"cleanup-interval" json:"cleanupInterval"`      // 清理间隔
	DefaultTTL       time.Duration `mapstructure:"default-ttl" yaml:"default-ttl" json:"defaultTtl"`                     // 默认TTL
	MaxSize          int           `mapstructure:"max-size" yaml:"max-size" json:"maxSize"`                              // 最大大小
	EvictionPolicy   string        `mapstructure:"eviction-policy" yaml:"eviction-policy" json:"evictionPolicy"`         // 驱逐策略: lru, lfu, fifo
	EnableLazyExpiry bool          `mapstructure:"enable-lazy-expiry" yaml:"enable-lazy-expiry" json:"enableLazyExpiry"` // 启用懒惰过期
	MaxMemoryUsage   int64         `mapstructure:"max-memory-usage" yaml:"max-memory-usage" json:"maxMemoryUsage"`       // 最大内存使用量(字节)
}

type Memory struct {
	ModuleName  string        `mapstructure:"module-name" yaml:"module-name" json:"moduleName"`                     // 模块名
	Capacity    int           `mapstructure:"capacity" yaml:"capacity" json:"capacity" validate:"min=1"`            // 缓存容量
	DefaultTTL  time.Duration `mapstructure:"default-ttl" yaml:"default-ttl" json:"defaultTtl"`                     // 默认过期时间
	CleanupSize int           `mapstructure:"cleanup-size" yaml:"cleanup-size" json:"cleanupSize" validate:"min=0"` // 清理大小
	MaxSize     int           `mapstructure:"max-size" yaml:"max-size" json:"maxSize" validate:"min=0"`             // 最大大小
}

type Redis struct {
	ModuleName string `mapstructure:"module-name" yaml:"module-name" json:"moduleName"` // 模块名
	// 兼容原有配置
	Addr string `mapstructure:"addr" yaml:"addr" json:"addr" validate:"url"` // Redis 数据服务器 IP 和端口（兼容旧版）
	// 新增增强配置
	Addrs                 []string      `mapstructure:"addrs" yaml:"addrs" json:"addrs"`                                                     // Redis服务器地址列表（集群模式）
	ClientName            string        `mapstructure:"client-name" yaml:"client-name" json:"clientName"`                                    // 客户端名称，执行 CLIENT SETNAME
	Protocol              int           `mapstructure:"protocol" yaml:"protocol" json:"protocol"`                                            // RESP 协议版本（2 或 3）
	Username              string        `mapstructure:"username" yaml:"username" json:"username"`                                            // 用户名
	Password              string        `mapstructure:"password" yaml:"password" json:"password"`                                            // 连接密码
	SentinelUsername      string        `mapstructure:"sentinel-username" yaml:"sentinel-username" json:"sentinelUsername"`                  // 哨兵认证用户名
	SentinelPassword      string        `mapstructure:"sentinel-password" yaml:"sentinel-password" json:"sentinelPassword"`                  // 哨兵认证密码
	DB                    int           `mapstructure:"db" yaml:"db" json:"db" validate:"min=0"`                                             // 指定连接的数据库，默认连数据库 0
	MaxRetries            int           `mapstructure:"max-retries" yaml:"max-retries" json:"maxRetries" validate:"min=0"`                   // 最大重试次数，最小值为 0
	MaxRedirects          int           `mapstructure:"max-redirects" yaml:"max-redirects" json:"maxRedirects" validate:"min=0"`             // 集群模式最大重定向次数
	PoolSize              int           `mapstructure:"pool-size" yaml:"pool-size" json:"poolSize" validate:"min=1"`                         // 连接池大小，最小值为 1
	MaxActiveConns        int           `mapstructure:"max-active-conns" yaml:"max-active-conns" json:"maxActiveConns" validate:"min=0"`     // 最大活跃连接数，0 表示不限制
	MinIdleConns          int           `mapstructure:"min-idle-conns" yaml:"min-idle-conns" json:"minIdleConns" validate:"min=0"`           // 最小空闲连接数，最小值为 0
	MaxIdleConns          int           `mapstructure:"max-idle-conns" yaml:"max-idle-conns" json:"maxIdleConns" validate:"min=0"`           // 最大空闲连接数，最小值为 0
	ReadBufferSize        int           `mapstructure:"read-buffer-size" yaml:"read-buffer-size" json:"readBufferSize" validate:"min=0"`     // 读缓冲区大小（字节），默认 32KB
	WriteBufferSize       int           `mapstructure:"write-buffer-size" yaml:"write-buffer-size" json:"writeBufferSize" validate:"min=0"`  // 写缓冲区大小（字节），默认 32KB
	MaxConnAge            time.Duration `mapstructure:"max-conn-age" yaml:"max-conn-age" json:"maxConnAge"`                                  // 连接最大存活时间
	DialTimeout           time.Duration `mapstructure:"dial-timeout" yaml:"dial-timeout" json:"dialTimeout"`                                 // 连接超时
	PoolTimeout           time.Duration `mapstructure:"pool-timeout" yaml:"pool-timeout" json:"poolTimeout"`                                 // 连接池超时
	IdleTimeout           time.Duration `mapstructure:"idle-timeout" yaml:"idle-timeout" json:"idleTimeout"`                                 // 空闲超时
	ReadTimeout           time.Duration `mapstructure:"read-timeout" yaml:"read-timeout" json:"readTimeout"`                                 // 读取超时
	WriteTimeout          time.Duration `mapstructure:"write-timeout" yaml:"write-timeout" json:"writeTimeout"`                              // 写入超时
	MinRetryBackoff       time.Duration `mapstructure:"min-retry-backoff" yaml:"min-retry-backoff" json:"minRetryBackoff" validate:"min=0"`  // 最小重试间隔
	MaxRetryBackoff       time.Duration `mapstructure:"max-retry-backoff" yaml:"max-retry-backoff" json:"maxRetryBackoff" validate:"min=0"`  // 最大重试间隔
	ContextTimeoutEnabled bool          `mapstructure:"context-timeout-enabled" yaml:"context-timeout-enabled" json:"contextTimeoutEnabled"` // 是否用 context 控制命令超时
	ReadOnly              bool          `mapstructure:"read-only" yaml:"read-only" json:"readOnly"`                                          // 集群模式只读（从节点读）
	ClusterMode           bool          `mapstructure:"cluster-mode" yaml:"cluster-mode" json:"clusterMode"`                                 // 是否集群模式（单地址集群也生效，映射到 go-redis IsClusterMode）
	MasterName            string        `mapstructure:"master-name" yaml:"master-name" json:"masterName"`                                    // 哨兵模式 master 名称，非空时启用哨兵模式
	RouteByLatency        bool          `mapstructure:"route-by-latency" yaml:"route-by-latency" json:"routeByLatency"`                      // 集群模式按延迟路由（只读从节点）
	RouteRandomly         bool          `mapstructure:"route-randomly" yaml:"route-randomly" json:"routeRandomly"`                           // 集群模式随机路由（只读从节点）
}

type Ristretto struct {
	ModuleName         string `mapstructure:"module-name" yaml:"module-name" json:"moduleName"`                           // 模块名
	NumCounters        int64  `mapstructure:"num-counters" yaml:"num-counters" json:"numCounters" validate:"min=1"`       // 计数器数量，用于跟踪访问频率
	MaxCost            int64  `mapstructure:"max-cost" yaml:"max-cost" json:"maxCost" validate:"min=1"`                   // 最大缓存成本
	BufferItems        int64  `mapstructure:"buffer-items" yaml:"buffer-items" json:"bufferItems" validate:"min=1"`       // Get 缓存的大小
	Metrics            bool   `mapstructure:"metrics" yaml:"metrics" json:"metrics"`                                      // 是否启用缓存统计
	IgnoreInternalCost bool   `mapstructure:"ignore-internal-cost" yaml:"ignore-internal-cost" json:"ignoreInternalCost"` // 是否忽略内部成本计算
	KeyToHash          bool   `mapstructure:"key-to-hash" yaml:"key-to-hash" json:"keyToHash"`                            // 是否将键转换为哈希
	Cost               int64  `mapstructure:"cost" yaml:"cost" json:"cost" validate:"min=0"`                              // 每个条目的默认成本
}

type Sharded struct {
	ModuleName   string    `mapstructure:"module-name" yaml:"module-name" json:"moduleName"`                  // 模块名
	ShardCount   int       `mapstructure:"shard-count" yaml:"shard-count" json:"shardCount" validate:"min=1"` // 分片数量
	BaseType     CacheType `mapstructure:"base-type" yaml:"base-type" json:"baseType"`                        // 基础缓存类型
	HashFunc     string    `mapstructure:"hash-func" yaml:"hash-func" json:"hashFunc"`                        // 哈希函数: fnv, crc32, md5
	LoadBalancer string    `mapstructure:"load-balancer" yaml:"load-balancer" json:"loadBalancer"`            // 负载均衡策略: consistent_hash, round_robin
}

type TwoLevel struct {
	ModuleName       string        `mapstructure:"module-name" yaml:"module-name" json:"moduleName"`                   // 模块名
	L1Type           CacheType     `mapstructure:"l1-type" yaml:"l1-type" json:"l1Type"`                               // L1缓存类型
	L2Type           CacheType     `mapstructure:"l2-type" yaml:"l2-type" json:"l2Type"`                               // L2缓存类型
	L1TTL            time.Duration `mapstructure:"l1-ttl" yaml:"l1-ttl" json:"l1Ttl"`                                  // L1缓存TTL
	L2TTL            time.Duration `mapstructure:"l2-ttl" yaml:"l2-ttl" json:"l2Ttl"`                                  // L2缓存TTL
	SyncStrategy     string        `mapstructure:"sync-strategy" yaml:"sync-strategy" json:"syncStrategy"`             // 同步策略: write_through, write_back, write_around
	L1Size           int           `mapstructure:"l1-size" yaml:"l1-size" json:"l1Size"`                               // L1缓存大小
	L2Size           int           `mapstructure:"l2-size" yaml:"l2-size" json:"l2Size"`                               // L2缓存大小
	PromoteThreshold int           `mapstructure:"promote-threshold" yaml:"promote-threshold" json:"promoteThreshold"` // 提升阈值
}