Gnuboard7/app/Extension/Traits/CachesModuleStatus.php

<?php

namespace App\Extension\Traits;

use App\Contracts\Extension\CacheInterface;
use App\Enums\ExtensionStatus;
use App\Extension\Cache\CoreCacheDriver;
use App\Models\Module;
use App\Support\InstallerContext;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Facades\Schema;

/**
 * 모듈 상태 캐시를 관리하는 Trait
 *
 * 활성화된 모듈, 설치된 모듈 목록을 캐시하여 DB 조회 오버헤드를 줄입니다.
 * ModuleManager, ModuleServiceProvider 등에서 사용됩니다.
 */
trait CachesModuleStatus
{
    /**
     * 활성화된 모듈 identifier 목록을 조회합니다.
     *
     * @return array<string> 활성화된 모듈 identifier 배열
     */
    public static function getActiveModuleIdentifiers(): array
    {
        if (! self::isExtensionTableReady('modules')) {
            return [];
        }

        return self::rememberNonEmpty(
            'ext.modules.active_identifiers',
            fn () => Module::where('status', ExtensionStatus::Active->value)
                ->pluck('identifier')
                ->toArray()
        );
    }

    /**
     * 목록 캐시를 조회하되, 빈 결과는 캐시에 남기지 않습니다.
     *
     * 확장 상태는 install/activate/update 도중 잠시 active 가 아닌 값으로 바뀐다. 그 창에서
     * 누가 이 목록을 읽으면 빈 배열이 TTL(기본 하루) 동안 굳어, 작업이 끝난 뒤에도 모든 확장이
     * 꺼진 것처럼 동작한다 — 관리자 화면이 통째로 404 가 되고 스스로 회복되지 않는다.
     * 빈 결과는 재계산 비용이 사실상 없는 단순 조회이므로 캐시하지 않는 편이 안전하다.
     *
     * @param  string  $key  캐시 키
     * @param  \Closure  $resolver  목록 계산 클로저
     * @return array<string> 조회된 identifier 배열
     */
    private static function rememberNonEmpty(string $key, \Closure $resolver): array
    {
        $cache = self::resolveStatusCache();
        $cached = $cache->get($key);

        if (is_array($cached) && $cached !== []) {
            return $cached;
        }

        $fresh = $resolver();

        if ($fresh !== []) {
            $cache->put(
                $key,
                $fresh,
                (int) g7_core_settings('cache.extension_status_ttl', 86400),
                ['ext.status', 'ext.modules']
            );
        }

        return $fresh;
    }

    /**
     * 설치된 모듈 (active + inactive) identifier 목록을 조회합니다.
     *
     * @return array<string> 설치된 모듈 identifier 배열
     */
    public static function getInstalledModuleIdentifiers(): array
    {
        if (! self::isExtensionTableReady('modules')) {
            return [];
        }

        return self::rememberNonEmpty(
            'ext.modules.installed_identifiers',
            fn () => Module::whereIn('status', [
                ExtensionStatus::Active->value,
                ExtensionStatus::Inactive->value,
            ])->pluck('identifier')->toArray()
        );
    }

    /**
     * 모듈 상태 캐시를 무효화합니다.
     * 모듈 상태 변경 시 (install, activate, deactivate, uninstall) 호출해야 합니다.
     */
    public static function invalidateModuleStatusCache(): void
    {
        $cache = self::resolveStatusCache();
        $cache->forget('ext.modules.active_identifiers');
        $cache->forget('ext.modules.installed_identifiers');
    }

    /**
     * DB 연결 + 테이블 존재 여부를 확인합니다 (인스톨러 안전성).
     *
     * 설치 완료 상태(`config('app.installer_completed')`)일 때는 테이블 존재를
     * 전제로 하여 `Schema::hasTable()` 호출을 건너뜁니다. 인스톨러 이전 환경이나
     * 테스트에서는 기존 체크 경로로 폴백합니다.
     *
     * 단, 마이그레이션 계열 명령 실행 중에는 `INSTALLER_COMPLETED=true` 라도 테이블이
     * 아직 없을 수 있으므로(빈 DB 새 서버에 .env 복사 후 migrate 전) fast-path 를
     * 신뢰하지 않고 실제 `Schema::hasTable()` 폴백으로 진입합니다.
     */
    private static function isExtensionTableReady(string $table): bool
    {
        if (! InstallerContext::isSchemaMutatingCommand() && config('app.installer_completed')) {
            return true;
        }

        try {
            DB::connection()->getPdo();

            return Schema::hasTable($table);
        } catch (\Throwable $e) {
            return false;
        }
    }

    /**
     * CacheInterface 인스턴스를 lazy 조회합니다 (register 시점 안전).
     */
    private static function resolveStatusCache(): CacheInterface
    {
        try {
            return app(CacheInterface::class);
        } catch (\Throwable $e) {
            return new CoreCacheDriver(config('cache.default', 'array'));
        }
    }
}