database

type CockroachDB struct {
	ModuleName                               string `mapstructure:"module-name" yaml:"module-name" json:"moduleName"`
	Host                                     string `mapstructure:"host" yaml:"host" json:"host" validate:"required"`
	Port                                     string `mapstructure:"port" yaml:"port" json:"port" validate:"required"`
	Config                                   string `mapstructure:"config" yaml:"config" json:"config" validate:"required"`
	LogLevel                                 string `mapstructure:"log-level" yaml:"log-level" json:"logLevel" validate:"required"`
	SlowThreshold                            int    `mapstructure:"slow-threshold" yaml:"slow-threshold" json:"slowThreshold"`
	IgnoreRecordNotFoundError                bool   `mapstructure:"ignore-record-not-found-error" yaml:"ignore-record-not-found-error" json:"ignoreRecordNotFoundError"`
	Dbname                                   string `mapstructure:"db-name" yaml:"db-name" json:"dbName" validate:"required"`
	Username                                 string `mapstructure:"username" yaml:"username" json:"username" validate:"required"`
	Password                                 string `mapstructure:"password" yaml:"password" json:"password" validate:"required"`
	MaxIdleConns                             int    `mapstructure:"max-idle-conns" yaml:"max-idle-conns" json:"maxIdleConns" validate:"min=0"`
	MaxOpenConns                             int    `mapstructure:"max-open-conns" yaml:"max-open-conns" json:"maxOpenConns" validate:"min=0"`
	ConnMaxIdleTime                          int    `mapstructure:"conn-max-idle-time" yaml:"conn-max-idle-time" json:"connMaxIdleTime" validate:"min=0"`
	ConnMaxLifeTime                          int    `mapstructure:"conn-max-life-time" yaml:"conn-max-life-time" json:"connMaxLifeTime" validate:"min=0"`
	SkipDefaultTransaction                   bool   `mapstructure:"skip-default-transaction" yaml:"skip-default-transaction" json:"skipDefaultTransaction"`
	PrepareStmt                              bool   `mapstructure:"prepare-stmt" yaml:"prepare-stmt" json:"prepareStmt"`
	DisableForeignKeyConstraintWhenMigrating bool   `` /* 161-byte string literal not displayed */
	DisableNestedTransaction                 bool   `mapstructure:"disable-nested-transaction" yaml:"disable-nested-transaction" json:"disableNestedTransaction"`
	AllowGlobalUpdate                        bool   `mapstructure:"allow-global-update" yaml:"allow-global-update" json:"allowGlobalUpdate"`
	QueryFields                              bool   `mapstructure:"query-fields" yaml:"query-fields" json:"queryFields"`
	CreateBatchSize                          int    `mapstructure:"create-batch-size" yaml:"create-batch-size" json:"createBatchSize"`
	SingularTable                            bool   `mapstructure:"singular-table" yaml:"singular-table" json:"singularTable"`
}

type DBType string

type Database struct {
	Type        DBType       `mapstructure:"type" yaml:"type" json:"type"`                      // 数据库类型
	Enabled     bool         `mapstructure:"enabled" yaml:"enabled" json:"enabled"`             // 是否启用
	Default     string       `mapstructure:"default" yaml:"default" json:"default"`             // 默认使用的数据库
	MySQL       *MySQL       `mapstructure:"mysql" yaml:"mysql" json:"mysql"`                   // MySQL配置
	PostgreSQL  *PostgreSQL  `mapstructure:"postgresql" yaml:"postgresql" json:"postgresql"`    // PostgreSQL配置
	SQLite      *SQLite      `mapstructure:"sqlite" yaml:"sqlite" json:"sqlite"`                // SQLite配置
	CockroachDB *CockroachDB `mapstructure:"cockroachdb" yaml:"cockroachdb" json:"cockroachdb"` // CockroachDB配置
}

