Genel Bakış & İş Değeri
Sağlık sektöründe gelen hasta/müşteri mesajlarını anında anlayıp doğru departmana yönlendirmek, operasyonel hız ve hasta memnuniyeti açısından kritik öneme sahiptir. ClinicExpert ML API, bu süreci tam otomatize eder.
Otomatik Tıbbi Sınıflandırma
Gelen sohbet metinlerini 7 farklı tıbbi kategoriye (Saç Ekimi, Diş Estetiği, Burun Estetiği vb.) otomatik olarak sınıflandırır. Manuel yönlendirme ihtiyacını ortadan kaldırır.
Hibrit ML + LLM Yaklaşımı
Yüksek güvenilirlikli tahminler için optimize edilmiş ML modeli çalışır. Düşük güvenilirlikli durumlarda OpenAI/Anthropic LLM'leri hakem olarak devreye girer.
Yüksek Performans
~%90 doğruluk ve ~0.88 F1 skoru ile güvenilir tahminler. ML modeliyle 1 saniyenin altında, LLM fallback ile 3 saniyenin altında yanıt süresi.
Kolay REST API Entegrasyonu
Sağlık bilgi sistemleri, çağrı merkezi yazılımları veya CRM platformları ile kolayca entegre edilebilir standart RESTful API arayüzü.
Ölçeklenebilir Mimari
Docker konteyner tabanlı dağıtım ile iş yükü arttığında kolayca yatay ölçekleme. CPU ve bellek kaynak yönetimi tanımlı.
Çoklu Dil Desteği
langdetect ile otomatik dil tespiti. Farklı dillerdeki hasta mesajlarını doğru şekilde işleme yeteneği.
Tıbbi Sınıflandırma Kategorileri
Sistem, gelen WhatsApp mesajlarını aşağıdaki 7 tıbbi kategoriden birine otomatik olarak atar.
| # | Kategori | Açıklama | Örnek Anahtar Kelimeler |
|---|---|---|---|
| 1 | Saç Ekimi | Saç ekimi, saç dökülmesi, FUE/DHI prosedürleri | hair transplant, saç ekimi, FUE, graft |
| 2 | Diş Estetiği | Diş kaplama, implant, gülüş tasarımı | dental, veneer, implant, teeth |
| 3 | Burun Estetiği | Rinoplasti, burun estetiği operasyonları | rhinoplasty, nose job, burun |
| 4 | Göz Estetiği | Göz kapağı estetiği, lazer göz operasyonları | eye surgery, blepharoplasty, göz |
| 5 | Yüz Estetiği | Yüz germe, botox, dolgu işlemleri | facelift, botox, filler, yüz |
| 6 | Vücut Estetiği | Liposuction, karın germe, vücut şekillendirme | liposuction, tummy tuck, body |
| 7 | Diğer | Yukarıdaki kategorilere uymayan genel sorgular | general inquiry, fiyat, randevu |
Makine Öğrenimi Pipeline'ı
Metin girişinden sınıflandırma sonucuna kadar olan uçtan uca veri işleme akışı. Hibrit yaklaşım ile güvenilirlik maksimize edilir.
Hibrit Fallback Mekanizması: Güven skoru belirlenen eşiğin altında kaldığında, sistem otomatik olarak OpenAI veya Anthropic LLM API'lerine başvurur ve hakem kararı ile nihai sınıflandırmayı yapar. Bu sayede düşük güvenilirlikli tahminlerde bile yüksek doğruluk sağlanır.
Sistem Mimarisi & Bileşenler
ETL'den model eğitimine, inference'dan API sunumuna kadar modüler ve katmanlı bir mimari. Her katman bağımsız olarak geliştirilebilir ve ölçeklenebilir.
Veri ETL Katmanı
src/data/
Data Pipeline
Ham WhatsApp konuşma verilerinin çıkarılması (Extract), dönüştürülmesi (Transform) ve yüklenmesi (Load) işlemlerini gerçekleştirir.
- Ham sohbet verilerinin okunması ve parse edilmesi
- Metin temizleme, normalizasyon ve ön işleme adımları
langdetectile otomatik dil tespiti ve filtreleme- İşlenmiş verilerin model eğitimine uygun formata dönüştürülmesi
- Veri seti dengeleme (
imbalanced-learn) ile sınıf dağılımı optimizasyonu
Model Eğitim Katmanı
src/models/
ML Engine
Çift öznitelik çıkarımı ve güçlü sınıflandırma modeli ile yüksek doğruluklu tahmin sistemi.
- TF-IDF Vektörizasyonu: Metinlerden istatistiksel anahtar kelime ağırlıkları çıkarma
- MiniLM Sentence Embeddings: Transformer tabanlı semantik metin vektörleri oluşturma
- Öznitelik Birleştirme: TF-IDF ve MiniLM özniteliklerinin concat edilmesi
- LightGBM Sınıflandırıcı: Gradient boosting tabanlı yüksek performanslı model eğitimi
- Çapraz doğrulama, hiperparametre optimizasyonu ve model değerlendirme
joblibile eğitilmiş modellerin serileştirilmesi ve saklanması
Tahmin (Inference) Katmanı
src/inference/
Prediction Engine
Eğitilmiş modeli kullanarak gerçek zamanlı tahminler yapan ve hibrit yönlendirme mantığını uygulayan katman.
- Eğitilmiş LightGBM modelinin bellekte yüklenmesi ve hazır tutulması
- Gelen metnin TF-IDF + MiniLM özniteliklerine dönüştürülmesi
- Güven Skoru Hesaplama: Model tahmin olasılıklarının değerlendirilmesi
- Eşik Değer Yönlendirme: Yüksek güven → direkt ML sonucu, düşük güven → LLM hakem
- LLM Fallback: OpenAI veya Anthropic API'ye metin gönderip hakem kararı alma
- Tahmin sonuçlarının yapılandırılmış formatta döndürülmesi
LLM Etiketleme Katmanı
src/labeling/
Auto Labeling
Eğitim verisi genişletme ve otomatik etiketleme için LLM'lerin kullanıldığı veri zenginleştirme katmanı.
- Etiketlenmemiş verilerin OpenAI/Anthropic API'leri ile otomatik etiketlenmesi
- Yarı otomatik etiketleme süreçleri ile eğitim veri setinin genişletilmesi
- LLM çıktılarının kalite kontrolü ve doğrulama mekanizmaları
- Sürekli öğrenme döngüsü için yeni etiketli veri üretimi
API Servis Katmanı
src/api/
REST API
Dış dünya ile iletişim kuran, tüm tahmin işlevselliğini RESTful API endpoints olarak sunan servis katmanı.
- FastAPI Framework: Python tabanlı yüksek performanslı asenkron API
- Uvicorn ASGI Sunucu: Asenkron istek işleme ile yüksek throughput
- Pydantic Modelleri: İstek ve yanıt şemalarının otomatik doğrulaması
- PostgreSQL Entegrasyonu: Tahmin logları ve analitik veriler için kalıcı depolama
- Otomatik API dokümantasyonu (Swagger/OpenAPI)
- Health check ve monitoring endpoints
Kullanılan Teknolojiler
Geleneksel makine öğrenimi, büyük dil modelleri ve modern web framework'lerinin gücünü birleştiren kapsamlı teknoloji yığını.
Konteyner Yapısı & Dağıtım
Docker tabanlı izole ve ölçeklenebilir dağıtım stratejisi. Kaynak limitleri ve harici ağ entegrasyonu ile production-ready altyapı.
Docker Konteyner
python:3.11-slim tabanlı optimize edilmiş imaj. Tüm ML modelleri, bağımlılıklar ve API servisi izole konteynerde çalışır.
Docker Compose
Servisin kolay başlatılması ve yönetilmesi için orkestrasyon. CPU ve bellek limitleri/rezervasyonları tanımlı.
Harici Ağ Entegrasyonu
Mevcut flaskapi_custom_net Docker ağına entegre. Daha büyük ekosistem ile servisler arası iletişim.
Apache Reverse Proxy
Servis doğrudan dışarıya açık değil, Apache ters proxy arkasından erişilir. Güvenlik katmanı ve yük dengeleme sağlar.
Dağıtım Betikleri
scripts/deploy_production.sh ile otomatik dağıtım. Makefile benzeri yapılar ile hızlı operasyonel yönetim.
.env Yapılandırma
API anahtarları (OpenAI, Anthropic), veritabanı bağlantıları ve model konfigürasyonları güvenli ortam değişkenlerinden yönetilir.
Dizin & Dosya Organizasyonu
ML model yaşam döngüsünü (veri hazırlığı, eğitim, tahmin, etiketleme) ve API servis katmanını net şekilde ayıran modüler yapı.