Gnuboard7/app/Repositories/PluginRepository.php

<?php

namespace App\Repositories;

use App\Contracts\Repositories\PluginRepositoryInterface;
use App\Enums\DeactivationReason;
use App\Enums\ExtensionStatus;
use App\Models\Plugin;
use Illuminate\Database\Eloquent\Collection;

class PluginRepository implements PluginRepositoryInterface
{
    /**
     * 모든 플러그인을 조회합니다.
     *
     * @return Collection 플러그인 컬렉션
     */
    public function getAll(): Collection
    {
        return Plugin::all();
    }

    /**
     * 이름으로 플러그인을 찾습니다.
     *
     * @param  string  $name  찾을 플러그인 이름
     * @return Plugin|null 찾은 플러그인 모델 또는 null
     */
    public function findByName(string $name): ?Plugin
    {
        return Plugin::where('name', $name)->first();
    }

    /**
     * 활성화된 플러그인들을 조회합니다.
     *
     * @return Collection 활성화된 플러그인 컬렉션
     */
    public function getActive(): Collection
    {
        return Plugin::where('status', ExtensionStatus::Active->value)->get();
    }

    /**
     * 새로운 플러그인을 생성합니다.
     *
     * @param  array  $data  플러그인 생성 데이터
     * @return Plugin 생성된 플러그인 모델
     */
    public function create(array $data): Plugin
    {
        return Plugin::create($data);
    }

    /**
     * 기존 플러그인을 업데이트합니다.
     *
     * @param  Plugin  $plugin  업데이트할 플러그인 모델
     * @param  array  $data  업데이트할 데이터
     * @return bool 업데이트 성공 여부
     */
    public function update(Plugin $plugin, array $data): bool
    {
        return $plugin->update($data);
    }

    /**
     * 플러그인을 삭제합니다.
     *
     * @param  Plugin  $plugin  삭제할 플러그인 모델
     * @return bool 삭제 성공 여부
     */
    public function delete(Plugin $plugin): bool
    {
        return $plugin->delete();
    }

    /**
     * 플러그인을 활성화합니다.
     *
     * @param  Plugin  $plugin  활성화할 플러그인 모델
     * @return bool 활성화 성공 여부
     */
    public function activate(Plugin $plugin): bool
    {
        return $plugin->update(['status' => ExtensionStatus::Active->value]);
    }

    /**
     * 플러그인을 비활성화합니다.
     *
     * @param  Plugin  $plugin  비활성화할 플러그인 모델
     * @return bool 비활성화 성공 여부
     */
    public function deactivate(Plugin $plugin): bool
    {
        return $plugin->update(['status' => ExtensionStatus::Inactive->value]);
    }

    /**
     * 플러그인의 설치 상태를 업데이트합니다.
     *
     * @param  Plugin  $plugin  대상 플러그인 모델
     * @param  bool  $installed  설치 상태 (기본값: true)
     * @return bool 업데이트 성공 여부
     */
    public function setInstalled(Plugin $plugin, bool $installed = true): bool
    {
        $status = $installed ? ExtensionStatus::Inactive->value : ExtensionStatus::Installing->value;

        return $plugin->update(['status' => $status]);
    }

    /**
     * 식별자로 플러그인을 찾습니다.
     *
     * @param  string  $identifier  플러그인 식별자
     * @return Plugin|null 찾은 플러그인 모델 또는 null
     */
    public function findByIdentifier(string $identifier): ?Plugin
    {
        return Plugin::where('identifier', $identifier)->first();
    }

    /**
     * 식별자로 활성화된 플러그인을 찾습니다.
     *
     * @param  string  $identifier  플러그인 식별자
     * @return Plugin|null 찾은 플러그인 모델 또는 null
     */
    public function findActiveByIdentifier(string $identifier): ?Plugin
    {
        return Plugin::where('identifier', $identifier)
            ->where('status', ExtensionStatus::Active->value)
            ->first();
    }

    /**
     * 활성화된 플러그인들의 identifier 목록을 반환합니다.
     *
     * @return array 활성화된 플러그인 identifier 배열
     */
    public function getActivePluginIdentifiers(): array
    {
        return Plugin::where('status', ExtensionStatus::Active->value)
            ->pluck('identifier')
            ->toArray();
    }

    /**
     * 플러그인을 생성하거나 업데이트합니다.
     *
     * @param  array  $attributes  조회 조건
     * @param  array  $values  생성/업데이트할 데이터
     * @return Plugin 생성 또는 업데이트된 플러그인 모델
     */
    public function updateOrCreate(array $attributes, array $values): Plugin
    {
        return Plugin::updateOrCreate($attributes, $values);
    }

