v7.0.0-beta.2 release

app/Console/Commands/Module/ClearModuleCacheCommand.php

@@ -2,10 +2,10 @@
 
 namespace App\Console\Commands\Module;
 
+use App\Contracts\Extension\CacheInterface;
 use App\Contracts\Repositories\ModuleRepositoryInterface;
 use App\Extension\ModuleManager;
 use Illuminate\Console\Command;
-use Illuminate\Support\Facades\Cache;
 use Illuminate\Support\Facades\Log;
 
 class ClearModuleCacheCommand extends Command
@@ -26,7 +26,8 @@ class ClearModuleCacheCommand extends Command
      */
     public function __construct(
         private ModuleManager $moduleManager,
-        private ModuleRepositoryInterface $moduleRepository
+        private ModuleRepositoryInterface $moduleRepository,
+        private CacheInterface $cache
     ) {
         parent::__construct();
     }
@@ -74,7 +75,7 @@ class ClearModuleCacheCommand extends Command
                 ];
 
                 foreach ($cacheKeys as $key) {
-                    if (Cache::forget($key)) {
+                    if ($this->cache->forget($key)) {
                         $clearedCount++;
                     }
                 }
@@ -122,7 +123,7 @@ class ClearModuleCacheCommand extends Command
         ];
 
         foreach ($cacheKeys as $key) {
-            if (Cache::forget($key)) {
+            if ($this->cache->forget($key)) {
                 $clearedCount++;
             }
         }

app/Console/Commands/Module/InstallModuleCommand.php

@@ -6,6 +6,7 @@ use App\Console\Commands\Traits\HasProgressBar;
 use App\Contracts\Repositories\ModuleRepositoryInterface;
 use App\Enums\ExtensionOwnerType;
 use App\Extension\ModuleManager;
+use App\Extension\Vendor\VendorMode;
 use App\Models\Menu;
 use App\Models\Permission;
 use App\Rules\ValidExtensionIdentifier;
@@ -20,7 +21,10 @@ class InstallModuleCommand extends Command
     /**
      * The name and signature of the console command.
      */
-    protected $signature = 'module:install {identifier : 설치할 모듈 식별자}';
+    protected $signature = 'module:install
+        {identifier : 설치할 모듈 식별자}
+        {--vendor-mode=auto : Vendor 설치 모드 (auto|composer|bundled)}
+        {--force : 이미 설치된 경우에도 _bundled/_pending 원본으로 활성 디렉토리를 덮어쓰고 재설치 (불완전 설치 복구)}';
 
     /**
      * The console command description.
@@ -56,22 +60,29 @@ class InstallModuleCommand extends Command
             return Command::FAILURE;
         }
 
+        $force = (bool) $this->option('force');
+
         try {
             // 모듈 디렉토리 스캔 및 로드
             $this->moduleManager->loadModules();
 
-            // 이미 설치된 모듈인지 확인
+            // 이미 설치된 모듈인지 확인 (force 시 스킵하여 재설치/복구 허용)
             $existingModule = $this->moduleRepository->findByIdentifier($identifier);
-            if ($existingModule) {
+            if ($existingModule && ! $force) {
                 $this->warn('⚠️  '.__('modules.commands.install.already_installed', ['module' => $identifier]));
 
                 return Command::FAILURE;
             }
 
+            if ($existingModule && $force) {
+                $this->warn('⚠️  '.__('modules.commands.install.force_reinstall', ['module' => $identifier]));
+            }
+
             // 모듈 설치
+            $vendorMode = VendorMode::fromStringOrAuto((string) $this->option('vendor-mode'));
             $onProgress = $this->createProgressCallback(ModuleManager::INSTALL_STEPS);
             try {
-                $result = $this->moduleManager->installModule($identifier, $onProgress);
+                $result = $this->moduleManager->installModule($identifier, $onProgress, $vendorMode, $force);
                 $this->finishProgress();
             } catch (\Exception $e) {
                 $this->finishProgress();

app/Console/Commands/Module/ModuleVendorBundleCommand.php

@@ -0,0 +1,56 @@
+<?php
+
+namespace App\Console\Commands\Module;
+
+use App\Console\Commands\Vendor\Concerns\RunsVendorBundleAction;
+use App\Extension\Vendor\VendorBundler;
+use Illuminate\Console\Command;
+
+/**
+ * 모듈 vendor/ 디렉토리를 vendor-bundle.zip 으로 빌드합니다.
+ *
+ * 기존 module:build 패턴과 동일하게 positional identifier + --all 옵션 지원.
+ */
+class ModuleVendorBundleCommand extends Command
+{
+    use RunsVendorBundleAction;
+
+    protected $signature = 'module:vendor-bundle
+                            {identifier? : 빌드할 모듈 식별자 (생략 시 --all 필요)}
+                            {--all : 모든 _bundled 모듈 빌드}
+                            {--force : 해시 체크 무시, 강제 재빌드}
+                            {--check : 실제 빌드 없이 stale 여부만 확인}';
+
+    protected $description = '모듈 vendor/ 디렉토리를 vendor-bundle.zip 으로 빌드합니다 (공유 호스팅용)';
+
+    public function handle(VendorBundler $bundler): int
+    {
+        $identifier = $this->argument('identifier');
+        $all = (bool) $this->option('all');
+
+        if (! $identifier && ! $all) {
+            $this->error('식별자 또는 --all 옵션을 지정해야 합니다.');
+            $this->line('사용법:');
+            $this->line('  php artisan module:vendor-bundle sirsoft-ecommerce');
+            $this->line('  php artisan module:vendor-bundle --all');
+
+            return self::FAILURE;
+        }
+
+        $targets = [];
+        if ($all) {
+            foreach ($this->discoverBundledIdentifiers('module') as $id) {
+                $targets[] = ['type' => 'module', 'identifier' => $id];
+            }
+        } else {
+            $targets[] = ['type' => 'module', 'identifier' => $identifier];
+        }
+
+        return $this->runBuildAction(
+            $bundler,
+            $targets,
+            (bool) $this->option('force'),
+            (bool) $this->option('check'),
+        );
+    }
+}

app/Console/Commands/Module/ModuleVendorVerifyCommand.php

@@ -0,0 +1,44 @@
+<?php
+
+namespace App\Console\Commands\Module;
+
+use App\Console\Commands\Vendor\Concerns\RunsVendorBundleAction;
+use App\Extension\Vendor\VendorIntegrityChecker;
+use Illuminate\Console\Command;
+
+/**
+ * 모듈 vendor-bundle.zip 무결성을 검증합니다.
+ */
+class ModuleVendorVerifyCommand extends Command
+{
+    use RunsVendorBundleAction;
+
+    protected $signature = 'module:vendor-verify
+                            {identifier? : 검증할 모듈 식별자 (생략 시 --all 필요)}
+                            {--all : 모든 _bundled 모듈 검증}';
+
+    protected $description = '모듈 vendor-bundle.zip 의 SHA256 무결성을 검증합니다';
+
+    public function handle(VendorIntegrityChecker $checker): int
+    {
+        $identifier = $this->argument('identifier');
+        $all = (bool) $this->option('all');
+
+        if (! $identifier && ! $all) {
+            $this->error('식별자 또는 --all 옵션을 지정해야 합니다.');
+
+            return self::FAILURE;
+        }
+
+        $targets = [];
+        if ($all) {
+            foreach ($this->discoverBundledIdentifiers('module') as $id) {
+                $targets[] = ['type' => 'module', 'identifier' => $id];
+            }
+        } else {
+            $targets[] = ['type' => 'module', 'identifier' => $identifier];
+        }
+
+        return $this->runVerifyAction($checker, $targets);
+    }
+}

app/Console/Commands/Module/UpdateModuleCommand.php

@@ -5,6 +5,7 @@ namespace App\Console\Commands\Module;
 use App\Console\Commands\Traits\HasProgressBar;
 use App\Contracts\Repositories\ModuleRepositoryInterface;
 use App\Extension\ModuleManager;
+use App\Extension\Vendor\VendorMode;
 use Illuminate\Console\Command;
 use Illuminate\Support\Facades\Log;
 
@@ -17,7 +18,11 @@ class UpdateModuleCommand extends Command
      */
     protected $signature = 'module:update
         {identifier : 업데이트할 모듈 식별자}
-        {--force : 버전 비교 없이 강제 업데이트}';
+        {--force : 버전 비교 없이 강제 업데이트}
+        {--vendor-mode=auto : Vendor 설치 모드 (auto|composer|bundled)}
+        {--layout-strategy=overwrite : 레이아웃 전략 (overwrite|keep)}
+        {--source=auto : 업데이트 소스 (auto|bundled|github) — bundled 는 _bundled 만 사용(GitHub 우회)}
+        {--zip= : 외부 ZIP 파일 경로 (지정 시 GitHub/번들 우회 + 버전은 module.json 기준)}';
 
     /**
      * The console command description.
@@ -41,6 +46,40 @@ class UpdateModuleCommand extends Command
     {
         $identifier = $this->argument('identifier');
         $force = $this->option('force');
+        $layoutStrategy = (string) $this->option('layout-strategy');
+        $sourceOption = (string) $this->option('source');
+        $zipPath = $this->option('zip');
+
+        if (! in_array($layoutStrategy, ['overwrite', 'keep'], true)) {
+            $this->error('❌ --layout-strategy 는 overwrite 또는 keep 이어야 합니다.');
+
+            return Command::FAILURE;
+        }
+
+        if (! in_array($sourceOption, ['auto', 'bundled', 'github'], true)) {
+            $this->error('❌ --source 는 auto, bundled, github 중 하나여야 합니다.');
+
+            return Command::FAILURE;
+        }
+
+        // --zip 과 --source 동시 지정 금지 (zip 이 우선 대상이므로)
+        if ($zipPath !== null && $sourceOption !== 'auto') {
+            $this->error('❌ --zip 은 --source 와 동시에 지정할 수 없습니다.');
+
+            return Command::FAILURE;
+        }
+
+        if ($zipPath !== null) {
+            $resolvedZip = realpath($zipPath);
+            if (! $resolvedZip || ! is_file($resolvedZip)) {
+                $this->error('❌ 지정된 ZIP 파일이 존재하지 않습니다: '.$zipPath);
+
+                return Command::FAILURE;
+            }
+            $zipPath = $resolvedZip;
+        }
+
+        $sourceOverride = $sourceOption === 'auto' ? null : $sourceOption;
 
         try {
             $this->moduleManager->loadModules();
@@ -54,23 +93,29 @@ class UpdateModuleCommand extends Command
                 return Command::FAILURE;
             }
 
-            // 업데이트 확인
-            $checkResult = $this->moduleManager->checkModuleUpdate($identifier);
+            // 업데이트 확인 (--zip 모드는 GitHub/번들 비교를 우회하므로 스킵)
+            if ($zipPath === null) {
+                $checkResult = $this->moduleManager->checkModuleUpdate($identifier);
 
-            if (! $checkResult['update_available'] && ! $force) {
-                $this->info('✅ '.__('modules.commands.update.no_update', ['module' => $identifier]));
+                if (! $checkResult['update_available'] && ! $force) {
+                    $this->info('✅ '.__('modules.commands.update.no_update', ['module' => $identifier]));
 
-                return Command::SUCCESS;
-            }
+                    return Command::SUCCESS;
+                }
 
-            // 업데이트 정보 표시
-            $this->info(__('modules.commands.update.current_version', ['version' => $checkResult['current_version']]));
+                // 업데이트 정보 표시
+                $this->info(__('modules.commands.update.current_version', ['version' => $checkResult['current_version']]));
 
-            if ($force && ! $checkResult['update_available']) {
-                $this->warn('⚠️  '.__('modules.commands.update.force_mode'));
+                if ($force && ! $checkResult['update_available']) {
+                    $this->warn('⚠️  '.__('modules.commands.update.force_mode'));
+                } else {
+                    $this->info(__('modules.commands.update.latest_version', ['version' => $checkResult['latest_version']]));
+                    $this->info(__('modules.commands.update.update_source', ['source' => $checkResult['update_source']]));
+                }
             } else {
-                $this->info(__('modules.commands.update.latest_version', ['version' => $checkResult['latest_version']]));
-                $this->info(__('modules.commands.update.update_source', ['source' => $checkResult['update_source']]));
+                $this->info(__('modules.commands.update.current_version', ['version' => $module->version]));
+                $this->info('업데이트 소스: ZIP ('.$zipPath.')');
+                $this->info('업데이트 버전: (module.json 추출 후 판별)');
             }
 
             $this->newLine();
@@ -83,9 +128,31 @@ class UpdateModuleCommand extends Command
             }
 
             // 업데이트 실행
+            $vendorMode = VendorMode::fromStringOrAuto((string) $this->option('vendor-mode'));
             $onProgress = $this->createProgressCallback(ModuleManager::UPDATE_STEPS);
+
+            // upgrade step 콘솔 출력 콜백: progress bar 를 잠시 지우고 별도 줄에 출력
+            $onUpgradeStep = function (string $version) use ($identifier): void {
+                if ($this->progressBar) {
+                    $this->progressBar->clear();
+                }
+                $this->line("  • [{$identifier}] upgrade step 실행: {$version}");
+                if ($this->progressBar) {
+                    $this->progressBar->display();
+                }
+            };
+
             try {
-                $updateResult = $this->moduleManager->updateModule($identifier, $force, $onProgress);
+                $updateResult = $this->moduleManager->updateModule(
+                    $identifier,
+                    $force,
+                    $onProgress,
+                    $vendorMode,
+                    $layoutStrategy,
+                    $onUpgradeStep,
+                    $sourceOverride,
+                    $zipPath,
+                );
                 $this->finishProgress();
             } catch (\Exception $e) {
                 $this->finishProgress();
@@ -104,6 +171,7 @@ class UpdateModuleCommand extends Command
                     'module' => $identifier,
                     'from' => $updateResult['from_version'],
                     'to' => $updateResult['to_version'],
+                    'layout_strategy' => $layoutStrategy,
                 ]);
 
                 return Command::SUCCESS;