feat(backup): add dedicated .kmh archive reader with zero-storage file inspection and CLI command

This commit is contained in:
Ray1111-aa
2026-10-30 09:00:28 +07:00
parent 39a5ee67ef
commit 18e4e6471e
6 changed files with 699 additions and 0 deletions
@@ -0,0 +1,107 @@
<?php
namespace App\Console\Commands;
use App\Services\DatabaseBackupService;
use Illuminate\Console\Command;
use Illuminate\Support\Facades\File;
class InspectKmhBackupCommand extends Command
{
/**
* The name and signature of the console command.
*/
protected $signature = 'kmh:inspect
{file? : Nama file .kmh di folder backup atau path absolut ke file .kmh}';
/**
* The console command description.
*/
protected $description = 'Inspeksi dan baca isi metadata file backup .kmh terenkripsi tanpa mengubah database';
public function handle(DatabaseBackupService $service): int
{
$input = $this->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;
}
}
}
@@ -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.
+99
View File
@@ -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<string, mixed>
*/
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).
*/
@@ -15,6 +15,11 @@
</p>
</div>
<div class="flex items-center gap-2.5 shrink-0 self-start md:self-auto">
<button type="button"
onclick="openInspectModal()"
class="whitespace-nowrap px-4 py-2.5 rounded-xl border border-sky-300 bg-sky-50 hover:bg-sky-100 text-sky-900 text-xs font-semibold transition shadow-2xs inline-flex items-center gap-1.5">
🔍 Baca Arsip .kmh
</button>
<button type="button"
onclick="openDirectRestoreModal()"
class="whitespace-nowrap px-4 py-2.5 rounded-xl border border-amber-300 bg-amber-50 hover:bg-amber-100 text-amber-900 text-xs font-semibold transition shadow-2xs inline-flex items-center gap-1.5">
@@ -225,6 +230,13 @@
<td class="py-3 px-5 text-right whitespace-nowrap">
<div class="inline-flex items-center gap-1.5">
@if($hasServerFile)
<button type="button"
onclick="inspectServerBackup('{{ $log->filename }}')"
title="Inspeksi isi arsip backup (manifest, tabel, dan media)"
class="px-2.5 py-1 rounded-lg border border-sky-300 bg-sky-50 hover:bg-sky-100 text-sky-900 font-semibold text-[11px] transition">
Baca
</button>
<a href="{{ route('admin.backups.download', $log->filename) }}"
class="px-2.5 py-1 rounded-lg border border-slate-200 bg-white hover:bg-slate-50 text-slate-700 font-semibold text-[11px] transition">
Unduh
@@ -243,6 +255,13 @@
Hapus dari Server
</button>
@else
<button type="button"
onclick="openInspectModal('upload')"
title="Baca file arsip .kmh dari komputer lokal"
class="px-2.5 py-1 rounded-lg border border-sky-300 bg-sky-50 hover:bg-sky-100 text-sky-900 font-semibold text-[11px] transition">
Baca File PC
</button>
<button type="button"
onclick="openDirectRestoreModal()"
class="px-2.5 py-1 rounded-lg border border-amber-300 bg-amber-50 hover:bg-amber-100 text-amber-900 font-semibold text-[11px] transition">
@@ -609,6 +628,159 @@
</div>
</div>
<!-- ========================================================================= -->
<!-- MODAL: PEMBACA & INSPEKTOR ARSIP BACKUP (.KMH READER) -->
<!-- ========================================================================= -->
<div id="inspectBackupModal" data-backdrop="static" class="fixed inset-0 z-50 hidden bg-slate-900/60 backdrop-blur-xs flex items-center justify-center p-4 overflow-y-auto">
<div class="bg-white rounded-2xl max-w-2xl w-full shadow-2xl overflow-hidden animate-scale-in border border-slate-100 my-8">
<!-- Header -->
<div class="px-6 py-4 bg-sky-50/80 border-b border-sky-100 flex items-center justify-between">
<div class="flex items-center gap-2.5">
<div class="w-9 h-9 rounded-xl bg-sky-600 text-white flex items-center justify-center font-bold text-sm shadow-xs">
KMH
</div>
<div>
<h3 class="text-base font-bold text-slate-900">Pembaca &amp; Inspeksi Arsip .kmh</h3>
<p class="text-xs text-sky-800 mt-0.5">Lihat struktur data, tabel, dan media tanpa memulihkan ke database (Read-Only).</p>
</div>
</div>
<button type="button" onclick="closeInspectModal()" class="text-slate-400 hover:text-slate-600 text-xl p-1 leading-none">&times;</button>
</div>
<div class="p-6 space-y-5">
<!-- Navigasi Tab: Server vs Upload Komputer -->
<div class="flex items-center gap-2 p-1 bg-slate-100 rounded-xl text-xs font-semibold">
<button type="button" id="tabInspectServer" onclick="switchInspectTab('server')" class="flex-1 py-2 px-3 rounded-lg bg-white shadow-2xs text-slate-800 transition">
📁 Arsip di Server VPS
</button>
<button type="button" id="tabInspectUpload" onclick="switchInspectTab('upload')" class="flex-1 py-2 px-3 rounded-lg text-slate-500 hover:text-slate-700 transition">
💻 Upload File dari Komputer (0 B Storage)
</button>
</div>
<!-- Panel 1: Pilih dari Server -->
<div id="panelInspectServer" class="space-y-3">
<label class="block text-xs font-semibold text-slate-700">Pilih Berkas Backup yang Tersedia di Server:</label>
@if(!empty($backups) && count($backups) > 0)
<div class="flex gap-2">
<select id="serverInspectFilenameSelect" class="flex-1 text-xs px-3 py-2.5 rounded-xl border border-slate-200 focus:outline-none focus:border-sky-500 font-mono">
@foreach($backups as $b)
<option value="{{ $b['filename'] }}">{{ $b['filename'] }} ({{ $b['size_human'] ?? '' }})</option>
@endforeach
</select>
<button type="button" onclick="inspectSelectedServerBackup()" class="px-4 py-2.5 bg-sky-600 hover:bg-sky-700 text-white rounded-xl text-xs font-semibold transition shrink-0">
Periksa Arsip
</button>
</div>
@else
<div class="p-4 rounded-xl bg-slate-50 border border-slate-200 text-center text-xs text-slate-500">
Tidak ada berkas backup fisik di storage server saat ini. Silakan gunakan tab <strong>"Upload File dari Komputer"</strong> untuk membaca backup dari PC Anda.
</div>
@endif
</div>
<!-- Panel 2: Upload dari Komputer (Zero Storage Retention) -->
<div id="panelInspectUpload" class="hidden space-y-3">
<div class="p-3 bg-emerald-50 border border-emerald-200 rounded-xl text-xs text-emerald-900">
💡 <strong>Bebas Kapasitas (0 B Storage):</strong> File yang Anda upload hanya dibaca di RAM/memori sementara dan langsung dihapus otomatis seketika setelah metadata selesai dibaca.
</div>
<div id="inspectUploadDropzone"
class="border-2 border-dashed border-slate-300 hover:border-sky-500 rounded-2xl p-6 text-center bg-slate-50 hover:bg-sky-50/20 transition cursor-pointer select-none"
onclick="document.getElementById('inspectFileInput').click()"
ondragover="handleDropzoneDragOver(event, this)"
ondragleave="handleDropzoneDragLeave(event, this)"
ondrop="handleInspectFileDrop(event, this)">
<p class="text-xs font-bold text-slate-800" id="inspectDropzonePrompt">Tarik &amp; Letakkan file .kmh di sini</p>
<p class="text-[11px] text-slate-400 mt-1">atau <span class="text-sky-600 font-semibold underline">klik untuk memilih dari komputer Anda</span></p>
<p class="text-[10px] text-slate-400 mt-1.5">Mendukung format .kmh terenkripsi (Maks. 500 MB)</p>
<input type="file" id="inspectFileInput" accept=".kmh" class="hidden" onchange="handleInspectFileInput(this)">
</div>
</div>
<!-- Loading Spinner State -->
<div id="inspectLoading" class="hidden py-8 text-center space-y-2">
<div class="inline-block w-8 h-8 border-3 border-sky-600 border-t-transparent rounded-full animate-spin"></div>
<p class="text-xs font-semibold text-slate-700" id="inspectLoadingText">Mendekripsi &amp; memeriksa integritas berkas .kmh...</p>
<p class="text-[11px] text-slate-400">Verifikasi tanda tangan HMAC SHA-256 &amp; membaca manifest database</p>
</div>
<!-- Error State -->
<div id="inspectError" class="hidden p-3.5 bg-rose-50 border border-rose-200 rounded-xl text-rose-900 text-xs font-medium">
<div class="flex items-center gap-2">
<span class="inline-block w-2 h-2 rounded-full bg-rose-500"></span>
<span id="inspectErrorMessage">Gagal membaca arsip.</span>
</div>
</div>
<!-- Result Card Container -->
<div id="inspectResult" class="hidden space-y-4 pt-2 border-t border-slate-100">
<!-- Result Header Bar -->
<div class="flex flex-wrap items-center justify-between gap-3 p-3.5 bg-slate-50 border border-slate-200 rounded-xl">
<div>
<div class="flex items-center gap-2">
<span class="font-mono font-bold text-xs text-slate-900" id="resFilename">rkm-backup.kmh</span>
<span class="px-2 py-0.5 rounded text-[10px] font-bold bg-sky-100 text-sky-800" id="resFileSize">12.5 MB</span>
</div>
<p class="text-[11px] text-slate-500 mt-0.5">Dibuat pada <strong id="resCreatedAt">-</strong> (<span id="resCreatedDiff">-</span>)</p>
</div>
<div class="flex items-center gap-1.5">
<span class="px-2.5 py-1 rounded-full text-[11px] font-bold bg-emerald-100 text-emerald-800 border border-emerald-200 inline-flex items-center gap-1">
🔒 <span id="resSecurity">AES-256-CBC Valid</span>
</span>
</div>
</div>
<!-- Grid Ringkasan -->
<div class="grid grid-cols-2 sm:grid-cols-4 gap-2.5 text-xs">
<div class="p-3 bg-white rounded-xl border border-slate-200">
<span class="text-[10px] uppercase font-bold text-slate-400 block">Tipe Backup</span>
<span class="font-semibold text-slate-800 block mt-1" id="resType">Backup Semua</span>
</div>
<div class="p-3 bg-white rounded-xl border border-slate-200">
<span class="text-[10px] uppercase font-bold text-slate-400 block">Database Asal</span>
<span class="font-semibold text-slate-800 block mt-1 font-mono" id="resDatabase">rkm_kmh</span>
</div>
<div class="p-3 bg-white rounded-xl border border-slate-200">
<span class="text-[10px] uppercase font-bold text-slate-400 block">Ukuran SQL Dump</span>
<span class="font-semibold text-slate-800 block mt-1" id="resSql">12 MB</span>
</div>
<div class="p-3 bg-white rounded-xl border border-slate-200">
<span class="text-[10px] uppercase font-bold text-slate-400 block">Berkas Media Foto</span>
<span class="font-semibold text-slate-800 block mt-1" id="resMedia">0 Berkas</span>
</div>
</div>
<!-- Daftar Tabel -->
<div class="bg-white rounded-xl border border-slate-200 p-3.5 space-y-2">
<div class="flex items-center justify-between">
<span class="text-xs font-bold text-slate-800">Daftar Tabel Terarsip (<span id="resTableCount">0</span> tabel):</span>
<span class="text-[11px] text-slate-400">Siap sinkron ke database</span>
</div>
<div id="resTableList" class="flex flex-wrap gap-1.5 max-h-40 overflow-y-auto p-1.5 bg-slate-50 rounded-lg border border-slate-100">
<!-- badges tabel -->
</div>
</div>
<!-- Action Footer -->
<div class="pt-3 border-t border-slate-100 flex items-center justify-between">
<span class="text-[11px] text-slate-500">
Status: <strong class="text-emerald-600">Arsip Sah &amp; Tidak Mengubah Data Aktif</strong>
</span>
<button type="button" id="btnProceedRestore" class="px-4 py-2 rounded-xl bg-amber-600 hover:bg-amber-700 text-white font-semibold text-xs transition shadow-xs inline-flex items-center gap-1.5">
Lanjutkan Pulihkan Sistem
</button>
</div>
</div>
</div>
<div class="px-6 py-3 bg-slate-50 border-t border-slate-100 flex items-center justify-end">
<button type="button" onclick="closeInspectModal()" class="px-4 py-2 rounded-xl border border-slate-200 bg-white hover:bg-slate-50 text-slate-700 font-semibold text-xs transition">
Tutup Pembaca
</button>
</div>
</div>
</div>
<!-- ========================================================================= -->
<!-- MODAL: KONFIRMASI HAPUS DARI SERVER -->
<!-- ========================================================================= -->
@@ -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 = '<span class="text-xs text-slate-400 italic">Daftar tabel tidak terdefinisi di manifest.</span>';
}
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');
}
</script>
@endsection
+2
View File
@@ -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');
+56
View File
@@ -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);
}
}