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

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

// UserSignInLogsColumns defines and stores column names for the table user_sign_in_logs.
type UserSignInLogsColumns struct {
	Id             string // 主键
	UserId         string // 用户ID，关联 users 表
	RuleId         string // 规则ID，关联 sign_in_reward_rules 表
	RewardDetailId string // 奖励详情ID，关联 sign_in_reward_details 表
	SignInDate     string // 签到日期
	Quantity       string // 奖励数量，如积分数量或礼包数量
	Status         string // 记录状态：1=有效，0=无效
	CreatedAt      string // 创建时间
	UpdatedAt      string // 更新时间
	DeletedAt      string // 软删除时间戳
}

// userSignInLogsColumns holds the columns for the table user_sign_in_logs.
var userSignInLogsColumns = UserSignInLogsColumns{
	Id:             "id",
	UserId:         "user_id",
	RuleId:         "rule_id",
	RewardDetailId: "reward_detail_id",
	SignInDate:     "sign_in_date",
	Quantity:       "quantity",
	Status:         "status",
	CreatedAt:      "created_at",
	UpdatedAt:      "updated_at",
	DeletedAt:      "deleted_at",
}

// NewUserSignInLogsDao creates and returns a new DAO object for table data access.
func NewUserSignInLogsDao(handlers ...gdb.ModelHandler) *UserSignInLogsDao {
	return &UserSignInLogsDao{
		group:    "default",
		table:    "user_sign_in_logs",
		columns:  userSignInLogsColumns,
		handlers: handlers,
	}
}

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

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

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

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