Problem
Acentelerin büyük kısmı müşteri bilgilerini Excel'de, poliçeleri sigorta şirketlerinin ayrı ayrı portallarında, yenileme tarihlerini ise hatırlatma notlarında tutuyor. Müşteri mesajları WhatsApp, Instagram ve e-posta arasında dağılıyor. Sonuç: kaçırılan yenilemeler, tekrar tekrar girilen veriler ve yöneticinin portföyü bütün olarak görememesi.
Çözüm
Her acentenin kendi izole veri alanında çalıştığı, müşteriyi merkeze alan ve poliçe yaşam döngüsünü yenileme hatırlatmalarıyla birlikte yöneten bir CRM. Müşteriyle yapılan yazışmalar da aynı ekrana, tek bir gelen kutusuna düşüyor.
Modüller
- Acente & kullanıcı yönetimi: acente (tenant) tanımı, roller ve yetkiler, acente ayarları, işlem logları.
- Müşteri 360°: bireysel ve kurumsal müşteriler, sigortalanan araç ve konut bilgileri, KVKK veri ihlali kaydı ve silme talepleri.
- Teklif: teklif hazırlama ve takip.
- Poliçe: poliçe dokümanları, ödeme takibi, komisyon hesabı, çapraz satış fırsatları ve müşteriye gönderilen online ödeme linki.
- İş akışı: acente süreçlerinin tanımlanması ve takibi.
- Bildirim & yenileme: mesaj şablonları ve vadesi yaklaşan poliçeler için otomatik yenileme hatırlatmaları.
- Çok kanallı gelen kutusu: Instagram ve webhook entegrasyonlarıyla gelen mesajlar tek kutuda; yeni mesajlar sayfa yenilenmeden (SSE) anlık geliyor, yanıtlar aynı ekrandan veriliyor.
- Ekip içi iletişim: hatırlatıcılar, müşteri notları, ekip içi direkt mesaj ve çevrimiçi durum göstergesi.
- AI asistan: Spring AI ile OpenAI modellerine bağlanan sohbet servisi (mikroservis sürümünde).
Mimari: mikroservisten modüler monolite
Proje önce 8 mikroservis (identity, customer, policy, quote, workflow, notification, inbox, reminder), Spring Cloud Gateway ve Kafka ile geliştirildi. Ürünün ölçeği ve ekip büyüklüğü düşünüldüğünde dağıtık mimarinin operasyon maliyeti getirisini aşınca, iş mantığı aynı paket yapısı korunarak tek bir Spring Boot uygulamasına taşındı.
| Mikroservis sürümü | Modüler monolit | |
|---|---|---|
| Çalışma birimi | 8 servis + gateway | 1 Spring Boot uygulaması |
| Veritabanı | Servis başına ayrı DB | Tek DB; ortak şema + acente başına şema |
| Olaylar | Kafka | Süreç içi olay yolu |
| Modüller arası çağrı | REST | Doğrudan çağrı, ayrı transaction |
| Redis | Zorunlu | Opsiyonel |
| Gateway | Spring Cloud Gateway | nginx |
Öne çıkan teknik kararlar
- Acente başına şema: Her acente ayrı bir PostgreSQL şemasında. Uygulama açılırken her modülün ortak ve acenteye özel Flyway migration'ları, kayıtlı tüm acentelerin şemalarına uygulanıyor.
- Mikroservis semantiğini korumak: Modüller arası olaylar commit sonrasında, sanal thread'de, 3 denemeyle iletiliyor; idempotency anahtarı her tüketici modül için ayrı. Eskiden HTTP olan çağrılar ayrı transaction'da çalışıyor; bu sayede karşı modüldeki hata, çağıranın transaction'ını geri almıyor.
- KVKK silme orkestrasyonu: Silme talebi kaydedildikten sonra her modül kendi verisini kendi transaction'ında temizliyor.
- Veri erişimi: Basit CRUD için JPA, raporlama ve karmaşık sorgular için jOOQ.
- Zamanlanmış işler: Yenileme hatırlatmaları gibi işler Quartz ile çalışıyor; ShedLock, birden fazla instance'ta aynı işin iki kez çalışmasını engelliyor.
Bu geçişin gerekçelerini anlattığım yazı: Mikroservis değil, modüler monolit
Teknolojiler
| Katman | Teknoloji |
|---|---|
| Backend | Java, Spring Boot, Spring Security (JWT), Spring Data JPA, jOOQ, MapStruct |
| Veritabanı | PostgreSQL, Flyway, Redis (opsiyonel) |
| Zamanlama | Quartz, ShedLock |
| Frontend | React, Vite, TanStack Query, Zustand, Recharts, i18next |
| AI | Spring AI, OpenAI |
| Altyapı | Docker, nginx |