kknongchang_2506/app/Module/OpenAPI/Contracts/HandlerInterface.php

<?php

namespace App\Module\OpenAPI\Contracts;

use App\Module\OpenAPI\Enums\SCOPE_TYPE;
use Illuminate\Http\JsonResponse;

/**
 * OpenAPI Handler接口
 * 
 * 定义所有业务Handler必须实现的基本方法
 */
interface HandlerInterface
{
    /**
     * 处理请求
     *
     * @param array $data 请求数据
     * @param array $context 上下文信息（如用户信息、应用信息等）
     * @return JsonResponse
     */
    public function handle(array $data, array $context = []): JsonResponse;

    /**
     * 验证权限
     *
     * @param array $scopes 应用权限范围
     * @param array $context 上下文信息
     * @return bool
     */
    public function validatePermissions(array $scopes, array $context = []): bool;

    /**
     * 获取所需的权限范围
     *
     * @return SCOPE_TYPE[]
     */
    public function getRequiredScopes(): array;
}