@rglabs/butterfly 2.0.1 → 2.1.0

package/docs/butterfly_upload_api_docs-2.md

@@ -0,0 +1,255 @@
+# Butterfly Dosya Yükleme Dokümantasyonu
+
+## Genel Bakış
+
+Butterfly DXP'de dosya yükleme iki yöntemle yapılabilir:
+
+1. **Admin Panel Endpoint (Önerilen)** — Session-based auth, custom report sayfalarında ve admin panelinde kullanılır
+2. **REST API Endpoint** — Token-based auth, harici sistemler ve mobil uygulamalar için
+
+---
+
+## Yöntem 1: Admin Panel File Helper (Önerilen)
+
+Custom report sayfaları veya admin panelindeki JavaScript kodlarından dosya yüklemek için bu yöntem kullanılır. Kullanıcı zaten admin paneline giriş yaptığı için ek authentication gerekmez.
+
+### Endpoint
+
+```
+POST /admin/ajax/file_helper/upload_file?alias=ALIAS
+```
+
+### Parametreler
+
+| Parametre | Tip | Zorunlu | Açıklama |
+|-----------|-----|---------|----------|
+| `file_upload` | File | Evet | Yüklenecek dosya (input name **mutlaka** `file_upload` olmalı) |
+| `uuid` | String | Evet | Benzersiz tanımlayıcı (örn: `upload-` + timestamp) |
+| `original_filename` | String | Evet | Orijinal dosya adı |
+| `total_file_size` | Number | Evet | Dosya boyutu (bytes) |
+| `alias` | String | Evet | Storage alias (URL query parameter olarak gönderilir) |
+
+### Storage Alias Yapılandırması
+
+Alias'lar `cms_file_uploads` tablosunda tanımlıdır. Her alias şunları kontrol eder:
+- İzin verilen dosya uzantıları (`extensions` alanı, virgülle ayrılmış)
+- Maksimum dosya boyutu
+- Depolama konumu
+
+**Alias yönetimi:** Admin panel → File Storage menüsü veya `cms_file_uploads` tablosu üzerinden.
+
+**Yaygın alias'lar:**
+- `content` — Genel içerik (görsel, medya)
+- `import` — İçe aktarma dosyaları (varsayılan: json, xlsx, xls; ihtiyaca göre genişletilebilir)
+
+**Yeni uzantı eklemek için:**
+```bash
+butterfly-cli record edit cms_file_uploads --id <alias_id> --data '{"extensions": "mevcut,yeni,uzantilar"}'
+```
+
+### JavaScript Örneği (Custom Report Sayfası)
+
+```javascript
+function uploadFile(file) {
+  return new Promise(function(resolve, reject) {
+    var fd = new FormData();
+    fd.append('file_upload', file);
+    fd.append('uuid', 'upload-' + Date.now());
+    fd.append('original_filename', file.name);
+    fd.append('total_file_size', file.size);
+
+    $.ajax({
+      url: '/admin/ajax/file_helper/upload_file?alias=import',
+      type: 'POST',
+      data: fd,
+      processData: false,
+      contentType: false,
+      headers: { 'X-Requested-With': 'XMLHttpRequest' },
+      success: function(response) {
+        if (response.success && response.filename) {
+          resolve(response.filename);
+        } else {
+          rg_alert(response.message || 'Dosya yüklenemedi.');
+          reject('Upload failed');
+        }
+      },
+      error: function() {
+        rg_alert('Dosya yükleme sırasında hata oluştu.');
+        reject('Upload error');
+      }
+    });
+  });
+}
+```
+
+### Yanıt Formatı
+
+**Başarılı:**
+```json
+{
+  "success": true,
+  "filename": "dosya_adi_islenmis.jpg",
+  "full_path": "/storage/path/dosya_adi_islenmis.jpg"
+}
+```
+
+**Hata:**
+```json
+{
+  "success": false,
+  "message": "Dosya tipi izin verilmiyor."
+}
+```
+
+### Dosya Kaydı ile Entegrasyon (İki Aşamalı)
+
+Dosya yükleme ve kayıt oluşturma iki ayrı adımda yapılır:
+
+```javascript
+// 1. Dosyayı yükle → filename al
+var filename = await uploadFile(file);
+
+// 2. Kaydı oluştur, filename'i veri olarak gönder
+$.ajax({
+  url: '/admin/ajax/cms_object/operation?do=tablo_adi__add',
+  type: 'POST',
+  data: {
+    csrf_token: csrfToken,
+    parent_id: parentId,
+    dosya: filename,        // file_upload field'ın column adı
+    aciklama: 'Açıklama'
+  }
+});
+```
+
+### Object Spec Yapılandırması
+
+`file_upload` tipindeki field'ın `val_1` parametresi alias adını belirtir:
+
+```json
+{
+  "type": "file_upload",
+  "val_1": "import"
+}
+```
+
+### Dosya Önizleme Linki Oluşturma
+
+Upload edilen dosyalar veritabanında sadece **relative path** olarak saklanır (örn: `26-03/08/dosya.png`). Tam URL oluşturmak için alias'ın `path` değeri gerekir.
+
+**Twig'de base path'i al:**
+```twig
+{% set importAlias = db().table('cms_file_uploads').where('alias', 'import').first() %}
+{% set importBasePath = importAlias ? importAlias.path : '/static/import/' %}
+```
+
+**JS'e aktar:**
+```html
+<script>
+window._data = {
+  importBasePath: '{{ importBasePath }}'
+};
+</script>
+```
+
+**JS'de tam URL oluştur:**
+```javascript
+var basePath = data.importBasePath || '/static/import/';
+var fullUrl = basePath + record.dosya;
+// Örnek: /static/import/26-03/08/dosya.png
+```
+
+**Path yapısı:**
+- `cms_file_storages.base_url` → Storage base URL (örn: `/static`)
+- `cms_file_uploads.path` → Alias path (örn: `/static/import/`)
+- Veritabanındaki `dosya` değeri → Relative path (örn: `26-03/08/dosya.png`)
+- **Tam URL** = `cms_file_uploads.path` + `dosya` değeri
+
+### Önemli Notlar
+
+- **Input name:** Mutlaka `file_upload` olmalı, field'ın column adı (örn: `dosya`) DEĞİL
+- **Authentication:** Admin session cookie'leri otomatik gönderilir, ek header gerekmez
+- **Alias zorunlu:** URL'de `?alias=ALIAS` belirtilmeli, yoksa hata verir
+- **Tek dosya:** Bu endpoint tek seferde bir dosya yükler, birden fazla dosya için döngü kullanın
+- **Dosya uzantısı kontrol:** Alias'ta tanımlı uzantılarla eşleşmeyen dosyalar reddedilir
+- **Dosya linki:** Veritabanında sadece relative path saklanır, görüntülemek için alias path'i ile birleştirin
+
+---
+
+## Yöntem 2: REST API (Harici Sistemler İçin)
+
+Harici uygulamalar, mobil uygulamalar veya otomatik süreçler için REST API kullanılır.
+
+### Ön Gereksinimler
+
+1. **API Erişimi:** Admin panelinde kullanıcı profilinde "API Access" aktif edilmeli
+2. **API Key:** `/admin/user_auth/list` sayfasından API key oluşturulmalı
+
+### Authentication
+
+```bash
+# Token oluştur
+curl -X POST /rest/auth/generateToken \
+  -H "Content-Type: application/x-www-form-urlencoded" \
+  -d "api_key=YOUR_API_KEY&password=YOUR_PASSWORD"
+```
+
+**Yanıt:**
+```json
+{
+  "success": true,
+  "token": "session_token",
+  "expires_at": "2024-12-31 23:59:59"
+}
+```
+
+### Dosya Yükleme
+
+```bash
+curl -X POST /rest/upload/image \
+  -H "BUTTERFLY_API_KEY: api-key-here" \
+  -H "BUTTERFLY_ACCESS_TOKEN: access-token-here" \
+  -F "files[]=@/path/to/image.jpg" \
+  -F "alias=content" \
+  -F "sub_folder=gallery"
+```
+
+**Parametreler:**
+- `files[]` (file array, zorunlu): Yüklenecek dosyalar
+- `alias` (string, opsiyonel): Storage alias (varsayılan: 'content')
+- `sub_folder` (string, opsiyonel): Alt klasör
+
+**Yanıt:**
+```json
+{
+  "success": true,
+  "result": [
+    {
+      "full_path": "https://cdn.example.com/content/gallery/image.jpg",
+      "filename": "image.jpg",
+      "webp": "https://cdn.example.com/content/gallery/image.webp"
+    }
+  ]
+}
+```
+
+### REST API Hata Durumları
+
+| Hata | Açıklama |
+|------|----------|
+| `"invalid request"` | api_key veya password eksik |
+| `"invalid parameters"` | API key bulunamadı, API erişimi kapalı, yanlış şifre |
+| 401 Unauthorized | Geçersiz veya süresi dolmuş token |
+| 422 Unprocessable | Dosya tipi veya boyut sınırı aşıldı |
+
+---
+
+## Hangi Yöntemi Kullanmalı?
+
+| Senaryo | Yöntem |
+|---------|--------|
+| Custom report sayfasında dosya yükleme | Admin Panel (Yöntem 1) |
+| Object edit sayfasında file_upload field | Otomatik (Butterfly yönetir) |
+| Harici uygulama / mobil uygulama | REST API (Yöntem 2) |
+| Cron job / workflow / otomasyon | REST API (Yöntem 2) |
+| Admin paneli içi JavaScript | Admin Panel (Yöntem 1) |

