TotalApp Docs

Saha & Kestirim Operasyonları

Eksper görevlendirmesinden onarım kestirimi onayına, oradan nihai uzlaşmaya — bir hasarın fiziksel ve finansal çözümü.

Bu grup ne işe yarar?

Bir hasar Hasar Dosyaları Merkezi'nde adjuster_assigned durumuna ulaştığında, bu üç ekran onu çoğu kişinin "bir hasarı işleme koymak" dediğinde aklına gelen operasyonel zincirden geçirir: kaybı fiziksel olarak keşfetmek, onarımı fiyatlandırmak ve ödemeyi yürütmek. Zincir doğrusaldır ve her ekran bir sonrakine gerçek veri devreder.

Dispatch & Field Calendar
Estimate Approvals & Limits
Settlement & Payouts
Subrogation & Recovery

Her ekran, src/types/insurOps.ts içindeki paylaşılan TypeScript sözleşmeleriyle (ClaimRecord, FieldTaskRecord, EstimateRecord, PayoutRecord) desteklenir ve aşağıdaki her entegrasyon aksiyonu, bir sonraki ekranın kalıcı kaydı üzerinde gerçek bir oku-değiştir-yaz işlemi yapar — simüle edilmiş bir devir değil.

1. Dispatch & Field Calendar

Amaç: Onaylı hasar dosyalarını saha eksperleriyle eşleştirmek ve fiziksel keşfi planlamak/takip etmek. Bölünmüş harita/takvim görünümü hem kayıpların coğrafi dağılımını hem de saha görevlerinin yaşam döngüsü durumunu gösterir.

Ana özellikler

  • Bölünmüş harita/takvim görünümü — bir mock harita, kaza konumlarını (pin rengi = aciliyet: kırmızı/amber/yeşil) ve eksper kapsama alanlarını gösterir; takvim listesi yanında yer alır.
  • Akıllı Eşleştirme motoru — "Smart Match" butonundan açılır, adaylar birleşik bir puana göre sıralanır: yakınlık (yakın olan daha iyi), uzmanlık eşleşmesi (hasar tipi → ideal AdjusterSpecialty, eşleşmede bonus puan) ve iş yükü (daha az açık görev daha yüksek puan). En yüksek puanlı aday ✦ ile işaretlenir.
  • Saha görevi yaşam döngüsüpending_dispatch → en_route → on_site_inspection → report_submitted, durum rozetleriyle takip edilir.
  • Saha Keşfi Özet modalı — seçili görev için saha fotoğrafları (emoji yer tutucular), GPS check-in zamanı, ön değerleme ve saha notları.

Entegrasyon tetikleyicileri

AksiyonNe yapar
Submit Inspection & Push to EstimateSaha görevini report_submitted yapar; bağlı ClaimRecord.estimateStep'i pending_approval'a çeker ve ön değerlemeyi kestirim tutarı olarak taşır — hasar artık Estimate Approvals & Limits'in inceleme kuyruğunda görünür.
Flag InvestigationSaha notlarını yeni bir kırmızı bayrak nedeni olarak ekler ve hasarı Fraud & Risk Scoring'e yönlendirir (bağlı FraudAlertRecord'u oluşturur veya günceller).

2. Estimate Approvals & Limits

Amaç: Onarım kestirimini kalem kalem incelemek, hasar fotoğraflarıyla karşılaştırmak ve çok kademeli bir yetki iş akışı üzerinden onaylamak veya pertotal ilan etmek.

Ana özellikler

  • Kalem bazlı tablo — Parça Adı / Kategori (OEM, Yan Sanayi, İşçilik, Boya) / Birim Maliyet / İşçilik Saati / İskonto Oranı / Toplam, tamamen düzenlenebilir; her satırın toplamı otomatik hesaplanır (işçilik satırları saat × oran, diğerleri birim maliyet kullanır, ikisi de iskontolanır).
  • Yan yana fotoğraf karşılaştırma — "Compare Photos" modalı FNOL hasar fotoğraflarını (ClaimRecord.fnolSnapshot.evidenceThumbnails) talep edilen onarım kalemlerinin yanında gösterir, böylece incelemeciler parçaları gerçek hasarla karşılaştırabilir.
  • Çok kademeli yetki limiti iş akışı — kestirim toplamından otomatik türetilen bir rozet:
