apploader

type Configuration struct {
	// Name 是应用名称。
	Name string `mapstructure:"name" toml:"name"`
	// Version 是应用配置声明的版本。
	Version string `mapstructure:"version" toml:"version"`
	// Web 保存 Web 监听配置。
	Web web `mapstructure:"web" toml:"web"`
	// Db 保存 PostgreSQL 配置；字段名为兼容既有调用保留。
	Db db `mapstructure:"db" toml:"db"`
	// Redis 保存 Redis 配置。
	Redis redis `mapstructure:"redis" toml:"redis"`
	// LogConf 保存日志输出配置。
	LogConf logConf `mapstructure:"logConf" toml:"logConf"`
}

type Loader interface {
	// LoadToStruct 将配置文件和环境变量映射到非 nil 结构体指针。
	LoadToStruct(config interface{}) error
	// SetConfigFileSearcher 设置配置文件名称和搜索目录，并立即尝试读取配置文件。
	SetConfigFileSearcher(configName string, searchPath ...string) Loader
	// EnableEnvSearcher 开启环境变量覆盖；非空前缀会生成 PREFIX_SECTION_FIELD 格式的变量名。
	EnableEnvSearcher(envPrefix string) Loader
	// Watch 监听配置文件变更，重载成功（含业务校验）后同步调用 handler。
	// 必须在 LoadToStruct 之后调用；仅支持文件源的变更监听。
	Watch(handler func()) error
}

type Redactor interface {
	// Redact 返回可安全输出的配置快照；密码、Token 等敏感字段必须打码。
	Redact() map[string]interface{}
}

type Validator interface {
	// Validate 返回配置不可用于启动的具体原因，不得在错误中包含密码或完整连接串。
	Validate() error
}