// ==========================================================================
// Code generated and maintained by GoFrame CLI tool. DO NOT EDIT.
// ==========================================================================

package internal

import (
	"context"

	"github.com/gogf/gf/v2/database/gdb"
	"github.com/gogf/gf/v2/frame/g"
)

// StoreAdminsDao is the data access object for the table store_admins.
type StoreAdminsDao struct {
	table    string             // table is the underlying table name of the DAO.
	group    string             // group is the database configuration group name of the current DAO.
	columns  StoreAdminsColumns // columns contains all the column names of Table for convenient usage.
	handlers []gdb.ModelHandler // handlers for customized model modification.
}

// StoreAdminsColumns defines and stores column names for the table store_admins.
type StoreAdminsColumns struct {
	Id           string // 门店管理员ID
	StoreId      string // 所属门店ID
	Username     string // 用户名
	PasswordHash string // 密码哈希
	RealName     string // 真实姓名
	Phone        string // 手机号
	Email        string // 邮箱
	IsPrimary    string // 是否为主账号（1=是，0=否）
	Status       string // 状态：1=正常，2=禁用
	LastLoginAt  string // 最后登录时间
	CreatedAt    string // 创建时间
	UpdatedAt    string // 更新时间
	DeletedAt    string // 软删除时间戳
	RoleId       string // 角色ID
	StoreRoleId  string // 门店角色ID
}

// storeAdminsColumns holds the columns for the table store_admins.
var storeAdminsColumns = StoreAdminsColumns{
	Id:           "id",
	StoreId:      "store_id",
	Username:     "username",
	PasswordHash: "password_hash",
	RealName:     "real_name",
	Phone:        "phone",
	Email:        "email",
	IsPrimary:    "is_primary",
	Status:       "status",
	LastLoginAt:  "last_login_at",
	CreatedAt:    "created_at",
	UpdatedAt:    "updated_at",
	DeletedAt:    "deleted_at",
	RoleId:       "role_id",
	StoreRoleId:  "store_role_id",
}

// NewStoreAdminsDao creates and returns a new DAO object for table data access.
func NewStoreAdminsDao(handlers ...gdb.ModelHandler) *StoreAdminsDao {
	return &StoreAdminsDao{
		group:    "default",
		table:    "store_admins",
		columns:  storeAdminsColumns,
		handlers: handlers,
	}
}

// DB retrieves and returns the underlying raw database management object of the current DAO.
func (dao *StoreAdminsDao) DB() gdb.DB {
	return g.DB(dao.group)
}

// Table returns the table name of the current DAO.
func (dao *StoreAdminsDao) Table() string {
	return dao.table
}

// Columns returns all column names of the current DAO.
func (dao *StoreAdminsDao) Columns() StoreAdminsColumns {
	return dao.columns
}

// Group returns the database configuration group name of the current DAO.
func (dao *StoreAdminsDao) Group() string {
	return dao.group
}

// Ctx creates and returns a Model for the current DAO. It automatically sets the context for the current operation.
func (dao *StoreAdminsDao) Ctx(ctx context.Context) *gdb.Model {
	model := dao.DB().Model(dao.table)
	for _, handler := range dao.handlers {
		model = handler(model)
	}
	return model.Safe().Ctx(ctx)
}

// Transaction wraps the transaction logic using function f.
// It rolls back the transaction and returns the error if function f returns a non-nil error.
// It commits the transaction and returns nil if function f returns nil.
//
// Note: Do not commit or roll back the transaction in function f,
// as it is automatically handled by this function.
func (dao *StoreAdminsDao) Transaction(ctx context.Context, f func(ctx context.Context, tx gdb.TX) error) (err error) {
	return dao.Ctx(ctx).Transaction(ctx, f)
}