type DatabaseProvider interface {
	internal.Configurable

	// GetDBType 获取数据库类型
	GetDBType() DBType

	// GetHost 获取主机地址
	GetHost() string

	// GetPort 获取端口
	GetPort() string

	// GetDBName 获取数据库名称
	GetDBName() string

	// GetUsername 获取用户名
	GetUsername() string

	// GetPassword 获取密码
	GetPassword() string

	// GetConfig 获取额外配置
	GetConfig() string

	// GetModuleName 获取模块名称
	GetModuleName() string

	// GetSlowThreshold 获取慢查询阈值（毫秒）
	GetSlowThreshold() int

	// GetLogLevel 获取SQL日志等级（silent/error/warn/info，gorm logger 消费）
	GetLogLevel() string

	// GetIgnoreRecordNotFoundError 获取是否忽略RecordNotFound错误
	GetIgnoreRecordNotFoundError() bool

	// GORM 性能配置 Getter 方法
	// GetSkipDefaultTransaction 获取是否跳过默认事务
	GetSkipDefaultTransaction() bool

	// GetPrepareStmt 获取是否启用预编译语句
	GetPrepareStmt() bool

	// GetDisableForeignKeyConstraintWhenMigrating 获取迁移时是否禁用外键约束
	GetDisableForeignKeyConstraintWhenMigrating() bool

	// GetDisableNestedTransaction 获取是否禁用嵌套事务
	GetDisableNestedTransaction() bool

	// GetAllowGlobalUpdate 获取是否允许全局更新
	GetAllowGlobalUpdate() bool

	// GetQueryFields 获取是否在查询时选择所有字段
	GetQueryFields() bool

	// GetCreateBatchSize 获取批量创建的大小
	GetCreateBatchSize() int

	// GetSingularTable 获取是否使用单数表名
	GetSingularTable() bool

	// SetCredentials 设置凭证
	SetCredentials(username, password string)

	// SetHost 设置主机地址
	SetHost(host string)

	// SetPort 设置端口
	SetPort(port string)

	// SetDBName 设置数据库名称
	SetDBName(dbName string)
}

type MySQL struct {
	ModuleName                               string `mapstructure:"module-name" yaml:"module-name" json:"moduleName"`                                                    // 模块名称
	Host                                     string `mapstructure:"host" yaml:"host" json:"host"            validate:"required"`                                         // 数据库 IP 地址
	Port                                     string `mapstructure:"port" yaml:"port" json:"port"            validate:"required"`                                         // 端口
	Config                                   string `mapstructure:"config" yaml:"config" json:"config"          validate:"required"`                                     // 后缀配置 默认配置 charset=utf8mb4&parseTime=True&loc=Local
	LogLevel                                 string `mapstructure:"log-level" yaml:"log-level" json:"logLevel"       validate:"required"`                                // SQL 日志等级
	SlowThreshold                            int    `mapstructure:"slow-threshold" yaml:"slow-threshold" json:"slowThreshold"`                                           // 慢查询阈值（毫秒）
	IgnoreRecordNotFoundError                bool   `mapstructure:"ignore-record-not-found-error" yaml:"ignore-record-not-found-error" json:"ignoreRecordNotFoundError"` // 是否忽略ErrRecordNotFound错误
	Dbname                                   string `mapstructure:"db-name" yaml:"db-name" json:"dbName"         validate:"required"`                                    // 数据库名称
	Username                                 string `mapstructure:"username" yaml:"username" json:"username"        validate:"required"`                                 // 数据库用户名
	Password                                 string `mapstructure:"password" yaml:"password" json:"password"        validate:"required"`                                 // 数据库密码
	MaxIdleConns                             int    `mapstructure:"max-idle-conns" yaml:"max-idle-conns" json:"maxIdleConns"  validate:"min=0"`                          // 最大空闲连接数
	MaxOpenConns                             int    `mapstructure:"max-open-conns" yaml:"max-open-conns" json:"maxOpenConns"  validate:"min=0"`                          // 最大连接数
	ConnMaxIdleTime                          int    `mapstructure:"conn-max-idle-time" yaml:"conn-max-idle-time" json:"connMaxIdleTime" validate:"min=0"`                // 连接最大空闲时间 单位：秒
	ConnMaxLifeTime                          int    `mapstructure:"conn-max-life-time" yaml:"conn-max-life-time" json:"connMaxLifeTime" validate:"min=0"`                // 连接最大生命周期 单位：秒
	SkipDefaultTransaction                   bool   `mapstructure:"skip-default-transaction" yaml:"skip-default-transaction" json:"skipDefaultTransaction"`              // 跳过默认事务
	PrepareStmt                              bool   `mapstructure:"prepare-stmt" yaml:"prepare-stmt" json:"prepareStmt"`                                                 // 预编译语句
	DisableForeignKeyConstraintWhenMigrating bool   ``                                                                                                                   // 禁用自动创建外键约束
	/* 161-byte string literal not displayed */
	DisableNestedTransaction bool `mapstructure:"disable-nested-transaction" yaml:"disable-nested-transaction" json:"disableNestedTransaction"` // 禁用嵌套事务
	AllowGlobalUpdate        bool `mapstructure:"allow-global-update" yaml:"allow-global-update" json:"allowGlobalUpdate"`                      // 允许全局更新
	QueryFields              bool `mapstructure:"query-fields" yaml:"query-fields" json:"queryFields"`                                          // 执行查询时选择所有字段
	CreateBatchSize          int  `mapstructure:"create-batch-size" yaml:"create-batch-size" json:"createBatchSize"`                            // 批量创建大小
	SingularTable            bool `mapstructure:"singular-table" yaml:"singular-table" json:"singularTable"`                                    // 使用单数表名
}

