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

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

// V1SysUserPaymentRecordsColumns defines and stores column names for the table sys_user_payment_records.
type V1SysUserPaymentRecordsColumns struct {
	Id              string // 主键
	TransactionId   string // 交易唯一ID
	PaymentId       string // 钱包ID
	DeductionId     string // 预扣款ID
	UserId          string //
	Amount          string // 操作金额
	TransactionType string // 交易类型 1deposit 2.withdrawal
	OrderNo         string // 订单号
	Status          string // 交易状态：0.失败 1.成功
	Category        string //
	Notes           string // 备注
	CreatedAt       string //
	DeletedAt       string //
	UpdatedAt       string //
}

// v1SysUserPaymentRecordsColumns holds the columns for the table sys_user_payment_records.
var v1SysUserPaymentRecordsColumns = V1SysUserPaymentRecordsColumns{
	Id:              "id",
	TransactionId:   "transaction_id",
	PaymentId:       "payment_id",
	DeductionId:     "deduction_id",
	UserId:          "user_id",
	Amount:          "amount",
	TransactionType: "transaction_type",
	OrderNo:         "order_no",
	Status:          "status",
	Category:        "category",
	Notes:           "notes",
	CreatedAt:       "created_at",
	DeletedAt:       "deleted_at",
	UpdatedAt:       "updated_at",
}

// NewV1SysUserPaymentRecordsDao creates and returns a new DAO object for table data access.
func NewV1SysUserPaymentRecordsDao(handlers ...gdb.ModelHandler) *V1SysUserPaymentRecordsDao {
	return &V1SysUserPaymentRecordsDao{
		group:    "default",
		table:    "sys_user_payment_records",
		columns:  v1SysUserPaymentRecordsColumns,
		handlers: handlers,
	}
}

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

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

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

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