package/docs/objects/listing-query.md

@@ -0,0 +1,78 @@
+# Object Listing Query
+
+Each object can have a `listing_query.bfy` file that customizes the listing page behavior and appearance.
+
+## File Location
+
+```
+butterfly-resources/objects/[butterfly|app]/[table_name]/listing_query.bfy
+```
+
+## Header Block
+
+Use the `{% block header %}` to display custom content at the top of the listing page, above the data table.
+
+### Basic Usage
+
+```twig
+{% block header %}
+  <div class="alert alert-info">
+    Custom content displayed at the top of the listing page
+  </div>
+{% endblock %}
+```
+
+### Example with Statistics
+
+```twig
+{% block header %}
+  {% set stats = db().table('orders').selectRaw('COUNT(*) as total, SUM(amount) as sum').first() %}
+  <div class="row mb-3">
+    <div class="col-md-4">
+      <div class="card">
+        <div class="card-body text-center">
+          <h5 class="card-title">Total Orders</h5>
+          <p class="display-6">{{ stats.total }}</p>
+        </div>
+      </div>
+    </div>
+    <div class="col-md-4">
+      <div class="card">
+        <div class="card-body text-center">
+          <h5 class="card-title">Total Amount</h5>
+          <p class="display-6">{{ stats.sum|number_format(2) }} TL</p>
+        </div>
+      </div>
+    </div>
+  </div>
+{% endblock %}
+```
+
+### Example with Filters
+
+```twig
+{% block header %}
+  <div class="card mb-3">
+    <div class="card-body">
+      <form method="get" class="row g-3">
+        <div class="col-md-3">
+          <label class="form-label">Status</label>
+          <select name="status" class="form-select">
+            <option value="">All</option>
+            <option value="active">Active</option>
+            <option value="inactive">Inactive</option>
+          </select>
+        </div>
+        <div class="col-md-3 d-flex align-items-end">
+          <button type="submit" class="btn btn-primary">Filter</button>
+        </div>
+      </form>
+    </div>
+  </div>
+{% endblock %}
+```
+
+## Related
+
+- [Objects Overview](./README.md)
+- [Creating Objects](./creating.md)

