PDF Upload ve Senkronizasyon Entegrasyon Rehberi / PDF Upload and Synchronization Integration Guide

Bu rehber, herhangi bir modüle PDF dosya yükleme özelliği ve otomatik veritabanı eşleştirme (sync) altyapısının nasıl ekleneceğini açıklar. This guide explains how to add PDF file upload functionality and automatic database synchronization infrastructure to any module.

Genel Bakış / Overview

Sistem, yüklenen PDF dosyalarını isimlendirme kurallarına göre veritabanındaki kayıtlarla otomatik olarak eşleştirir. İşlem 4 ana adımdan oluşur: The system automatically matches uploaded PDF files with database records based on naming conventions. The process consists of 4 main steps:

Database Migration: download sütununun eklenmesi.
Module View: Arayüze yükleme butonu ve indirme linkinin eklenmesi.
Upload Handler: Dosya yüklendiğinde çalışacak tetikleyicinin (trigger) tanımlanması.
Sync Script: Dosya adı ile veritabanı kaydını eşleştiren mantığın kurulması.

Adım 1: Veritabanı Migration / Database Migration

İlgili modülün tablosuna download sütunu eklenmelidir. Add a download column to the module's table.

php artisan make:migration add_download_to_itps_table --table=i_t_p_s

public function up(): void
{
    Schema::table('i_t_p_s', function (Blueprint $table) {
        $table->string('download')->nullable();
    });
}

Adım 2: Modül Arayüzü / Module View

resources/views/admin/type/{module}.blade.php dosyasını düzenleyin. Edit the module's blade file.

a. Sütun Tanımı / Column Definition

$relationDatas dizisine download alanını ekleyin. Add the download field to $relationDatas.

$relationDatas = [
    'download' => [
        'type' => 'link-search',
        'html' => '<i class="fa fa-pdf"></i>'
    ],
    // ...
];

b. Blok Grubu / Block Group

$blockGroup dizisinde uygun yere (genellikle 'General Info') ekleyin. Add to $blockGroup array.

c. Yükleme Ayarları / Upload Configuration

Dosyanın en altına, PHP bloğunun içine yükleme ayarlarını ekleyin. Add upload settings inside the PHP block.

$firstUploadFolder = '004_QA/000_ITP/'; // Hedef klasör / Target folder
$firstUploadTitle = 'Upload PDF';
$uploadPermissionKey = 'itp_upload_permission';

d. Include Upload Component

Sayfanın HTML kısmına upload bileşenini dahil edin. Include the upload component in the HTML section.

<div class="content">
    <div class="row">   
        @include("admin.type.document.upload")  <!-- Add this line -->
        @include("components.blocks.module-block")     
    </div>
</div>

Adım 3: Yükleme İşleyicisi / Upload Handler

resources/views/admin-ajax/document-upload.blade.php dosyasını açın ve modülünüz için bir koşul ekleyin. Open document-upload.blade.php and add a condition for your module.

if ($tableName == "i_t_p_s") { // Tablo adı / Table name
    ?>
    @include("cron.pdf-db-itp-sync", [
        "fileName" => $onlyFileName
    ])
    <?php
}

Adım 4: Senkronizasyon Betiği / Sync Script

resources/views/cron/pdf-db-{module}-sync.blade.php dosyasını oluşturun. Bu dosya eşleştirme mantığını içerir. Create the sync script file. This file contains the matching logic.

Örnek / Example (ITP):

<?php 
$table = "i_t_p_s";
$mainPath = "004_QA/000_ITP";
$nullDownload = db($table);

// Tek dosya yüklendiğinde filtreleme / Filtering when single file uploaded
if(isset($fileName)) {
    // Eşleşecek sütun (örn: itp_no) / Matching column (e.g. itp_no)
    $nullDownload = $nullDownload->where("itp_no", $fileName);
    $commitSize = 1;
}

$nullDownload = $nullDownload->get();

DB::beginTransaction();
// ... (Standart döngü ve update işlemi / Standard loop and update process)
// Detaylar için mevcut sync dosyalarına bakınız / See existing sync files for details
?>

İpuçları / Tips

Wildcard Matching: Dosya adlarında / veya boşluk gibi karakterler farklılık gösterebilir. Sync scriptinde str_replace kullanarak bunları * ile değiştirmek eşleştirme başarısını artırır.
Permission: uploadPermissionKey tanımlamayı unutmayın, aksi halde yetki hatası alabilirsiniz.

4.2 KiB Raw Blame History Unescape Escape