KademeEşikAnlamı
Tier 1 · Otomatik/Masa Onayı< $2.500Masa seviyesinde otomatik onaylanır
Tier 2 · Kıdemli Eksper Onayı$2.500 – $15.000Kıdemli eksper onayı gerektirir
Tier 3 · Direktör İmzası Gerekli≥ $15.000Direktör imzası gerektirir

Eşikler APPROVAL_TIER_LIMITS'te (src/types/insurOps.ts) tanımlıdır; rozet bilgilendirme amaçlıdır — gerçek yetkilendirme RBAC yetenekleriyle (ins:estimate:review, ins:estimate:approve) sunucu tarafında sağlanır.

Entegrasyon tetikleyicileri

AksiyonNe yapar
Approve & Lock ReserveKestirimi approved yapar, ClaimRecord.status'u estimate_approved'a çeker ve rezervi kestirim toplamına kilitler — hasar artık Settlement & Payouts'ta ödeme bekleyen onaylı kestirim olarak görünür.
Declare Total Loss (Pert)Kestirimi total_loss yapar ve hasarın kestirim adımını reddeder; ayrıca Salvage & Parts Management'ta gerçek bir SalvageAssetRecord açan bir TotalLossPayload yayınlar (rezerv fiyatı ve tahmini sovtaj değeri kestirim toplamından türetilir).

3. Settlement & Payouts

Amaç: Onaylı bir kestirimden net ödemeyi hesaplamak, doğru alacaklı ve bankaya yönlendirmek, ödemeyi yürütmek ve üçüncü taraf kusuru olduğunda bir rücu dosyası açmak.

Ana özellikler

  • Finansal uzlaşma dökümüOnaylanan Onarım Toplamı − Muafiyet − Yıpranma Payı − Hurda Alıkoyma = Net Ödeme Tutarı, rakamlar düzenlendikçe canlı hesaplanır.
  • Alacaklı & banka yönlendirme paneli — hedef seçici (Sigortalıya Öde / Doğrudan Servise Öde — alacaklı adı Repair & Service Network'ten otomatik doldurulur / Üçüncü Taraf Lehtar), IBAN doğrulama rozeti, Banka Adı alanı ve Ödeme Yöntemi (EFT/Havale, Çek, Doğrudan Fiş).
  • Ödeme yürütme & durum hattı — Ödeme No, Hasar No, Alacaklı Adı, Brüt Tutar, Kesintiler, Net Ödeme ve Banka Durumu (Yürütme Bekliyor / İşleniyor / Ödendi / Başarısız) sütunlu bir kuyruk tablosu.
  • Bekleyen kestirim ipucu şeridi — henüz ödemesi açılmamış onaylı kestirimler ekranın altındaki bir bilgi şeridinde gösterilir.

Entegrasyon tetikleyicileri

AksiyonNe yapar
Execute PayoutÖdemeyi paid yapar, bağlı ClaimRecord.status'u closed ve payoutStep.payoutStatus'unu paid yapar — hasar artık Hasar Dosyaları Merkezi'nde kapalı görünür.
Initiate Subrogation (koşullu)Sadece Üçüncü Taraf Kusuru % > 0 olduğunda etkindir. Tam bir SubrogationRecord dosyası açar (talep tutarı = net ödeme × kusur payı) ve payoutStep.subrogationStatus'u pending yapar — Subrogation & Recovery'de müzakereye hazırdır.

Uçtan uca veri akışı

Kaynak ekranAksiyonHedef ekran / kayıt
Hasar Dosyaları MerkeziEksper atandıHasar Dispatch & Field Calendar kuyruğuna girer
Dispatch & Field CalendarSubmit Inspection & Push to EstimateClaimRecord.estimateStep.approvalStatus = pending_approval → Estimate Approvals kuyruğu
Dispatch & Field CalendarFlag InvestigationFraudAlertRecord açılır/güncellenir → Fraud & Risk Scoring
Estimate Approvals & LimitsApprove & Lock ReserveClaimRecord.status = estimate_approved → Settlement & Payouts kuyruğu
Estimate Approvals & LimitsDeclare Total LossSalvageAssetRecord oluşur → Salvage & Parts Management (bkz. Geri Kazanım & Analitik)
Settlement & PayoutsExecute PayoutClaimRecord.status = closed → Hasar Dosyaları Merkezi'nde kapalı görünür
Settlement & PayoutsInitiate SubrogationSubrogationRecord oluşur → Subrogation & Recovery (bkz. Geri Kazanım & Analitik)