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

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

// TasksColumns defines and stores column names for the table tasks.
type TasksColumns struct {
	Id                 string // 任务唯一标识符
	CreatedAt          string // 创建时间
	UpdatedAt          string // 更新时间
	DeletedAt          string // 软删除时间戳
	GameId             string // 游戏唯一id
	StoreId            string // 门店 id
	Status             string // 1：启用 2：禁用
	QqNetbarTaskId     string // QQ网吧任务ID
	QqNetbarTaskRules  string // 任务规则
	QqNetbarTaskMemo   string // 任务描述
	QqNetbarTaskName   string // QQ网吧任务名称
	QqNetbarReward     string // qq 网吧奖励名称
	QqNetbarTargetTime string // qq 网吧任务指标
	StartTime          string // 任务开始时间
	EndTime            string // 任务结束时间
}

// tasksColumns holds the columns for the table tasks.
var tasksColumns = TasksColumns{
	Id:                 "id",
	CreatedAt:          "created_at",
	UpdatedAt:          "updated_at",
	DeletedAt:          "deleted_at",
	GameId:             "game_id",
	StoreId:            "store_id",
	Status:             "status",
	QqNetbarTaskId:     "qq_netbar_task_id",
	QqNetbarTaskRules:  "qq_netbar_task_rules",
	QqNetbarTaskMemo:   "qq_netbar_task_memo",
	QqNetbarTaskName:   "qq_netbar_task_name",
	QqNetbarReward:     "qq_netbar_reward",
	QqNetbarTargetTime: "qq_netbar_target_time",
	StartTime:          "start_time",
	EndTime:            "end_time",
}

// NewTasksDao creates and returns a new DAO object for table data access.
func NewTasksDao(handlers ...gdb.ModelHandler) *TasksDao {
	return &TasksDao{
		group:    "default",
		table:    "tasks",
		columns:  tasksColumns,
		handlers: handlers,
	}
}

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

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

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

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