> ## Documentation Index
> Fetch the complete documentation index at: https://wiki.nodx.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Test ve sorun giderme

> FiveM Web Panel test durumları, hata anlamları ve çözüm adımları

Paneldeki **Test et** butonu, bir özelliğin neden çalışmadığını anlamanın en hızlı yoludur. Test sonucu sadece başarılı veya başarısız demez; hangi adımda sorun olduğunu da gösterir.

## Test durumları

| Durum                     | Anlamı                                      | Ne yapmalısın?                                                                |
| ------------------------- | ------------------------------------------- | ----------------------------------------------------------------------------- |
| `success`                 | Test başarılı                               | Entegrasyonu aktif kullanabilirsin                                            |
| `capability_not_synced`   | Sunucu bu özelliği panele henüz bildirmemiş | Plugin bağlantısını ve son bağlantı zamanını kontrol et, sonra tekrar test et |
| `resource_not_started`    | İlgili resource çalışmıyor                  | Sunucuda paketin aktif olduğundan emin ol                                     |
| `export_not_found`        | Girilen export bulunamadı                   | Export adını ve resource adını kontrol et                                     |
| `action_name_required`    | Action adı boş                              | Entegrasyon ayarında action adını doldur                                      |
| `sql_query_required`      | Database action için sorgu eksik            | Database ayarını tamamla                                                      |
| `database_bridge_missing` | Database bağlantı katmanı hazır değil       | Database entegrasyonunu kontrol et                                            |
| `test_timeout`            | Test süresi doldu                           | Sunucu bağlantısı, yoğunluk ve action cevabını kontrol et                     |
| `unauthorized`            | Yetki yok                                   | Panel rolünü veya sunucu lisans eşleşmesini kontrol et                        |

## `capability_not_synced` nedir?

Bu durum, panelin ilgili özelliği sunucudan henüz doğrulamadığını söyler.

Genelde şu durumlarda görülür:

| Neden                    | Çözüm                               |
| ------------------------ | ----------------------------------- |
| Plugin yeni başladı      | Biraz bekle ve tekrar test et       |
| Resource restartlandı    | Son bağlantı zamanını kontrol et    |
| Yeni entegrasyon eklendi | Health check çalıştır               |
| Yanlış sunucu seçildi    | Sunucu seçiciden doğru sunucuyu seç |
| Lisans eşleşmedi         | Sunucu lisans durumunu kontrol et   |

<Tip>
  Bu hata çoğu zaman kalıcı bir arıza değildir. Panelin sunucudan güncel capability bilgisini alması gerekir.
</Tip>

## Canlı görüntü gelmiyor

Panelde şu mesajı görüyorsan canlı görüntü henüz panele ulaşmamıştır:

> Canlı görüntü henüz gelmedi. screenshot-basic çalışıyor olmalı ve oyuncu client'ı API'ye erişebilmelidir.

Kontrol listesi:

| Kontrol                      | Açıklama                                     |
| ---------------------------- | -------------------------------------------- |
| Oyuncu online mı?            | Offline oyuncudan görüntü alınamaz           |
| Doğru oyuncu ID mi?          | ID restart sonrası değişebilir               |
| Doğru sunucu seçili mi?      | Yanlış sunucuda görüntü beklenmez            |
| Screenshot desteği aktif mi? | Sunucuda screenshot altyapısı çalışmalı      |
| Plugin panele erişiyor mu?   | Son bağlantı ve health check başarılı olmalı |
| Tarayıcı hatası var mı?      | CORS veya 404 varsa destek ekibine ilet      |

## Marketler boş görünüyor

| Belirti                          | Kontrol                                  |
| -------------------------------- | ---------------------------------------- |
| **Dükkan yok** yazıyor           | Market entegrasyonu aktif mi?            |
| Test başarısız                   | Action adı ve sonuç yolu doğru mu?       |
| Sunucuda market var, panelde yok | Doğru sunucu seçili mi?                  |
| Sadece bazı marketler yok        | Filtre veya sayfalama ayarını kontrol et |

## Kapı yok görünüyor

Kapı kilidi sayfasında **Kapı yok** yazıyorsa:

<Steps>
  <Step title="Kapı entegrasyonunu kontrol et">
    **Entegrasyonlar** sayfasında doorlock entegrasyonunun aktif olduğundan emin ol.
  </Step>

  <Step title="Test sonucunu incele">
    Export, event veya database testinde hangi adımın başarısız olduğunu kontrol et.
  </Step>

  <Step title="Sonuç yolunu doğrula">
    Kapı listesi farklı bir alan altında dönüyorsa sonuç yolu buna göre ayarlanmalıdır.
  </Step>

  <Step title="Sunucu seçimini kontrol et">
    Test sunucusu ve canlı sunucu karışmış olabilir.
  </Step>
</Steps>

## Envanter çalışmıyor

| Belirti             | Kontrol                                   |
| ------------------- | ----------------------------------------- |
| Envanter boş        | Oyuncu seçimi ve envanter paketi          |
| Item eklenmiyor     | Eşya verme capability aktif mi?           |
| Metadata görünmüyor | Paket metadata destekliyor mu?            |
| Test timeout        | Sunucu veya paket cevap vermiyor olabilir |

## Araçlar eksik görünüyor

| Belirti               | Kontrol                                  |
| --------------------- | ---------------------------------------- |
| Sadece model kodu var | Araç label katalogu eksik                |
| Addon araç yok        | Özel araç tanımı eklenmeli               |
| Garaj boş             | Sahiplik alanı mapping'i farklı olabilir |
| Görsel yok            | Araç görseli tanımlanmalı                |

## Destek ekibine iletirken

Sorun bildirirken şu bilgileri eklemen çözümü hızlandırır:

* Panel adresi: `https://fivem.nodx.org`
* Seçili sunucu adı
* Hangi sayfada sorun olduğu
* Test sonucundaki hata kodu
* İşlem yaptığın oyuncu ID veya entegrasyon adı
* Varsa tarayıcı konsolundaki hata
* Sorunun ne zaman başladığı