datasource

type Config struct {
	// Driver 选择已注册的关系数据库驱动。
	Driver Driver
	// DSN 允许高级场景直接提供驱动连接串（SQLite 为文件路径）；禁止写入日志。
	DSN string
	// UserName 是数据库用户名。
	UserName string
	// Password 是数据库密码，禁止写入日志。
	Password string
	// Host 是数据库主机名或 IP。
	Host string
	// Port 是数据库监听端口。
	Port int
	// Database 是数据库名、Schema 服务名或驱动定义的逻辑数据库。
	Database string
	// SSLMode 是 PostgreSQL SSL 模式；其他驱动可以忽略。
	SSLMode string
	// Charset 是 MySQL 字符集，默认 utf8mb4。
	Charset string
	// TimeZone 是数据库会话时区，默认 Asia/Shanghai。
	TimeZone string
	// MaxIdleConns 是最大空闲连接数。
	MaxIdleConns int
	// MaxOpenConns 是最大打开连接数。
	MaxOpenConns int
	// ConnMaxLifetime 是连接最大复用时间。
	ConnMaxLifetime time.Duration
	// ConnectTimeout 是打开连接和 Ping 的最大时长。
	ConnectTimeout time.Duration
	// AutoMigrate 控制是否自动迁移 Model，默认关闭。
	AutoMigrate bool
}

type DialectorFactory func(config Config) (gorm.Dialector, error)

type Driver string

type Instance struct {
	// contains filtered or unexported fields
}

type Migration struct {
	// Name 是迁移名称（如 "20260815_create_orders"），重复名称会被拒绝。
	Name string
	// Up 执行迁移内容。
	Up func(db *gorm.DB) error
	// Down 回滚迁移内容；为 nil 时该迁移不可回滚。
	Down func(db *gorm.DB) error
}

type Migrator struct {
	// contains filtered or unexported fields
}

type PageResult struct {
	Total      int64 // 符合条件的总记录数
	Page       int   // 当前页（从 1 开始）
	PageSize   int   // 每页大小
	TotalPages int64 // 总页数
}

type PostgresConfig struct {
	// UserName 是数据库用户名。
	UserName string
	// Password 是数据库密码，禁止写入日志。
	Password string
	// Host 是数据库主机名或 IP。
	Host string
	// Port 是 PostgreSQL 监听端口。
	Port int
	// DbName 是目标数据库名称。
	DbName string
	// InitDb 是旧版自动迁移开关。
	// Deprecated: 使用 AutoMigrate。
	InitDb bool
	// AliasName 是旧版连接别名字段，当前仅为源码兼容保留。
	AliasName string
	// SSL 是 PostgreSQL sslmode。
	SSL string
	// MaxIdleConns 是最大空闲连接数，零值使用默认值。
	MaxIdleConns int
	// MaxOpenConns 是最大打开连接数，零值使用默认值。
	MaxOpenConns int
	// ConnMaxLifetime 是连接可复用的最长时间，零值使用默认值。
	ConnMaxLifetime time.Duration
	// ConnectTimeout 是初始化和 Ping 的最大时长，零值使用默认值。
	ConnectTimeout time.Duration
	// AutoMigrate 控制是否在初始化成功后自动迁移 Model，默认关闭。
	AutoMigrate bool
}