kknongchang_2506/app/Module/Mex/AdminControllers/MexAdminToolController.php

<?php

namespace App\Module\Mex\AdminControllers;

use App\Module\Mex\Forms\InjectItemForm;
use App\Module\Mex\Forms\RecycleItemForm;
use App\Module\Mex\Forms\InitializeWarehouseForm;
use Spatie\RouteAttributes\Attributes\Get;
use UCore\DcatAdmin\AdminController;
use Dcat\Admin\Layout\Content;
use Dcat\Admin\Widgets\Card;

/**
 * 农贸市场管理员工具
 *
 * 提供物品注入、回收等管理员操作功能
 *
 * @menu 游戏运营管理/农贸市场管理/🛠 管理工具
 */
class MexAdminToolController extends AdminController
{
    /**
     * 页面标题
     *
     * @var string
     */
    protected $title = '农贸市场管理工具';

    /**
     * 工具页面
     */
    #[Get('mex-admin-tools', name: 'dcat.admin.mex-admin-tools.index')]
    public function index(Content $content)
    {
        return $content
            ->title($this->title)
            ->description('管理员操作工具')
            ->body($this->buildToolsPage());
    }

    /**
     * 物品注入页面
     */
    #[Get('mex-admin-tools/inject', name: 'dcat.admin.mex-admin-tools.inject')]
    public function inject(Content $content)
    {
        return $content
            ->title('物品注入')
            ->description('向市场注入物品，增加供应量')
            ->body(new Card(new InjectItemForm()));
    }

    /**
     * 物品回收页面
     */
    #[Get('mex-admin-tools/recycle', name: 'dcat.admin.mex-admin-tools.recycle')]
    public function recycle(Content $content)
    {
        return $content
            ->title('物品回收')
            ->description('从市场回收物品，减少供应量')
            ->body(new Card(new RecycleItemForm()));
    }

    /**
     * 初始化库存页面
     */
    #[Get('mex-admin-tools/initialize', name: 'dcat.admin.mex-admin-tools.initialize')]
    public function initialize(Content $content)
    {
        return $content
            ->title('初始化库存')
            ->description('为所有已定价的商品创建库存记录')
            ->body(new Card(new InitializeWarehouseForm()));
    }







    /**
     * 构建工具页面
     */
    private function buildToolsPage()
    {
        $card = new Card('农贸市场管理工具', '
            <div class="row">
                <div class="col-md-4">
                    <div class="card">
                        <div class="card-body text-center">
                            <i class="fa fa-plus-circle fa-3x text-success mb-3"></i>
                            <h5>物品注入</h5>
                            <p class="text-muted">向市场投放商品，增加供应量</p>
                            <a href="' . route('dcat.admin.mex-admin-tools.inject') . '" class="btn btn-success">
                                <i class="fa fa-plus"></i> 开始注入
                            </a>
                        </div>
                    </div>
                </div>
                <div class="col-md-4">
                    <div class="card">
                        <div class="card-body text-center">
                            <i class="fa fa-minus-circle fa-3x text-warning mb-3"></i>
                            <h5>物品回收</h5>
                            <p class="text-muted">从市场回收商品，减少供应量</p>
                            <a href="' . route('dcat.admin.mex-admin-tools.recycle') . '" class="btn btn-warning">
                                <i class="fa fa-minus"></i> 开始回收
                            </a>
                        </div>
                    </div>
                </div>
                <div class="col-md-4">
                    <div class="card">
                        <div class="card-body text-center">
                            <i class="fa fa-database fa-3x text-info mb-3"></i>
                            <h5>初始化库存</h5>
                            <p class="text-muted">为已定价商品创建库存记录</p>
                            <a href="' . route('dcat.admin.mex-admin-tools.initialize') . '" class="btn btn-info">
                                <i class="fa fa-database"></i> 开始初始化
                            </a>
                        </div>
                    </div>
                </div>
            </div>
            
            <div class="row mt-4">
                <div class="col-md-12">
                    <div class="alert alert-info">
                        <h6><i class="fa fa-info-circle"></i> 使用说明</h6>
                        <ul class="mb-0">
                            <li><strong>物品注入</strong>：相当于系统向仓库"卖出"物品，增加仓库库存，系统获得资金</li>
                            <li><strong>物品回收</strong>：相当于系统从仓库"买入"物品，减少仓库库存，系统支出资金</li>
                            <li>所有操作都会记录在管理员操作记录中，并生成对应的成交记录</li>
                            <li>操作前请确认商品ID、数量和价格的准确性</li>
                        </ul>
                    </div>
                </div>
            </div>
        ');

        return $card;
    }




}