First commit
This commit is contained in:
Saufi
105
app/Actions/Document/CreateDocumentAction.php
Normal file
105
app/Actions/Document/CreateDocumentAction.php
Normal file
@@ -0,0 +1,105 @@
|
||||
<?php
|
||||
|
||||
namespace App\Actions\Document;
|
||||
|
||||
use App\Jobs\ProcessUploadedDocumentJob;
|
||||
use App\Models\Document;
|
||||
use App\Models\DocumentVersion;
|
||||
use App\Services\KnowledgeBase\AuditService;
|
||||
use Illuminate\Http\UploadedFile;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use Illuminate\Support\Facades\Hash;
|
||||
use Illuminate\Support\Facades\Storage;
|
||||
use Illuminate\Support\Str;
|
||||
use RuntimeException;
|
||||
|
||||
/**
|
||||
* CreateDocumentAction
|
||||
*
|
||||
* Tanggungjawab: Simpan dokumen baru + versi pertama + dispatch job.
|
||||
* Dipanggil oleh DocumentController@store.
|
||||
*/
|
||||
class CreateDocumentAction
|
||||
{
|
||||
public function __construct(
|
||||
private readonly AuditService $auditService
|
||||
) {}
|
||||
|
||||
/**
|
||||
* @param array $data Data dari StoreDocumentRequest
|
||||
* @param UploadedFile $file Fail PDF yang diupload
|
||||
* @return Document
|
||||
* @throws RuntimeException
|
||||
*/
|
||||
public function execute(array $data, UploadedFile $file): Document
|
||||
{
|
||||
// Semak duplicate (hash yang sama dalam kategori yang sama)
|
||||
$fileHash = hash_file('sha256', $file->getRealPath());
|
||||
$existing = DocumentVersion::where('file_hash', $fileHash)->first();
|
||||
|
||||
if ($existing) {
|
||||
throw new RuntimeException(
|
||||
"Fail ini sudah pernah diupload. Sila semak dokumen: " .
|
||||
$existing->document->title
|
||||
);
|
||||
}
|
||||
|
||||
return DB::transaction(function () use ($data, $file, $fileHash) {
|
||||
// ── Buat rekod dokumen ────────────────────────────────────────
|
||||
$document = Document::create([
|
||||
'category_id' => $data['category_id'],
|
||||
'title' => $data['title'],
|
||||
'description' => $data['description'] ?? null,
|
||||
'status' => Document::STATUS_PROCESSING,
|
||||
'is_active' => false,
|
||||
'effective_date' => $data['effective_date'] ?? null,
|
||||
'expiry_date' => $data['expiry_date'] ?? null,
|
||||
'tags' => $data['tags'] ?? [],
|
||||
'language' => $data['language'] ?? 'ms',
|
||||
'created_by' => auth()->id(),
|
||||
'updated_by' => auth()->id(),
|
||||
]);
|
||||
|
||||
// ── Simpan fail PDF ────────────────────────────────────────────
|
||||
$storedPath = $this->storePdf($file, $document->id, 1);
|
||||
|
||||
// ── Buat rekod versi ──────────────────────────────────────────
|
||||
$version = DocumentVersion::create([
|
||||
'document_id' => $document->id,
|
||||
'version_number' => 1,
|
||||
'original_filename' => $file->getClientOriginalName(),
|
||||
'stored_path' => $storedPath,
|
||||
'mime_type' => $file->getMimeType(),
|
||||
'file_size' => $file->getSize(),
|
||||
'file_hash' => $fileHash,
|
||||
'processing_status' => DocumentVersion::STATUS_PENDING,
|
||||
'is_current' => true,
|
||||
'change_notes' => $data['change_notes'] ?? 'Versi pertama.',
|
||||
'uploaded_by' => auth()->id(),
|
||||
]);
|
||||
|
||||
// ── Audit log ─────────────────────────────────────────────────
|
||||
$this->auditService->documentUploaded($document, $version);
|
||||
|
||||
// ── Dispatch job ke queue ─────────────────────────────────────
|
||||
ProcessUploadedDocumentJob::dispatch($version->id);
|
||||
|
||||
return $document->load('currentVersion');
|
||||
});
|
||||
}
|
||||
|
||||
private function storePdf(UploadedFile $file, int $documentId, int $versionNumber): string
|
||||
{
|
||||
$disk = config('knowledgebase.upload.storage_disk', 'local');
|
||||
$folder = "documents/{$documentId}/v{$versionNumber}";
|
||||
$filename = Str::uuid() . '.pdf';
|
||||
|
||||
$path = $file->storeAs($folder, $filename, $disk);
|
||||
|
||||
if (!$path) {
|
||||
throw new RuntimeException('Gagal simpan fail PDF ke storage.');
|
||||
}
|
||||
|
||||
return $path;
|
||||
}
|
||||
}
|
||||
83
app/Actions/Document/UploadNewVersionAction.php
Normal file
83
app/Actions/Document/UploadNewVersionAction.php
Normal file
@@ -0,0 +1,83 @@
|
||||
<?php
|
||||
|
||||
namespace App\Actions\Document;
|
||||
|
||||
use App\Jobs\ProcessUploadedDocumentJob;
|
||||
use App\Models\Document;
|
||||
use App\Models\DocumentVersion;
|
||||
use App\Services\KnowledgeBase\AuditService;
|
||||
use Illuminate\Http\UploadedFile;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use Illuminate\Support\Facades\Storage;
|
||||
use Illuminate\Support\Str;
|
||||
use RuntimeException;
|
||||
|
||||
/**
|
||||
* UploadNewVersionAction
|
||||
*
|
||||
* Upload versi baru untuk dokumen yang sedia ada.
|
||||
* Versi lama TIDAK dipadam — kekal dalam storage dan MySQL.
|
||||
* Chunk versi lama akan di-deactivate (bukan delete) semasa ingestion.
|
||||
*/
|
||||
class UploadNewVersionAction
|
||||
{
|
||||
public function __construct(
|
||||
private readonly AuditService $auditService
|
||||
) {}
|
||||
|
||||
public function execute(Document $document, UploadedFile $file, array $data): DocumentVersion
|
||||
{
|
||||
$fileHash = hash_file('sha256', $file->getRealPath());
|
||||
|
||||
// Semak sama ada hash sama dengan versi semasa
|
||||
$currentVersion = $document->currentVersion;
|
||||
if ($currentVersion && $currentVersion->file_hash === $fileHash) {
|
||||
throw new RuntimeException(
|
||||
'Fail ini sama dengan versi semasa. Tiada perubahan.'
|
||||
);
|
||||
}
|
||||
|
||||
return DB::transaction(function () use ($document, $file, $fileHash, $data) {
|
||||
$newVersionNumber = $document->getLatestVersionNumber() + 1;
|
||||
|
||||
// ── Simpan fail baru ──────────────────────────────────────────
|
||||
$disk = config('knowledgebase.upload.storage_disk', 'local');
|
||||
$folder = "documents/{$document->id}/v{$newVersionNumber}";
|
||||
$filename = Str::uuid() . '.pdf';
|
||||
$path = $file->storeAs($folder, $filename, $disk);
|
||||
|
||||
if (!$path) {
|
||||
throw new RuntimeException('Gagal simpan fail PDF ke storage.');
|
||||
}
|
||||
|
||||
// ── Buat rekod versi baru ─────────────────────────────────────
|
||||
$version = DocumentVersion::create([
|
||||
'document_id' => $document->id,
|
||||
'version_number' => $newVersionNumber,
|
||||
'original_filename' => $file->getClientOriginalName(),
|
||||
'stored_path' => $path,
|
||||
'mime_type' => $file->getMimeType(),
|
||||
'file_size' => $file->getSize(),
|
||||
'file_hash' => $fileHash,
|
||||
'processing_status' => DocumentVersion::STATUS_PENDING,
|
||||
'is_current' => false, // akan di-set current semasa ingestion
|
||||
'change_notes' => $data['change_notes'] ?? null,
|
||||
'uploaded_by' => auth()->id(),
|
||||
]);
|
||||
|
||||
// Kemaskini status dokumen ke processing
|
||||
$document->update([
|
||||
'status' => Document::STATUS_PROCESSING,
|
||||
'updated_by' => auth()->id(),
|
||||
]);
|
||||
|
||||
// ── Audit log ─────────────────────────────────────────────────
|
||||
$this->auditService->documentUploaded($document, $version);
|
||||
|
||||
// ── Dispatch job ──────────────────────────────────────────────
|
||||
ProcessUploadedDocumentJob::dispatch($version->id);
|
||||
|
||||
return $version;
|
||||
});
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user