diff --git a/app/Console/Commands/InspectKmhBackupCommand.php b/app/Console/Commands/InspectKmhBackupCommand.php new file mode 100644 index 0000000..9cb0685 --- /dev/null +++ b/app/Console/Commands/InspectKmhBackupCommand.php @@ -0,0 +1,107 @@ +argument('file'); + $backupDir = $service->getBackupDirectory(); + + if (!$input) { + $files = collect(File::glob($backupDir . '/*.kmh')) + ->map(fn($f) => basename($f)) + ->values() + ->all(); + + if (empty($files)) { + $this->warn("Tidak ada file .kmh di direktori backup ({$backupDir})."); + $this->line("Gunakan: php artisan kmh:inspect /path/ke/file.kmh"); + return Command::FAILURE; + } + + $input = $this->choice('Pilih file .kmh yang ingin diinspeksi:', $files); + } + + // Tentukan path lengkap + $targetPath = File::exists($input) + ? $input + : $backupDir . DIRECTORY_SEPARATOR . basename($input); + + if (!File::exists($targetPath)) { + $this->error("Berkas .kmh tidak ditemukan pada: {$targetPath}"); + return Command::FAILURE; + } + + $this->info("Sedang memeriksa & membaca arsip: " . basename($targetPath) . " ..."); + + try { + $data = $service->inspectKmhFile($targetPath); + + $this->newLine(); + $this->line("====================================================================="); + $this->info(" 🔍 HASIL INSPEKSI ARSIP KMH (RKM BACKUP READER)"); + $this->line("====================================================================="); + + $this->table( + ['Parameter', 'Keterangan'], + [ + ['Nama File', $data['filename']], + ['Ukuran Berkas', $data['file_size_human'] . " ({$data['file_size']} bytes)"], + ['Format Arsip', $data['format']], + ['Sistem Asal', $data['system']], + ['Waktu Pembuatan', $data['created_at_human'] . " ({$data['created_at_diff']})"], + ['Tipe Backup', $data['type_label']], + ['Database Asal', $data['database']], + ['Enkripsi & Keamanan', $data['encryption_cipher'] . ' (' . $data['hmac_verification'] . ')'], + ['Ukuran SQL Database', $data['sql_size_human']], + ['File Media (storage/)', $data['has_media'] ? "{$data['media_file_count']} berkas media" : 'Tidak disertakan'], + ['Versi Environment', "Laravel {$data['laravel_version']} / PHP {$data['php_version']}"], + ] + ); + + if (!empty($data['tables'])) { + $this->newLine(); + $this->comment(" Daftar Tabel Terdaftar (" . count($data['tables']) . " tabel):"); + $chunks = array_chunk($data['tables'], 4); + $rows = array_map(function ($chunk) { + return array_pad($chunk, 4, ''); + }, $chunks); + $this->table(['Kolom 1', 'Kolom 2', 'Kolom 3', 'Kolom 4'], $rows); + } + + if (!empty($data['media_samples'])) { + $this->newLine(); + $this->comment(" Sampel Berkas Media:"); + foreach ($data['media_samples'] as $sample) { + $this->line(" - {$sample}"); + } + } + + $this->newLine(); + $this->info("✓ Berkas sah, terenkripsi valid, dan siap dipulihkan jika diperlukan."); + $this->line("====================================================================="); + + return Command::SUCCESS; + } catch (\Throwable $e) { + $this->error("Gagal membaca arsip .kmh: " . $e->getMessage()); + return Command::FAILURE; + } + } +} diff --git a/app/Http/Controllers/Admin/BackupController.php b/app/Http/Controllers/Admin/BackupController.php index 465500d..0d95870 100644 --- a/app/Http/Controllers/Admin/BackupController.php +++ b/app/Http/Controllers/Admin/BackupController.php @@ -6,6 +6,7 @@ use App\Http\Controllers\Controller; use App\Models\AdminActivityLog; use App\Models\BackupLog; use App\Services\DatabaseBackupService; +use Illuminate\Http\JsonResponse; use Illuminate\Http\RedirectResponse; use Illuminate\Http\Request; use Illuminate\Support\Facades\Artisan; @@ -382,6 +383,75 @@ class BackupController extends Controller } } + /** + * Inspeksi dan baca metadata isi file .kmh yang sudah ada di penyimpanan server. + */ + public function inspect(string $filename): JsonResponse + { + $filename = basename($filename); + $fullPath = $this->backupService->getBackupDirectory() . DIRECTORY_SEPARATOR . $filename; + + if (!File::exists($fullPath)) { + return response()->json([ + 'success' => false, + 'message' => "Berkas backup '{$filename}' tidak ditemukan di penyimpanan server VPS.", + ], 404); + } + + try { + $data = $this->backupService->inspectKmhFile($fullPath); + return response()->json([ + 'success' => true, + 'data' => $data, + ]); + } catch (\Throwable $e) { + return response()->json([ + 'success' => false, + 'message' => $e->getMessage(), + ], 422); + } + } + + /** + * Inspeksi dan baca metadata isi file .kmh yang diunggah dari komputer lokal. + * File sementara langsung dihapus otomatis setelah dibaca (Zero Storage Retention). + */ + public function inspectUpload(Request $request): JsonResponse + { + $request->validate([ + 'backup_file' => ['required', 'file', 'max:512000'], + ], [ + 'backup_file.required' => 'Pilih atau letakkan berkas file .kmh yang ingin dibaca.', + 'backup_file.file' => 'Berkas yang diunggah tidak valid.', + 'backup_file.max' => 'Ukuran file melebihi batas maksimal upload 500 MB.', + ]); + + $uploaded = $request->file('backup_file'); + $tempPath = tempnam(sys_get_temp_dir(), 'kmh_upload_inspect_'); + + try { + $uploaded->move(dirname($tempPath), basename($tempPath)); + + $data = $this->backupService->inspectKmhFile($tempPath); + // Ganti nama file dengan nama asli dari komputer pengguna + $data['filename'] = $uploaded->getClientOriginalName(); + + return response()->json([ + 'success' => true, + 'data' => $data, + ]); + } catch (\Throwable $e) { + return response()->json([ + 'success' => false, + 'message' => $e->getMessage(), + ], 422); + } finally { + if (is_file($tempPath)) { + @unlink($tempPath); + } + } + } + /** * Hapus file backup dari penyimpanan server untuk menghemat kapasitas disk VPS. * Riwayat log backup tetap tersimpan di sistem. diff --git a/app/Services/DatabaseBackupService.php b/app/Services/DatabaseBackupService.php index b8302f8..ea396d7 100644 --- a/app/Services/DatabaseBackupService.php +++ b/app/Services/DatabaseBackupService.php @@ -237,6 +237,105 @@ class DatabaseBackupService } } + /** + * Inspeksi dan baca metadata isi file arsip .kmh tanpa melakukan restore atau manipulasi database. + * Mengembalikan manifest, daftar tabel terarsip, metrik data, dan status integritas enkripsi. + * + * @return array + */ + public function inspectKmhFile(string $filePath): array + { + @set_time_limit(180); + @ini_set('memory_limit', '512M'); + + if (!File::exists($filePath)) { + throw new RuntimeException("Berkas file backup tidak ditemukan: {$filePath}"); + } + + $content = file_get_contents($filePath); + $headerLen = strlen(self::KMH_MAGIC_HEADER); + + if (substr($content, 0, $headerLen) !== self::KMH_MAGIC_HEADER) { + throw new RuntimeException("Berkas bukan format arsip .kmh yang sah atau file rusak (Magic Header tidak cocok)."); + } + + // Dekripsi payload (verifikasi HMAC & kunci enkripsi) + $decryptedZip = $this->decryptFromKmh($content); + + // Buka zip sementara untuk membaca manifest dan statistik file + $tempZip = tempnam(sys_get_temp_dir(), 'kmh_inspect_'); + file_put_contents($tempZip, $decryptedZip); + + try { + $zip = new ZipArchive(); + if ($zip->open($tempZip) !== true) { + throw new RuntimeException("Gagal membuka struktur arsip ZIP internal di dalam berkas .kmh."); + } + + $manifestJson = $zip->getFromName('manifest.json'); + $manifest = $manifestJson ? json_decode($manifestJson, true) : []; + + $filesCount = $zip->numFiles; + $mediaCount = 0; + $sqlSize = 0; + $mediaSamples = []; + + for ($i = 0; $i < $filesCount; $i++) { + $stat = $zip->statIndex($i); + $name = $stat['name'] ?? ''; + $size = $stat['size'] ?? 0; + + if (str_starts_with($name, 'storage/')) { + $mediaCount++; + if (count($mediaSamples) < 5) { + $mediaSamples[] = basename($name); + } + } elseif (str_ends_with($name, '.sql') || $name === 'database.sql') { + $sqlSize = $size; + } + } + + $zip->close(); + + $tables = $manifest['tables'] ?? []; + $tableCount = count($tables); + $hasMedia = (bool) ($manifest['has_media'] ?? ($mediaCount > 0)); + $createdAt = isset($manifest['created_at']) ? Carbon::parse($manifest['created_at']) : Carbon::createFromTimestamp(filemtime($filePath)); + + return [ + 'is_valid' => true, + 'filename' => basename($filePath), + 'file_size' => filesize($filePath), + 'file_size_human' => $this->formatBytes(filesize($filePath)), + 'format' => $manifest['format'] ?? 'KMH_ENCRYPTED_V1', + 'system' => $manifest['system'] ?? 'PT Kerinci Merangin Hidro (RKM)', + 'created_at' => $createdAt->toIso8601String(), + 'created_at_human' => $createdAt->translatedFormat('d F Y, H:i:s') . ' WIB', + 'created_at_diff' => $createdAt->diffForHumans(), + 'type' => $manifest['type'] ?? ($hasMedia ? 'semua' : 'pilihan'), + 'type_label' => ($manifest['type'] ?? '') === 'semua' || $hasMedia + ? 'Backup Semua (Database + Media Foto)' + : 'Pilih Backup (Tabel Tertentu)', + 'database' => $manifest['database'] ?? config('database.connections.mysql.database', 'rkm_kmh'), + 'table_count' => $tableCount, + 'tables' => $tables, + 'has_media' => $hasMedia, + 'media_file_count' => $mediaCount, + 'media_samples' => $mediaSamples, + 'sql_size' => $sqlSize, + 'sql_size_human' => $this->formatBytes($sqlSize), + 'laravel_version' => $manifest['laravel_version'] ?? app()->version(), + 'php_version' => $manifest['php_version'] ?? PHP_VERSION, + 'encryption_cipher' => 'AES-256-CBC', + 'hmac_verification' => 'SHA-256 Terverifikasi Sah', + ]; + } finally { + if (is_file($tempZip)) { + @unlink($tempZip); + } + } + } + /** * Pulihkan (Restore) data dari file .kmh (atau .sql / .zip sebagai fallback). */ diff --git a/resources/views/admin/backups/index.blade.php b/resources/views/admin/backups/index.blade.php index 5719bdd..19c87eb 100644 --- a/resources/views/admin/backups/index.blade.php +++ b/resources/views/admin/backups/index.blade.php @@ -15,6 +15,11 @@

