> ## 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.

# Entegrasyonlar

> FiveM script paketlerini Panel'e bağlama, doğrulama ve güvenli biçimde kullanma

**Entegrasyonlar** sayfası, sunucunda çalışan script paketleriyle NODX FiveM Web Panel arasındaki bağlantıyı yönetir. Panel bir resource'u otomatik algılayabilir veya sen özel bir entegrasyon ekleyebilirsin.

<Warning>
  Bir resource'un algılanması, o resource'un bütün Panel işlemlerini desteklediği anlamına gelmez. İlgili sayfanın açılması için doğru capability'lerin de hazır olması gerekir.
</Warning>

## Entegrasyon nasıl çalışır?

| Kavram         | Görevi                                                            |
| -------------- | ----------------------------------------------------------------- |
| Resource       | Sunucunda çalışan script paketidir                                |
| Kategori       | Resource'un EMS, banka, housing veya shop gibi kullanım alanıdır  |
| Capability     | Panel'in çağıracağı işlemin değişmeyen adıdır                     |
| Action mapping | Capability'nin resource üzerinde nasıl çalıştırılacağını belirler |
| Provider       | Otomatik algılanan aktif paketi gösterir                          |
| Test           | Resource, capability ve action bağlantısını doğrular              |

Örneğin sunucunda `ars_ambulancejob` algılanabilir. Bu durumda EMS sağlayıcısı görünür. Ancak **EMS** sayfasının personeli ve yaralı oyuncuları gösterebilmesi için `ems.staff.list` ve `ems.dead.list` capability'lerinin de çalışması gerekir.

## Rehberler

<Columns cols={2}>
  <Card title="Entegrasyon standardı" href="/fivem-web-panel/entegrasyon-standardi">
    Capability, action mapping, export, event, SQL, test ve güvenli yazma kuralları.
  </Card>

  <Card title="EMS ve ambulans" href="/fivem-web-panel/entegrasyon-ems">
    EMS personeli, yaralı oyuncular, diriltme ve özel ambulans paketleri.
  </Card>

  <Card title="Ekonomi ve işletmeler" href="/fivem-web-panel/entegrasyon-ekonomi">
    Marketler, banka hesapları, işlem geçmişi ve işletme yönetimi.
  </Card>

  <Card title="Dünya sistemleri" href="/fivem-web-panel/entegrasyon-dunya">
    Evler, kapı kilitleri, araç anahtarları, yakıt ve kıyafet sistemleri.
  </Card>

  <Card title="Oyuncu ve karakter" href="/fivem-web-panel/entegrasyon-oyuncu">
    Karakter, meslek, para, envanter, araç ve MDT işlemleri.
  </Card>

  <Card title="Özel paket uyarlama" href="/fivem-web-panel/entegrasyon-paket-uyarlama">
    Otomatik algılanmayan veya özel geliştirilmiş paketleri bağlama yöntemi.
  </Card>
</Columns>

## Otomatik algılanabilen paket örnekleri

| Kategori      | Paket örnekleri                                                                |
| ------------- | ------------------------------------------------------------------------------ |
| EMS           | `qb-ambulancejob`, `wasabi_ambulance`, `mri_Qambulancejob`, `ars_ambulancejob` |
| Banka         | `qb-banking`, `Renewed-Banking`, `okokBanking`, `tgiann-bank`                  |
| Ev sistemi    | `qb-houses`, `ps-housing`, `loaf_housing`, `qs-housing`                        |
| Kapı kilidi   | `ox_doorlock`, `qb-doorlock`                                                   |
| Araç anahtarı | `qb-vehiclekeys`, `mk_vehiclekeys`, `Renewed-Vehiclekeys`                      |
| Market        | `qb-shops`, `jim-shops`, `cloud-shop`                                          |
| MDT           | `ps-mdt`, `lb-tablet`                                                          |
| İş yönetimi   | `qb-management`, `qbx_management`                                              |

<Note>
  Resource adı `server.cfg` içindeki `ensure` adıyla birebir aynı olmalıdır. `ars-ambulancejob` ile `ars_ambulancejob` farklı resource adlarıdır.
</Note>

## Sağlam kurulum sırası

<Steps>
  <Step title="Doğru sunucuyu seç">
    Üst alandan entegrasyonu kuracağın sunucuyu seç.
  </Step>

  <Step title="Resource durumunu kontrol et">
    **Entegrasyonlar** sayfasında paketin algılanıp algılanmadığını kontrol et.
  </Step>

  <Step title="Gerekli capability'leri belirle">
    Kullanmak istediğin Panel sayfasının okuma ve yazma capability'lerini ilgili rehberden kontrol et.
  </Step>

  <Step title="Eksik işlemleri eşleştir">
    Otomatik desteklenmeyen işlemler için action mapping ekle.
  </Step>

  <Step title="Her action'ı ayrı test et">
    Önce listeleme gibi güvenli bir okuma işlemini, ardından yazma işlemlerini test et.
  </Step>

  <Step title="Yetkileri sınırla">
    Kritik işlemleri yalnızca gerekli staff rollerine aç.
  </Step>
</Steps>

## Resource algılandı ama sayfa çalışmıyor

Bu durumda genellikle provider algılanmış, fakat sayfanın beklediği capability hazır değildir.

| Belirti                                                     | Kontrol                                   |
| ----------------------------------------------------------- | ----------------------------------------- |
| EMS algılandı, personel yok                                 | `ems.staff.list`                          |
| Ev paketi algılandı, “Housing resource aktif değil” yazıyor | `housing.list`                            |
| Market algılandı, dükkan yok                                | `shops.list`                              |
| Kapı paketi algılandı, kapı yok                             | `doorlock.list`                           |
| Banka algılandı, geçmiş yok                                 | `banking.history.read`                    |
| İş yönetimi algılandı, sonuç boş                            | `management.roster` ve gönderilen job adı |

<Tip>
  **Test et** sonucunda resource bulunduğu halde capability eşleşmiyorsa, doğru capability adını kullanarak özel action mapping ekle.
</Tip>