# Arka Plan İşleri

Senkronizasyon ve aktarım işlerinin durumu
Kaynak: https://selwise.com/docs/operations/background-jobs

Arka planda çalışan işlerin durumu: besleme senkronu, arama indeksi, geçmiş veri aktarımı ve dışa aktarmalar. Bu ekran bir **izleme** ekranıdır: iş başlatmaz ve iptal etmez; yalnızca bitmiş bir işi **yeniden dener**.

## Panelde nerede

- Sol menüde **Ayarlar → Arka Plan İşleri** (Settings → Background Jobs) (`/dashboard/background-jobs`). Tüm roller açabilir; ama hangi işleri gördüğünüz yetkinize bağlıdır (aşağıda).
- Üst çubuktaki **çan** simgesi, aynı işlerin kısa listesidir — bkz. [Üst Çubuk ve Kısayollar](/docs/dashboard/shell#arka-plan-işleri-çanı).

Liste **seçili kanala** aittir: üstteki seçicide kanalı değiştirdiğinizde işler de değişir.

## Hangi işler görünür

| İş (EN) | Ne zaman oluşur | Görmek için yetki |
|---|---|---|
| **Feed Sync** | Ürün beslemesini senkronladığınızda ya da zamanlanmış senkron çalıştığında | Besleme senkronu (yalnızca `admin`) |
| **Search Reindex** | Arama indeksi yeniden kurulduğunda | Arama ayarı (yalnızca `admin`) |
| **Consent Export** | Çerez onayı raporunu dışa aktardığınızda | Analitik görüntüleme (her iki rol) |
| **Journey Export** | Müşteri yolu raporunu dışa aktardığınızda | Analitik görüntüleme (her iki rol) |
| Geçmiş veri aktarımı (`data_import.run`) | [Geçmiş Veri](/docs/data-import/overview) ekranında bir dosya ya da URL ile doğrulama ya da aktarım başlattığınızda | Veri aktarımı (yalnızca `admin`) |

`marketing` rolü yalnızca kendi yetkisi olan türleri (iki dışa aktarma) görür. **Segment hesaplama, öneri hazırlığı ve geçmiş veri ısıtması** bu listede iş olarak görünmez; segment üyelikleri ve ısıtma kendi ekranlarında ilerler.

## Durumlar

| Durum (EN) | Anlamı |
|---|---|
| **Pending** / **Waiting** (Bekliyor) | Kuyrukta, henüz başlamadı. Listede ve özet kartında birlikte "Waiting" sayılır. |
| **Processing** (İşleniyor) | Çalışıyor; ilerleme çubuğu yüzdeyi gösterir. |
| **Completed** (Tamamlandı) | Başarıyla bitti. Sonucu indirilebilir bir iş varsa **Download Result** çıkar. |
| **Failed** (Başarısız) | Hata verdi; hata mesajı kırmızı kutuda yazar. |

Sayfanın üstünde beş kart vardır: **Processing**, **Waiting**, **Completed**, **Failed** sayıları ve **Updated** (en son güncellenen işin zamanı). Bir sayı "—" ise özet okunamamıştır; sıfır değildir. Varsayılan filtre **Processing**; **Completed**, **Failed** ve **All** filtreleri ve bir arama kutusu vardır (iş adı, mesaj ya da durum içinde arar).

## İş detayı

Bir işe tıklayınca ayrıntı sayfası açılır: durum mesajı, ilerleme, ve **Details** bölümünde **Created**, **Updated**, **Started At**, **Completed At**, **Retry Count** (örneğin `1 / 3`) ve **Result Available**. Hata varsa kırmızı **Error** kutusu işin hata koduna göre açıklayıcı bir cümle yazar:

| Hata kodu | Anlamı | Ne yapmalı |
|---|---|---|
| `FEED_SYNC_FAILED` | Ürün beslemesi okunamadı | Ayrıntıdaki nedeni okuyup beslemeyi düzeltin ve yeniden senkronlayın — [Besleme Sorunları](/docs/product-feeds/troubleshooting) |
| `DATA_IMPORT_FAILED` | Aktarım tamamlanamadı | Dosyayı düzeltip yeniden yükleyin — [Doğrulama ve Uygulama](/docs/data-import/validate-and-apply) |
| `ANALYTICS_EXPORT_FAILED` | Dışa aktarma hazırlanamadı | Kısa süre sonra yeniden deneyin |
| `SEARCH_REINDEX_FAILED` | Arama indeksi kurulamadı | Kısa süre sonra yeniden deneyin |
| `QUEUE_ENQUEUE_FAILED` | İş kuyruğa alınamadı | Kısa süre sonra yeniden deneyin |
| `JOB_TIMEOUT` | İş süre sınırını aştı ve durduruldu | Kapsamı küçültüp yeniden deneyin; sürerse destekle konuşun |
| `STALE_WAITING` | İş kuyrukta çok uzun beklediği için iptal edildi | Yeniden başlatın; sürerse destekle konuşun |

## Yeniden deneme ve kendi kendine toparlanma

- **Retry** yalnızca **Failed** durumdaki işte vardır; işi yeniden kuyruğa alır ve **Retry Count**'u bir artırır. Başka durumdaki işi yeniden deneyemezsiniz.
- Her işin en fazla **3 deneme** hakkı vardır. Kuyruk, hata veren işi bu haklar bitene kadar kendiliğinden yeniden dener (ilk bekleme yaklaşık 30 saniye, sonra katlanarak artar); **Failed** gördüğünüzde bu denemeler tükenmiştir.
- Bir iş **10 dakika** boyunca hiç sinyal vermezse (işçi süreç durduysa) kendiliğinden yeniden kuyruğa alınır; deneme hakkı bittiyse **Failed** olur. Kuyrukta **45 dakikadan** uzun bekleyen iş `STALE_WAITING` ile başarısız sayılır. Bu kontrol dakikada bir çalışır.
- Süre sınırı işe göre değişir (geçmiş veri aktarımı için varsayılan bir saat).
- **İptal** düğmesi yoktur: çalışan bir işi durduramazsınız.

## Saklama

Tamamlanan ya da başarısız olan işler ve sonuç dosyaları **30 gün** sonra silinir (günlük bir temizlik işiyle); bir sonuç dosyasının kendi süresi bundan önce dolarsa dosya daha erken de kalkabilir. Bir dışa aktarmayı 30 günden sonra indirmeniz gerekiyorsa yeniden üretin.

## Ne zaman bakılır

| Belirti | Neden buraya bakın |
|---|---|
| Ürün listesi güncellenmiyor | **Feed Sync** işi çalışıyor mu, hata veriyor mu |
| Geçmiş veri aktarımı bitmedi | Aktarım işi hangi aşamada, ilerleme yüzdesi nedir |
| Dışa aktarma dosyası gelmedi | **Consent Export** / **Journey Export** tamamlandı mı, **Download Result** var mı |
| Sürekli "Waiting" | Kuyruk yoğun olabilir; 45 dakikayı geçerse otomatik başarısız olur ve **Retry** çıkar |

## Boş görünüyorsa

- **"No background jobs found"** — seçili kanalda henüz iş yok, ya da rolünüzün görebildiği türde iş yok (`marketing` için besleme ve aktarım işleri görünmez).
- **Beklediğiniz işi bulamıyorsunuz** — kanal seçicinin doğru kanalda olduğundan ve filtrenin **All** olduğundan emin olun; 30 günden eski işler silinmiş olabilir.
- **Kartlar "—" gösteriyor** — özet isteği başarısız; sayfadaki **Retry** ile yeniden okutun.

## Sırada ne var

- [Besleme Sorunları](/docs/product-feeds/troubleshooting)
- [Geçmiş Veri Aktarımı](/docs/data-import/overview)