kknongchang_2506/app/Module/Point/AdminControllers/Helper/FormHelperTrait.php

<?php

namespace App\Module\Point\AdminControllers\Helper;

use App\Module\Point\Enums\LOG_TYPE;
use App\Module\Point\Enums\POINT_TYPE;

/**
 * 表单辅助特性
 *
 * 提供积分模块后台控制器的表单构建功能的具体实现
 */
trait FormHelperTrait
{
    /**
     * 添加积分类型选择字段
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @param bool $required 是否必填
     * @return void
     */
    public function selectPointId(string $field = 'point_id', string $label = '积分类型', bool $required = true): void
    {
        $select = $this->form->select($field, $label)->options([
            1 => '经验积分',
            2 => '成就积分',
            3 => '活动积分',
            4 => '签到积分',
            5 => '推荐积分',
        ]);
        
        if ($required) {
            $select->required();
        }
    }

    /**
     * 添加操作类型选择字段
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @param bool $required 是否必填
     * @return void
     */
    public function selectOperateType(string $field = 'operate_type', string $label = '操作类型', bool $required = true): void
    {
        $select = $this->form->select($field, $label)->options(LOG_TYPE::getAllTypes());
        
        if ($required) {
            $select->required();
        }
    }

    /**
     * 添加积分数量输入字段
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @param bool $required 是否必填
     * @param int $min 最小值
     * @return void
     */
    public function numberAmount(string $field = 'amount', string $label = '积分数量', bool $required = true, int $min = 0): void
    {
        $number = $this->form->number($field, $label)->min($min);
        
        if ($required) {
            $number->required();
        }
    }

    /**
     * 添加积分余额输入字段
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @param bool $required 是否必填
     * @param int $min 最小值
     * @return void
     */
    public function numberBalance(string $field = 'balance', string $label = '积分余额', bool $required = true, int $min = 0): void
    {
        $number = $this->form->number($field, $label)->min($min);
        
        if ($required) {
            $number->required();
        }
    }

    /**
     * 添加用户ID输入字段
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @param bool $required 是否必填
     * @return void
     */
    public function numberUserId(string $field = 'user_id', string $label = '用户ID', bool $required = true): void
    {
        $number = $this->form->number($field, $label)->min(1);
        
        if ($required) {
            $number->required();
        }
    }

    /**
     * 添加状态选择字段
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @param bool $required 是否必填
     * @return void
     */
    public function selectStatus(string $field = 'status', string $label = '状态', bool $required = true): void
    {
        $select = $this->form->select($field, $label)->options([
            0 => '待处理',
            1 => '已完成',
            2 => '已失败',
        ]);
        
        if ($required) {
            $select->required();
        }
    }

    /**
     * 添加订单类型选择字段
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @param bool $required 是否必填
     * @return void
     */
    public function selectOrderType(string $field = 'order_type', string $label = '订单类型', bool $required = true): void
    {
        $select = $this->form->select($field, $label)->options([
            'exchange' => '积分兑换',
            'consume' => '积分消费',
            'reward' => '积分奖励',
            'refund' => '积分退款',
        ]);
        
        if ($required) {
            $select->required();
        }
    }

    /**
     * 添加备注文本域字段
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @param bool $required 是否必填
     * @param int $rows 行数
     * @return void
     */
    public function textareaRemark(string $field = 'remark', string $label = '备注', bool $required = false, int $rows = 3): void
    {
        $textarea = $this->form->textarea($field, $label)->rows($rows);
        
        if ($required) {
            $textarea->required();
        }
    }

    /**
     * 添加操作ID输入字段
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @param bool $required 是否必填
     * @return void
     */
    public function textOperateId(string $field = 'operate_id', string $label = '操作ID', bool $required = true): void
    {
        $text = $this->form->text($field, $label);
        
        if ($required) {
            $text->required();
        }
    }

    /**
     * 添加订单号输入字段
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @param bool $required 是否必填
     * @return void
     */
    public function textOrderNo(string $field = 'order_no', string $label = '订单号', bool $required = true): void
    {
        $text = $this->form->text($field, $label);
        
        if ($required) {
            $text->required();
        }
    }

    /**
     * 添加标题输入字段
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @param bool $required 是否必填
     * @return void
     */
    public function textTitle(string $field = 'title', string $label = '标题', bool $required = true): void
    {
        $text = $this->form->text($field, $label);
        
        if ($required) {
            $text->required();
        }
    }

    /**
     * 添加描述文本域字段
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @param bool $required 是否必填
     * @param int $rows 行数
     * @return void
     */
    public function textareaDescription(string $field = 'description', string $label = '描述', bool $required = false, int $rows = 4): void
    {
        $textarea = $this->form->textarea($field, $label)->rows($rows);
        
        if ($required) {
            $textarea->required();
        }
    }

    /**
     * 添加JSON数据文本域字段
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @param bool $required 是否必填
     * @param int $rows 行数
     * @return void
     */
    public function textareaJson(string $field, string $label, bool $required = false, int $rows = 5): void
    {
        $textarea = $this->form->textarea($field, $label)->rows($rows);
        
        if ($required) {
            $textarea->required();
        }
    }

    /**
     * 添加时间戳隐藏字段处理
     *
     * @return void
     */
    public function hiddenTimestamps(): void
    {
        $this->form->hidden('create_time');
        $this->form->hidden('update_time');
    }
}