Genel Bakış

Kaza Rehberi Kılavuzu, platformun üç temel katmanını tek ve şeffaf bir kaynakta belgeler:

Bölümler

1. Hesaplama Metodolojisi

Tazminat hesaplamalarında kullanılan matematiğin tamamı — değer kaybından destekten yoksun kalmaya, maluliyetten kusur oranına kadar. Her formül, katsayı ve yasal madde açıkça yazılıdır. Kaynak: Trafik Sigortası Genel Şartları (RG-4/12/2021) ve TRH-2010 aktüerya tabloları. İçerik doğrudan çalışan koddan (backend/api/src/hesaplamalar/) türetilmiştir; dokümantasyon ile üretim davranışı birbirinden sapmaz.

2. API Referansı

Sistemin uygulama programlama arayüzü. Hono + zod-openapi üzerine kuruludur; şemalar koddan otomatik üretilir. Canlı, gezilebilir OpenAPI 3.1 sözleşmesi /v1/docs adresinde yayınlanır — bu bölüm o sözleşmenin mimarisini, kimlik doğrulamasını ve hata sözleşmesini açıklar.

3. Tüzük & İşleyiş

Yol yardım eşleştirme, tamirci atama, dosya durum akışları, sigorta teklifi ve yönetim yetkileri gibi operasyonel kuralların işleyiş tüzüğü.

Kimler için?

• Son kullanıcılar & kamu — "Tazminatı nasıl hesaplıyorsunuz?" sorusunun şeffaf yanıtı.
• Partner & entegratörler — API üzerinden entegrasyon yapan sigorta ve servis firmaları.
• İç ekip — geliştiriciler ve operasyon için tek referans kaynağı.