type PostgreSQL struct {
	ModuleName                               string `mapstructure:"module-name" yaml:"module-name" json:"moduleName"`                                                    // 模块名称
	Host                                     string `mapstructure:"host" yaml:"host" json:"host"            validate:"required"`                                         // 数据库 IP 地址
	Port                                     string `mapstructure:"port" yaml:"port" json:"port"            validate:"required"`                                         // 端口
	Config                                   string `mapstructure:"config" yaml:"config" json:"config"          validate:"required"`                                     // 后缀配置
	LogLevel                                 string `mapstructure:"log-level" yaml:"log-level" json:"logLevel"       validate:"required"`                                // SQL 日志等级
	SlowThreshold                            int    `mapstructure:"slow-threshold" yaml:"slow-threshold" json:"slowThreshold"`                                           // 慢查询阈值（毫秒）
	IgnoreRecordNotFoundError                bool   `mapstructure:"ignore-record-not-found-error" yaml:"ignore-record-not-found-error" json:"ignoreRecordNotFoundError"` // 是否忽略ErrRecordNotFound错误
	Dbname                                   string `mapstructure:"db-name" yaml:"db-name" json:"dbName"         validate:"required"`                                    // 数据库名称
	Username                                 string `mapstructure:"username" yaml:"username" json:"username"        validate:"required"`                                 // 数据库用户名
	Password                                 string `mapstructure:"password" yaml:"password" json:"password"        validate:"required"`                                 // 数据库密码
	MaxIdleConns                             int    `mapstructure:"max-idle-conns" yaml:"max-idle-conns" json:"maxIdleConns"  validate:"min=0"`                          // 最大空闲连接数
	MaxOpenConns                             int    `mapstructure:"max-open-conns" yaml:"max-open-conns" json:"maxOpenConns"  validate:"min=0"`                          // 最大连接数
	ConnMaxIdleTime                          int    `mapstructure:"conn-max-idle-time" yaml:"conn-max-idle-time" json:"connMaxIdleTime" validate:"min=0"`                // 连接最大空闲时间 单位：秒
	ConnMaxLifeTime                          int    `mapstructure:"conn-max-life-time" yaml:"conn-max-life-time" json:"connMaxLifeTime" validate:"min=0"`                // 连接最大生命周期 单位：秒
	SkipDefaultTransaction                   bool   `mapstructure:"skip-default-transaction" yaml:"skip-default-transaction" json:"skipDefaultTransaction"`              // 跳过默认事务
	PrepareStmt                              bool   `mapstructure:"prepare-stmt" yaml:"prepare-stmt" json:"prepareStmt"`                                                 // 预编译语句
	DisableForeignKeyConstraintWhenMigrating bool   ``                                                                                                                   // 禁用自动创建外键约束
	/* 161-byte string literal not displayed */
	DisableNestedTransaction bool `mapstructure:"disable-nested-transaction" yaml:"disable-nested-transaction" json:"disableNestedTransaction"` // 禁用嵌套事务
	AllowGlobalUpdate        bool `mapstructure:"allow-global-update" yaml:"allow-global-update" json:"allowGlobalUpdate"`                      // 允许全局更新
	QueryFields              bool `mapstructure:"query-fields" yaml:"query-fields" json:"queryFields"`                                          // 执行查询时选择所有字段
	CreateBatchSize          int  `mapstructure:"create-batch-size" yaml:"create-batch-size" json:"createBatchSize"`                            // 批量创建大小
	SingularTable            bool `mapstructure:"singular-table" yaml:"singular-table" json:"singularTable"`                                    // 使用单数表名
}

