Ödeme Kodunu Stripe Bağımlılığından Kurtaran Sınır Deseni

Video, yapay zekâya yazdırılmış tipik bir ödeme işleviyle açılıyor: Stripe bağlantısı alınıyor, müşteri bulunuyor veya yaratılıyor, ödeme niyeti kuruluyor, hatalara göre dallanılıyor. Kod tek başına çalışıyor; sorun, bu Stripe bilgisinin ödeme gereken her yere kopyalanmasıyla başlıyor. Servis değişirse veya sürüm yükselirse, fatura kabarık bir yeniden yazım olarak dönüyor.

Temel teşhis bağımlılık kavramıyla konuyor: sipariş işleyen kod, Stripe müşterilerinin, ödeme niyetlerinin, üstveri uzlaşımlarının, onay çağrılarının ve hata sınıflarının tamamını bilmek zorunda kalıyor. Sistemin ödeme ile ilgili her parçası, dış servisin iç dünyasını ezberliyor. Bu ezber, değişimin maliyetini katlıyor.

Çözüm olarak facade deseni tanıtılıyor; karmaşık bir alt sisteme açılan sade bir kapı. Video, desenin hem en basit hem de en kolay yanlış uygulanan desenlerden biri olduğunu vurguluyor. Yanında, bakımlı tasarım kararları için hazırlanan bir eğitim programının duyurusu da yer alıyor.

İlk denemede ödeme akışı bir facade arkasına taşınıyor ve kod kısalıyor. Fakat imzada bir sızıntı kalıyor: ödeme yöntemi, Stripe'a özgü ödeme niyeti nesnesini döndürmeye devam ediyor. Arayan kod, bu nesnenin içini yoklamak ve Stripe hata türlerini yakalamak zorunda kalıyor. Sadeleşme var ama bağımsızlık yok.

Video buradaki yaygın yanılgıyı adlandırıyor: katman kurmak, sadeleştirmek sanılıyor; oysa asıl iş sınır bekçiliği. İyi facade, hangi bilginin uygulamaya geçeceğine karar veren gümrük kapısı gibi çalışmalı. İmza dış servisin dilini konuşuyorsa, bağımlılık yalnızca taşınmış olur.

İkinci sürümde tablo değişiyor: ödemeler için protokole dayalı bir soyutlama tanımlanıyor. Ödeme yöntemi sipariş ve ödeme bilgisini alıp servisten bağımsız bir sonuç nesnesi döndürüyor. Alan mantığı artık müşteri yaratmayı, niyet kurmayı, onay detaylarını hiç görmüyor; Stripe bilgisi sıfıra iniyor.

Ardından üç klasik tuzak sıralanıyor. Birincisi sızdıran soyutlama: dış servisin hata türleri veya iç kavramları üst katmana taşınıyor. İkincisi tanrı nesne: ödemeler, faturalar, abonelikler, müşteriler ve kuponlar tek bir dev facade içinde toplanıyor; bunun yerine uyumlu küçük servislere bölünmesi öneriliyor.

Üçüncü tuzak, önemli davranışın gizlenmesi: ödemelerin her zaman eşzamanlıymış gibi sunulması veya müşteri doğrulaması gereken akışların saklanması. Arayanın gerçekten bilmesi gereken kavram, sınırın arkasına gömülmemeli. Dürüst bir sınır, gizlemek ile korumak arasındaki farkı bilir.

Kapanışta facade ile adapter desenleri ayrıştırılıyor: adapter bir arayüzü diğerine dönüştürür ve parçaların değiştirilmesini kolaylaştırır; facade ise karmaşık bir alt sisteme erişimi sadeleştirir ve dış kararları içeriden uzak tutar. İkisi de sarar ama farklı dertleri çözer. Video, izleyicileri kendi bağımlılık hikâyelerini paylaşmaya çağırarak bitiyor.

Örnek kodun herkese açık bir depoda paylaşıldığı, küçük bir çalıştırma betiğiyle sonucun denenebildiği de ekleniyor. Böylece anlatılan soyutlama, kopyalanabilir somut bir örneğe bağlanmış oluyor.