Genel Bakış
Kaza Rehberi Kılavuzu, platformun üç temel katmanını tek ve şeffaf bir kaynakta belgeler:
Bölümler
Section titled “Bölümler”1. Hesaplama Metodolojisi
Section titled “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ı
Section titled “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ş
Section titled “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?
Section titled “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ğı.