// ==========================================================================
// 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"
)

// V1SysUserPaymentDao is the data access object for the table sys_user_payment.
type V1SysUserPaymentDao 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  V1SysUserPaymentColumns // columns contains all the column names of Table for convenient usage.
	handlers []gdb.ModelHandler      // handlers for customized model modification.
}

// V1SysUserPaymentColumns defines and stores column names for the table sys_user_payment.
type V1SysUserPaymentColumns struct {
	Id                    string //
	UserId                string //
	Balance               string // 余额
	TotalDeposits         string // 总充值金额
	TotalConsumption      string // 总消耗金额
	LastDepositTime       string //
	LastConsumptionTime   string // 上次消耗时间
	TotalDepositCount     string // 总充值次数
	TotalConsumptionCount string // 总消耗次数
	Status                string // 0.禁用 1.正常 3.关闭
	Notes                 string // 备注
	CreatedAt             string //
	UpdatedAt             string //
	DeletedAt             string //
}

// v1SysUserPaymentColumns holds the columns for the table sys_user_payment.
var v1SysUserPaymentColumns = V1SysUserPaymentColumns{
	Id:                    "id",
	UserId:                "user_id",
	Balance:               "balance",
	TotalDeposits:         "total_deposits",
	TotalConsumption:      "total_consumption",
	LastDepositTime:       "last_deposit_time",
	LastConsumptionTime:   "last_consumption_time",
	TotalDepositCount:     "total_deposit_count",
	TotalConsumptionCount: "total_consumption_count",
	Status:                "status",
	Notes:                 "notes",
	CreatedAt:             "created_at",
	UpdatedAt:             "updated_at",
	DeletedAt:             "deleted_at",
}

// NewV1SysUserPaymentDao creates and returns a new DAO object for table data access.
func NewV1SysUserPaymentDao(handlers ...gdb.ModelHandler) *V1SysUserPaymentDao {
	return &V1SysUserPaymentDao{
		group:    "default",
		table:    "sys_user_payment",
		columns:  v1SysUserPaymentColumns,
		handlers: handlers,
	}
}

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

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

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

// Group returns the database configuration group name of the current DAO.
func (dao *V1SysUserPaymentDao) 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 *V1SysUserPaymentDao) 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 *V1SysUserPaymentDao) Transaction(ctx context.Context, f func(ctx context.Context, tx gdb.TX) error) (err error) {
	return dao.Ctx(ctx).Transaction(ctx, f)
}
