kknongchang_2506/app/Module/UrsPromotion/AdminControllers/UrsUserReferralController.php

<?php

namespace App\Module\UrsPromotion\AdminControllers;

use UCore\DcatAdmin\AdminController;
use App\Module\UrsPromotion\Models\UrsUserReferral;
use App\Module\UrsPromotion\Repositorys\UrsUserReferralRepository;
use App\Module\UrsPromotion\AdminControllers\Helper\UrsUserReferralGridHelper;
use App\Module\UrsPromotion\AdminControllers\Helper\UrsUserReferralShowHelper;
use App\Module\UrsPromotion\AdminControllers\Helper\UrsUserReferralFormHelper;
use App\Module\UrsPromotion\AdminControllers\Helper\UrsUserReferralFilterHelper;
use Dcat\Admin\Grid;
use Dcat\Admin\Show;
use Dcat\Admin\Form;

/**
 * URS用户推荐关系管理控制器
 * 
 * @route /admin/urs-promotion/user-referrals
 */
class UrsUserReferralController extends AdminController
{
    /**
     * 页面标题
     */
    protected $title = 'URS用户推荐关系';

    /**
     * 模型类
     */
    protected $model = UrsUserReferral::class;

    /**
     * 仓库类
     */
    protected $repository = UrsUserReferralRepository::class;

    /**
     * 列表页面
     */
    protected function grid(): Grid
    {
        return UrsUserReferralGridHelper::make($this->repository(), function (Grid $grid) {
            $grid->column('id', 'ID')->sortable();
            $grid->column('user_id', '用户ID')->sortable();
            $grid->column('referrer_id', '推荐人ID')->sortable();
            $grid->column('referral_code', '推荐码');
            $grid->column('referral_time', '推荐时间')->sortable();
            $grid->column('status', '状态')->using([
                UrsUserReferral::STATUS_INVALID => '无效',
                UrsUserReferral::STATUS_VALID => '有效',
            ])->label([
                UrsUserReferral::STATUS_INVALID => 'danger',
                UrsUserReferral::STATUS_VALID => 'success',
            ]);
            $grid->column('created_at', '创建时间')->sortable();

            // 禁用创建按钮（推荐关系由系统自动创建）
            $grid->disableCreateButton();
            
            // 禁用编辑（推荐关系不允许修改）
            $grid->disableActions();
            
            // 只允许查看详情
            $grid->actions(function (Grid\Displayers\Actions $actions) {
                $actions->disableEdit();
                $actions->disableDelete();
            });

            $grid->filter(function (Grid\Filter $filter) {
                UrsUserReferralFilterHelper::make($filter);
            });
        });
    }

    /**
     * 详情页面
     */
    protected function detail($id): Show
    {
        return UrsUserReferralShowHelper::make($this->repository(), $id, function (Show $show) {
            $show->field('id', 'ID');
            $show->field('user_id', '用户ID');
            $show->field('referrer_id', '推荐人ID');
            $show->field('referral_code', '推荐码');
            $show->field('referral_time', '推荐时间');
            $show->field('status', '状态')->using([
                UrsUserReferral::STATUS_INVALID => '无效',
                UrsUserReferral::STATUS_VALID => '有效',
            ]);
            $show->field('created_at', '创建时间');
            $show->field('updated_at', '更新时间');
        });
    }

    /**
     * 表单页面（禁用）
     */
    protected function form(): Form
    {
        return UrsUserReferralFormHelper::make($this->repository(), function (Form $form) {
            // 推荐关系由系统自动创建，不提供手动创建表单
            $form->display('message', '提示')->default('推荐关系由系统自动创建，不支持手动添加或编辑');
        });
    }
}