Koza Karar Destek Zekâsı – Entegrasyon Gereksinimleri

Bu doküman, Koza Karar Destek Zekâsı’nın (Decision Intelligence) bir işletmede devreye alınabilmesi için ERP ve bağlı
operasyonel sistemlerde hazır olması gereken aksiyon, kural, onay ve senaryo verilerini ve teknik beklentileri tanımlar.
Hedef kitle: Üst yönetim, IT ekipleri, ERP danışmanları, süreç yöneticileri, sistem entegratörleri.

  • Veri erişimi: Read-only (karar üretir, ERP’ye yazmaz)
  • Desteklenen yöntemler: REST API, SOAP, Database View, Scheduled Export (JSON/CSV)
  • Veri güncelliği önerisi: Gerçek zamanlı / 5–15 dakika
  • Zaman formatı: ISO 8601

1) Amaç

Koza Karar Destek Zekâsı; üretim, finans, planlama, satış, lojistik ve İK zekâlarından gelen çıktıları birleştirerek
işletmeye ne yapması gerektiğini öneren bir üst karar katmanıdır.

Riskleri sadece göstermekle kalmaz, aksiyon önerisi üretir.

2) Veri Kaynakları

Koza Karar Destek Zekâsı aşağıdaki Koza modüllerinden ve ERP’den beslenir:

  • Koza Üretim Zekâsı çıktıları
  • Koza Planlama Zekâsı çıktıları
  • Koza Finans Zekâsı çıktıları
  • Koza Satış Zekâsı çıktıları
  • Koza Lojistik Zekâsı çıktıları
  • Koza İK Zekâsı çıktıları
  • ERP iş kuralları & onay süreçleri

3) Zorunlu Veri Setleri

3.1) BusinessRules (İş Kuralları)

Amaç: Karar üretiminde sınır ve politika tanımları.

Alan Adı Açıklama Zorunlu
RuleCode Kural kodu Evet
RuleName Kural adı Evet
Module Üretim / Finans / Satış vb. Evet
Condition Şart (ör: stok < min) Evet
ActionType Uyarı / Öneri / Blokaj Evet
Status Aktif / Pasif Evet

3.2) DecisionScenarios (Karar Senaryoları)

Amaç: Alternatif aksiyon yolları.

Alan Adı Açıklama Zorunlu
ScenarioCode Senaryo kodu Evet
ScenarioName Senaryo adı Evet
TriggerSource Üretim / Finans / Satış vb. Evet
Description Açıklama Hayır
Priority Öncelik Hayır

3.3) DecisionResults (Üretilen Kararlar)

Amaç: Karar çıktılarının izlenmesi ve geri besleme.

Alan Adı Açıklama Zorunlu
DecisionId Karar ID Evet
DecisionDate Karar tarihi Evet
SourceModule Tetikleyen modül Evet
DecisionText Karar açıklaması Evet
SuggestedAction Önerilen aksiyon Evet
RiskLevel Düşük / Orta / Yüksek Hayır
Status Yeni / Onaylandı / Reddedildi Hayır

4) Opsiyonel Veri Setleri

4.1) ApprovalFlows (Onay Akışları)

Amaç: Kararların kim tarafından onaylanacağını belirlemek.

Alan Adı Açıklama Zorunlu
FlowCode Akış kodu Evet
Module Üretim / Finans / Satış vb. Evet
ApproverRole Onaylayacak rol Evet
Level Seviye Hayır

4.2) ImpactScores (Etki Skorları)

Amaç: Kararın finansal/operasyonel etkisini ölçmek.

Alan Adı Açıklama Zorunlu
DecisionId Karar ID Evet
FinancialImpact Finansal etki (+/-) Hayır
OperationalImpact Operasyonel etki Hayır
CustomerImpact Müşteri etkisi Hayır

5) Entegrasyon Yöntemi

Koza Karar Destek Zekâsı ERP’ye doğrudan yazmaz. Karar üretir, bildirir, yönlendirir.

  • REST API (karar çıktıları için)
  • Webhook (bildirim)
  • Database View
  • Scheduled Export

6) Karar Mimarisi & Akış

  1. Veri Koza modüllerinden toplanır
  2. İş kuralları ile karşılaştırılır
  3. Risk & fırsat analizi yapılır
  4. Senaryo motoru çalışır
  5. Aksiyon önerisi üretilir
  6. Onay akışına düşer veya doğrudan bildirilir

7) Performans & Format Beklentileri

  • RuleCode ve ScenarioCode benzersiz olmalı
  • DecisionDate ISO 8601 formatında
  • Metin alanları UTF-8

8) Hazırlık Kontrol Listesi

9) Örnek API Endpoint’leri

/api/business-rules
/api/decision-scenarios
/api/decision-results
/api/approval-flows
/api/impact-scores

Yetkilendirme önerisi: OAuth2 / API Key / IP Whitelist + SSL/TLS