ERP Sistemlerinde Integration Endpoint Mimarisi: Dış Sistem Bağlantılarını Nasıl Düşünmeli?

Endpoint, bir iş sürecinin dış yeteneğe erişirken kullandığı kontrollü temas noktasıdır. İş kuralı, hangi müşteri bilgisinin gönderileceğini veya hangi onayın gerektiğini belirler; endpoint ise nereye, hangi kimlikle, hangi sınırlarla ve hangi izleme sinyalleriyle gidileceğini taşır.

Bu ayrım, teknik soyutlama uğruna soyutlama değildir. Adres değişikliği, sertifika yenileme, erişim daraltma veya hata takibi gerektiğinde iş sürecini yeniden yazmadan hareket edebilmenin yoludur.

Point-to-point bağlantı, iki sistemin kısa yoldan birbirine ulaşmasını sağlar. Endpoint yaklaşımı ise bu bağlantıyı tanımlanabilir, denetlenebilir ve değiştirilebilir bir kapasite olarak ele alır. Küçük bir entegrasyonda fark önemsiz görünebilir; aynı servise farklı süreçler, ekipler ve ortamlar erişmeye başladığında fark büyür.

Bağlantı konfigürasyonu iş kuralından ayrılmalıdır: hedef, protokol, sertifika, zaman sınırı ve güvenli sır bilgisi ayrı yönetilen bir tanımda düşünülmelidir. Böylece test ve üretim farkı, gizli bilginin rotasyonu ve erişim denetimi kod değişikliğine dönüşmez.

• ✓Credential kaynak kodda, ekran parametresinde veya serbest metin logunda görünmüyor mu?
• ✓Erişim, sadece 'sisteme girebilen' herkese açık olmak yerine kullanıcı/profil/servis ihtiyacına göre sınırlandırılmış mı?
• ✓Bir sürecin ihtiyacı olan izin ile yönetsel konfigürasyon izni ayrılmış mı?
• ✓Aynı dış servis için farklı amaçlar ve ortamlar bilinçli olarak ayrılmış mı?

Bağlantının ömrü, ihtiyacı kadar kısa ve davranışı görünür olmalıdır. Sürekli açık tutmak bazen gecikmeyi azaltır; fakat kaynak tüketimi, kopuk bağlantı ve havuz baskısı riski getirir. Her çağrıda açıp kapatmak da maliyetli olabilir. Doğru karar, iş yükü, oturum modeli, bağlantı havuzu ve hata sonrası toparlanma davranışı birlikte değerlendirilerek verilir.

Bir endpoint için yalnızca başarı/başarısızlık saymak yetmez. Hangi süreç, hangi hedef, hangi yetki bağlamı, hangi süre ve hangi hata sınıfı ile çağrı yaptı sorularını ilişkilendirebilmek gerekir. Correlation ID, süre dağılımı, timeout oranı, retry sayısı ve hata nedeninin ayrıştırılması bu yüzden değerlidir.

• ✓İstek ve iş sonucu aynı izleme kimliğiyle ilişkilendirilebiliyor mu?
• ✓Başarı oranı yanında p95 gecikme ve timeout oranı görülüyor mu?
• ✓Kimlik veya erişim hatası, ağ hatası ve dış servis hatası birbirinden ayrılıyor mu?
• ✓Sır bilgilerinin maskelendiği, fakat teşhis için yeterli bağlamın korunduğu bir log tasarımı var mı?

Endpoint katmanı bir entegrasyon platformu satın alma gerekçesi değildir. Önce hangi sorumlulukların ayrılması gerektiğini netleştirin; araç seçimi ancak bu çerçeveden sonra anlamlı olur.

• ✓Connection configuration nerede yaşar ve ortamlar arasında nasıl ayrışır?
• ✓Credential ve erişim politikası business logic'ten ayrılmış mı?
• ✓Aynı dış servise farklı süreçlerden erişim hangi ortak sınırlarla kontrol edilir?
• ✓Bağlantı ne zaman açılır, kapanır ve tükenirse ne olur?
• ✓Timeout, retry ve idempotency kararlarının iş etkisi tanımlı mı?
• ✓Monitoring, hata takibi ve correlation hangi seviyede üretilir?

Mini glossary: Endpoint = dış yeteneğe erişim noktası; abstraction = değişken ayrıntıyı ortak sınırın arkasına alma; idempotency = aynı isteği tekrar işlediğinde sonucu güvenle koruyabilme; correlation = olayları aynı iş akışı içinde ilişkilendirebilme.

TROIA'nın kamuya açık geliştirici dokümantasyonunda integration endpoint başlığı bu mimari kavramın ürün içindeki güncel karşılığını ele alır. Bu rehber ürün konfigürasyonu veya uygulama adımı öğretmez; problem çerçevesini açıklar. TROIA'ya özgü güncel ayrıntılar için özgün dokümantasyona başvurulmalıdır.