owl-admin/app/Admin/Controllers/SettingGroupController.php

<?php

namespace App\Admin\Controllers;

use App\Services\SettingGroupService;
use Slowlyo\OwlAdmin\Controllers\AdminController;

/**
 * @group 后台
 *
 * [后台]设置分组管理
 *
 * @property SettingGroupService $service
 */
class SettingGroupController extends AdminController
{
    protected string $serviceName = SettingGroupService::class;

    public function list()
    {
        $crud = $this->baseCRUD()
            ->filterTogglable(false)
            ->headerToolbar([
                $this->createButton('dialog'),
                ...$this->baseHeaderToolBar(),
            ])
            ->columns([
                amis()->TableColumn('id', 'ID')->sortable(),
                amis()->TableColumn('code', 'Code'),
                amis()->TableColumn('name', 'Name'),
                amis()->TableColumn('description', 'Description'),
                amis()->TableColumn('sort', 'Sort')->sortable(),
                amis()->TableColumn('created_at', admin_trans('admin.created_at'))->type('datetime')->sortable(),
                amis()->TableColumn('updated_at', admin_trans('admin.updated_at'))->type('datetime')->sortable(),
                $this->rowActions('dialog'),
            ]);

        return $this->baseList($crud);
    }

    public function form($isEdit = false)
    {
        return $this->baseForm()->body([
            amis()->TextControl('code', 'Code'),
            amis()->TextControl('name', 'Name'),
            amis()->TextControl('description', 'Description'),
            amis()->TextControl('sort', 'Sort'),
        ]);
    }

    public function detail()
    {
        return $this->baseDetail()->body([
            amis()->TextControl('id', 'ID')->static(),
            amis()->TextControl('code', 'Code')->static(),
            amis()->TextControl('name', 'Name')->static(),
            amis()->TextControl('description', 'Description')->static(),
            amis()->TextControl('sort', 'Sort')->static(),
            amis()->TextControl('created_at', admin_trans('admin.created_at'))->static(),
            amis()->TextControl('updated_at', admin_trans('admin.updated_at'))->static(),
        ]);
    }

    /**
     * [分组]获取设置分组列表
     *
     * @description 获取所有设置分组列表
     *
     * @param string keyword 关键词搜索
     * @param int perPage 每页数量
     *
     * @response {
     *  "data": [
     *    {
     *      "id": 1,
     *      "code": "basic",
     *      "name": "基础设置",
     *      "description": "系统基础配置",
     *      "sort": 0,
     *      "created_at": "2023-01-01 00:00:00",
     *      "updated_at": "2023-01-01 00:00:00"
     *    }
     *  ]
     * }
     */
    public function getList()
    {
        return $this->service->getList(request()->all());
    }

    /**
     * [分组]创建设置分组
     *
     * @description 创建新的设置分组
     *
     * @param string code 分组代码
     * @param string name 分组名称
     * @param string description 分组描述
     * @param int sort 排序值
     *
     * @response {
     *   "code": "basic",
     *   "name": "基础设置",
     *   "description": "系统基础配置",
     *   "sort": 0
     * }
     */
    public function createGroup()
    {
        return $this->response()->success(
            $this->service->createGroup(request()->all())
        );
    }

    /**
     * [分组]更新设置分组
     *
     * @description 更新指定ID的设置分组
     *
     * @param int id 分组ID
     * @param string code 分组代码
     * @param string name 分组名称
     * @param string description 分组描述
     * @param int sort 排序值
     *
     * @response true
     */
    public function updateGroup($id)
    {
        return $this->response()->success(
            $this->service->updateGroup($id, request()->all())
        );
    }

    /**
     * [分组]删除设置分组
     *
     * @description 删除指定ID的设置分组
     *
     * @param int id 分组ID
     *
     * @response true
     */
    public function deleteGroup($id)
    {
        return $this->response()->success(
            $this->service->deleteGroup($id)
        );
    }

    /**
     * [分组]获取设置分组详情
     *
     * @description 获取指定ID的设置分组详情
     *
     * @param int id 分组ID
     *
     * @response {
     *   "id": 1,
     *   "code": "basic",
     *   "name": "基础设置",
     *   "description": "系统基础配置",
     *   "sort": 0,
     *   "created_at": "2023-01-01 00:00:00",
     *   "updated_at": "2023-01-01 00:00:00"
     * }
     */
    public function groupDetail($id)
    {
        return $this->response()->success(
            $this->service->groupDetail($id)
        );
    }
}