+ + Unduh @@ -243,6 +255,13 @@ Hapus dari Server @else + +
+ + + + + @@ -863,5 +1035,198 @@ document.getElementById('deleteBackupModal').classList.add('hidden'); document.documentElement.classList.remove('modal-open'); } + + /* ========================================================================= */ + /* PEMBACA & INSPEKSI ARSIP .KMH (KMH READER JAVASCRIPT) */ + /* ========================================================================= */ + let currentInspectedFile = null; + let currentInspectedSource = 'server'; + + function openInspectModal(initialTab = 'server') { + document.getElementById('inspectBackupModal').classList.remove('hidden'); + document.documentElement.classList.add('modal-open'); + switchInspectTab(initialTab); + resetInspectResult(); + } + + function closeInspectModal() { + document.getElementById('inspectBackupModal').classList.add('hidden'); + document.documentElement.classList.remove('modal-open'); + } + + function switchInspectTab(tab) { + currentInspectedSource = tab; + const tabServer = document.getElementById('tabInspectServer'); + const tabUpload = document.getElementById('tabInspectUpload'); + const panelServer = document.getElementById('panelInspectServer'); + const panelUpload = document.getElementById('panelInspectUpload'); + + if (tab === 'server') { + tabServer.classList.add('bg-white', 'shadow-2xs', 'text-slate-800'); + tabServer.classList.remove('text-slate-500'); + tabUpload.classList.remove('bg-white', 'shadow-2xs', 'text-slate-800'); + tabUpload.classList.add('text-slate-500'); + panelServer.classList.remove('hidden'); + panelUpload.classList.add('hidden'); + } else { + tabUpload.classList.add('bg-white', 'shadow-2xs', 'text-slate-800'); + tabUpload.classList.remove('text-slate-500'); + tabServer.classList.remove('bg-white', 'shadow-2xs', 'text-slate-800'); + tabServer.classList.add('text-slate-500'); + panelUpload.classList.remove('hidden'); + panelServer.classList.add('hidden'); + } + } + + function resetInspectResult() { + document.getElementById('inspectLoading').classList.add('hidden'); + document.getElementById('inspectError').classList.add('hidden'); + document.getElementById('inspectResult').classList.add('hidden'); + } + + function inspectSelectedServerBackup() { + const select = document.getElementById('serverInspectFilenameSelect'); + if (select && select.value) { + inspectServerBackup(select.value); + } + } + + function inspectServerBackup(filename) { + openInspectModal('server'); + const select = document.getElementById('serverInspectFilenameSelect'); + if (select) select.value = filename; + + resetInspectResult(); + const loading = document.getElementById('inspectLoading'); + loading.classList.remove('hidden'); + + fetch(`/admin/backups/${encodeURIComponent(filename)}/inspect`, { + headers: { + 'Accept': 'application/json', + 'X-Requested-With': 'XMLHttpRequest' + } + }) + .then(res => res.json()) + .then(res => { + loading.classList.add('hidden'); + if (res.success && res.data) { + renderInspectionResult(res.data, 'server'); + } else { + showInspectError(res.message || 'Gagal membaca arsip.'); + } + }) + .catch(err => { + loading.classList.add('hidden'); + showInspectError('Terjadi kesalahan jaringan saat membaca arsip: ' + err.message); + }); + } + + function handleInspectFileInput(input) { + if (input.files && input.files[0]) { + inspectUploadedFile(input.files[0]); + } + } + + function handleInspectFileDrop(e, dropzone) { + e.preventDefault(); + e.stopPropagation(); + dropzone.classList.remove('border-sky-500', 'bg-sky-50/20'); + if (e.dataTransfer && e.dataTransfer.files && e.dataTransfer.files.length > 0) { + inspectUploadedFile(e.dataTransfer.files[0]); + } + } + + function inspectUploadedFile(file) { + if (!file.name.toLowerCase().endsWith('.kmh')) { + alert('File yang dipilih harus berekstensi .kmh!'); + return; + } + + resetInspectResult(); + const loading = document.getElementById('inspectLoading'); + document.getElementById('inspectLoadingText').textContent = `Mengunggah & memeriksa "${file.name}" (${(file.size / (1024 * 1024)).toFixed(1)} MB)...`; + loading.classList.remove('hidden'); + + const formData = new FormData(); + formData.append('backup_file', file); + formData.append('_token', '{{ csrf_token() }}'); + + fetch(`{{ route('admin.backups.inspect_upload') }}`, { + method: 'POST', + body: formData, + headers: { + 'Accept': 'application/json', + 'X-Requested-With': 'XMLHttpRequest' + } + }) + .then(res => res.json()) + .then(res => { + loading.classList.add('hidden'); + if (res.success && res.data) { + currentInspectedFile = file; + renderInspectionResult(res.data, 'upload'); + } else { + showInspectError(res.message || 'Gagal membaca arsip.'); + } + }) + .catch(err => { + loading.classList.add('hidden'); + showInspectError('Gagal membaca berkas: ' + err.message); + }); + } + + function showInspectError(msg) { + const errorDiv = document.getElementById('inspectError'); + document.getElementById('inspectErrorMessage').textContent = msg; + errorDiv.classList.remove('hidden'); + } + + function renderInspectionResult(data, source) { + document.getElementById('resFilename').textContent = data.filename; + document.getElementById('resFileSize').textContent = data.file_size_human; + document.getElementById('resCreatedAt').textContent = data.created_at_human; + document.getElementById('resCreatedDiff').textContent = data.created_at_diff; + document.getElementById('resSecurity').textContent = `${data.encryption_cipher} (${data.hmac_verification})`; + document.getElementById('resType').textContent = data.type_label; + document.getElementById('resDatabase').textContent = data.database; + document.getElementById('resSql').textContent = data.sql_size_human; + document.getElementById('resMedia').textContent = data.has_media ? `${data.media_file_count} Berkas Media` : 'Tidak Ada Media'; + document.getElementById('resTableCount').textContent = data.table_count; + + const tableListDiv = document.getElementById('resTableList'); + tableListDiv.innerHTML = ''; + if (data.tables && data.tables.length > 0) { + data.tables.forEach(tbl => { + const badge = document.createElement('span'); + badge.className = 'px-2 py-0.5 bg-white border border-slate-200 rounded text-[11px] font-mono text-slate-700 shadow-2xs'; + badge.textContent = tbl; + tableListDiv.appendChild(badge); + }); + } else { + tableListDiv.innerHTML = 'Daftar tabel tidak terdefinisi di manifest.'; + } + + const btnProceed = document.getElementById('btnProceedRestore'); + if (source === 'server') { + btnProceed.onclick = function() { + closeInspectModal(); + openRestoreModal(data.filename, data.type_label, data.file_size_human); + }; + } else { + btnProceed.onclick = function() { + closeInspectModal(); + openDirectRestoreModal(); + if (currentInspectedFile) { + const input = document.getElementById('directRestoreFileInput'); + const dataTransfer = new DataTransfer(); + dataTransfer.items.add(currentInspectedFile); + input.files = dataTransfer.files; + handleDirectRestoreFileChange(input); + } + }; + } + + document.getElementById('inspectResult').classList.remove('hidden'); + } @endsection diff --git a/routes/web.php b/routes/web.php index 3d5648b..efa1fc4 100644 --- a/routes/web.php +++ b/routes/web.php @@ -218,7 +218,9 @@ Route::middleware('auth')->group(function () { // Backup & Restore Sistem (Database & Media) Route::get('/backups', [BackupController::class, 'index'])->name('backups.index'); Route::post('/backups', [BackupController::class, 'store'])->name('backups.store'); + Route::post('/backups/inspect-file', [BackupController::class, 'inspectUpload'])->name('backups.inspect_upload'); Route::post('/backups/restore-file', [BackupController::class, 'restoreFromFile'])->name('backups.restore_file')->middleware('throttle:5,1'); + Route::get('/backups/{filename}/inspect', [BackupController::class, 'inspect'])->name('backups.inspect'); Route::get('/backups/{filename}/download', [BackupController::class, 'download'])->name('backups.download'); Route::post('/backups/upload', [BackupController::class, 'upload'])->name('backups.upload'); Route::post('/backups/{filename}/restore', [BackupController::class, 'restore'])->name('backups.restore')->middleware('throttle:5,1'); diff --git a/tests/Feature/BackupAndRestoreTest.php b/tests/Feature/BackupAndRestoreTest.php index 406426f..21d196a 100644 --- a/tests/Feature/BackupAndRestoreTest.php +++ b/tests/Feature/BackupAndRestoreTest.php @@ -310,4 +310,60 @@ class BackupAndRestoreTest extends TestCase 'target_name' => 'backup_dari_pc.kmh', ]); } + + public function test_super_admin_can_inspect_server_kmh_backup(): void + { + $filename = $this->backupService->createKmhBackup(['users'], false, 'test_inspect_server.kmh'); + + $response = $this->actingAs($this->superAdmin) + ->getJson(route('admin.backups.inspect', $filename)); + + $response->assertStatus(200); + $response->assertJson([ + 'success' => true, + 'data' => [ + 'filename' => $filename, + 'is_valid' => true, + 'encryption_cipher' => 'AES-256-CBC', + ], + ]); + + $this->assertContains('users', $response->json('data.tables')); + } + + public function test_super_admin_can_inspect_uploaded_kmh_backup_with_zero_disk_retention(): void + { + $filename = $this->backupService->createKmhBackup(['users'], false, 'test_inspect_upload.kmh'); + $fullPath = $this->backupService->getBackupDirectory() . DIRECTORY_SEPARATOR . $filename; + $kmhContent = file_get_contents($fullPath); + + $uploadedFile = UploadedFile::fake()->createWithContent('arsip_lama_2bulan_lalu.kmh', $kmhContent); + + $response = $this->actingAs($this->superAdmin) + ->postJson(route('admin.backups.inspect_upload'), [ + 'backup_file' => $uploadedFile, + ]); + + $response->assertStatus(200); + $response->assertJson([ + 'success' => true, + 'data' => [ + 'filename' => 'arsip_lama_2bulan_lalu.kmh', + 'is_valid' => true, + 'encryption_cipher' => 'AES-256-CBC', + ], + ]); + + $this->assertContains('users', $response->json('data.tables')); + } + + public function test_inspect_kmh_command_outputs_metadata(): void + { + $filename = $this->backupService->createKmhBackup(['users'], false, 'test_cli_inspect.kmh'); + + $this->artisan('kmh:inspect', ['file' => $filename]) + ->expectsOutputToContain('HASIL INSPEKSI ARSIP KMH') + ->expectsOutputToContain('AES-256-CBC') + ->assertExitCode(0); + } }