package/docs/pdf-generation.md

@@ -0,0 +1,376 @@
+# Butterfly PDF Oluşturma Dokümantasyonu
+
+## Genel Bakış
+
+Butterfly DXP, `pdf_templates` tablosundaki Twig şablonlarından PDF dosyaları oluşturmak için yerleşik bir PDF sistemi sunar. Sistem arka planda `https://pdf.butterfly.dev/get` adresindeki PDF sunucusunu kullanır.
+
+## Mimari
+
+```
+[İstek] → /pdf/create veya /pdf/view
+    → pdf_templates tablosundan şablon çek (system_name ile)
+    → Twig render (Input parametreleri değişken olarak geçer)
+    → HTML'i PDF sunucusuna gönder
+    → /create: PDF'i storage'a kaydet, dosya bilgisi dön
+    → /view: PDF'i tarayıcıda inline göster
+```
+
+## Endpoint'ler
+
+### 1. PDF Oluştur ve Kaydet (`/pdf/create`)
+
+PDF oluşturur, storage alias'a kaydeder, dosya bilgisi döner.
+
+**URL:** `POST /pdf/create`
+
+**Parametreler:**
+
+| Parametre | Tip | Zorunlu | Açıklama |
+|-----------|-----|---------|----------|
+| `template_name` | string | Evet | `pdf_templates.system_name` değeri |
+| `filename` | string | Hayır | Çıktı dosya adı (varsayılan: `document.pdf`) |
+| `alias` | string | Hayır | Storage alias (varsayılan: `pdf`) |
+| *diğer parametreler* | any | Hayır | Template'e değişken olarak geçer |
+
+**Başarılı Yanıt:**
+```json
+{
+  "success": true,
+  "full_path": "https://butterfly.rg/static/pdf/26-03/08/harcama-3.pdf",
+  "filename": "26-03/08/harcama-3.pdf"
+}
+```
+
+**Hata Yanıtları:**
+```json
+{"success": false, "message": "PDF tasarımı seçiniz."}
+{"success": false, "message": "PDF tasarımı bulunamadı."}
+{"success": false, "message": "Hata: ...twig render hatası..."}
+{"success": false, "message": "PDF oluşturulurken bir hata oluştu..."}
+```
+
+### 2. PDF Önizleme (`/pdf/view`)
+
+PDF oluşturur ve tarayıcıda inline gösterir (kaydetmez). Yazdır/önizleme için idealdir.
+
+**URL:** `GET /pdf/view`
+
+**Parametreler:** `/pdf/create` ile aynı. Ek olarak template'e `preview: true` değişkeni geçer.
+
+**Yanıt:** `Content-Type: application/pdf` ile doğrudan PDF binary.
+
+## pdf_templates Tablosu
+
+| Kolon | Açıklama |
+|-------|----------|
+| `system_name` | Şablonun benzersiz tanımlayıcısı (endpoint'ten `template_name` ile eşleşir) |
+| `name` | Şablon görünen adı |
+| `template` | Twig + HTML şablon içeriği |
+
+## Storage Alias Yapılandırması
+
+PDF dosyaları `cms_file_uploads` tablosundaki alias ayarına göre kaydedilir.
+
+**`pdf` alias yoksa oluştur:**
+```bash
+butterfly-cli record add cms_file_uploads --data '{
+  "alias": "pdf",
+  "path": "/static/pdf/",
+  "extensions": "pdf",
+  "cms_file_storage_id": 1
+}'
+```
+
+Kayıtlı PDF'lerin tam URL'i: `cms_file_uploads.path` + `response.filename`
+Örnek: `/static/pdf/` + `26-03/08/harcama-3.pdf` = `/static/pdf/26-03/08/harcama-3.pdf`
+
+## Şablon Yazma Kuralları
+
+### Permission Bypass (KRİTİK)
+
+`/pdf/create` ve `/pdf/view` endpoint'leri admin context dışında çalışır. Standart `db().table()` çağrıları permission hatası verir:
+
+```
+"You don't have permission to view TABLE_NAME object"
+```
+
+**Çözüm:** `db('default', false)` kullan — ikinci parametre `false` permission kontrolünü devre dışı bırakır.
+
+```twig
+{# ❌ YANLIŞ — permission hatası verir #}
+{% set r = db().table('tablo').where('id', id).first() %}
+
+{# ✅ DOĞRU — permission bypass #}
+{% set r = db('default', false).table('tablo').where('id', id).first() %}
+```
+
+> **Not:** Bu sadece PDF template'lerinde kullanılmalıdır. Normal report/object kodlarında standart `db()` kullanmaya devam edin.
+
+### Değişken Erişimi
+
+Template'e gönderilen tüm parametreler doğrudan Twig değişkeni olarak erişilebilir:
+
+```
+POST /pdf/create?template_name=sablonAdi&id=5&extra_param=deger
+```
+
+Template içinde:
+```twig
+{{ id }}          {# 5 #}
+{{ extra_param }} {# deger #}
+```
+
+### Inline CSS Zorunluluğu
+
+PDF sunucusu harici CSS dosyalarını yüklemez. **Tüm stiller `<style>` etiketi içinde veya inline olmalıdır.**
+
+```html
+{# ❌ YANLIŞ — PDF'te çalışmaz #}
+<link href="https://cdn.jsdelivr.net/npm/tailwindcss..." rel="stylesheet">
+
+{# ✅ DOĞRU #}
+<style>
+  body { font-family: Arial, sans-serif; font-size: 12px; }
+  .section { background: #f3f4f6; padding: 6px 12px; font-weight: 700; }
+  table { width: 100%; border-collapse: collapse; }
+</style>
+```
+
+### Temel Şablon Yapısı
+
+```html
+<html>
+<head>
+  <meta charset="utf-8">
+  <style>
+    body { font-family: Arial, sans-serif; font-size: 12px; color: #333; margin: 20px 40px; }
+    h1 { font-size: 18px; text-align: center; }
+    .section { background: #f3f4f6; padding: 6px 12px; font-weight: 700; font-size: 13px;
+               border-left: 4px solid #ef4444; margin: 14px 0 8px; }
+    table { width: 100%; border-collapse: collapse; margin-bottom: 10px; }
+    .info-table td { padding: 4px 8px; font-size: 12px; }
+    .info-table .lbl { font-weight: 600; width: 140px; color: #555; }
+    .data-table th { background: #f3f4f6; padding: 6px 8px; text-align: left; font-size: 11px;
+                     font-weight: 700; border: 1px solid #d1d5db; }
+    .data-table td { padding: 5px 8px; border: 1px solid #d1d5db; font-size: 11px; }
+    .footer { margin-top: 20px; border-top: 1px solid #d1d5db; padding-top: 8px;
+              font-size: 10px; color: #999; text-align: center; }
+  </style>
+</head>
+<body>
+  {% set r = db('default', false).table('ana_tablo').where('id', id).first() %}
+  {% if r is empty %}
+    <p>Kayıt bulunamadı.</p>
+  {% else %}
+    {% set children = db('default', false).table('child_tablo').where('parent_id', id).get() %}
+
+    <h1>BAŞLIK</h1>
+
+    <div class="section">Bilgiler</div>
+    <table class="info-table">
+      <tr><td class="lbl">Alan Adı</td><td>{{ r.alan_adi }}</td></tr>
+    </table>
+
+    {% if children|length > 0 %}
+      <div class="section">Alt Kayıtlar</div>
+      <table class="data-table">
+        <tr><th>Kolon 1</th><th>Kolon 2</th></tr>
+        {% for c in children %}
+          <tr><td>{{ c.kolon1 }}</td><td>{{ c.kolon2 }}</td></tr>
+        {% endfor %}
+      </table>
+    {% endif %}
+
+    <div class="footer">Bu belge sistem tarafından otomatik oluşturulmuştur.</div>
+  {% endif %}
+</body>
+</html>
+```
+
+## Entegrasyon Örnekleri
+
+### Custom Report Sayfasından Yazdır Butonu
+
+**HTML (query_code.bfy):**
+```html
+{% if isEdit %}
+  <button onclick="printPdf()">
+    <i class="fas fa-print mr-1"></i> Yazdır
+  </button>
+{% endif %}
+```
+
+**JS (script.js):**
+```javascript
+function printPdf() {
+  if (!data.isEdit || !data.recordId) {
+    rg_alert('Lütfen önce formu kaydediniz.');
+    return;
+  }
+  window.open('/pdf/view?template_name=SABLON_ADI&id=' + data.recordId
+    + '&filename=dosya-' + data.recordId + '.pdf', '_blank');
+}
+```
+
+### PDF Oluştur ve Kayda Yaz
+
+Formu göndermeden önce PDF oluşturup dosya yolunu ana kayda yazmak için:
+
+```javascript
+function createPdf(recordId) {
+  return new Promise(function(resolve, reject) {
+    $.ajax({
+      url: '/pdf/create',
+      type: 'POST',
+      data: {
+        template_name: 'SABLON_ADI',
+        id: recordId,
+        filename: 'dosya-' + recordId + '.pdf',
+        alias: 'pdf'
+      },
+      headers: { 'X-Requested-With': 'XMLHttpRequest' },
+      success: function(response) {
+        if (response.success && response.filename) {
+          var pdfPath = response.full_path || '/static/pdf/' + response.filename;
+          // PDF yolunu ana kayda yaz
+          $.ajax({
+            url: '/admin/ajax/cms_object/operation?do=TABLO__edit',
+            type: 'POST',
+            data: { csrf_token: csrfToken, id: recordId, pdf_dosya: pdfPath },
+            headers: { 'X-Requested-With': 'XMLHttpRequest' },
+            success: function() { resolve(pdfPath); },
+            error: function() { resolve(pdfPath); }
+          });
+        } else {
+          rg_alert(response.message || 'PDF oluşturulamadı.');
+          reject('PDF failed');
+        }
+      },
+      error: function() {
+        rg_alert('PDF oluşturma sırasında hata oluştu.');
+        reject('PDF error');
+      }
+    });
+  });
+}
+```
+
+### State Machine Transition ile PDF Link'ini E-postaya Ekle
+
+PDF dosyası JS tarafında oluşturulup `pdf_dosya` field'ına yazıldıktan sonra, transition action_code'unda bu değer okunabilir:
+
+```twig
+{# action_code.bfy #}
+{% set tpl = db().table('cms_email_templates').where('alias', 'template-alias').first() %}
+{% set pdfDosya = getValue('pdf_dosya') %}
+{% set vars = {
+  'talep_no': getValue('talep_no'),
+  'ad_soyad': getValue('ad_soyad'),
+  'pdf_link': pdfDosya
+    ? '<p><strong>PDF Doküman:</strong> <a href="' ~ pdfDosya ~ '" style="color:#3b82f6;">Formu İndir</a></p>'
+    : ''
+} %}
+{% set replacements = {} %}
+{% for key, val in vars %}
+  {% set replacements = replacements|merge({('{{ ' ~ key ~ ' }}'): val}) %}
+{% endfor %}
+{{ sendEmail(recipient, tpl.subject|replace(replacements), tpl.content|replace(replacements)) }}
+```
+
+E-posta template'ine `{{ pdf_link }}` placeholder'ı eklemeyi unutmayın.
+
+### Tipik Akış (Kaydet → PDF → Gönder)
+
+```javascript
+function submitForm() {
+  rg_confirm('Göndermek istediğinize emin misiniz?', function() {
+    saveForm().then(function(recordId) {           // 1. Formu kaydet
+      return createPdf(recordId).then(function() { // 2. PDF oluştur + kayda yaz
+        return triggerTransition(recordId, transitionId); // 3. Transition tetikle
+      });
+    }).then(function() {
+      window.location.href = '/admin/cms_report/view/DASHBOARD_ID';
+    });
+  });
+}
+```
+
+## Sıfırdan PDF Entegrasyonu Adımları
+
+### 1. Storage Alias Oluştur (bir kez)
+
+```bash
+butterfly-cli record add cms_file_uploads --data '{
+  "alias": "pdf",
+  "path": "/static/pdf/",
+  "extensions": "pdf",
+  "cms_file_storage_id": 1
+}'
+```
+
+### 2. pdf_templates Objesi Oluştur (bir kez)
+
+Eğer `pdf_templates` objesi yoksa:
+
+```bash
+# Object
+butterfly-cli record add objects --data '{
+  "table_name": "pdf_templates",
+  "name": "PDF Şablonları",
+  "has_item": 0,
+  "auto_increment_column_name": "id"
+}'
+# Object ID'yi not al, aşağıda OBJECT_ID olarak kullan
+
+# Field'lar
+butterfly-cli record add object_specs --data '{"object_id":OBJECT_ID,"name":"System Name","column_name":"system_name","type":"string","required":1,"list_column":1,"edit_order_no":1}'
+butterfly-cli record add object_specs --data '{"object_id":OBJECT_ID,"name":"Şablon Adı","column_name":"name","type":"string","required":1,"list_column":1,"edit_order_no":2}'
+butterfly-cli record add object_specs --data '{"object_id":OBJECT_ID,"name":"HTML Şablon","column_name":"template","type":"code","edit_order_no":3}'
+```
+
+### 3. Şablon Kaydı Ekle
+
+```bash
+butterfly-cli record add pdf_templates --data '{
+  "system_name": "sablonun-adi",
+  "name": "Şablonun Görünen Adı",
+  "template": "<html>...şablon HTML...</html>"
+}'
+```
+
+### 4. Ana Tabloya `pdf_dosya` Field Ekle (opsiyonel)
+
+PDF dosya yolunu kayıtta saklamak istiyorsan:
+
+```bash
+butterfly-cli record add object_specs --data '{
+  "object_id": ANA_OBJECT_ID,
+  "name": "PDF Dosya",
+  "column_name": "pdf_dosya",
+  "type": "string",
+  "edit_order_no": 99
+}'
+```
+
+### 5. JS Fonksiyonlarını Ekle
+
+`printPdf()` ve `createPdf()` fonksiyonlarını script.js'e ekle (yukarıdaki örneklere bakın).
+
+### 6. Yazdır Butonunu Forma Ekle
+
+```html
+{% if isEdit %}
+  <button onclick="printPdf()"><i class="fas fa-print mr-1"></i> Yazdır</button>
+{% endif %}
+```
+
+## Sık Karşılaşılan Hatalar
+
+| Hata | Neden | Çözüm |
+|------|-------|-------|
+| `"PDF tasarımı bulunamadı."` | `template_name` ile eşleşen `system_name` yok | `pdf_templates` tablosunu kontrol et |
+| `"You don't have permission to view X object"` | Template'te `db()` kullanılmış | `db('default', false)` kullan |
+| PDF oluştu ama değerler boş | Template'e parametre geçilmemiş veya `db()` sorgusu hatalı | `id` parametresinin gönderildiğini ve sorgunun doğru olduğunu kontrol et |
+| PDF sunucu hatası (HTTP != 200) | HTML geçersiz veya PDF sunucusu erişilemiyor | HTML'i `/pdf/view` ile test et, hata mesajını incele |
+| Stiller PDF'te görünmüyor | Harici CSS kullanılmış | Tüm stilleri `<style>` etiketi içine al, inline CSS kullan |
+| `"Sayfa Bulunamadı"` | `/admin/pdf/create` veya `/admin/ajax/pdf/create` kullanılmış | Doğru URL: `/pdf/create` (admin prefix'siz) |