hyapp-server/services/lucky-gift-service/internal/config/config.go

package config

import (
	"fmt"
	"strings"
	"time"

	"hyapp/pkg/configx"
	"hyapp/pkg/logx"
)

// Config 描述 lucky-gift-service 的进程启动边界。
// 规则、RTP、奖池、应用级外部接入和 outbox 都属于本服务；room/activity/admin 只能通过 gRPC 访问。
type Config struct {
	ServiceName       string                `yaml:"service_name"`
	NodeID            string                `yaml:"node_id"`
	Environment       string                `yaml:"environment"`
	GRPCAddr          string                `yaml:"grpc_addr"`
	HealthHTTPAddr    string                `yaml:"health_http_addr"`
	MySQLDSN          string                `yaml:"mysql_dsn"`
	MySQLAutoMigrate  bool                  `yaml:"mysql_auto_migrate"`
	WalletServiceAddr string                `yaml:"wallet_service_addr"`
	LuckyGiftWorker   LuckyGiftWorkerConfig `yaml:"lucky_gift_worker"`
	Log               logx.Config           `yaml:"log"`
}

// LuckyGiftWorkerConfig 控制 draw outbox 补偿和统计快照刷新。
// 外部 App 抽奖不走 HyApp wallet，但仍写 outbox 给审计/统计；内部房间抽奖中奖后由 worker 兜底补发钱包和 IM。
type LuckyGiftWorkerConfig struct {
	Enabled              bool          `yaml:"enabled"`
	WorkerPollInterval   time.Duration `yaml:"worker_poll_interval"`
	WorkerBatchSize      int           `yaml:"worker_batch_size"`
	WorkerConcurrency    int           `yaml:"worker_concurrency"`
	WorkerLockTTL        time.Duration `yaml:"worker_lock_ttl"`
	WorkerMaxRetry       int           `yaml:"worker_max_retry"`
	PublishTimeout       time.Duration `yaml:"publish_timeout"`
	StatsRefreshInterval time.Duration `yaml:"stats_refresh_interval"`
	StatsBatchSize       int           `yaml:"stats_batch_size"`
	// Retention 控制 delivered 历史事件的定期清理；它独立于 Enabled，临时关闭补偿投递不会停掉清理。
	Retention OutboxRetentionConfig `yaml:"retention"`
}

// OutboxRetentionConfig 控制 lucky_gift_outbox 中 delivered 历史事件的小批量定期删除。
// 只清理 delivered：pending/retryable/delivering 仍在投递生命周期内，failed 留给人工补偿。
// 抽奖事实和审计都在 lucky_draw_records，outbox 没有下游读方，默认开启。
type OutboxRetentionConfig struct {
	Enabled bool `yaml:"enabled"`
	// MaxAge 是 delivered 事件按 updated_at_ms 计算的保留时长，早于 now-MaxAge 的才会删除。
	MaxAge time.Duration `yaml:"max_age"`
	// ScanInterval 是清空一轮可删事件后到下一轮扫描的间隔。
	ScanInterval time.Duration `yaml:"scan_interval"`
	// BatchSize 是单条 DELETE 的行数上限，小批量避免大事务长时间持有行锁。
	BatchSize int `yaml:"batch_size"`
}

func Default() Config {
	return Config{
		ServiceName:       "lucky-gift-service",
		NodeID:            "lucky-gift-local",
		Environment:       "local",
		GRPCAddr:          ":13013",
		HealthHTTPAddr:    ":13113",
		MySQLDSN:          "hyapp:hyapp@tcp(127.0.0.1:23306)/hyapp_lucky_gift?parseTime=true&charset=utf8mb4&loc=UTC",
		MySQLAutoMigrate:  true,
		WalletServiceAddr: "127.0.0.1:13004",
		LuckyGiftWorker: LuckyGiftWorkerConfig{
			Enabled:              true,
			WorkerPollInterval:   time.Second,
			WorkerBatchSize:      100,
			WorkerConcurrency:    8,
			WorkerLockTTL:        30 * time.Second,
			WorkerMaxRetry:       8,
			PublishTimeout:       5 * time.Second,
			StatsRefreshInterval: 10 * time.Minute,
			StatsBatchSize:       5000,
			Retention: OutboxRetentionConfig{
				Enabled: true,
				// 线上 delivered 约 9 万行/天且无下游读方；7 天足够排障，30 天会让表膨胀到近 300 万行。
				MaxAge:       7 * 24 * time.Hour,
				ScanInterval: 5 * time.Minute,
				BatchSize:    500,
			},
		},
		Log: logx.Config{
			Level:           "info",
			Format:          "json",
			MaxPayloadBytes: 2048,
		},
	}
}