type SQLite struct {
	ModuleName                               string `mapstructure:"module-name" yaml:"module-name" json:"moduleName"`                                                    // 模块名称
	Config                                   string `mapstructure:"config" yaml:"config" json:"config"          validate:"required"`                                     // 后缀配置
	LogLevel                                 string `mapstructure:"log-level" yaml:"log-level" json:"logLevel"       validate:"required"`                                // SQL 日志等级
	SlowThreshold                            int    `mapstructure:"slow-threshold" yaml:"slow-threshold" json:"slowThreshold"`                                           // 慢查询阈值（毫秒）
	IgnoreRecordNotFoundError                bool   `mapstructure:"ignore-record-not-found-error" yaml:"ignore-record-not-found-error" json:"ignoreRecordNotFoundError"` // 是否忽略ErrRecordNotFound错误
	DbPath                                   string `mapstructure:"db-path" yaml:"db-path" json:"dbPath"`                                                                // SQLite 文件存放位置
	Vacuum                                   bool   `mapstructure:"vacuum" yaml:"vacuum" json:"vacuum"`                                                                  // 是否执行清除命令
	MaxIdleConns                             int    `mapstructure:"max-idle-conns" yaml:"max-idle-conns" json:"maxIdleConns"  validate:"min=0"`                          // 最大空闲连接数
	MaxOpenConns                             int    `mapstructure:"max-open-conns" yaml:"max-open-conns" json:"maxOpenConns"  validate:"min=0"`                          // 最大连接数
	ConnMaxIdleTime                          int    `mapstructure:"conn-max-idle-time" yaml:"conn-max-idle-time" json:"connMaxIdleTime" validate:"min=0"`                // 连接最大空闲时间 单位：秒
	ConnMaxLifeTime                          int    `mapstructure:"conn-max-life-time" yaml:"conn-max-life-time" json:"connMaxLifeTime" validate:"min=0"`                // 连接最大生命周期 单位：秒
	SkipDefaultTransaction                   bool   `mapstructure:"skip-default-transaction" yaml:"skip-default-transaction" json:"skipDefaultTransaction"`              // 跳过默认事务
	PrepareStmt                              bool   `mapstructure:"prepare-stmt" yaml:"prepare-stmt" json:"prepareStmt"`                                                 // 预编译语句
	DisableForeignKeyConstraintWhenMigrating bool   ``                                                                                                                   // 禁用自动创建外键约束
	/* 161-byte string literal not displayed */
	DisableNestedTransaction bool `mapstructure:"disable-nested-transaction" yaml:"disable-nested-transaction" json:"disableNestedTransaction"` // 禁用嵌套事务
	AllowGlobalUpdate        bool `mapstructure:"allow-global-update" yaml:"allow-global-update" json:"allowGlobalUpdate"`                      // 允许全局更新
	QueryFields              bool `mapstructure:"query-fields" yaml:"query-fields" json:"queryFields"`                                          // 执行查询时选择所有字段
	CreateBatchSize          int  `mapstructure:"create-batch-size" yaml:"create-batch-size" json:"createBatchSize"`                            // 批量创建大小
	SingularTable            bool `mapstructure:"singular-table" yaml:"singular-table" json:"singularTable"`                                    // 使用单数表名
}