    /**
     * 식별자로 플러그인 상태를 업데이트합니다.
     *
     * @param  string  $identifier  플러그인 식별자
     * @param  array  $data  업데이트할 데이터
     * @return int 업데이트된 레코드 수
     */
    public function updateByIdentifier(string $identifier, array $data): int
    {
        return Plugin::where('identifier', $identifier)->update($data);
    }

    /**
     * 식별자로 플러그인을 삭제합니다.
     *
     * @param  string  $identifier  플러그인 식별자
     * @return int 삭제된 레코드 수
     */
    public function deleteByIdentifier(string $identifier): int
    {
        return Plugin::where('identifier', $identifier)->delete();
    }

    /**
     * 모든 플러그인을 identifier로 키잉하여 조회합니다.
     *
     * @return Collection identifier를 키로 하는 플러그인 컬렉션
     */
    public function getAllKeyedByIdentifier(): Collection
    {
        return Plugin::all()->keyBy('identifier');
    }

    /**
     * 설치된 모든 플러그인의 identifier 목록을 조회합니다.
     *
     * @return array 설치된 플러그인 identifier 배열
     */
    public function getInstalledIdentifiers(): array
    {
        return Plugin::pluck('identifier')->toArray();
    }

    /**
     * 특정 모듈에 의존하는 활성 플러그인을 조회합니다.
     *
     * PluginManager를 통해 각 플러그인의 getDependencies()를 확인하여
     * 해당 모듈에 의존하는 플러그인만 필터링합니다.
     *
     * @param  string  $moduleIdentifier  의존 대상 모듈 식별자
     * @return Collection 해당 모듈에 의존하는 활성 플러그인 컬렉션
     */
    public function findActiveByModuleDependency(string $moduleIdentifier): Collection
    {
        // 활성화된 모든 플러그인 조회
        $activePlugins = Plugin::where('status', ExtensionStatus::Active->value)->get();

        if ($activePlugins->isEmpty()) {
            return new Collection();
        }

        // PluginManager를 통해 각 플러그인의 모듈 의존성 확인
        $pluginManager = app(\App\Contracts\Extension\PluginManagerInterface::class);

        return $activePlugins->filter(function (Plugin $plugin) use ($pluginManager, $moduleIdentifier) {
            $pluginInstance = $pluginManager->getPlugin($plugin->identifier);

            if (! $pluginInstance) {
                return false;
            }

            // getModuleDependencies 메서드가 있는지 확인
            if (! method_exists($pluginInstance, 'getModuleDependencies')) {
                return false;
            }

            $moduleDependencies = $pluginInstance->getModuleDependencies();

            // 해당 모듈이 의존성에 포함되어 있는지 확인
            return in_array($moduleIdentifier, $moduleDependencies);
        })->values();
    }

    /**
     * 특정 플러그인에 의존하는 활성 플러그인을 조회합니다.
     *
     * PluginManager를 통해 각 플러그인의 getDependencies()를 확인하여
     * 해당 플러그인에 의존하는 플러그인만 필터링합니다.
     *
     * @param  string  $pluginIdentifier  의존 대상 플러그인 식별자
     * @return Collection 해당 플러그인에 의존하는 활성 플러그인 컬렉션
     */
    public function findActiveByPluginDependency(string $pluginIdentifier): Collection
    {
        // 활성화된 모든 플러그인 조회
        $activePlugins = Plugin::where('status', ExtensionStatus::Active->value)->get();

        if ($activePlugins->isEmpty()) {
            return new Collection();
        }

        // PluginManager를 통해 각 플러그인의 플러그인 의존성 확인
        $pluginManager = app(\App\Contracts\Extension\PluginManagerInterface::class);

        return $activePlugins->filter(function (Plugin $plugin) use ($pluginManager, $pluginIdentifier) {
            $pluginInstance = $pluginManager->getPlugin($plugin->identifier);

            if (! $pluginInstance) {
                return false;
            }

            $dependencies = $pluginInstance->getDependencies();

            // 해당 플러그인이 의존성에 포함되어 있는지 확인
            return in_array($pluginIdentifier, $dependencies);
        })->values();
    }

    /**
     * 코어 버전 비호환으로 자동 비활성화된 플러그인을 조회합니다.
     *
     * @return Collection 자동 비활성화된 플러그인 컬렉션
     */
    public function findAutoDeactivated(): Collection
    {
        // 마이그레이션이 아직 적용되지 않은 부팅 단계(예: migrate 직전 boot)에서는
        // 컬럼 부재로 SQLSTATE 42S22 가 발생하므로 정적으로 가드한다.
        if (! \Illuminate\Support\Facades\Schema::hasColumn('plugins', 'deactivated_reason')) {
            return new Collection;
        }

        return Plugin::where('status', ExtensionStatus::Inactive->value)
            ->where('deactivated_reason', DeactivationReason::IncompatibleCore->value)
            ->orderByDesc('deactivated_at')
            ->get();
    }
}