func Load(path string) (Config, error) {
	cfg := Default()
	if strings.TrimSpace(path) == "" {
		return cfg, nil
	}
	if err := configx.LoadYAML(path, &cfg); err != nil {
		return Config{}, err
	}
	cfg.ServiceName = strings.TrimSpace(cfg.ServiceName)
	if cfg.ServiceName == "" {
		cfg.ServiceName = "lucky-gift-service"
	}
	cfg.NodeID = strings.TrimSpace(cfg.NodeID)
	if cfg.NodeID == "" {
		cfg.NodeID = cfg.ServiceName
	}
	cfg.Environment = strings.ToLower(strings.TrimSpace(cfg.Environment))
	if cfg.Environment == "" {
		cfg.Environment = "local"
	}
	cfg.GRPCAddr = strings.TrimSpace(cfg.GRPCAddr)
	if cfg.GRPCAddr == "" {
		cfg.GRPCAddr = ":13013"
	}
	cfg.HealthHTTPAddr = strings.TrimSpace(cfg.HealthHTTPAddr)
	if cfg.HealthHTTPAddr == "" {
		cfg.HealthHTTPAddr = ":13113"
	}
	cfg.WalletServiceAddr = strings.TrimSpace(cfg.WalletServiceAddr)
	if cfg.WalletServiceAddr == "" {
		cfg.WalletServiceAddr = "127.0.0.1:13004"
	}
	if cfg.LuckyGiftWorker.WorkerPollInterval <= 0 {
		cfg.LuckyGiftWorker.WorkerPollInterval = time.Second
	}
	if cfg.LuckyGiftWorker.WorkerBatchSize <= 0 {
		cfg.LuckyGiftWorker.WorkerBatchSize = 100
	}
	if cfg.LuckyGiftWorker.WorkerConcurrency <= 0 {
		cfg.LuckyGiftWorker.WorkerConcurrency = 8
	}
	if cfg.LuckyGiftWorker.WorkerLockTTL <= 0 {
		cfg.LuckyGiftWorker.WorkerLockTTL = 30 * time.Second
	}
	if cfg.LuckyGiftWorker.WorkerMaxRetry <= 0 {
		cfg.LuckyGiftWorker.WorkerMaxRetry = 8
	}
	if cfg.LuckyGiftWorker.PublishTimeout <= 0 {
		cfg.LuckyGiftWorker.PublishTimeout = 5 * time.Second
	}
	if cfg.LuckyGiftWorker.StatsRefreshInterval <= 0 {
		cfg.LuckyGiftWorker.StatsRefreshInterval = 10 * time.Minute
	}
	if cfg.LuckyGiftWorker.StatsBatchSize <= 0 {
		cfg.LuckyGiftWorker.StatsBatchSize = 5000
	}
	defaults := Default().LuckyGiftWorker.Retention
	if cfg.LuckyGiftWorker.Retention.MaxAge <= 0 {
		cfg.LuckyGiftWorker.Retention.MaxAge = defaults.MaxAge
	}
	if cfg.LuckyGiftWorker.Retention.ScanInterval <= 0 {
		cfg.LuckyGiftWorker.Retention.ScanInterval = defaults.ScanInterval
	}
	if cfg.LuckyGiftWorker.Retention.BatchSize <= 0 {
		cfg.LuckyGiftWorker.Retention.BatchSize = defaults.BatchSize
	}
	if cfg.LuckyGiftWorker.Retention.Enabled && cfg.LuckyGiftWorker.Retention.MaxAge < 24*time.Hour {
		// 保留窗口低于一天基本可以断定是把单位写错（比如 30 写成 30ns/30s），宁可拒绝启动。
		return Config{}, fmt.Errorf("lucky_gift_worker retention max_age %s is below the 24h safety floor", cfg.LuckyGiftWorker.Retention.MaxAge)
	}
	return cfg, nil
}