Nasıl çalışır
Telefon trafiği yerine bir HTTP çağrısı.
HBYS isteği yollar, Medonay kuralları işler, sigorta tarafı eş zamanlı bilgilenir. Sahnedeki her oyuncu ve teknik adım aşağıda.
Bugün ne oluyor
Özel hastane provizyonu hala büyük oranda telefon trafiği üzerinden yürür. Hasta vezne önünde, personel kuyrukta sigorta operatörü bekler.
Mevcut akış
Hastane personeli sigortayı arar, poliçeyi sözlü okur, doktor kalemlerini tek tek aktarır. Beklenen süre tipik olarak 5-25 dakika.
Gerçek maliyet
Hasta deneyiminde sürtünme, marka algısında kayıp; orta ölçekli hastanede 4-6 tam zamanlı personel sadece bu süreçte; sözlü iletim hatasından kaynaklı aylık kalem bazlı sapmalar.
Medonay sonrası
Tek bir eşzamanlı API çağrısı, saniyenin altında karar, otomatik denetim kaydı ve sigortaya HMAC imzalı bildirim. Telefon yerine milisaniye.
HBYS (Hastane Bilgi Yönetim Sistemi)
HBYS, hastanenin idari, finansal ve klinik tüm operasyonlarını tek çatı altında tutan yazılımdır. Hasta kayıt, poliklinik, laboratuvar (LIS), radyoloji (RIS), eczane, fatura ve provizyon modüllerini içerir.
Türkiye'de onlarca farklı HBYS var ve her biri kendi biçimiyle konuşuyor. Hiçbiri kamuya açık REST dokümantasyonu yayınlamıyor; entegrasyon NDA, PDF dokümantasyon ve VPN test ortamı üzerinden ilerliyor. Medonay bu yüzden her HBYS'ye kendi adaptörüyle bağlanır: yeni bir sistem eklemek tek dosya ve tek kayıttır, karar motoru hiç değişmez.
Özel sağlık sigortası provizyonu
Provizyon = sigorta şirketinin, hizmet verilmeden önce o hizmetin kapsamda olduğunu ve hangi oranda karşılanacağını teyit etmesidir. Poliçe + kapsam + bekleme süresi + yıllık limit + plan kuralları sıralı olarak değerlendirilir.
Ödeyicilerin büyük kısmı provizyonu bugün SOAP/XML, kapalı portal ya da çağrı merkezi üzerinden yürütüyor; gerçek zamanlı ve açık bir API hâlâ istisna. Medonay her ödeyiciye de kendi biçimiyle bağlanan bir adaptör kullanır.
Bugün Medonay nerede duruyor
Kod tabanında bir örnek ve bir gerçek HBYS adaptörü (FHIR R4 şekilli) ve sigorta tarafında sadece mock adapter mevcut. Adapter pattern sayesinde yeni bir sağlayıcı eklemek tek dosya + tek DB satırıdır; motor (AdjudicationEngine) hiç değişmez. İlk gerçek partnerla birlikte adapter takvimi açıktır.
Senaryo: 38 yaş Ahmet Bey, tahlil + EKG
Tek bir hasta için sahnedeki 9 adım. Süre hedefi: hastane senkron yanıtı 1 saniyenin altında alır.
- 1
Polikliniğe kayıt
Resepsiyon Ahmet Bey'in T.C. kimliğini girer; HBYS hastanın tamamlayıcı sağlık sigortası olduğunu bilir.
- 2
Doktor önerisi
Dahiliye uzmanı iki kalem önerir: 901550 Tam kan sayımı (70 TL), 902340 EKG 12 kanallı (120 TL).
- 3
HBYS'den Medonay'a istek
Hastanenin HBYS'si POST /v1/provision/request adresini çağırır. Başlıkta X-API-Key, gövdede hastanın poliçe bilgileri ve iki kalem yer alır. Veri hastanenin kendi biçiminde gelir.
- 4
Adapter normalize eder
O HBYS'nin adaptörü isteği Medonay'ın ortak biçimine çevirir. Ham TC kimlik bu sınırda SHA-256 ile hash'lenir; servis katmanı asla plaintext görmez.
- 5
Çapraz sigorta poliçe çözünürlüğü
Hastanenin gönderdiği veride 'patient.provider_code' varsa sadece o sigortaya sorulur (hint hızlı yolu). Yoksa Medonay aktif tüm sigortalara paralel sorar. Birden fazla sigorta 'evet, hastam' derse (örneğin hastanın hem işyerinin grup poliçesi hem kendi aldığı bir poliçe varsa) Medonay seçim yapmaz; 409 POLICY_SELECTION_REQUIRED + aday listesi döner. Hastane operatörü hastaya hangi sigortayı kullanmak istediğini sorar ve aynı 'hbys_request_id' ile 'provider_code' alanını doldurarak tekrar gönderir; orijinal istek 'awaiting_selection' durumundan 'decided'a geçer. Bu tasarım, hasta seçimini sisteme havale etmez; mali konuda algoritmik tahmin yok.
- 6
Adjudication motoru karar verir
Her kalem için: kategori kapsamda mı? Poliçe aktif mi? Kapsam araması, bekleme süresi, plan kuralları (DSL), per-item / sub-limit / annual limit kontrolü. Sırayla ve deterministik.
- 7
Persist + sync yanıt
provision_decisions + items + outbound_webhook_deliveries tek transaction'da yazılır. HBYS'e JSON dönülür; üretimde ölçülen p95 100 ms'in altında.
- 8
Eşzamansız sigorta bildirimi
Worker pool kuyruktaki webhook'u alır, sigortanın URL'ine HMAC-SHA256 imzalı POST gönderir. Ulaşmazsa artan aralıklarla yeniden denenir: 60 sn, 5 dk, 30 dk, 2 sa, 12 sa. Sonunda ölü mektup listesine düşer.
- 9
Hastane karar belgesini yazdırır
Personel ekranında ✅ Onaylandı görür: hangi kalem hangi oranda, hasta katkısı ne kadar. Vezne hastayı çağırır.
Teknik mimari: kuş bakışı
Yüksek seviyeli akış ve sistemi ölçeklenebilir tutan beş temel ilke.
Adapter pattern
Her HBYS ve her sigorta için ayrı bir adapter dosyası. Yeni partner = 1 dosya + 1 DB satırı + 1 registry girişi. Motor kodu hiç değişmez.
Pure adjudication engine
Aynı istek ve aynı poliçe her zaman aynı kararı üretir. Motorun içinde saat okunmaz, veritabanına yazılmaz, dışarıya çağrı yapılmaz. Motor sürümü her kararın üstüne damgalanır; geçmiş bir karar aynı sürümle yeniden üretilebilir.
Çapraz sigorta poliçe çözünürlüğü
Hastane hangi sigortada olduğunu bilmek zorunda değil; Medonay aktif tüm sigortalara paralel sorar. Aynı anda birden fazla geçerli poliçe varsa (örneğin iş yeri grup poliçesi ve bireysel ek poliçe) Medonay sessizce seçim yapmaz; 409 POLICY_SELECTION_REQUIRED ile aday listesini döner, operatör hastaya sorar, aynı istek kimliğiyle hint dolu olarak yeniden gönderir. Operatör gönderilen veriye sigorta kodunu doğrudan yazarsa tek-atış 'hint' yolu çalışır. Mali konuda algoritmik tahmin yapmayız.
Audit & rule_trace
Her durum değiştirici çağrı audit_log satırı yazar (append-only, regulator-facing). Her karar rule_trace JSONB içinde hangi kuralın hangi sırayla çalıştığını saklar.
Güvenlik baseline
TC kimlik no SHA-256 + pepper, JWT (panel) + X-API-Key (HBYS), multi-tenant org_id scoping, HMAC webhook imzaları, bcrypt cost 12, custom HTTP server timeout'ları + custom HTTP client.
Ölçeklenebilirlik zarfı
Her müşteri kurulumu kendi veritabanıyla ayrı çalışır ve kapasitesi kuruluma göre boyutlandırılır. Veritabanı bağlantı sayısı kurulum başına sınırlıdır, yani ani bir yük artışı veritabanını tüketmez. Kararın kendisi milisaniyeler içinde verilir; uçtan uca süre, karşı taraftaki sistemin yanıt hızına bağlıdır. Hedef p95 1 saniyenin altı.
Konuşmaya hazır mısınız?
Hastane veya sigorta tarafından, mevcut entegrasyon durumunuzu dinleyip adapter takvimi çıkaralım.