Dil: English | Türkçe

IQV Integration API¶

IQVizyon için tescilli ERP entegrasyon API’sidir. Servis, ERP sistemlerinden proje ve iş emri verisi alır, doğrulayıp dönüştürür ve kabul edilen veriyi müşteri yerel MongoDB ortamına yazar.

Dokümantasyon sürümü

Belgelenen sürüm: unreleased. Hedef sürüm: 1.0.0. Yayınlandığında bu değerleri docs/site-meta.yml içinde güncelleyin. Bu site bir GitHub Release değildir.

Ne uygulanmıştır¶

HTTP API: health, isteğe bağlı Client Credentials kimlik doğrulama, inbound iş emirleri (JSON/XML), makine olayları, üretim performansı
Canlı inbound POST için idempotency ve istek arşivi
İleri yönlü migration’larla MongoDB kalıcılığı
CLI: serve, worker, check, migrate, version, service (Windows)
Dört dağıtım ailesi: Windows Native, Windows Docker, Linux Native (systemd), Linux Docker

Outbound worker işleri ve küresel health push iskelet / planlanan durumdadır. Üretim iş özelliği değildir.

Başlangıç¶

Konu	Sayfa
Kurulum	Kurulum Kılavuzu
API	Inbound İş Emirleri
Operasyon	Yapılandırma
Test	Test Genel Bakış
Sorun giderme	Sorun Giderme
Sürüm modeli	Sürüm Süreci
Bu sitenin yayını	GitHub Pages Yayınlama

Dağıtım matrisi¶

flowchart TB
  subgraph windows [Windows]
    WN[Native Service]
    WD[Docker Desktop Linux containers]
  end
  subgraph linux [Linux]
    LN[systemd prebuilt binary]
    LD[Docker Engine offline image]
  end
  WN --> Mongo[(Harici MongoDB)]
  WD --> Mongo
  LN --> Mongo
  LD --> Mongo

Platform	Model	Bugünkü üretim şekli
Windows	Native Service	Kaynak ağacı kurucusu (`scripts/windows/service`). Windows üretim için önerilen yol.
Windows	Docker	Kaynak ağacı / lab kurucusu (`scripts/windows/docker`). Henüz offline prebuilt paket değil.
Linux	Native systemd	Offline prebuilt binary paketi. Müşteri sunucusunda Go/Git yok.
Linux	Docker	Offline prebuilt OCI image paketi. Müşteri sunucusunda registry pull veya `docker build` yok.

Kanıt, garanti değil¶

Canlı laboratuvar sonuçları commit kapsamlıdır. Otomatik test, canlı E2E yerine geçmez. Bkz. Canlı E2E Kabul.